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.

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.

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

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

Utdata från dokumentextraktion

Alla AI Builder-promptutdata returneras.

Content Synthesizer

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

Innehållssynthesizer-utgångar

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

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

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

Forskningskomponentresultat

Komponenten visar rapporten direkt i konversationen.

Genomförande av ledningssammanfattande del

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

Executive Brief Komponentresultat

Komponenten visar executive briefen direkt i samtalet.

ServiceNow Biljettassistent

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

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

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

Kontrollera incidentstatusutdata

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

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

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.

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.

Related information

• Components management
• AI Builder dokumentation