Een onderliggende agent toevoegen

Een subagent is een lichtgewicht agent die binnen de context van je hoofdagent bestaat. Met subagenten kunt u hulpprogramma's, instructies en kennis logisch groeperen in duidelijk gedefinieerde subagenten binnen een grotere hoofdagent. Ze zijn ideaal voor gebruiksvoorbeelden die reageren op één intentie of die één taak voltooien. In dit artikel wordt uitgelegd hoe u een sub-agent maakt en beheert.

Een subagent maken

1. Ga naar de pagina Agents voor uw hoofdagent en selecteer Een agent toevoegen.

2. Selecteer Nieuwe subagent.

3. Voer een unieke naam in voor uw nieuwe subagent.

4. Bepaal wanneer uw agent moet worden gebruikt. Standaard reageren agenten op gebruikers of triggers op basis van hun beschrijving.

   • Als u het standaardgedrag wilt gebruiken (De agent kiest - Op basis van beschrijving), voert u een korte beschrijving in van het doel van uw agent.
   • Vouw anders de lijst uit onder Wanneer wordt dit gebruikt? en selecteer het gewenste gedrag. Zie Bepalen wanneer uw agent moet worden gebruikt voor meer informatie over het ondersteunde gedrag.

5. Voer duidelijke instructies in die uw agent moet volgen wanneer deze wordt aangeroepen. Als u naar hulpprogramma's, variabelen of Power Fx-formules wilt verwijzen in uw instructies, voert u een slash (/) in en selecteert u de gewenste optie in het menu dat wordt weergegeven.

   Belangrijk

   Wanneer je bestaande tools raadpleegt in je subagentinstructies, bepaal dan of de tool direct toegankelijk moet zijn voor je hoofdagent of alleen wanneer deze expliciet binnen de subagentinstructies wordt aangeroepen. Het beperken van het gebruik van een tool tot expliciete instructiereferenties helpt om verwarring met de orchestrator te voorkomen wanneer vergelijkbare tools of agents bestaan. Als u bijvoorbeeld een agent 'Accountbalans controleren' hebt en een vergelijkbaar hulpprogramma 'Accountbalans ophalen', beperkt u het hulpprogramma dat alleen door de agent wordt aangeroepen om overlapping te voorkomen. Als u wilt beperken dat een hulpprogramma alleen beschikbaar is wanneer het door een andere agent wordt aangeroepen, schakelt u de eigenschap Agent toestaan om dynamisch te bepalen wanneer dit hulpprogramma te gebruiken uit in de sectie Aanvullende details op de detailpagina van het hulpprogramma.

6. Voeg optioneel kennis en hulpmiddelen toe die alleen deze kindagent kan gebruiken:

   • Selecteer Toevoegen in de sectie Kennis en ga op dezelfde manier verder als wanneer u kennis toevoegt aan uw hoofdagent.
   • In de sectie Extra, selecteer Toevoegen en ga verder op dezelfde manier zoals wanneer je tools aan je hoofdagent toevoegt.

7. Als u niet wilt dat deze agent nog actief is, schakelt u Ingeschakeld uit. U kunt de onderliggende agent later activeren.

8. Selecteer Opslaan.

In- en uitvoer beheren

Standaard ontvangt een onderliggende agent een taak in natuurlijke taal, die moet worden uitgevoerd vanuit de hoofdagent wanneer de agent deze aanroept. Wanneer het zijn taak voltooit, geeft het een natuurlijke taalsamenvatting terug van wat er tijdens de uitvoering is gebeurd. In sommige gevallen wilt u mogelijk expliciete invoer- en uitvoerwaarden voor de agent opgeven.

Configureer invoer en invoerverzameling

1. Selecteer vanaf de pagina van je ouderagent je kindagent.

2. Scroll naar de sectie Invoer.

3. Als u een invoer wilt toevoegen, selecteert u Invoer toevoegen. Definieer een Weergavenaam en Beschrijving, zodat de agent het doel van de invoer begrijpt en deze kan vullen met een relevante waarde bij het aanroepen van deze agent.

4. Selecteer een gegevenstype.

5. Selecteer desgewenst Deze invoer vereist maken om voor de invoer een waarde te vereisen voordat de agent kan worden aangeroepen.

6. Selecteer Opslaan.

Geavanceerde invoerconfiguraties

Selecteer Geavanceerde om de sectie uit te breiden en de andere instellingen te zien die je voor de invoer kunt instellen.

Geavanceerde instellingen omvatten de volgende instellingen met betrekking tot hoe de agent de invoerwaarde invult bij het oproepen van de kindagent:

• Moet de gebruiker vragen: Als deze instelling is ingeschakeld, vraagt de agent expliciet de eindgebruiker om een waarde voor de invoer als de agent de waarde niet kan vinden uit de beschikbare context. Dit is handig als je wilt zorgen dat de agent een waarde krijgt voor deze input, zelfs als de bellende agent die niet geeft of geen relevante context heeft om die te vullen. Wanneer deze instelling is ingeschakeld, genereert de kindagent een prompt om de gebruiker om de benodigde informatie te vragen, wat kan helpen om de nauwkeurigheid van het antwoord van de agent te verbeteren.
• Prompt - Aanpas: Selecteer om een specifieke prompttekst voor verzameling aan te passen voor meer deterministische controle.
• Hoeveel reprompts: Geef aan hoe vaak de agent de gebruiker moet hervragen voor een waarde voor deze invoer als de opgegeven waarde niet geldig is. Dit is nuttig om ervoor te zorgen dat de agent een geldige waarde voor deze invoer krijgt. Je kunt tot twee herhalingen selecteren.
• Herhaal prompt - Pas aan: Selecteer om specifieke promptformuleringen aan te passen voor reprompts wanneer de opgegeven waarde niet aan de opgegeven voorwaarden voldoet, voor meer deterministische controle.
• Voorwaarde: Specificeer voorwaarden waaraan de gegeven invoer moet voldoen om als geldig te worden beschouwd.
• Voorwaarde niet voldaan prompt: Pas de formulering van een specifieke prompt aan zodat de gebruiker om een andere waarde wordt gevraagd wanneer de opgegeven waarde niet aan de opgegeven voorwaarden voldoet.
• Actie als geen entiteit is gevonden: Specificeer welke actie de agent moet uitvoeren als de agent geen waarde voor deze invoer kan vinden uit de beschikbare context of via prompting. Kies of je wilt escaleren, de variabele op een specifieke waarde zet, of de waarde leeg laat.
• Geen entiteit gevonden bericht: Als je ervoor kiest dat de agent escaleert terwijl er geen waarde voor deze invoer wordt gevonden, pas dan het bericht dat de agent naar de gebruiker stuurt, aan.

Configureer kindagent-uitvoer en voltooiingsgedrag

Onder Outputs kun je de outputwaarden configureren die je kindagent terugstuurt naar de ouderagent wanneer hij klaar is. Je kunt ook het gedrag van de ouderagent configureren nadat de kindagent klaar is.

Configureer het gedrag van de ouderagent na voltooiing van de kindagent

Je kunt het gedrag van de bovenliggende agent specificeren nadat de onderliggende agent is voltooid onder Na uitvoering in de sectie Outputs:

• Niet reageren: Standaard gaat de ouderagent door met de volgende stap in zijn orkestratieplan nadat de kindagent is afgerond en stuurt alle uitvoer terug naar de ouderagent. Je kunt er ook voor kiezen dat de ouderagent direct na afloop van de kindagent een bericht naar de gebruiker stuurt, voordat je doorgaat met de volgende stap in het orkestratieplan door een van de andere opties te selecteren.
• Schrijf het antwoord met generatieve AI: De ouderagent stuurt direct na afloop van de kindagent een bericht naar de gebruiker met een generatieve AI-reactie, waarbij de output van de kindagent als context voor het antwoord wordt gebruikt.
• Specifiek antwoord sturen: De ouderagent stuurt direct na afloop van de kindagent een specifiek bericht naar de gebruiker, ongeacht de output van de kindagent. Wanneer je deze optie selecteert, kun je de inhoud van het bericht aanpassen.
• Stuur een adaptieve kaart: De ouderagent stuurt onmiddellijk nadat de kindagent zijn taak heeft afgerond een adaptieve kaart naar de gebruiker. Wanneer je deze optie kiest, kun je de inhoud van de adaptieve kaarten aanpassen.

Uitvoer configureren

1. Ga naar de details van de kinderagent.

2. Scroll naar het gedeelte Outputs .

3. Als u de huidige lijst met uitvoer wilt zien, vouwt u de sectie Geavanceerd uit in de sectie Uitvoer.

4. Als u een uitvoer wilt toevoegen, selecteert u Uitvoer toevoegen. Definieer een Weergavenaam en Beschrijving, zodat de agent het doel van de uitvoer begrijpt en deze kan vullen met een relevante waarde bij het retourneren van waarden naar de aanroepende agent.

5. Selecteer een gegevenstype.

6. Selecteer Opslaan.

In de sectie Uitvoer kunt u er ook voor kiezen om een bericht naar de gebruiker te laten verzenden, direct nadat de subagent is afgerond. Als u het bericht wilt verzenden, wijzigt u de optie Nadat de selectie is uitgevoerd.

Bepalen wanneer u uw agent moet gebruiken

Subagenten reageren standaard op een gebruikersvraag op basis van hun beschrijving. U kunt onderliggende agenten ook configureren om andere gebeurtenissen te onderscheppen en erop te reageren onder Wanneer wordt dit gebruikt?.

Overige details

Afhankelijk van uw selectie voor Wanneer wordt dit gebruikt?, zijn er mogelijk meer eigenschappen beschikbaar. De volgende eigenschappen zijn altijd beschikbaar.

Voorwaarde

Geef voorwaarden op waaraan moet worden voldaan om de agent aan te roepen. U wilt bijvoorbeeld dat de agent alleen wordt aangeroepen als het kanaal dat door een werknemer wordt gebruikt, Microsoft Teams is.

Als u complexere voorwaarden nodig hebt, kunt u overschakelen naar de Power Fx-formule-editor: selecteer Builder en selecteer vervolgens Formule.

Prioriteit

Er kan meer dan één agent worden geactiveerd voor één inkomende activiteit, zoals een bericht. De optie die u selecteert voor Wanneer wordt dit gebruikt? bepaalt standaard de volgorde waarin de agents worden geactiveerd.

Onderliggende agenten en onderwerpen delen dezelfde set triggers of gebeurtenissen waarop ze kunnen reageren. Als een agent en een thema zijn geconfigureerd om te reageren op dezelfde gebeurtenis, zoals inactiviteit van de gebruiker, gebruik de prioriteitseigenschap om te bepalen welke eerst komt.

Uitvoeringsvolgorde:

1. Er vindt een activiteit plaats
2. Er wordt een bericht ontvangen / Een aangepaste clientgebeurtenis treedt op / Het gesprek wijzigt / Het wordt aangeroepen
3. De agent kiest

Als er meerdere agenten of onderwerpen moeten worden aangeroepen op basis van hetzelfde type gebeurtenis, worden ze aangeroepen in de volgorde van maken (oudste eerst).

U kunt de eigenschap Prioriteit expliciet instellen. Een lager getal geeft een hogere prioriteit aan.

Kindagenten en hulpmiddelen gebruiken

Copilot Studio-agents die gebruikmaken van generatieve orkestratie hebben beperkingen op het maximale aantal en de aanbevolen hulpprogramma's die ze kunnen gebruiken. Voor meer informatie, zie Beperkingen van tools bij agenten.

Wanneer een kindagent wordt opgeroepen, gebruikt deze zijn eigen tools en kennis om te reageren op de gebruiker of gebeurtenis. Omdat kindagenten hun eigen orkestratie hebben, hebben ze hun eigen limieten voor het aantal tools, los van de limieten van de ouderagent.

De aparte limiet is een van de voordelen van het gebruik van kindagenten: je kunt tools en kennis logisch groeperen in kleinere agenten die zich op specifieke taken richten, zonder dat het de algemene limieten van de hoofdagent beïnvloedt. Er is echter een afweging in de latentie die wordt toegevoegd door de extra orkestratielaag.