Hulpmiddelen toevoegen aan aangepaste agenten

Hulpmiddelen zijn de bouwstenen waarmee uw agent kan communiceren met externe systemen. Hulpmiddelen breiden de functionaliteit van uw agent uit, zodat deze verschillende acties kan uitvoeren als reactie op gebruikersaanvragen of autonome triggers. Elk hulpmiddel vertegenwoordigt een specifieke mogelijkheid die uw agent kan uitvoeren. U kunt uw agent bijvoorbeeld uitrusten met hulpmiddelen die het volgende doen:

E-mailberichten verzenden met de Office 365 Outlook-connector
De huidige weersomstandigheden en -verwachtingen controleren
Gegevens lezen en schrijven vanuit Dataverse
Berichten lezen en posten in Teams

Mechanismen voor het toevoegen van hulpmiddelen

U kunt de mogelijkheden van uw aangepaste agent uitbreiden door een of meer hulpmiddelen toe te voegen. Uw agent kan hulpmiddelen gebruiken om automatisch te reageren op gebruikers, met behulp van generatieve orkestratie. U kunt hulpmiddelen ook expliciet aanroepen vanuit een onderwerp.

Met generatieve orkestratie (standaard actief) kan uw agent automatisch het meest geschikte hulpmiddel of het meest geschikte onderwerp selecteren, of zoeken in kennis, om op een gebruiker te reageren. In deze orkestratiemodus wordt een dynamischere en intelligentere gesprekservaring gemaakt.

In de klassieke modus (generatieve orkestratie uitgeschakeld) kan een agent alleen onderwerpen gebruiken om op de gebruiker te reageren. U kunt uw agent echter nog steeds zo ontwerpen dat deze expliciet vanuit onderwerpen hulpmiddelen aanroept.

Er zijn verschillende mechanismen beschikbaar om hulpmiddelen aan uw agent toe te voegen:

Connector: maak verbinding met eigen API's en services met behulp van Power Platform-connectors om gegevens op te halen of acties uit te voeren.
- Vooraf gemaakte connector: kies uit een selectie vooraf ingestelde verbindingen met duizenden populaire API's van Microsoft- en niet-Microsoft-services.
- Aangepaste connector: definieer een verbinding met een aangepaste service of systeem om opties voor aangepaste hulpmiddelen in te schakelen met behulp van Power Platform-connectors. De connector heeft weergave- en deelmachtigingen nodig voor de organisatie zodat de agent de connector kan gebruiken.
Agentstroom: definieer een agentstroom, inclusief een of meer acties die moeten worden uitgevoerd.
Prompt: modelgebaseerde prompt met één wending die kan verwijzen naar kennis die u verstrekt en code kan genereren om gegevens te analyseren.
REST API: definieer een verbinding met een REST API en selecteer een of meer API-eindpunten en -methoden om toe te voegen als hulpmiddelen.
Modelcontextprotocol: maak verbinding met een MCP-server om toegang te krijgen tot hulpmiddelen en resources.
Computergebruik: hiermee kan uw agent communiceren met elk systeem met een grafische gebruikersinterface, voor websites en bureaublad-apps, het selecteren van knoppen, het kiezen van menu's en het invoeren van tekst in velden op het scherm.

Er zijn twee andere mechanismen die u kunt gebruiken om hulpmiddelachtig gedrag toe te voegen aan uw agent:

Vaardigheden: container voor een reeks gerelateerde hulpmiddelen.
Clienthulpmiddel: stuur een gebeurtenisactiviteit naar de client, zodat de client een actie uitvoert en een respons terugstuurt.

Zie de koppelingen in de sectie Gerelateerde inhoud voor meer informatie over vaardigheden en clienthulpmiddelen.

Een nieuw hulpmiddel maken en toevoegen op agentniveau

Als u nieuwe hulpmiddelen rechtstreeks in Copilot Studio maakt, stroomlijnt u het ontwikkelingsproces en zorgt u voor een juiste integratie met uw agent. Hulpmiddelen die worden toegevoegd aan een agent, zijn beschikbaar voor automatische orkestratie tijdens de gesprekken van uw agent.

Open uw agent door Agenten te kiezen in het navigatievenster aan de linkerkant en uw agent uit de lijst te selecteren.
Ga naar de pagina Hulpmiddelen voor de agent.
Selecteer Een hulpmiddel toevoegen.
Selecteer Nieuw hulpmiddel in het deelvenster Hulpmiddel toevoegen.
Selecteer het type hulpmiddel dat u wilt toevoegen in de lijst die wordt weergegeven:
- Prompt
- Agentstroom
- Computergebruik
- Aangepaste connector
- Protocol voor modelcontext
- REST-API
Voer de specifieke configuratiestappen uit voor het type hulpmiddel dat u hebt geselecteerd. Als u bijvoorbeeld Prompt selecteert, moet u de volgende stappen uitvoeren:
- De promptsjabloon en instructies definiëren
- Invoerparameters opgeven
- Kennisbronnen configureren
- Antwoordindeling en -beperkingen instellen
Selecteer Opslaan of Publiceren, indien van toepassing, om het nieuwe hulpmiddel te maken.
Selecteer Toevoegen en configureren. Het hulpmiddel wordt toegevoegd aan uw agent. De configuratiepagina voor uw hulpmiddel wordt weergegeven. U kunt hier de configuratie van uw hulpmiddelen bekijken en hierin wijzigingen aanbrengen.

U ziet het nieuwe hulpmiddel op de pagina Extra voor de agent.

Uw configuratie van hulpmiddelen weergeven en wijzigen

U kunt de configuratie van uw hulpmiddel op elk moment bekijken en bewerken: ga naar de pagina Extra voor uw agent en selecteer het hulpmiddel in de lijst met hulpmiddelen.

De configuratiepagina voor uw hulpmiddel wordt geopend. De details worden weergegeven in drie secties:

DETAILS
Invoer
Voltooiing

Voor MCP-servers die zijn verbonden als agenthulpmiddelen wijkt de configuratiepagina af van die van andere typen hulpmiddelen. De sectie Details is vergelijkbaar, maar in plaats van Invoer en Voltooiing zijn er de secties Extra en Resources met informatie over beschikbare hulpmiddelen en resources voor de MCP-server. Zie Hulpmiddelen en resources in een bestaande MCP-server weergeven voor meer informatie.

DETAILS

In het gedeelte Details kunt u basisgegevens over uw hulpmiddel configureren.

Hier kunt u het volgende bekijken en bijwerken:

Naam: de naam van het hulpmiddel. Deze naam wordt weergegeven in de lijst met hulpmiddelen voor uw agent. Kies een naam die duidelijk de functie van het hulpmiddel aangeeft.
Beschrijving: een beschrijving van het hulpmiddel. Generatieve orkestratie is afhankelijk van deze beschrijving om te bepalen wanneer uw agent het hulpmiddel moet gebruiken. Schrijf duidelijke, specifieke beschrijvingen, inclusief wat het hulpmiddel doet en wanneer het moet worden gebruikt.
Bijkomende details:
- Toestaan dat de agent dynamisch bepaalt wanneer het hulpmiddel moet worden gebruikt: wanneer deze optie is geselecteerd, kan de agent generatieve orkestratie gebruiken om te bepalen wanneer het hulpmiddel moet worden gebruikt. Als deze optie niet is geselecteerd, gebruikt de agent het hulpmiddel alleen wanneer het expliciet wordt aangeroepen vanuit een onderwerp. (Deze optie wordt standaard geselecteerd wanneer generatieve orkestratie is ingeschakeld.)
- Vraag de eindgebruiker vóór het uitvoeren: vraag de agent om bevestiging in de chatervaring van de eindgebruiker voordat u het hulpmiddel uitvoert. Standaard is deze optie ingesteld op Nee.
- Verificatie: geef aan of u de referenties van de gebruiker (Eindgebruiker) of maker (Door maker opgegeven) voor het hulpmiddel wilt gebruiken. Gebruikersverificatie is standaard van toepassing.
- Beschrijving: u kunt desgewenst een beschrijving toevoegen van het hulpmiddel dat de agent aan de gebruiker laat zien wanneer deze het hulpmiddel wil uitvoeren. Met deze beschrijving weet de gebruiker wat er wordt gevraagd om zich te verifiëren.

Invoer

Hier kunt u de invoer voor uw hulpmiddel weergeven en configureren. De invoer wordt gebruikt om informatie van de gebruiker te verzamelen om de vereiste invoer voor het hulpmiddel in te vullen. De informatie wordt weergegeven als een tabel, met één regel voor elke invoer.

Standaard is de kolomwaarde Vullen met voor elke invoer ingesteld op Dynamisch invullen met AI. De agent probeert de waarde uit de beschikbare context te halen, bijvoorbeeld uit het bericht van de gebruiker. Als er geen geschikte waarde wordt gevonden, wordt er een vraag gegenereerd waarin de gebruiker om een waarde wordt gevraagd. Selecteer Aanpassen om toegang te krijgen tot meer gedetailleerde aanpassingen voor het verzamelen en invullen van invoer:

Weergavenaam en beschrijving: hoe de invoer voor de gebruiker wordt weergegeven.
Identificeren als: hoe het antwoord van de gebruiker wordt geïnterpreteerd, bijvoorbeeld als tekenreeks of toegewezen aan een vooraf gedefinieerde entiteit.
Logica voor opnieuw proberen: als de agent geen entiteit identificeert in de instructie van de gebruiker, kan deze de vraag opnieuw stellen.
Invoervalidatie: configureer extra validatiegedrag voor de invoer van de gebruiker naast de standaardinstelling voor het entiteitstype.

U kunt er ook voor kiezen om invoer met een expliciete waarde te overschrijven in plaats van de agent deze te laten extraheren. Als u een overschrijving wilt instellen, stelt u Vullen met in op Aangepaste waarde en voert u een waarde in, selecteert u een variabele of gebruikt u een Power Fx-formule. Als invoer wordt overschreven, vraagt agent de gebruiker niet meer om een waarde.

Voltooiing

Hier kunt u opgeven wat u wilt doen wanneer het hulpmiddel wordt uitgevoerd.

U kunt de agent automatisch een contextuele respons voor een gebruiker laten genereren, op basis van de zoekopdracht en de resultaten van het hulpmiddel.

U kunt er ook voor kiezen om een specifieke, opgestelde respons te schrijven die door uw hulpmiddel moet worden geretourneerd. U kunt vanuit het hulpmiddel verwijzingen naar uitvoervariabelen invoegen met behulp van de variabelekiezer. U kunt ook Power Fx-formules gebruiken voor de indeling van het antwoord.

Selecteer onder Na uitvoering een van de verschillende opties voor hoe het hulpmiddel moet reageren op de gebruiker nadat het hulpmiddel is uitgevoerd:

Niet reageren (standaard): de agent verwerkt de uitvoer van het hulpmiddel in zijn respons
De respons schrijven met generatieve AI: laat AI een contextuele respons opstellen met behulp van de uitvoer van het hulpmiddel
Specifieke respons verzenden: schrijf een sjabloonrespons met variabele invoeging
Een adaptieve kaart verzenden: maak uitgebreide, interactieve responsen met knoppen en acties

U kunt ook configureren welke uitvoervariabelen beschikbaar moeten worden gesteld voor de agent en andere hulpmiddelen.

Selectie van hulpmiddelen en verzameling van invoer

Wanneer u een hulpmiddel in Copilot Studio definieert, geeft u ook informatie op die het doel ervan beschrijft. Met deze informatie kan de agent bepalen wanneer het hulpmiddel moet worden gebruikt. De beschrijving van het hulpmiddel helpt de orchestrator ook bij het gebruik van generatieve AI om zo nodig vragen te genereren om invoer te verzamelen. Uw agent kan vragen gebruiken om informatie te verzamelen om de invoer in te vullen die nodig is om het hulpmiddel te gebruiken. Hierdoor hoeft u niet handmatig vraagknooppunten te maken om alle benodigde invoer te verzamelen, zoals invoer in een stroom. De orchestrator van de agent verwerkt de verzameling van invoer voor u tijdens runtime.

De agent houdt rekening met verschillende factoren om de selectie van hulpmiddelen te bepalen:

De naam en beschrijving van het hulpmiddel
De context van het huidige gesprek
Gebruikersintentie afgeleid uit hun bericht
Beschikbare in- en uitvoer
Eerder gebruik van het hulpmiddel in het gesprek

Wanneer de generatieve modus wordt gebruikt, retourneren tools hun informatie standaard naar de agent. Met het antwoord van het hulpmiddel kan de agent een contextueel antwoord genereren op basis van de query van de gebruiker. U kunt er ook voor kiezen om uw hulpmiddel altijd direct te laten reageren. U kunt hiervoor een bericht genereren of een expliciet bericht opstellen.

Fooi

Wanneer u gegenereerde vragen van een hulpmiddel gebruikt, moet u uw gebruikers informeren dat AI een deel van het gesprek heeft gegenereerd.

Voeg bijvoorbeeld een extra bericht toe in het systeemonderwerp Begin van gesprek. Dit onderwerp bepaalt welk bericht aan uw gebruikers wordt getoond wanneer een nieuw gesprek begint.

Een bestaand hulpmiddel vanuit een onderwerp aanroepen

U kunt een hulpmiddel expliciet vanuit een onderwerp aanroepen. Afhankelijk van uw gebruiksscenario kunt u uw hulpmiddel gebruiken als onderdeel van een breder onderwerp, dat meer knooppunten gebruikt. Of, zoals in het weervoorbeeld, is het toevoegen van een knooppunt aan een onderwerp misschien alles wat u hoeft te doen.

Een hulpmiddel aanroepen in een onderwerp:

Ga in Copilot Studio naar de pagina Onderwerpen voor de agent die u wilt bewerken.
Maak een nieuw onderwerp en geef het een naam, bijvoorbeeld Weerbericht ophalen.
Voeg de juiste triggerzinnen toe. Voortbordurend op hetzelfde weervoorbeeld uit de vorige stap kunnen triggerzinnen het volgende bevatten:
- gaat het regenen
- voorspelling voor vandaag
- weerbericht ophalen
- wat voor weer is het
Selecteer Knooppunt toevoegen (+) en vervolgens Een hulpmiddel toevoegen. Selecteer het hulpmiddel tool uit de beschikbare hulpmiddelen. Er zijn drie tabbladen met verschillende soorten hulpmiddelen:
- Basishulpmiddelen
- Verbindingslijn
- Hulpprogramma
Uw knooppunt Actie is nu toegevoegd aan uw onderwerp.
Selecteer Opslaan.

MCP-connectorgegevens

Voor MCP-connectors kunt u de namen en beschrijvingen bekijken van de MCP-hulpmiddelen en -resources die beschikbaar worden gesteld door de MCP-connector. Informatie voor de hulpmiddelen en resources wordt weergegeven in een tabel, met één regel voor elk hulpmiddel.

Verificatieoverwegingen voor hulpmiddelen

Sommige hulpmiddelen vereisen verificatie om correct te werken, zoals Dynamic Prompt of andere die een Dataverse-API aanroepen. De juiste verificatieconfiguratie zorgt voor beveiliging en zorgt voor een soepele gebruikerservaring.

Hulpmiddelen worden altijd uitgevoerd in de runtime van agent in de gebruikerscontext en kunnen alleen worden uitgevoerd als verificatie is ingeschakeld. Er worden twee typen verificatiemethoden ondersteund:

Referenties voor eindgebruikers: de agent gebruikt de referenties van de gebruiker voor verificatie bij de service. Deze methode zorgt ervoor dat gebruikers alleen toegang hebben tot gegevens waarvoor ze toestemming hebben om ze te zien.
Door maker opgegeven referenties: de agent gebruikt de referenties van de auteur voor verificatie bij de service. Gebruik deze verificatiemodus voor gedeelde resources of wanneer gebruikers geen afzonderlijke toegang nodig hebben.

Uw hulpmiddel testen

Met generatieve orkestratie selecteert de orchestrator uw hulpmiddel wanneer deze relevant wordt geacht voor een gebruikersquery.

U kunt een bestaand hulpmiddel ook vanuit een onderwerp aanroepen.

Een hulpmiddel in- of uitschakelen in uw agent

U kunt een hulpmiddel in- of uitschakelen voor uw agent op de configuratiepagina voor het hulpmiddel. Door een hulpmiddel uit te schakelen, zorgt u dat de agent het hulpmiddel niet kan gebruiken, maar het hulpmiddel is nog steeds verbonden met de agent en kan later weer worden ingeschakeld. Wanneer u een hulpmiddel aan een agent toevoegt, wordt dit standaard ingeschakeld.

Een hulpmiddel in een agent uitschakelen:

Ga naar uw agent en selecteer de pagina Extra voor uw agent.
Selecteer het hulpmiddel om naar de configuratiepagina van het hulpmiddel te gaan.
Schakel boven aan de configuratiepagina het hulpmiddel uit met de wisselknop Ingeschakeld.
Selecteer Opslaan om de wijziging toe te passen

Het hulpmiddel wordt nog steeds weergegeven in de lijst met hulpmiddelen voor agenten, maar is niet meer ingeschakeld.

Een hulpmiddel verwijderen uit uw agent

Als u een hulpmiddel uitschakelt, wordt het hulpmiddel niet meer gebruikt, maar hebt u ook de flexibiliteit om het later weer in te schakelen. U kunt een hulpmiddel ook permanenter uit uw agent verwijderen. Een hulpmiddel verwijderen uit uw agent:

Ga naar uw agent en selecteer de pagina Extra voor uw agent.
Zoek het hulpmiddel in de lijst met hulpmiddelen en plaats de muisaanwijzer op de naam van het hulpmiddel. Selecteer de drie stippen (...).
Selecteer Verwijderen. Er wordt een bevestigingsvenster weergegeven.
Als u het hulpmiddel wilt verwijderen, selecteert u Verwijderen.

Het hulpmiddel verdwijnt uit de lijst met agenthulpmiddelen.

Notitie

U kunt hulpmiddelen alleen verwijderen van de pagina met agenthulpmiddelen. U kunt hulpmiddelen niet verwijderen via de pagina Extra van Copilot Studio.

Feedback

Is deze pagina nuttig?

Last updated on 2025-12-17