Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Componenten in de Agent Library zijn herbruikbare, vooraf gebouwde componentencollecties die je aan elke Copilot Studio-agent kunt toevoegen. Elke component wordt als een eigen componentencollectie verpakt, dus je installeert alleen de componenten die je nodig hebt.
Dit artikel is de referentie per component. Voor een overzicht van componenten, hoe je componenten uit de kit kunt bekijken en installeren, en hoe je ze aan je agent toevoegt, zie Componentenbeheer in de Agentbibliotheek.
Note
De Agent Library is beschikbaar als zowel een beheerde als een niet-beheerde oplossing. Gebruik de beheerde oplossing om componenten aan je agenten toe te voegen zonder aanpassing. Gebruik de unmanaged oplossing alleen als je componentinterne onderdelen moet bewerken. Er is maar één instantie van elke component per omgeving, dus elke wijziging die je maakt aan een onderwerp, prompt of flow binnen de Agent Library geldt voor elke agent die die component in dezelfde omgeving gebruikt.
Componenten in één oogopslag
De Agent Library bevat de volgende componenten die via hun oplossingen worden geleverd. Componenten die geen verbindingsreferenties vereisen, zitten in hun eigen basisoplossing. Componenten die een gemeenschappelijke connector delen, worden samen gegroepeerd.
| Component collection | Description | Components | Connections |
|---|---|---|---|
| Document Extraction | Zet geüploade documenten om in gestructureerde data met behulp van AI Builder. | 1 prompt | Dataverse |
| Content Synthesizer | Gedeelde AI Builder-prompt die onderzoeksinhoud samenvoegt in evidence-based secties met citaties. | 1 prompt | Dataverse |
| Research Component | Drie-fasen AI-pijplijn die webbronnen synthetiseert tot een uitgebreid onderzoeksrapport. | 1 onderwerp + 3 prompts (Fase 2 noemt Content Synthesizer) | Dataverse |
| Uitvoerend Briefing-onderdeel | Drie-fasen AI-pijplijn die beslissingsgerichte samenvattingen produceert. | 1 onderwerp + 3 prompts (Fase 2 noemt Content Synthesizer) | Dataverse |
| ServiceNow Ticket Assistant | End-to-end ServiceNow incidentmanagement met behulp van adaptieve kaarten. | 5 onderwerpen + 1 verbindingsreferentie | Dataverse, ServiceNow |
Important
Velden die Nee voor Vereist zijn gemarkeerd hebben ingebouwde standaardinstellingen en werken zonder configuratie. Geef alleen een waarde om het standaardgedrag te overschrijven.
Prerequisites
Voordat u begint, moet u ervoor zorgen dat aan de volgende vereisten wordt voldaan:
- Installeer en configureer Copilot Agent Kit in je Power Platform-omgeving.
- De ingelogde gebruiker heeft de CSK - Maker beveiligingsrol toegewezen in Copilot Agent Kit om componenten te bekijken en te installeren.
- De Power Platform-omgeving heeft Copilot Studio ingeschakeld.
- Zorg dat AI Builder-credits beschikbaar zijn in je omgeving (vereist voor prompt-gebaseerde componenten).
- Voor ServiceNow Ticket Assistant moet je een ServiceNow-instantie hebben met REST API-toegang en een geconfigureerde ServiceNow-verbinding in Power Platform. Lees meer in ServiceNow service principal setup.
Document Extraction
| Property | Value |
|---|---|
| Type | AI Builder-prompt (TaskDialog) |
| Category | Dataverzameling en integratie |
| Interaction model | Tool-initiated. De agent orchestrator roept dit hulpmiddel aan wanneer de intentie van de gebruiker overeenkomt met de toolbeschrijving. |
Document Extraction transformeert geüploade documenten in gestructureerde data. Het gebruikt een AI Builder-prompt om sleutelvelden te parsen en te extraheren op basis van een configureerbaar schema.
Wanneer te gebruiken: facturatieverwerking, contractbeoordeling, digitalisering van formulieren, of elk scenario waarbij gestructureerde informatie uit ongestructureerde documenten moet worden gehaald.
Hoe documentextractie werkt
- De gebruiker uploadt een document naar het agentgesprek.
- De component verwerkt het document met AI Builder.
- De component levert geëxtraheerde data terug als gestructureerde output die je kunt opslaan, weergeven of doorgeven aan downstream stromen.
Invoer voor documentextractie
| Name | Display name | Required | Description |
|---|---|---|---|
| DocumentContent | Document Content | Yes | Volledige tekst uit het bestand of geplakte inhoud. |
| ExtractionSchema | Extraction Schema | Yes | Sleutelvelden om uit de inhoud van het document te halen. Een factuurschema kan bijvoorbeeld velden bevatten zoals naam, factuurnummer en datum. |
Documentextractie-uitkomsten
Alle AI Builder-prompt-uitvoer worden teruggegeven.
Content Synthesizer
| Property | Value |
|---|---|
| Type | AI Builder-prompt (TaskDialog) |
| Category | Contentgeneratie en -transformatie |
| Interaction model | Module. Aangeroepen door een ouderpipeline (Research Component of Executive Brief Component) als de Stage 2 synthesestap. Kan ook als zelfstandig hulpmiddel worden gebruikt. |
Content Synthesizer transformeert ruwe zoekresultaten in een gestructureerde, op bewijs gebaseerde onderzoekssectie met inline citaties. Het is de gedeelde synthese-engine die wordt gebruikt door zowel de Research Component als de Executive Brief Component-pijplijnen. Het kan ook aan elke agent worden toegevoegd als een zelfstandig hulpmiddel voor on-demand contentsynthese.
Wanneer te gebruiken: Elk scenario dat vereist dat meerdere brondocumenten worden samengevoegd tot een samenhangend, op citatie gebaseerde verhaallijn, hetzij als onderdeel van een meerfasige pijplijn of als een zelfstandig hulpmiddel voor contentgeneratie.
Hoe Content Synthesizer werkt
- De ouderpipeline (of agent) geeft een onderzoeksprompt, ruwe zoekresultaten-inhoud en optionele stijlinstructies door.
- De prompt integreert inzichten uit alle bronnen per thema. Het vat niet de bron per bron samen.
- Het bewijs is gebaseerd op de verstrekte inhoud met specifieke datapunten zoals cijfers, percentages, data en genoemde entiteiten.
- De output is een JSON-object met het gesynthetiseerde markdown-gedeelte en een array van geëxtraheerde citaties.
Content Synthesizer-ingangen
| Name | Display name | Required | Type | Description |
|---|---|---|---|---|
| Content | Content | Yes | Automatic | Markdown-onderzoeksoutput die wordt gegenereerd uit de zoekopdracht van de gebruiker, gebruikt als input voor het synthetiseren van inhoud. Het verwachte formaat omvat Title:, Source:, en Content: blokken. |
| ResearchPrompt | Research Prompt | Yes | Automatic | De onderzoeksvraag of -vraag van de gebruiker. Alle inhoud is rondom dit doel geraamd. |
Content Synthesizer-uitvoer
De prompt geeft een JSON-object terug met twee velden:
| Field | Type | Description |
|---|---|---|
| SectionContentMarkdown | String | Volledige gesynthetiseerde sectie in markdown. Georganiseerd op thema met koppen, belangrijke bevindingen, belangrijke lessen en een vertrouwen/recentheid voettekst. |
| Citations | Array | Lijst van geciteerde bronnen, opgemaakt als "Title - URL". Elke vermelding komt overeen met een inline-marker [n] in de inhoud van de sectie. |
Content-synthesizer outputstructuur
De gesynthetiseerde sectie volgt deze structuur:
- Opening: Leidt met de belangrijkste bevinding en geeft een voorsmakie van belangrijke thema's.
-
Hoofdtekst: Georganiseerd op thema (niet op bron), met inline toeschrijving en
[n]citatiemarkeringen, vetgedrukte Key Finding-aanmeldingen en optionele[CHART SUGGESTION]markeringen. - Belangrijkste punten: Drie tot vijf beknopte, toepasbare opsommingstekens.
- Voettekst: Zelfvertrouwensbeoordeling (hoog naar laag), recente data en opvallende hiaten.
Research Component
| Property | Value |
|---|---|
| Type | Onderwerp + 3 AI Builder-prompts + webzoekopdrachten |
| Category | Data-analyse en inzicht |
| Interaction model | Tool-initiated. Drie-fasen pijplijn: onderzoeksplanning, contentsynthese, rapportfinalisatie. |
Research Component synthetiseert informatie uit meerdere bronnen tot een uitgebreid onderzoeksrapport. Het gebruikt een drie-fasen AI-pijplijn om bevindingen te plannen, te onderzoeken en samen te stellen.
Wanneer te gebruiken: concurrentieanalyse, marktonderzoek, beleidsherziening of elk scenario dat een geconsolideerd overzicht vereist over meerdere informatiebronnen.
Hoe het onderzoeksonderdeel werkt
- De gebruiker levert een onderzoeksvraag of onderwerp.
- Fase 1 (Onderzoeksplanner): Maakt een gestructureerd onderzoeksplan met secties en vragen.
- Fase 2 (Content Synthesizer): Zoekt webbronnen voor elke sectie en genereert inhoud met citaties.
- Fase 3 (Report Finalizer): Combineert alle secties en citaties tot een gepolijst rapport.
- Het eindrapport wordt direct in het gesprek weergegeven.
Onderzoekscomponenten
| Name | Display name | Required | Description |
|---|---|---|---|
| ResearchPrompt | Research Prompt | Yes | Het hoofdonderwerp of onderzoeksonderwerp, zoals "Overzicht van de markt voor elektrische voertuigen." |
| AdditionalInstructions | Additional Instructions | No | Optionele context zoals focusgebieden of beperkingen. Standaard staat het op "Begin met een duidelijk onderzoeksdoel" als het leeg is. |
| InstructionsForInformationCompiler | Instructies voor Informatiecompiler | No | Regelt de stijl en lengte van elke gesynthetiseerde sectie. Standaard staat het op "Eenvoudige stijl, maximaal 200 woorden" als het leeg is. |
| InstructionsForReportFinalizer | Instructies voor de Rapportfinalisator | No | Bepaalt hoe het eindrapport wordt samengesteld. Standaard is het samenvoegen van alle secties tot een samenhangend rapport. |
Resultaten van onderzoekscomponenten
De component toont het rapport direct in het gesprek.
Uitvoerend Briefing-onderdeel
| Property | Value |
|---|---|
| Type | Onderwerp + 3 AI Builder-prompts + interne/webzoekopdrachten |
| Category | Contentgeneratie en -transformatie |
| Interaction model | Tool-initiated. Drie-fasen pijplijn: strategische planning, synthese van inzichten, korte finalisatie. |
Executive Brief Component genereert beknopte, besluitvormingsgerichte samenvattingen uit complexe inputs. Het gebruikt een driefasige AI-pijplijn om inzichten te plannen, te synthetiseren en een uitgewerkte executive brief samen te stellen.
Wanneer te gebruiken: voorbereiding van bestuursvergaderingen, projectstatusupdates, kwartaalbeoordelingen van het bedrijfsleven, of elk scenario dat een uitgewerkte samenvatting voor belanghebbenden vereist.
Hoe Executive Brief Component werkt
- De gebruiker geeft een kort onderwerp of vraag.
- Fase 1 (Executive Brief Planner): Maakt een strategisch onderzoeksplan op met onderzoeksgebieden.
- Fase 2 (Insight Synthesizer, aangedreven door Content Synthesizer): Zoekt in interne en webbronnen voor elk gebied en extraheert belangrijke feiten en citaties.
- Fase 3 (Brief Finalizer): Verzamelt alle inzichten en citaties in een gepolijste executive brief.
- De brief wordt direct in het gesprek getoond.
Executive Brief Component-invoer
| Name | Display name | Required | Description |
|---|---|---|---|
| ResearchPrompt | Research Prompt | Yes | Het korte onderwerp of vraag, zoals "AI-adoptiestrategie voor middenmarktbedrijven." |
| AdditionalInstructions | Additional Instructions | No | Optionele bedrijfscontext, focusgebieden of beperkingen. |
Executive Brief Component-uitkomsten
Het onderdeel toont de executive brief direct in het gesprek.
ServiceNow Ticket Assistant
| Property | Value |
|---|---|
| Type | 5 onderwerpen + ServiceNow-connector + adaptieve kaarten |
| Category | Actie-uitvoering en systeemintegratie |
| Interaction model | Conversation-initiated. De agent stuurt naar het juiste onderwerp op basis van de intentie van de gebruiker. Elk onderwerp gebruikt adaptieve kaarten om de benodigde velden te verzamelen. |
ServiceNow Ticket Assistant biedt end-to-end ServiceNow incidentmanagement direct van een Copilot Studio-agent. Het bevat vijf onderwerpen die de volledige levenscyclus van het incident bestrijken.
Wanneer te gebruiken: IT-helpdesk, zelfbediening voor medewerkers, of elk scenario waarbij ServiceNow incidentmanagement betrokken is.
ServiceNow bevatte onderwerpen
| Topic | Description |
|---|---|
| Create Incident | Verzamelt korte beschrijvingen, gedetailleerde beschrijvingen, impact en urgentie via een adaptieve kaart, en maakt vervolgens het incident aan in ServiceNow. |
| Check Status | Accepteert een incidentnummer (bijvoorbeeld INC0010002) en geeft status, prioriteit, data en beschrijving terug. |
| Resolve/Close Incident | Werkt de status van een incident bij (Opgelost, Gesloten, Geannuleerd, In Wacht, In Uitvoering) met resolutiecode en notities. |
| Ontvang recente incidenten | Automatisch haalt tot 10 recente incidenten op voor de ingelogde gebruiker. Er is geen input nodig. |
| Next Actions | Toont een navigatiemenu na het voltooien van een ServiceNow-operatie, waarbij je doorgaat naar andere ServiceNow-onderwerpen of algemene gesprekken. |
Note
ServiceNow-onderwerpen gebruiken adaptieve kaarten om gebruikersinput direct in het gesprek te verzamelen. Er zijn geen invoer op gereedschapsniveau nodig.
ServiceNow prerequisites
Deze component wordt geleverd in een eigen oplossing (CopilotStudioKit_ServiceNow_Components) omdat het een ServiceNow-verbindingsreferentie vereist tijdens import. Voordat je deze oplossing importeert, zorg ervoor dat je:
- Een ServiceNow-instantie met REST API-toegang.
- Een verbinding geconfigureerd in Power Platform voor ServiceNow. Je wordt gevraagd dit in te stellen tijdens de import van de oplossing.
- Passende ServiceNow-gebruikersrechten voor de benodigde bewerkingen.
ServiceNow service principal setup
Om een ServiceNow Power Platform-verbinding op te zetten die Microsoft Entra ID gebruikt, volgt u de stappen in Hoe een ServiceNow Power Platform-verbinding opzet die Microsoft Entra ID gebruikt.
Hoe ServiceNow Ticket Assistant werkt
- De gebruiker geeft een intentie uit (bijvoorbeeld: "Ik moet een ticket aanmaken" of "Wat is de status van INC0012345?").
- Het juiste onderwerp wordt geactiveerd en presenteert een adaptieve kaart om de benodigde invoer te verzamelen.
- De component roept de ServiceNow API aan via een connector en geeft het resultaat terug.
- Nadat de operatie is voltooid, presenteert het onderwerp Volgende Acties opties voor de volgende stap.
Create incident
Maakt een nieuw ServiceNow-incident aan door gegevens van de gebruiker te verzamelen en deze via een connector aan ServiceNow te sturen.
Wanneer te gebruiken: IT-helpdesk, zelfbediening voor medewerkers, of in elk scenario waarin gebruikers nieuwe incidenten direct uit gesprekken moeten registreren.
Creëer incidentflow
- De gebruiker geeft aan een incident te willen creëren, zoals "Ik moet een ticket aanmaken voor een kapotte laptop."
- Een adaptieve kaart verzamelt de benodigde incidentgegevens.
- De component roept de ServiceNow API aan om het incident te creëren en geeft een bevestiging terug met het incidentnummer.
- Er wordt een Next Actions-menu weergegeven zodat de gebruiker kan doorgaan met een andere ServiceNow-operatie.
Maak incident-invoer via adaptieve kaart
| Field | Required | Description |
|---|---|---|
| ShortDescription | Yes | Kort overzicht van het probleem |
| Description | No | Gedetailleerde beschrijving van het probleem |
| Impact | Yes | Bedrijfsimpactniveau (1-Hoog, 2-Middel, 3-Laag) |
| Urgency | Yes | Urgentieniveau (1-Hoog, 2-Middel, 3-Laag) |
Maak incident-uitvoeren
Bevestigingsbericht met het aangemaakte incidentnummer inline.
Controleer de incidentstatus
Haalt de laatste status en details op van een bestaand ServiceNow-incident.
Controleer de incidentstatusstroom
- De gebruiker vraagt bijvoorbeeld naar een incident: "Wat is de status van INC0010002?"
- Een adaptieve kaart verzamelt het incidentnummer.
- Het onderdeel vraagt ServiceNow aan en geeft de incidentgegevens terug.
Controleer de incidentstatusinvoer via een adaptieve kaart
| Field | Required | Description |
|---|---|---|
| IncidentNumber | Yes | Het incidentnummer om op te zoeken, zoals INC0010002. |
Controleer incidentstatus-uitgangen
| Field | Description |
|---|---|
| IncidentNumber | De incidentidentificatie |
| State | Huidige stand van zaken |
| Priority | Priority level |
| CreatedDate | Toen het incident werd veroorzaakt |
| LastUpdatedDate | Wanneer het incident voor het laatst werd aangepast |
Oplos of sluit incident
Werkt de status van een bestaand ServiceNow-incident bij naar Opgelost, Gesloten, Geannuleerd, Op Pauze of In Gang, samen met resolutiedetails.
Incidentstroom oplossen of sluiten
- De gebruiker geeft aan een incident op te lossen of te sluiten, zoals "Ticket sluiten INC0010002."
- Een adaptieve kaart verzamelt het incidentnummer, de doelstatus, de resolutiecode en de resolutienotities.
- De component werkt het incident bij in ServiceNow en geeft een bevestiging terug.
Voorafgaande vereisten voor incidenten oplossen of afsluiten
Een ServiceNow-instantie met REST API-toegang en een ServiceNow-verbinding in Power Platform.
Oplossing of sluit incident inputs via adaptieve kaart
| Field | Required | Description |
|---|---|---|
| IncidentNumber | Yes | Het incidentnummer om bij te werken |
| State | Yes | Doeltoestand (Opgelost, Gesloten, Geannuleerd, In Pauze, In Uitvoering) |
| ResolutionCode | Yes | Resolutiecategorie, zoals Opgelost op afstand of Opgelost door Beller |
| ResolutionNotes | Yes | Beschrijving van de resolutie |
Incident-uitgangen oplossen of sluiten
Bevestigingsbericht met de bijgewerkte incidentstatus weergegeven in de lijn.
Haal recente incidenten op
Haalt tot 10 recente ServiceNow-incidenten op en toont deze voor de huidige gebruiker. Er zijn geen invoervelden nodig. De component gebruikt automatisch het e-mailadres van de ingelogde gebruiker.
Wanneer te gebruiken: Wanneer gebruikers een snel overzicht willen van hun recente of openstaande incidenten.
Ontvang recente incidentenstroom
- De gebruiker vraagt naar zijn incidenten, zoals "Laat mijn recente incidenten zien."
- De component vraagt ServiceNow op naar maximaal 10 recente incidenten die overeenkomen met het e-mailadres van de ingelogde gebruiker.
- Details van het incident worden direct in het gesprek weergegeven.
Ontvang recente incidenten-inputs
None. De component gebruikt automatisch het e-mailadres van de ingelogde gebruiker.
Verkrijg recente incidenten-uitkomsten
| Field | Description |
|---|---|
| IncidentNumber | De incidentidentificatie |
| State | Huidige stand van zaken |
| Priority | Priority level |
| ShortDescription | Kort overzicht van het probleem |
| CreatedDate | Toen het incident werd veroorzaakt |
| LastUpdatedDate | Wanneer het incident voor het laatst werd aangepast |
Note
Alle ServiceNow-componenten bevatten een navigatiemenu Volgende Acties dat na elke bewerking verschijnt, waardoor de gebruiker snel naar een andere ServiceNow-actie kan gaan of kan terugkeren naar een algemeen gesprek.
Paneel met componentdetails
Wanneer je een component opent uit de Agent Library in Copilot Agent Kit, toont het detailpaneel de componentbeschrijving, categorie, invoer- en uitvoervariabelen en gebruikte technologie.
Om een component te installeren en toe te voegen aan een agentworkflow, zie Componentenbeheer.
Gebruik componenten met een beheerde oplossing
Gebruik de beheerde oplossing voor de meeste gebruikers. De geïmporteerde componenten zijn alleen-lezen. Je kunt ze toevoegen aan je agenten en gebruiken zonder het risico per ongeluk de onderliggende onderwerpen, prompts of flows aan te passen.
Zelfs zonder de componenten zelf te bewerken, heb je twee manieren om gedrag te controleren: agentinstructies en toolinvoerstandaardinstellingen.
Agent instructions
Het Instructieveld van je Copilot Studio-agent is de belangrijkste manier om te bepalen hoe componenten worden gebruikt. Via natuurlijke taalinstructies kun je het volgende controleren:
- Wanneer een component wordt aangeroepen: Beschrijf de scenario's of gebruikersintenties die elk hulpmiddel zouden moeten triggeren.
- Welke data wordt doorgegeven: Vertel de agent welke context, variabelen of gespreksgeschiedenis hij moet opnemen.
- Hoe resultaten worden gepresenteerd: Specificeer opmaak, toon, vervolgacties of routing nadat een component zijn output heeft teruggegeven.
- Algemene orkestratie: Definieer de volgorde van de operaties wanneer meerdere componenten betrokken zijn, zoals "Na het voltooien van het onderzoek, genereer een executive brief op basis van de bevindingen."
Toolinvoerstandaardinstellingen
Wanneer je componenten als tools toevoegt, zoals AI Builder-prompts, kun je invoerparameters direct configureren in Copilot Studio, zelfs als je een beheerde oplossing gebruikt. Met deze inputs kun je standaardwaarden instellen die specifieker zijn dan wat agentinstructies alleen kunnen bereiken. For example:
- Geef een standaard
ExtractionSchemadie is afgestemd op je bedrijfsdocumenten, zoals facturenvelden zoals naam, factuurnummer en datum. - Prevul
AdditionalInstructionsin met de voorkeursschrijfstijl of compliance-eisen van uw organisatie.
Inputstandaardwaarden worden per agent geconfigureerd, zodat verschillende agenten verschillende waarden kunnen doorgeven aan hetzelfde gedeelde component.
Componenten aanpassen met een niet-beheerde oplossing
Als je de componentinterne onderdelen moet aanpassen, zoals het wijzigen van promptlogica, het bewerken van topic flows of het opnieuw bedraaden van connectors, moet je de niet-beheerde oplossing importeren. Deze oplossing geeft je volledige bewerkingstoegang tot elk onderwerp, prompt en flow in de Agent Library.
Important
Componentencollecties worden gedeeld binnen de omgeving. Er is maar één instantie van elke component per omgeving, dus elke wijziging die je maakt aan een onderwerp, prompt of flow binnen de Agent Library geldt voor elke agent die die component in dezelfde omgeving gebruikt. Controleer voordat je een component aanpast, voordat je een onderdeel aanpast, of de wijziging geschikt is voor alle consumenten.
Veelvoorkomende aanpassingen zijn onder andere:
- Pas prompts aan: Pas AI Builder-prompts aan om overeen te komen met jouw domein en outputformat.
- Verander gegevensbronnen: Wijs componenten naar je eigen Dataverse-tabellen, SharePoint-lijsten of externe connectors.
- Pas onderwerpen aan: Werk de gespreksstromen bij zodat ze aansluiten bij de terminologie en processen van uw organisatie.
- Update triggerzinnen: Voeg triggerzinnen toe die weerspiegelen hoe je gebruikers van nature om dingen vragen.
- Authenticatie toevoegen: Configuratie authenticatie als componenten toegang moeten krijgen tot gebruikersspecifieke gegevens.
Tip
Als je verschillend gedrag voor verschillende agenten nodig hebt, overweeg dan om een kopie van de component in een aparte oplossing te maken in plaats van de gedeelde instantie te bewerken.
Related information
- Components management
- AI Builder documentatie