Delen via

Acties gebruiken met aangepaste agenten (preview)

  • Artikel

U kunt de mogelijkheden van uw agent uitbreiden door een of meer acties toe te voegen. Acties worden door uw agent gebruikt om automatisch op gebruikers te reageren, met behulp van generatieve orkestratie, of u kunt ze expliciet vanuit een onderwerp aanroepen.

Kernactietypen

Als u generatieve orkestratie inschakelt, kan uw agent automatisch de meest geschikte actie of het meest geschikte onderwerp selecteren of in de kennis zoeken om op een gebruiker te reageren.

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 acties expliciet vanuit onderwerpen worden aangeroepen.

Acties zijn gebaseerd op een van de volgende kernactietypen:

  • Vooraf gebouwde connectoractie
  • Aangepaste connectoractie
  • Power Automate-cloudstroom
  • AI Builder prompts (binnen een onderwerp)
  • Bot Framework-vaardigheid
  • REST API-verbinding

Elke kernactie heeft aanvullende informatie die het doel ervan beschrijft, waardoor de agent generatieve AI kan gebruiken om vragen te genereren. Deze vragen zijn nodig om de invoer in te vullen die nodig is om de actie uit te voeren. Daarom hoeft u niet handmatig vraagknooppunten te maken om alle benodigde invoer te verzamelen, zoals invoer in een stroom. De invoer wordt tijdens runtime voor u verwerkt.

Wanneer u de generatieve modus gebruikt, sturen acties hun informatie standaard terug naar de agent, zodat de agent een contextueel antwoord op de query van de gebruiker kan genereren. U kunt er ook voor kiezen om uw actie altijd direct te laten reageren. U kunt hiervoor een bericht genereren of een expliciet bericht opstellen.

Tip

Wanneer u gegenereerde vragen op basis van een actie gebruikt, informeert u uw gebruikers dan dat een deel van het gesprek door AI wordt 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 actie toevoegen

  1. Open uw agent door Agenten te kiezen in het navigatievenster aan de linkerkant en uw agent uit de lijst te selecteren.

  2. Selecteer Acties om acties voor de agent te bekijken.

  3. Selecteer Een actie toevoegen.

  4. Zoek in de wizard Een actie kiezen naar een actie die u wilt gebruiken en selecteer deze.

    De standaardlijst die wordt weergegeven bevat Power Automate-stromen en aangepaste connectors die beschikbaar zijn binnen uw omgeving. Deze lijst bevat veelgebruikte vooraf gebouwde connectors en Bot Framework-vaardigheden die zijn geregistreerd bij uw agent.

    Schermopname van de eerste pagina in de actiewizard met het actietypefilter geopend.

    Belangrijk

    Sommige acties die zijn gemaakt op basis van AI-invoegtoepassingen, zoals dynamische prompts en acties gebaseerd op Dataverse-API's vereisen verificatie.

    Afhankelijk van de actie wordt uw verbinding automatisch geconfigureerd, zoals weergegeven in het voorbeeld. Volg anders de instructies van de wizard om de verbinding te configureren. Zodra uw verbinding is geconfigureerd, selecteert u Volgende.

    Schermopname van de eerste pagina in de actiewizard op de verbindingspagina.

  5. Controleer de configuratie van uw invoegtoepassingsactie en breng wijzigingen aan, indien nodig.

    Selecteer Volgende.

  6. Selecteer Voltooien om de actie toe te voegen aan uw agent.

Uw actie testen

Als u generatieve orkestratie hebt ingeschakeld, wordt uw actie automatisch aangeroepen als reactie op een relevante gebruikersquery.

U kunt ook een actie expliciet aanroepen vanuit een onderwerp.

Uw agent selecteert en voert uw actie uit op basis van de naam en beschrijving. U kunt beschrijvingen van hoge kwaliteit schrijven en de activiteitenkaart gebruiken om te zien welke acties uw agent hebben geselecteerd op de pagina acties .

In deze Schermopname kunt u zien hoe een weeractie wordt getest:

Schermopname van de actie die wordt getest.

Wijzigingen aanbrengen in de configuratie van uw actie

U kunt uw actie op diverse manieren configureren. In de laatste stap van de actiewizard, genaamd Bekijken en voltooien, kunt u wijzigingen aanbrengen in de configuratie van uw actie door op Bewerken te klikken naast de betreffende sectie. U kunt de invoer- en uitvoerparameters voor de actie beheren via het scherm Invoer en uitvoer controleren in de wizard of via de detailpagina voor een actie die al deel uitmaakt van uw agent.

Actiegegevens

Hier kunt u details over uw actie configureren, waaronder de weergavenaam van het model en de modelbeschrijving voor uw actie. Meestal worden de naam en beschrijving vooraf voor u ingevuld op basis van de actie die u hebt geselecteerd.

De eigenschappen Weergavenaam en Beschrijving voor elke invoer helpen de agent het doel van de invoer te begrijpen, een geschikte vraag voor de gebruiker te genereren en de juiste waarde in het antwoord van een gebruiker te herkennen. Hieronder volgen bijvoorbeeld de standaardnaam en -beschrijving van de locatie-invoerparameter voor de MSN Weather-connector.

  • Naam: Locatie
  • Beschrijving: de zoekquery voor de locatie. Geldige invoerwaarden zijn plaats, regio, provincie, land, oriëntatiepunt, postcode, breedte- en lengtegraad

Wanneer de agent de gebruiker vraagt om een locatie, genereert het een vraag zoals Wat is de locatie waar u het weer wilt controleren? U kunt een stad, regio, staat, land, bezienswaardigheid of postcode invoeren.

U kunt de optie Identificeren als wijzigen in een specifiek entiteitstype, afhankelijk van de invoer die wordt verzameld. Dit kan de agent helpen om nauwkeurig een waarde uit het antwoord van een gebruiker te extraheren.

Invoer

Standaard wordt elke invoer ingesteld op Dynamisch vullen met de beste optie. 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. U kunt een invoer met een waarde overschrijven in plaats van dit aan de gebruiker te vragen. Om een overschrijving in te stellen, selecteert u voor Hoe vult de agent deze invoer in? Instellen als waarde en voert u de gewenste waarde in. Deze waarde kan een letterlijke waarde zijn, een bestaande variabele of een Power Fx-formule.

Schermopname van de invoersectie voor de actieconfiguratie.

Om het gedrag van uw agent te bepalen bij het opvragen van een waarde of het valideren van het antwoord van een gebruiker, kunt u aanvullende instellingen voor invoer configureren.

Uitvoeren

Standaard is uw actie geconfigureerd om automatisch een contextuele respons voor een gebruiker te genereren, op basis van zijn of haar vraag en het resultaat van de actie. Als een gebruiker bijvoorbeeld vraagt: "Wat is de huidige temperatuur in Londen?", wordt er een contextueel antwoord gegenereerd met behulp van GPT, zoals "De huidige temperatuur in Londen is 9 graden Celsius".

U kunt er ook voor kiezen om een ​​specifieke respons te schrijven die uw actie moet retourneren. Net als voor de bevestigingseditor kunt u verwijzingen naar uitvoervariabelen uit de actie invoegen met behulp van de variabelenkiezer, zoals weergegeven in dit voorbeeld.

Schermopname van de uitvoerantwoord-editor met de variabelenkiezer geopend.

Een actie aanroepen in een onderwerp

U kunt een actie expliciet aanroepen vanuit een onderwerp, op vergelijkbare wijze als wanneer u andere actietypen aanroept, zoals Power Automate-stromen. Afhankelijk van uw gebruiksscenario kunt u uw stroom gebruiken als onderdeel van een breder onderwerp waarin meer knooppunten worden gebruikt. Of, zoals in het weervoorbeeld, kan het toevoegen van een enkel actieknooppunt aan een onderwerp alles zijn wat u nodig hebt.

Een actie aanroepen in een onderwerp:

  1. Ga in Copilot Studio naar de pagina Onderwerpen voor de agent die u wilt bewerken.

  2. Maak een nieuw onderwerp en noem deze Weerbericht ophalen.

  3. Voeg de volgende triggerzinnen toe:

    • gaat het regenen
    • voorspelling voor vandaag
    • weerbericht ophalen
    • wat voor weer is het

    Schermopname van triggerzinnen in een nieuw onderwerp.

  4. Selecteer Knooppunt toevoegen (+) en selecteer vervolgens Een actie aanroepen. Ga naar het tabblad Invoegtoepassingsacties (preview) en selecteer de actie die u eerder hebt gemaakt (Weersvoorspelling ophalen).

    Schermopname van nieuw knooppuntmenu geopend en de weeractie geselecteerd.

  5. Uw knooppunt Invoegtoepassingsactie (preview) wordt nu toegevoegd aan uw onderwerp.

    Schermopname van het knooppunt Nieuwe actie in het onderwerp.

  6. Selecteer Opslaan.

Invoer overschrijven bij het aanroepen van een actie vanuit een onderwerp

Wanneer uw actie wordt uitgevoerd, genereert uw agent standaard vragen voor de gebruiker om de vereiste invoer in te vullen. Maar u wilt mogelijk een of meer invoeritems overschrijven en een expliciete waarde opgeven in plaats van het de gebruiker te vragen. U kunt dit in de configuratie van invoegtoepassingsacties in de sectie Invoer overschrijven. Of u kunt waarden alleen overschrijven als uw actie wordt gebruikt vanuit een specifiek onderwerp:

  1. Selecteer Waarde instellen voor het knooppunt en kies de invoer die u wilt overschrijven.

    Schermopname van de lijst met invoer die kan worden overschreven.

  2. Voer de waarde voor de invoer in door een waarde te typen, een variabele te selecteren of een formule te gebruiken.

    Schermopname van de eenhedeninvoer met een override.

Nu deze invoer is overschreven, vraagt agent de gebruiker niet meer om een waarde.

Verificatie voor AI-acties inschakelen

Sommige acties vereisen, wanneer ze worden gemaakt op basis van AI-acties, verificatie om correct te werken, zoals dynamische prompts of andere die een Dataverse-API aanroepen.

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

  1. Ga naar de eigenschappen van de connectoractie.

  2. Selecteer onder Eindgebruikersverificatie de optie Auteursverificatie agent.

  3. Publiceer en test de ervaring in het testvenster voor agenten of in een gewenst kanaal.

    Schermopname van het configureren van connectorinstellingen.

Stroomacties met referenties van gebruikers gebruiken

Stroomacties kunnen worden geconfigureerd om referenties van gebruikers te gebruiken. Voor het gebruik van een stroom in een ondersteund kanaal is geen speciale configuratie in uw agent-dialoogvenster vereist. Gebruikers kunnen hun verbindingen beheren voor een bepaalde stroom in een bepaalde ervaring.

Verificatie voor acties op basis van invoegtoepassingen in uw bibliotheek

Wanneer ze worden gemaakt op basis van AI-invoegtoepassingen, vereisen acties verificatie om correct te werken. Dit komt het meest voor bij acties die zijn gebaseerd op prompts of andere acties die Dataverse-API's aanroepen. Acties op basis van invoegtoepassingen worden altijd uitgevoerd in de gebruikerscontext en kunnen alleen worden uitgevoerd als verificatie is ingeschakeld. Er worden twee typen verificatiemethoden ondersteund:

  • Geïntegreerde authenticatie (Teams en Power Apps): U kunt deze authenticatiemethode gebruiken als u uw agent wilt publiceren op een Teams-kanaal. Deze methode werkt ook voor agenten die zijn ingesloten in elke Power Platform app die tokens gebruikt die zijn gebouwd met de PPAPI-standaard.

  • Handmatige authenticatie (agenten van derden): Deze authenticatiemethode omvat het instellen van een Microsoft Entra ID-verbinding.

Een handmatige verificatieverbinding maken:

  1. Stel een Microsoft Entra ID-app in.

  2. Stel handmatige verificatie in voor uw agent.

  3. Sta toe dat uw app machtiging gebruikt om een token op te halen namens de gebruiker. Zorg ervoor dat u de benodigde bereiken toevoegt.

    Schermopname van de instellingen voor verificatie.