Delen via

Een onderliggende agent toevoegen

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

Een onderliggende agent maken

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

  2. Selecteer Nieuwe onderliggende agent.

  3. Voer een onderscheidende naam in voor uw nieuwe onderliggende agent.

  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 u verwijst naar bestaande hulpprogramma's in uw instructies, moet u bepalen of het hulpprogramma rechtstreeks toegankelijk moet zijn voor uw hoofdagent of alleen wanneer het expliciet wordt aangeroepen binnen de instructies. Door het gebruik van een hulpprogramma te beperken tot expliciete instructieverwijzingen, voorkomt u verwarring wanneer er vergelijkbare hulpprogramma's of agenten 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 dat een hulpprogramma alleen beschikbaar is wanneer er naar een andere agent wordt verwezen, schakelt u de eigenschap Agent toestaan om dynamisch te bepalen wanneer dit hulpprogramma moet worden gebruikt in de sectie Aanvullende details in op de detailpagina van het hulpprogramma.

  6. Voeg eventueel kennis en hulpprogramma's toe die alleen door deze onderliggende agent kunnen worden gebruikt:

    • In de sectie Kennis selecteert u Toevoegen en gaat u op dezelfde manier door als wanneer u kennis toevoegt aan uw hoofdagent.
    • In de sectie Hulpprogramma's selecteert u Toevoegen en gaat u op dezelfde manier door als wanneer u hulpprogramma's toevoegt aan uw hoofdagent.

  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 de taak is voltooid, wordt er vervolgens een samenvatting in natuurlijke taal geretourneerd, van wat er is gebeurd tijdens de uitvoering. In sommige gevallen wilt u mogelijk expliciete invoer- en uitvoerwaarden voor de agent opgeven.

Invoer beheren

  1. Ga naar de details van de onderliggende agent.

  2. Blader omlaag 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.

Notitie

U kunt desgewenst de sectie Geavanceerd uitvouwen en andere instellingen voor de invoer configureren, inclusief de keuze Moet gebruiker vragen. Als de instelling is ingeschakeld, vraagt de agent de eindgebruiker expliciet om een waarde voor de invoer, als deze niet kan worden gevonden vanuit de beschikbare context. Zie meer informatie over de andere instellingen voor invoer.

De lijst met uitvoer beheren

  1. Ga naar de details van de onderliggende agent.

  2. Blader omlaag naar de sectie Uitvoer.

  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 onderliggende agent is voltooid. Als u het bericht wilt verzenden, wijzigt u de optie Nadat de selectie is uitgevoerd.

Bepalen wanneer u uw agent moet gebruiken

Onderliggende agenten reageren standaard op een gebruikersquery 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?.

Gebeurtenis Omschrijving
Er is een bericht ontvangen Wordt aangeroepen als er een berichtactiviteit, het meest voorkomende type activiteit, wordt ontvangen. Ontvangen wanneer een gebruiker iets typt of zegt tegen de agent. Standaard reageert de agent op berichten. Als u het antwoord van de agent wilt beperken tot een specifiek type bericht, gebruikt u de lijst met Activiteitstypen onder Aanvullende informatie.
Er vindt een aangepaste clientgebeurtenis plaats Wordt aangeroepen wanneer er een gebeurtenisactiviteit wordt ontvangen. Standaard reageert de agent op elke gebeurtenis. Als u het antwoord van de agent wilt beperken tot een specifieke gebeurtenis, gebruikt u de eigenschap Gebeurtenisnaam onder Aanvullende informatie.
Er vindt een activiteit plaats Wordt aangeroepen wanneer er een activiteit van elk type wordt ontvangen. Als u het antwoord van de agent wilt beperken tot een specifiek type activiteit, gebruikt u de lijst met Activiteitstypen onder Aanvullende informatie.
De gesprekswijzigingen Wordt aangeroepen wanneer een activiteit voor het bijwerken van gesprekken wordt ontvangen. Teams verzendt bijvoorbeeld een activiteit van dit type wanneer een gebruiker deelneemt aan een gesprek.
Wordt aangeroepen Wordt aangeroepen wanneer er een aanroepactiviteit wordt ontvangen. Wordt meestal ontvangen via het Teams-kanaal, bijvoorbeeld wanneer de gebruiker interactie heeft met een bericht of zoekextensie in Teams.
Het wordt omgeleid naar Aangeroepen wanneer de agent expliciet vanuit een onderwerp wordt aangeroepen.
De gebruiker is enige tijd inactief Aangeroepen wanneer de gebruiker na een geconfigureerde periode geen interactie heeft gehad met de hoofdagent. Selecteer de gewenste drempelwaarde voor inactiviteit in de lijst Duur van inactiviteit onder Aanvullende informatie.
Een plan wordt voltooid Aangeroepen wanneer de hoofdagent klaar is met het uitvoeren van alle geplande stappen, om te reageren op een gebruikersquery of autonome trigger.
Een door AI gegenereerde respons staat op het punt te worden verzonden Aangeroepen wanneer de hoofdagent een antwoord voor een gebruiker genereert, na het aanroepen van een of meer onderwerpen, hulpprogramma's of kennisbronnen. Gebruik de Response.FormattedText systeemvariabele om het gegenereerde antwoord te zien. Stel de ContinueResponse variabele in op false als u wilt voorkomen dat het indelingsantwoord wordt verzonden (dat wil zeggen, als u het bericht wijzigt en uw eigen bericht verzendt met een Berichtknooppunt ).

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 door een werknemer gebruikte kanaal Microsoft Teams is.

Schermopname van een voorwaarde, om het bereik van een onderliggende agent te beperken tot het Microsoft Teams-kanaal.

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

Schermopname van de optie om naar de formule-editor te gaan.

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 agenten worden geactiveerd.

Onderliggende agenten en onderwerpen delen dezelfde set triggers of gebeurtenissen waarop ze kunnen reageren. Als een agent en een onderwerp zijn geconfigureerd om te reageren op dezelfde gebeurtenis, zoals inactiviteit van de gebruiker, gebruikt u de prioriteitseigenschap om te bepalen welke eigenschap het eerst gaat.

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.

  • Last updated on