Komponentreferens i agentbiblioteket i Copilot Agent Kit

Komponenter i Agent Library är återanvändbara, förbyggda komponentsamlingar som du kan lägga till i vilken Copilot Studio-agent som helst. Varje komponent paketeras som en egen komponentsamling, så du installerar bara de komponenter du behöver.

Den här artikeln är en komponentreferens. För en översikt över komponenter, hur du bläddrar bland och installerar komponenter från kitet, och hur du lägger till dem i din agent, se Komponenthantering i Agent Library.

Note

Agent Library finns både som en hanterad och en ohanterad lösning. Använd den hanterade lösningen för att lägga till komponenter till dina agenter utan att ändra dem. Använd den ohanterade lösningen endast om du behöver redigera komponenters interna system. Det finns bara en instans av varje komponent per miljö, så varje redigering du gör i ett ämne, prompt eller flöde i Agent Library gäller för varje agent som använder den komponenten i samma miljö.

Komponenter i en översikt

Agentbiblioteket inkluderar följande komponenter som levereras i deras lösningar. Komponenter som inte kräver några anslutningsreferenser finns i sin egen baslösning. Komponenter som delar en gemensam kontakt grupperas tillsammans.

Component collection	Description	Components	Connections
Document Extraction	Omvandlar uppladdade dokument till strukturerad data med hjälp av AI Builder.	1 prompt	Dataverse
Content Synthesizer	Delad AI Builder-prompt som syntetiserar forskningsinnehåll i evidensbaserade avsnitt med referenser.	1 prompt	Dataverse
Research Component	Trestegs AI-pipeline som syntetiserar webbkällor till en omfattande forskningsrapport.	1 ämne + 3 prompts (Steg 2 kallar Content Synthesizer)	Dataverse
Genomförande av ledningssammanfattande del	Trestegs AI-pipeline som producerar beslutsorienterade sammanfattningar.	1 ämne + 3 prompts (Steg 2 kallar Content Synthesizer)	Dataverse
ServiceNow Biljettassistent	Tjänsteincidenthantering från början till slut med adaptiva kort.	5 ämnen + 1 kopplingsreferens	Dataverse, ServiceNow

Important

Fält markerade Nej för Required har inbyggda standardinställningar och fungerar utan konfiguration. Ge ett värde endast för att åsidosätta standardbeteendet.

Prerequisites

Innan du börjar kontrollerar du att följande krav är uppfyllda:

• Installera och konfigurera Copilot Agent Kit i din Power Platform-miljö.
• Den inloggade användaren har CSK - Maker säkerhetsrollen tilldelad i Copilot Agent Kit för att bläddra bland och installera komponenter.
• Power Platform-miljön har Copilot Studio aktiverat.
• Ha AI Builder-krediter tillgängliga i din miljö (krävs för promptbaserade komponenter).
• För ServiceNow Ticket Assistant, ha en ServiceNow-instans med REST API-åtkomst och en konfigurerad ServiceNow-anslutning i Power Platform. Läs mer i ServiceNows service principal-setup.

Document Extraction

Property	Value
Type	AI Builder-prompt (TaskDialog)
Category	Datainsamling och integration
Interaction model	Tool-initiated. Agent-orkestratorn anropar detta verktyg när användarens avsikt stämmer överens med verktygsbeskrivningen.

Dokumentextraktion omvandlar uppladdade dokument till strukturerad data. Den använder en AI Builder-prompt för att tolka och extrahera nyckelfält baserat på ett konfigurerbart schema.

När ska användas: Fakturahantering, kontraktsgranskning, digitalisering av formulär eller alla scenarier som kräver att strukturerad information hämtas från ostrukturerade dokument.

Hur dokumentextraktion fungerar

1. Användaren laddar upp ett dokument till agentkonversationen.
2. Komponenten bearbetar dokumentet med AI Builder.
3. Komponenten returnerar extraherad data som strukturerad utdata som du kan lagra, visa eller skicka vidare till nedströms flöden.

Indata för dokumentutvinning

Name	Display name	Required	Description
DocumentContent	Document Content	Yes	Fulltext från filen eller inklistrat innehåll.
ExtractionSchema	Extraction Schema	Yes	Nyckelfält för att extrahera från dokumentinnehållet. Till exempel kan ett fakturaschema innehålla fält som namn, fakturanummer och datum.

Utdata från dokumentextraktion

Alla AI Builder-promptutdata returneras.

Content Synthesizer

Property	Value
Type	AI Builder-prompt (TaskDialog)
Category	Innehållsgenerering och omvandling
Interaction model	Module. Anropas av en moderpipeline (Research Component eller Executive Brief Component) som steg 2-syntessteget. Kan också användas som ett fristående verktyg.

Content Synthesizer omvandlar råa sökresultat till en strukturerad, evidensbaserad forskningssektion med inline-citat. Det är den delade syntesmotorn som används av både Research Component och Executive Brief Component-pipelines. Det kan också läggas till i vilken agent som helst som ett fristående verktyg för on-demand-innehållssyntes.

När ska användas: Alla scenarier som kräver att flera källdokument syntetiseras till en sammanhängande, citeringsbaserad berättelse, antingen som en del av en flerstegspipeline eller som ett fristående verktyg för innehållsgenerering.

Hur Content Synthesizer fungerar

1. Föräldrapipelinen (eller agenten) skickar en forskningsprompt, råt sökresultatinnehåll och valfria stilinstruktioner.
2. Prompten integrerar insikter från alla källor efter tema. Den sammanfattar inte källa för källa.
3. Bevisen är grundade i det tillhandahållna innehållet med specifika datapunkter såsom siffror, procentantal, datum och namngivna enheter.
4. Utdata är ett JSON-objekt som innehåller den syntetiserade markdown-sektionen och en array av extraherade citeringar.

Innehållssyntetisatoringångar

Name	Display name	Required	Type	Description
Content	Content	Yes	Automatic	Markdown-forskningsresultat som genereras från användarens sökning, används som indata för att syntetisera innehåll. Förväntat format inkluderar Title:, Source:, och Content: block.
ResearchPrompt	Research Prompt	Yes	Automatic	Användarens forskningsfråga eller förfrågan. Allt innehåll är utformat kring detta mål.

Innehållssynthesizer-utgångar

Prompten returnerar ett JSON-objekt med två fält:

Field	Type	Description
SectionContentMarkdown	String	Fullständig syntetiserad sektion i markdown. Organiserad efter tema med rubriker, viktiga fynd, viktiga insikter och en självförtroende-/nylighetsfot.
Citations	Array	Lista över citerade källor formaterade som "Title - URL". Varje post motsvarar en inline-markör [n] i avsnittets innehåll.

Innehållssyntesers utmatningsstruktur

Den syntetiserade sektionen följer denna struktur:

• Inledning: Leder med det viktigaste fyndet och förhandsvisar nyckelteman.
• Brödtext: Organiserad efter tema (inte efter källa), med inline-attributions- och [n] citeringsmarkörer, fetstilta nyckelsökningsmarkeringar och valfria [CHART SUGGESTION] markörer.
• Viktiga punkter: Tre till fem koncisa, handlingsbara punkter.
• Fot: Förtroendebedömning (hög till låg), dataaktualitet och märkbara luckor.

Research Component

Property	Value
Type	Ämne + 3 AI Builder-promptar + webbsökning
Category	Dataanalys och insikt
Interaction model	Tool-initiated. Trestegspipeline: forskningsplanering, innehållssyntes, rapportslutförande.

Research Component sammanställer information från flera källor till en omfattande forskningsrapport. Den använder en trestegs AI-pipeline för att planera, forska och sammanställa resultat.

När ska man använda: Konkurrensanalys, marknadsundersökning, policygranskning eller vilket scenario som helst som kräver en sammanslagen översikt över flera informationskällor.

Hur forskningskomponenten fungerar

1. Användaren tillhandahåller en forskningsfråga eller ämne.
2. Steg 1 (Forskningsplanerare): Skapar en strukturerad forskningsplan med avsnitt och frågor.
3. Steg 2 (Content Synthesizer): Söker i webbkällor för varje avsnitt och genererar innehåll med referenser.
4. Steg 3 (Rapportslutgiltighet): Kombinerar alla avsnitt och källhänvisningar till en polerad rapport.
5. Den slutgiltiga rapporten visas direkt i samtalet.

Forskningskomponentindata

Name	Display name	Required	Description
ResearchPrompt	Research Prompt	Yes	Huvudämnet eller forskningsämnet, såsom "Översikt av elbilmarknaden."
AdditionalInstructions	Additional Instructions	No	Valfri kontext såsom fokusområden eller begränsningar. Standardinställningen är "Börja med tydligt forskningsmål" om den är tom.
InstructionsForInformationCompiler	Instruktioner för informationskompilator	No	Kontrollerar stil och längd på varje syntetiserad sektion. Standardinställningen är "Enkel stil, max 200 ord" om den är tom.
InstructionsForReportFinalizer	Instruktioner för rapportslutförare	No	Kontrollerar hur slutrapporten sammanställs. Som standard syntetiserar alla avsnitt till en sammanhängande rapport.

Forskningskomponentresultat

Komponenten visar rapporten direkt i konversationen.

Genomförande av ledningssammanfattande del

Property	Value
Type	Ämne + 3 AI Builder-promptar + intern/webbsökning
Category	Innehållsgenerering och omvandling
Interaction model	Tool-initiated. Trestegspipeline: strategisk planering, insiktssyntes, kort slutförande.

Executive Brief Component genererar koncisa, beslutsorienterade sammanfattningar från komplexa indata. Den använder en trestegs AI-pipeline för att planera, syntetisera insikter och sammanställa en polerad ledningsbrief.

När ska användas: förberedelse inför styrelsemöten, uppdateringar av projektstatus, kvartalsvisa affärsöversikter eller något scenario som kräver en välgrundad sammanfattning för intressenter.

Hur Executive Brief-komponenten fungerar

1. Användaren ger ett kort ämne eller en fråga.
2. Steg 1 (Executive Brief Planner): Skapar en strategisk forskningsplan med forskningsområden.
3. Steg 2 (Insight Synthesizer, driven av Content Synthesizer): Söker interna och webbbaserade källor för varje område och extraherar viktiga fakta och citat.
4. Steg 3 (Brief Finalizer): Sammanställer alla insikter och citat till en polerad executive brief.
5. Inlagan visas i samtalet.

Executive Brief Komponentindata

Name	Display name	Required	Description
ResearchPrompt	Research Prompt	Yes	Det korta ämnet eller frågan, såsom "AI-implementeringsstrategi för medelstora företag."
AdditionalInstructions	Additional Instructions	No	Valfri företagskontext, fokusområden eller begränsningar.

Executive Brief Komponentresultat

Komponenten visar executive briefen direkt i samtalet.

ServiceNow Biljettassistent

Property	Value
Type	5 ämnen + ServiceNow-kontakt + adaptiva kort
Category	Åtgärdskörning och systemintegration
Interaction model	Conversation-initiated. Agenten leder till rätt ämne baserat på användarens avsikt. Varje ämne använder adaptiva kort för att samla in nödvändiga fält.

ServiceNow Ticket Assistant erbjuder hel serviceNow-incidenthantering direkt från en agent från Copilot Studio. Den innehåller fem ämnen som täcker hela incidentens livscykel.

När ska man använda: IT-helpdesk, medarbetarsjälvbetjäning eller något scenario som involverar ServiceNow-incidenthantering.

ServiceNow inkluderade ämnen

Topic	Description
Create Incident	Samlar in kort beskrivning, detaljerad beskrivning, påverkan och brådska via ett adaptivt kort, och skapar sedan incidenten i ServiceNow.
Check Status	Accepterar ett incidentnummer (till exempel INC0010002) och returnerar tillstånd, prioritet, datum och beskrivning.
Resolve/Close Incident	Uppdaterar en incidents tillstånd (Löst, Stängt, Inställt, På vänt, Pågår) med upplösningskod och anteckningar.
Få färska incidenter	Hämtar automatiskt upp till 10 senaste incidenter för den inloggade användaren. Ingen input krävs.
Next Actions	Visar en navigationsmeny efter att en ServiceNow-operation slutförts, och dirigerar till andra ServiceNow-ämnen eller allmänna konversationer.

Note

ServiceNow-ämnen använder adaptiva kort för att samla in användarinput direkt i samtalet. Inga verktygsnivåinmatningar krävs.

ServiceNow prerequisites

Denna komponent levereras i sin egen lösning (CopilotStudioKit_ServiceNow_Components) eftersom den kräver en ServiceNow-anslutningsreferens under importen. Innan du importerar denna lösning, se till att du har:

• En ServiceNow-instans med REST API-åtkomst.
• En anslutning konfigurerad i Power Platform för ServiceNow. Du blir ombedd att ställa in detta under lösningsimporten.
• Lämpliga ServiceNow-användarbehörigheter för de operationer som behövs.

ServiceNow-tjänsteprincipuppsättning

För att skapa en ServiceNow Power Platform-anslutning som använder Microsoft Entra ID, följ stegen i Hur man sätter upp en ServiceNow Power Platform-anslutning som använder Microsoft Entra ID.

Hur ServiceNow Ticket Assistant fungerar

1. Användaren uttrycker en avsikt (till exempel "Jag behöver skapa ett ärende" eller "Vad är statusen för INC0012345?").
2. Rätt ämne triggas och presenterar ett adaptivt kort för att samla in nödvändiga indata.
3. Komponenten anropar ServiceNow API via en connector och returnerar resultatet.
4. Efter att operationen är klar presenterar ämnet Nästa åtgärder alternativ för nästa steg.

Create incident

Skapar en ny ServiceNow-incident genom att samla in detaljer från användaren och skicka dem till ServiceNow via en koppling.

När ska man använda: IT-helpdesk, medarbetar-självbetjäning eller i alla situationer där användare behöver logga nya incidenter direkt från konversation.

Skapa incidentflöde

1. Användaren uttrycker avsikt att skapa en incident, till exempel "Jag behöver skapa ett ärende för en trasig laptop."
2. Ett adaptivt kort samlar in de nödvändiga incidentuppgifterna.
3. Komponenten anropar ServiceNow-API:et för att skapa incidenten och returnerar en bekräftelse med incidentnumret.
4. En meny för Nästa åtgärder presenteras så att användaren kan fortsätta med en annan ServiceNow-operation.

Skapa incidentindata via adaptivt kort

Field	Required	Description
ShortDescription	Yes	Kort sammanfattning av problemet
Description	No	Detaljerad beskrivning av problemet
Impact	Yes	Affärspåverkan (1-Hög, 2-Medel, 3-Låg)
Urgency	Yes	Brådskningsnivå (1-Hög, 2-Medel, 3-Låg)

Skapa incidentutdata

Bekräftelsemeddelande med det skapade incidentnumret visat inutifrån.

Kontrollera incidentstatus

Hämtar senaste status och detaljer om en befintlig ServiceNow-incident.

Kontrollera incidentstatusflödet

1. Användaren frågar om en incident, till exempel: "Vad är statusen för INC0010002?"
2. Ett adaptivt kort samlar in incidentnumret.
3. Komponenten frågar ServiceNow och returnerar incidentdetaljerna.

Kontrollera incidentstatusindata via adaptivt kort

Field	Required	Description
IncidentNumber	Yes	Incidentnumret att slå upp, såsom INC0010002.

Kontrollera incidentstatusutdata

Field	Description
IncidentNumber	Incidentidentifieraren
State	Händelsens nuvarande tillstånd
Priority	Priority level
CreatedDate	När incidenten skapades
LastUpdatedDate	När händelsen senast ändrades

Lös eller avsluta incidenten

Uppdaterar statusen för en befintlig ServiceNow-incident till Löst, Stängt, Avbrutet, På Vänt eller Pågår, tillsammans med detaljer om lösningen.

Lös eller stäng incidentflödet

1. Användaren uttrycker en avsikt att lösa eller stänga en incident, såsom "Stäng ärende INC0010002."
2. Ett adaptivt kort samlar in incidentnummer, måltillstånd, upplösningskod och upplösningsanteckningar.
3. Komponenten uppdaterar incidenten i ServiceNow och returnerar en bekräftelse.

Lös eller stäng incidentens förutsättningar

En ServiceNow-instans med REST API-åtkomst och en ServiceNow-anslutning i Power Platform.

Lös eller stäng infallande indata via adaptivt kort

Field	Required	Description
IncidentNumber	Yes	Incidentnumret som ska uppdateras
State	Yes	Måltillstånd (Löst, Stängt, Inställt, På vänt, Pågår)
ResolutionCode	Yes	Upplösningskategori, såsom Löst på distans eller Löst av uppringare
ResolutionNotes	Yes	Beskrivning av resolutionen

Lös eller stäng incident-utgångar

Bekräftelsemeddelande med uppdaterat incidentstatus visad inlines.

Få färska incidenter

Hämtar och visar upp till 10 senaste ServiceNow-incidenter för den nuvarande användaren. Inga inmatningsfält behövs. Komponenten använder automatiskt den inloggade användarens e-postadress.

När ska användas: När användare vill ha en snabb översikt över sina senaste eller öppna incidenter.

Få flödet av senaste incidenter

1. Användaren frågar om sina incidenter, till exempel "Visa mina senaste incidenter."
2. Komponenten frågar ServiceNow efter upp till 10 senaste incidenter som matchar den inloggade användarens e-post.
3. Händelsedetaljer visas direkt i konversationen.

Få input om senaste incidenter

None. Komponenten, som automatiskt använder den inloggade användarens e-postadress.

Få ut data från senaste incidenter

Field	Description
IncidentNumber	Incidentidentifieraren
State	Händelsens nuvarande tillstånd
Priority	Priority level
ShortDescription	Kort sammanfattning av problemet
CreatedDate	När incidenten skapades
LastUpdatedDate	När händelsen senast ändrades

Note

Alla ServiceNow-komponenter inkluderar en navigationsmeny för Nästa åtgärder som visas efter varje operation, vilket gör att användaren snabbt kan gå vidare till en annan ServiceNow-åtgärd eller återgå till allmän konversation.

Panelen för komponentdetaljer

När du öppnar en komponent från Agentbiblioteket i Copilot Agent Kit visar detaljpanelen komponentbeskrivning, kategori, in- och utdata samt den använda tekniken.

För att installera en komponent och lägga till den i ett agentarbetsflöde, se Komponenthantering.

Använd komponenter med en hanterad lösning

Använd den hanterade lösningen för de flesta användare. De importerade komponenterna är skrivskyddade. Du kan lägga till dem i dina agenter och använda dem utan risk att av misstag ändra de underliggande ämnena, promptarna eller flödena.

Även utan att redigera komponenterna själva finns det två sätt att kontrollera beteendet: agentinstruktioner och standardinställningar för verktygsinmatning.

Agent instructions

Din Copilot Studio-agents Instructions-fält är det primära sättet att forma hur komponenter används. Genom naturliga språkinstruktioner kan du kontrollera:

• När en komponent anropas: Beskriv scenarierna eller användarintentionerna som bör trigga varje verktyg.
• Vilken data som skickas: Berätta för agenten vilken kontext, vilka variabler eller konversationshistorik som ska inkluderas.
• Hur resultaten presenteras: Specificera formatering, ton, uppföljande åtgärder eller routing efter att en komponent returnerat sin utdata.
• Övergripande orkestrering: Definiera ordningen för operationer när flera komponenter är involverade, såsom "Efter att forskningen slutförts, generera en exekutiv sammanfattning utifrån resultaten."

Standardinställningar för verktygsinmatning

När du lägger till komponenter som verktyg, som AI Builder-promptar, kan du konfigurera inmatningsparametrar direkt i Copilot Studio, även när du använder en hanterad lösning. Dessa indata låter dig ställa in standardinställningar som är mer specifika än vad agentinstruktioner ensamma kan uppnå. For example:

• Ange en standard ExtractionSchema anpassad till dina affärsdokument, såsom fakturafält som namn, fakturanummer och datum.
• Förfyll AdditionalInstructions i med din organisations föredragna skrivstil eller efterlevnadskrav.

Ingångsstandardinställningar konfigureras per agent, så olika agenter kan skicka olika värden till samma delade komponent.

Anpassa komponenter med en ohanterad lösning

Om du behöver modifiera komponenternas interna delar, till exempel ändra promptlogik, redigera ämnesflöden eller koppla om kopplingar, måste du importera den ohanterade lösningen. Denna lösning ger dig full redigeringsåtkomst till varje ämne, prompt och flöde i Agent Library.

Important

Komponentsamlingar delas över hela miljön. Det finns bara en instans av varje komponent per miljö, så varje redigering du gör i ett ämne, prompt eller flöde i Agent Library gäller för varje agent som använder den komponenten i samma miljö. Innan du modifierar en komponent, kontrollera att ändringen är lämplig för alla konsumenter.

Vanliga anpassningar inkluderar:

• Ändra promptar: Justera AI Builder-prompts för att matcha din domän och ditt utdataformat.
• Byt datakällor: Peka komponenter till dina egna Dataverse-tabeller, SharePoint-listor eller externa kopplingar.
• Justera ämnen: Uppdatera samtalsflöden för att matcha organisationens terminologi och processer.
• Uppdatera triggerfraser: Lägg till triggerfraser som speglar hur dina användare naturligt ber om saker.
• Lägg till autentisering: Konfigurera autentisering om komponenter behöver åtkomst till användarspecifik data.

Tip

Om du behöver olika beteenden för olika agenter, överväg att skapa en kopia av komponenten i en separat lösning istället för att redigera den delade instansen.

Related information

• Components management
• AI Builder dokumentation