Invoegtoepassingsacties gebruiken in Copilot Studio (preview)

Belangrijk

Power Virtual Agents-mogelijkheden en -functies maken nu deel uit van Microsoft Copilot Studio na aanzienlijke investeringen in generatieve AI en verbeterde integraties binnen Microsoft Copilot.

Sommige artikelen en schermopnamen verwijzen mogelijk naar Power Virtual Agents terwijl we de documentatie en trainingsinhoud bijwerken.

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

[Dit artikel maakt deel uit van de voorlopige documentatie en kan nog veranderen.]

Kernactietypen voor invoegtoepassingen

Invoegtoepassingsacties zijn gebaseerd op een van de volgende kernactietypen:

• Vooraf gebouwde connectoractie
• Aangepaste connectoractie
• Power Automate-cloudstroom
• Bot Framework-vaardigheid

Belangrijk

U kunt gespreksinvoegtoepassingen die zijn gemaakt in Copilot Studio niet gebruiken als invoegtoepassingsacties.

Elke kernactie heeft aanvullende informatie die het doel ervan beschrijft, waardoor Copilot gebruik kan maken van GPT 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 vraagknooppunten niet handmatig te schrijven om alle benodigde invoer te verzamelen, zoals de invoer voor een stroom. Invoer wordt tijdens runtime voor u afgehandeld.

Invoegtoepassingsacties kunnen een contextueel antwoord genereren op de zoekopdracht van een gebruiker, met behulp van de resultaten van de actie. Als alternatief kunt u expliciet een antwoord schrijven voor de invoegtoepassingsactie.

Tip

Wanneer u gegenereerde vragen uit een invoegtoepassingsactie gebruikt, informeer uw gebruikers dan dat een deel van het gesprek door AI wordt gegenereerd.

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

Een invoegtoepassingsactie toevoegen

1. Open uw copilot en selecteer Onderwerpen en invoegtoepassingen in het navigatiedeelvenster.

2. Selecteer + Maken.

3. Selecteer Invoegtoepassingsactie (preview).

   

4. In de wizard Een actie toevoegen (preview) zoekt en selecteert u een invoegtoepassingsactie die u wilt gebruiken.

   De standaardlijst die wordt weergegeven bevat Power Automate-stromen en aangepaste connectoren die beschikbaar zijn binnen uw omgeving. Deze lijst bevat ook veelgebruikte, vooraf gebouwde connectoren en Bot Framework-vaardigheden die met uw copilot zijn geregistreerd. Zie AI-invoegtoepassingen maken voor Microsoft Copilot (preview) voor meer informatie.

   

   Belangrijk

   Voor sommige invoegtoepassingsacties die zijn gemaakt op basis van AI-invoegtoepassingen, zoals dynamische aanwijzingen en acties die zijn gebaseerd op Dataverse-API's, is verificatie vereist.

5. Configureer de verbinding voor de actie.

   Afhankelijk van de invoegtoepassing wordt uw verbinding automatisch geconfigureerd, zoals weergegeven in het voorbeeld. Als alternatief moet u de verbinding configureren als er instructies worden gegeven in de wizard. Zodra uw verbinding is geconfigureerd, selecteert u Volgende.

   

6. U kunt het nu controleren en indien nodig, wijzigingen aanbrengen in de configuratie van uw invoegtoepassingsacties. Selecteer Voltooien om de invoegtoepassingsactie aan uw copilot toe te voegen.

   

Een invoegtoepassingsactie aanroepen

Als u generatieve acties hebt ingeschakeld, wordt uw invoegtoepassingsactie automatisch aangeroepen in reactie op een relevante gebruikersquery.

Als alternatief kunt u een invoegtoepassingsactie expliciet aanroepen vanuit een onderwerp.

Uw invoegtoepassingsactie testen

Stel uw copilot een relevante vraag via de testchat. U kunt de weergave van het chatvenster onder aan het navigatiemenu in- en uitschakelen (weergeven of verbergen).

Met uw copilot wordt uw invoegtoepassingsactie geselecteerd en uitgevoerd op basis van de naam en beschrijving. U kunt beschrijvingen van hoge kwaliteit opstellen met behulp van de speciale traceringsmodus om te zien welke invoegtoepassingsacties uw copilot heeft geselecteerd op de pagina met generatieve acties.

Als u een invoegtoepassingsactie hebt toegevoegd aan een onderwerp, kunt u deze ook testen door een bericht in te voeren dat lijkt op een van de triggerzinnen voor dat onderwerp.

In deze schermopname ziet u hoe een weerinvoegtoepassingsactie wordt getest:

GPT-gestuurde gesprekken kunnen vloeiender zijn dan traditioneel geschreven vragen. Gebruikers kunnen meer dan één vraag in één beurt beantwoorden of eerder ingevoerde waarden corrigeren.

In dit voorbeeld kunt u zien dat de copilot-gebruiker er eerst voor heeft gekozen om het weer te controleren voor Orlando, FL, maar vervolgens in de bevestigingsfase heeft aangegeven de locatie te willen wijzigen in Seattle. Deze wijziging van de invoerwaarde kan op elk moment worden uitgevoerd, niet alleen in de bevestigingsfase.

Wijzigingen aanbrengen in de configuratie van uw invoegtoepassingsactie

Er zijn veel manieren waarop u uw invoegtoepassingsactie kunt configureren. Bij de laatste stap van de actiewizard voor invoegtoepassingen, genaamd Controleren en voltooien, kunt u wijzigingen aanbrengen in de configuratie van uw invoegtoepassingsactie door op Bewerken naast de betreffende sectie te klikken.

Actiegegevens

Hier kunt u details over uw actie configureren, inclusief de Weergavenaam van model en Modelbeschrijving voor uw invoegtoepassingsactie. Meestal worden de naam en beschrijving vooraf voor u ingevuld op basis van de actie die u hebt geselecteerd.

Op deze pagina kunt u het selectievakje De gebruiker vragen voordat u deze actie uitvoert inschakelen. Dit is handig voor acties waarmee wijzigingen voor een gebruiker worden aangebracht, zoals het invoegen in of bijwerken van een record in een tabel.

Invoer

Met de sectie Invoer kunt u de Weergavenaam en Beschrijving voor elke input over uw actie beheren. De naam en beschrijving helpen de copilot een vraag aan de gebruiker te genereren. Een gegenereerde vraag voor de locatie-invoer kan bijvoorbeeld zijn: Wat is de locatie waarvan u het weer wilt controleren? U kunt een steden, regio´s, staten, landen, oriëntatiepunten of postcodes invoeren"

U kunt de optie Identificeren als voor een specifiek entiteitstype wijzigen, afhankelijk van de invoer die wordt verzameld. Dit kan de copilot helpen nauwkeurig een waarde voor de invoer te extraheren uit de reactie van een gebruiker.

Standaard wordt elke invoer ingesteld op Dynamisch vullen met de beste optie. De copilot probeert de waarde op basis van de beschikbare context in te vullen, zoals het extraheren van een waarde 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 het te overschrijven, wijzigt u de vervolgkeuzelijst Hoe vult de copilot deze invoer in? in Als een waarde instellen en voert u vervolgens een waarde in. Deze waarde kan een letterlijke waarde zijn, een bestaande variabele of een Power Fx-formule.

Uitvoeren

Standaard is uw invoegtoepassingsactie geconfigureerd om automatisch een contextueel antwoord voor een gebruiker te genereren, op basis van hun 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".

Als alternatief kunt u ervoor kiezen om een ​​specifiek antwoord te schrijven zodat uw invoegtoepassingsactie kan worden geretourneerd. Net als voor de bevestigingseditor kunt u verwijzingen naar uitvoervariabelen uit de actie invoegen met behulp van de variabelenkiezer, zoals weergegeven in dit voorbeeld.

Een invoegtoepassingsactie aanroepen in een onderwerp

U kunt een invoegtoepassingsactie expliciet aanroepen vanuit een onderwerp, vergelijkbaar met het aanroepen van andere actietypen, 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 één invoegtoepassingsactieknooppunt aan een onderwerp alles zijn wat u nodig hebt.

Ga als volgt te werk om een invoegtoepassingsactie op te roepen vanuit een onderwerp:

1. Ga in Microsoft Copilot Studio naar de pagina Onderwerpen voor de copilot 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

   

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

   

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

   

6. Selecteer Opslaan.

Invoer overschrijven bij het aanroepen van een invoegtoepassingsactie vanuit een onderwerp

Wanneer uw invoegtoepassingsactie wordt uitgevoerd, genereert uw copilot standaard vragen aan 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 configuratie van invoegtoepassingsactie in de sectie Invoer overschrijven. Of u kunt waarden alleen overschrijven als uw invoegtoepassingsactie wordt gebruikt vanuit een specifiek onderwerp:

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

   

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

   

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

Verificatie inschakelen voor AI-invoegtoepassingen

Wanneer sommige invoegtoepassingsacties zijn gemaakt op basis van AI-invoegtoepassingen, wordt er verificatie vereist om goed te kunnen werken, zoals dynamische aanwijzingen of iets anders waarmee een Dataverse-API wordt aangeroepen.

Invoegtoepassingen worden altijd uitgevoerd in de Microsoft Copilot-runtime in de context van de eindgebruiker en kunnen niet worden uitgevoerd tenzij verificatie is ingeschakeld. Er worden twee typen verificatiemethoden ondersteund:

• Geïntegreerde verificatie (Teams en Power Apps): deze verificatie-instelling kan worden gebruikt als uw copilot zich in het Teams-kanaal bevindt. De instelling werkt ook met ingesloten copilots in een Power Platform-app die tokens gebruikt die zijn gebouwd met de PPAPI-standaard.

• Handmatige verificatie (copilots van derden): deze verificatiemethode omvat het opzetten van een Entra ID-verbinding.

Een handmatige verificatieverbinding maken:

1. Stel een Entra ID-app in.

2. Stel handmatige verificatie in op uw Copilot Studio-copilot.

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.