Komponentreferanse i agentbiblioteket i Copilot Agent Kit

Komponenter i Agent Library er gjenbrukbare, ferdigbygde komponentsamlinger du kan legge til i hvilken som helst Copilot Studio-agent. Hver komponent er pakket som sin egen komponentsamling, så du installerer kun de komponentene du trenger.

Denne artikkelen er referansen for hver komponent. For en oversikt over komponenter, hvordan du bla gjennom og installerer komponenter fra settet, og hvordan du legger dem til i agenten din, se Komponenthåndtering i Agentbiblioteket.

Skjermbilde av komponentene i Agent Library i Copilot Agent Kit.

Note

Agent Library er tilgjengelig både som administrert og uadministrert løsning. Bruk den administrerte løsningen for å legge til komponenter i agentene dine uten endringer. Bruk den uadministrerte løsningen kun hvis du trenger å redigere komponentens interne detaljer. Det er bare én instans av hver komponent per miljø, så enhver redigering du gjør i et emne, en prompt eller flyt i Agentbiblioteket gjelder for alle agenter som bruker den komponenten i samme miljø.

Komponenter i et overblikk

Agent Library inkluderer følgende komponenter som leveres på deres løsninger. Komponenter som ikke krever tilkoblingsreferanser er i sin egen basisløsning. Komponenter som deler en felles kontakt grupperes sammen.

Component collection Description Components Connections
Document Extraction Omdanner opplastede dokumenter til strukturert data ved hjelp av AI Builder. 1 prompt Dataverse
Content Synthesizer Delt AI Builder-prompt som syntetiserer forskningsinnhold i evidensbaserte seksjoner med referanser. 1 prompt Dataverse
Research Component Tretrinns AI-pipeline som syntetiserer nettkilder til en omfattende forskningsrapport. 1 tema + 3 prompts (Trinn 2 kalles Content Synthesizer) Dataverse
Executive Brief-komponent Tretrinns AI-pipeline som produserer beslutningsorienterte sammendrag. 1 tema + 3 prompts (Trinn 2 kalles Content Synthesizer) Dataverse
ServiceNow Billettassistent End-to-end ServiceNow hendelseshåndtering ved bruk av adaptive kort. 5 temaer + 1 tilkoblingsreferanse Dataverse, ServiceNow

Important

Felt merket Nei for Required har innebygde standardinnstillinger og fungerer uten konfigurasjon. Oppgi en verdi kun for å overstyre standardoppførselen.

Prerequisites

Før du begynner, må du kontrollere at følgende forutsetninger er oppfylt:

  • Installer og konfigurer Copilot Agent Kit i Power Platform-miljøet ditt.
  • Den innloggede brukeren har CSK - Maker sikkerhetsrollen tildelt i Copilot Agent Kit for å bla gjennom og installere komponenter.
  • Power Platform-miljøet har Copilot Studio aktivert.
  • Ha AI Builder-kreditter tilgjengelig i miljøet ditt (påkrevd for promptbaserte komponenter).
  • For ServiceNow Ticket Assistant, ha en ServiceNow-instans med REST API-tilgang og en konfigurert ServiceNow-tilkobling i Power Platform. Lær mer i ServiceNow service principal-oppsett.

Document Extraction

Property Value
Type AI Builder-prompt (TaskDialog)
Category Datainnsamling og integrasjon
Interaction model Tool-initiated. Agent-orkestratoren aktiverer dette verktøyet når brukerens intensjon samsvarer med verktøybeskrivelsen.

Dokumentuttrekking omdanner opplastede dokumenter til strukturerte data. Den bruker en AI Builder-prompt for å analysere og hente ut nøkkelfelt basert på et konfigurerbart skjema.

Når skal man bruke: Fakturabehandling, kontraktsgjennomgang, skjemadigitalisering eller ethvert scenario som krever henting av strukturert informasjon fra ustrukturerte dokumenter.

Hvordan dokumentuttrekking fungerer

  1. Brukeren laster opp et dokument til agentsamtalen.
  2. Komponenten behandler dokumentet med AI Builder.
  3. Komponentene returnerer uttrukne data som strukturert output som du kan lagre, vise eller sende videre til nedstrøms strømmer.

Inputs for dokumentuttrekking

Name Display name Required Description
DocumentContent Document Content Yes Fulltekst fra filen eller limt inn innhold.
ExtractionSchema Extraction Schema Yes Nøkkelfelt for å trekke ut fra dokumentinnholdet. For eksempel kan et fakturaskjema inneholde felt som navn, fakturanummer og dato.

Utdata fra dokumentuttrekking

Alle AI Builder-prompt-utdata returneres.

Content Synthesizer

Property Value
Type AI Builder-prompt (TaskDialog)
Category Innholdsgenerering og transformasjon
Interaction model Module. Aktiveres av en foreldrepipeline (Research Component eller Executive Brief Component) som trinn 2 syntesetrinn. Kan også brukes som et frittstående verktøy.

Content Synthesizer omdanner rå søkeresultater til en strukturert, evidensbasert forskningsseksjon med inline-siteringer. Det er den delte syntesemotoren som brukes av både Research Component- og Executive Brief Component-pipelinene. Det kan også legges til enhver agent som et frittstående verktøy for on-demand innholdssyntese.

Når skal man bruke: Ethvert scenario som krever å syntetisere flere kildedokumenter til en sammenhengende, siteringsbasert fortelling, enten som en del av en flertrinns pipeline eller som et frittstående verktøy for innholdsgenerering.

Hvordan Content Synthesizer fungerer

  1. Foreldrepipelinen (eller agenten) sender en forskningsprompt, rått søkeresultatinnhold og valgfrie stilinstruksjoner.
  2. Prompten integrerer innsikt fra alle kilder etter tema. Den oppsummerer ikke kilde for kilde.
  3. Bevisene er forankret i det tilgjengelige innholdet med spesifikke datapunkter som tall, prosenter, datoer og navngitte enheter.
  4. Utgangen er et JSON-objekt som inneholder den syntetiserte markdown-seksjonen og et array av hentede referanser.

Innholdssynthesizer-innganger

Name Display name Required Type Description
Content Content Yes Automatic Markdown-forskningsresultater generert fra brukerens spørring, brukt som input for å syntetisere innhold. Forventet format inkluderer Title:, Source:, og Content: blokker.
ResearchPrompt Research Prompt Yes Automatic Brukerens forskningsspørsmål eller henvendelse. Alt innhold er rammet inn rundt dette målet.

Innholdssynthesizer-utganger

Prompten returnerer et JSON-objekt med to felt:

Field Type Description
SectionContentMarkdown String Full syntetisert seksjon i markdown. Organisert etter tema med overskrifter, nøkkelfunn, viktige punkter og en selvtillits-/nylig bunntekst.
Citations Array Liste over siterte kilder formatert som "Title - URL". Hver oppføring tilsvarer en innebygd [n] markør i seksjonsinnholdet.

Innholdssynthesizer-utgangsstruktur

Den syntetiserte delen følger denne strukturen:

  • Åpning: Leder med det viktigste funnet og forhåndsviser nøkkeltemaer.
  • Brødtekst: Organisert etter tema (ikke etter kilde), med inline attributt- og [n] referansemarkører, fete Key Finding-markeringer og valgfrie [CHART SUGGESTION] markører.
  • Viktige punkter: Tre til fem konsise, handlingsrettede punktlister.
  • Fottekst: Tillitsvurdering (høy til lav), nylig data, og merkbare hull.

Research Component

Property Value
Type Tema + 3 AI Builder-prompter + nettsøk
Category Dataanalyse og innsikt
Interaction model Tool-initiated. Tretrinns pipeline: forskningsplanlegging, innholdssyntese, rapportferdigstillelse.

Research Component syntetiserer informasjon fra flere kilder til en omfattende forskningsrapport. Den bruker en tretrinns AI-pipeline for å planlegge, forske på og samle funn.

Når skal man bruke: Konkurranseanalyse, markedsundersøkelser, policygjennomgang eller ethvert scenario som krever en samlet oversikt over flere informasjonskilder.

Hvordan forskningskomponenten fungerer

  1. Brukeren gir et forskningsspørsmål eller tema.
  2. Trinn 1 (Forskningsplanlegger): Lager en strukturert forskningsplan med seksjoner og spørringer.
  3. Trinn 2 (Content Synthesizer): Søker i nettkilder for hver seksjon og genererer innhold med referanser.
  4. Fase 3 (Report Finalizer): Kombinerer alle seksjoner og henvisninger til en polert rapport.
  5. Den endelige rapporten vises i samtalen.

Forskningskomponent-input

Name Display name Required Description
ResearchPrompt Research Prompt Yes Hovedtemaet eller forskningsobjektet, som for eksempel «Oversikt over markedet for elektriske kjøretøy.»
AdditionalInstructions Additional Instructions No Valgfri kontekst som fokusområder eller begrensninger. Standardinnstillingen er «Start med klart forskningsmål» hvis den er tom.
InstructionsForInformationCompiler Instruksjoner for informasjonskompilator No Kontrollerer stilen og lengden på hver syntetisert seksjon. Standard er "Enkel stil, maks 200 ord" hvis den er tom.
InstructionsForReportFinalizer Instruksjoner for rapportferdigstiller No Kontrollerer hvordan sluttrapporten settes sammen. Som standard syntetiserer alle seksjoner til en sammenhengende rapport.

Resultater fra forskningskomponenter

Komponenten viser rapporten inline i samtalen.

Executive Brief-komponent

Property Value
Type Tema + 3 AI Builder-prompts + internt/nettsøk
Category Innholdsgenerering og transformasjon
Interaction model Tool-initiated. Tre-trinns pipeline: strategisk planlegging, innsiktssyntese, kort ferdigstillelse.

Executive Brief Component genererer konsise, beslutningsorienterte sammendrag fra komplekse input. Den bruker en tretrinns AI-pipeline for å planlegge, syntetisere innsikter og sette sammen en polert executive brief.

Når bør du bruke: forberedelse til styremøter, oppdateringer av prosjektstatus, kvartalsvise forretningsgjennomganger, eller ethvert scenario som krever en polert oppsummering for interessenter.

Hvordan Executive Brief-komponenten fungerer

  1. Brukeren gir et kort tema eller spørsmål.
  2. Trinn 1 (Executive Brief Planner): Lager en strategisk forskningsplan med forskningsområder.
  3. Fase 2 (Insight Synthesizer, drevet av Content Synthesizer): Søker i interne og nettbaserte kilder for hvert område og henter ut viktige fakta og sitater.
  4. Fase 3 (Brief Finalizer): Samler alle innsikter og referanser til en polert executive brief.
  5. Innlegget vises i dialogen.

Executive Brief Komponentinnspill

Name Display name Required Description
ResearchPrompt Research Prompt Yes Det korte temaet eller spørsmålet, som «AI-adopsjonsstrategi for mellomstore selskaper.»
AdditionalInstructions Additional Instructions No Valgfri selskapskontekst, fokusområder eller begrensninger.

Executive Brief Komponentresultater

Komponenten viser lederbriefen i samtalen.

ServiceNow Billettassistent

Property Value
Type 5 temaer + ServiceNow-kontakt + adaptive kort
Category Handlingsutførelse og systemintegrasjon
Interaction model Conversation-initiated. Agenten ruter til riktig tema basert på brukerens intensjon. Hvert emne bruker adaptive kort for å samle nødvendige felt.

ServiceNow Ticket Assistant tilbyr helhetlig ServiceNow-hendelseshåndtering direkte fra en Copilot Studio-agent. Den inkluderer fem temaer som dekker hele hendelseslivssyklusen.

Når bør man bruke: IT-helpdesk, selvbetjening for ansatte, eller ethvert scenario som involverer ServiceNow-hendelseshåndtering.

ServiceNow inkluderte temaer

Topic Description
Create Incident Samler korte beskrivelser, detaljerte beskrivelser, påvirkning og hastverk gjennom et adaptivt kort, og oppretter deretter hendelsen i ServiceNow.
Check Status Godtar et hendelsesnummer (for eksempel INC0010002) og returnerer tilstand, prioritet, datoer og beskrivelse.
Resolve/Close Incident Oppdaterer en hendelses tilstand (løst, avsluttet, kansellert, på vent, pågår) med løsningskode og notater.
Få nylige hendelser Henter automatisk opptil 10 nylige hendelser for den innloggede brukeren. Ingen innspill er nødvendig.
Next Actions Viser en navigasjonsmeny etter å ha fullført en ServiceNow-operasjon, ruting til andre ServiceNow-temaer eller generell samtale.

Note

ServiceNow-temaer bruker adaptive kort for å samle inn brukerinnspill direkte i samtalen. Ingen verktøynivå-input kreves.

ServiceNow prerequisites

Denne komponenten leveres i sin egen løsning (CopilotStudioKit_ServiceNow_Components) fordi den krever en ServiceNow-tilkoblingsreferanse under importen. Før du importerer denne løsningen, sørg for at du har:

  • En ServiceNow-instans med REST API-tilgang.
  • En tilkobling konfigurert i Power Platform for ServiceNow. Du blir bedt om å sette dette opp under løsningsimporten.
  • Passende ServiceNow-brukertillatelser for nødvendige operasjoner.

ServiceNow tjenesteprinsippoppsett

For å sette opp en ServiceNow Power Platform-tilkobling som bruker Microsoft Entra ID, følg stegene i Hvordan sette opp en ServiceNow Power Platform-tilkobling som bruker Microsoft Entra ID.

Hvordan ServiceNow Ticket Assistant fungerer

  1. Brukeren uttrykker en intensjon (for eksempel «Jeg må opprette en sak» eller «Hva er status på INC0012345?»).
  2. Det aktuelle temaet utløses og presenterer et adaptivt kort for å samle inn nødvendige input.
  3. Komponenten kaller ServiceNow API via en kobling og returnerer resultatet.
  4. Etter at operasjonen er fullført, presenterer temaet Neste handlinger alternativer for neste steg.

Create incident

Oppretter en ny ServiceNow-hendelse ved å samle inn detaljer fra brukeren og sende dem til ServiceNow via en kobling.

Når skal man bruke: IT-helpdesk, selvbetjening for ansatte, eller ethvert scenario der brukere trenger å loggføre nye hendelser direkte fra samtalen.

Lag hendelsesflyt

  1. Brukeren uttrykker en intensjon om å skape en hendelse, for eksempel «Jeg må opprette en sak for en ødelagt laptop.»
  2. Et adaptivt kort samler inn de nødvendige hendelsesdetaljene.
  3. Komponenten kaller ServiceNow API for å opprette hendelsen og returnerer en bekreftelse med hendelsesnummeret.
  4. En Neste handlinger-meny presenteres slik at brukeren kan fortsette med en annen ServiceNow-operasjon.

Lag hendelsesinnganger gjennom adaptivt kort

Field Required Description
ShortDescription Yes Kort oppsummering av utgaven
Description No Detaljert beskrivelse av problemet
Impact Yes Forretningspåvirkningsnivå (1-Høy, 2-Middels, 3-Lav)
Urgency Yes Hastverk (1-Høy, 2-Middels, 3-Lav)

Lag hendelsesutganger

Bekreftelsesmelding med det opprettede hendelsesnummeret vist i linjen.

Sjekk hendelsesstatus

Henter siste status og detaljer om en eksisterende ServiceNow-hendelse.

Sjekk hendelsesstatusflyten

  1. Brukeren spør om en hendelse, for eksempel: «Hva er status på INC0010002?»
  2. Et adaptivt kort samler inn hendelsesnummeret.
  3. Komponenten spør ServiceNow og returnerer hendelsesdetaljene.

Sjekk innfallsstatusinnganger via adaptivt kort

Field Required Description
IncidentNumber Yes Hendelsesnummeret man bør slå opp, for eksempel INC0010002.

Sjekk hendelsesstatusutdata

Field Description
IncidentNumber Hendelsesidentifikatoren
State Nåværende tilstand for hendelsen
Priority Priority level
CreatedDate Da hendelsen ble skapt
LastUpdatedDate Når hendelsen sist ble endret

Løs eller lukk hendelsen

Oppdaterer tilstanden til en eksisterende ServiceNow-hendelse til løst, stengt, kansellert, på vent eller pågående, sammen med detaljer om løsningen.

Løs eller lukk innkommende flyt

  1. Brukeren uttrykker en intensjon om å løse eller avslutte en hendelse, som for eksempel «Lukk sak INC0010002».
  2. Et adaptivt kort samler inn hendelsesnummer, målstatus, oppløsningskode og oppløsningsnotater.
  3. Komponenten oppdaterer hendelsen i ServiceNow og returnerer en bekreftelse.

Løs eller lukk hendelsesforutsetninger

En ServiceNow-instans med REST API-tilgang og en ServiceNow-tilkobling i Power Platform.

Løs eller lukk innkommende innganger via adaptivt kort

Field Required Description
IncidentNumber Yes Hendelsesnummeret må oppdateres
State Yes Måltilstand (Løst, Lukket, Kansellert, På vent, Pågår)
ResolutionCode Yes Oppløsningskategori, som løst eksternt eller løst av anroper
ResolutionNotes Yes Beskrivelse av resolusjonen

Løs eller lukk innkommende utganger

Bekreftelsesmelding med oppdatert hendelsestilstand vist i linjen.

Få nylige hendelser

Henter og viser opptil 10 nylige ServiceNow-hendelser for nåværende bruker. Ingen inndatafelt er nødvendig. Komponenten bruker automatisk e-posten til den innloggede brukeren.

Når skal man bruke: Når brukere ønsker en rask oversikt over sine nylige eller åpne hendelser.

Få flyt over nylige hendelser

  1. Brukeren spør om hendelsene deres, for eksempel «Vis mine siste hendelser.»
  2. Komponenten spør ServiceNow etter opptil 10 nylige hendelser som matcher e-posten til den innloggede brukeren.
  3. Hendelsesdetaljer vises direkte i samtalen.

Få inndata om nylige hendelser

None. Komponenten bruker automatisk e-posten til den innloggede brukeren.

Få resultater fra nylige hendelser

Field Description
IncidentNumber Hendelsesidentifikatoren
State Nåværende tilstand for hendelsen
Priority Priority level
ShortDescription Kort oppsummering av utgaven
CreatedDate Da hendelsen ble skapt
LastUpdatedDate Når hendelsen sist ble endret

Note

Alle ServiceNow-komponenter inkluderer en navigasjonsmeny for Neste handlinger som vises etter hver operasjon, slik at brukeren raskt kan gå videre til en annen ServiceNow-handling eller gå tilbake til generell samtale.

Panel for komponentdetaljer

Når du åpner en komponent fra Agent Library i Copilot Agent Kit, viser detaljpanelet komponentbeskrivelsen, kategorien, input- og outputvariabler, samt teknologien som brukes.

Skjermbilde av komponentdetaljpanelet som viser beskrivelse, innganger, utganger og brukt teknologi.

For å installere en komponent og legge den til i en agentarbeidsflyt, se Komponenthåndtering.

Bruk komponenter med en administrert løsning

Bruk den administrerte løsningen for de fleste brukere. De importerte komponentene er skrivebeskyttet. Du kan legge dem til i agentene dine og bruke dem uten risiko for å endre underliggende temaer, prompts eller flows ved et uhell.

Selv uten å redigere komponentene selv, har du to måter å kontrollere oppførsel på: agentinstruksjoner og standardinnstillinger for verktøyinput.

Agent instructions

Instruksjonsfeltet til din Copilot Studio-agent er den primære måten å forme hvordan komponenter brukes. Gjennom naturlige språkinstruksjoner kan du kontrollere:

  • Når en komponent aktiveres: Beskriv scenarioene eller brukerintensjonene som skal utløse hvert verktøy.
  • Hvilke data som overleveres: Fortell agenten hvilken kontekst, hvilke variabler eller samtalehistorikk som skal inkluderes.
  • Slik presenteres resultatene: Spesifiser formatering, tone, oppfølgingshandlinger eller ruting etter at en komponent returnerer sitt utdata.
  • Overordnet orkestrering: Definer rekkefølgen på operasjonene når flere komponenter er involvert, for eksempel «Etter at forskningen er fullført, generer en executive brief ut fra funnene.»

Standardinnstillinger for verktøyinput

Når du legger til komponenter som verktøy, som AI Builder-prompter, kan du konfigurere inputparametere direkte i Copilot Studio, selv når du bruker en administrert løsning. Disse inputene lar deg sette standardinnstillinger som er mer spesifikke enn det agentinstruksjoner alene kan oppnå. For example:

  • Oppgi en standard ExtractionSchema tilpasset forretningsdokumentene dine, som fakturafelt som navn, fakturanummer og dato.
  • Forhåndsfyll AdditionalInstructions ut med organisasjonens foretrukne skrivestil eller krav til etterlevelse.

Inndatastandardinnstillinger konfigureres per agent, slik at ulike agenter kan sende forskjellige verdier til samme delte komponent.

Tilpass komponenter med en uadministrert løsning

Hvis du trenger å endre komponentenes interne deler, som å endre prompt-logikk, redigere emneflyter eller koble om koblinger, må du importere den uadministrerte løsningen. Denne løsningen gir deg full redigeringstilgang til hvert tema, prompt og flyt i Agent Library.

Important

Komponentsamlinger deles på tvers av miljøet. Det er bare én instans av hver komponent per miljø, så enhver redigering du gjør i et emne, en prompt eller flyt i Agentbiblioteket gjelder for alle agenter som bruker den komponenten i samme miljø. Før du modifiserer en komponent, må du bekrefte at endringen er passende for alle forbrukere.

Vanlige tilpasninger inkluderer:

  • Endre promptene: Juster AI Builder-promptene for å matche domenet og utdataformatet ditt.
  • Endre datakilder: Pek komponentene til dine egne Dataverse-tabeller, SharePoint-lister eller eksterne koblinger.
  • Juster temaer: Oppdater samtaleflyter for å matche organisasjonens terminologi og prosesser.
  • Oppdater triggerfraser: Legg til triggerfraser som gjenspeiler hvordan brukerne dine naturlig ber om ting.
  • Legg til autentisering: Konfigurer autentisering hvis komponenter trenger tilgang til brukerspesifikke data.

Tip

Hvis du trenger forskjellig oppførsel for forskjellige agenter, vurder å lage en kopi av komponenten i en separat løsning i stedet for å redigere den delte instansen.