Een agentstroom als hulpmiddel creëren

Meer informatie over hoe u een cloudstroom in Copilot Studio kunt gebruiken door een agent de mogelijkheid te geven om op verzoek een weersvoorspelling te maken. In dit eerste voorbeeld maakt u een stroom die een weersvoorspelling ophaalt. In het volgende voorbeeld stelt u een onderwerp in om de stroom als een actie aan te roepen zodat de agent kan reageren met de weersverwachting wanneer een klant vraagt naar het weer.

Om een agentenstroom als hulpmiddel met agenten te kunnen gebruiken, is het volgende vereist:

• De trigger Wanneer een agent de stroom aanroept en een responsactie van Reageren op de agent hebben.
• Geconfigureerd zijn om in realtime te reageren, niet asynchroon. De schakelaar Asynchrone respons moet worden ingesteld op Uit onder Netwerken in de actie-instellingen Reageren op de agent.
• Reageer binnen de actietermijn van 100 seconden op de agent. Optimaliseer de stroomlogica, query's en de hoeveelheid geretourneerde gegevens, zodat een typische run onder deze limiet van 100 seconden blijft. Acties in de stroom die langer moeten worden uitgevoerd, kunnen na de actie Reageren op Copilot worden geplaatst, zodat ze uitgevoerd worden tot de limiet voor duur van stroomuitvoeringen van 30 dagen. Raadpleeg De uitvoering van de agentstroom versnellen met de expresmodus voor richtlijnen over het versnellen van uw stromen.

Wanneer u een agentstroom maakt in Copilot Studio als een nieuwe tool die aan een agent is toegevoegd, worden de vereiste stroomtrigger en responsactie voor u toegevoegd. U kunt een bestaande stroom aanpassen voor gebruik met agenten door deze bij te werken zodat deze trigger en deze responsactie worden gebruikt.

Vereisten

• Toegang tot Copilot Studio met een licentie die het gebruik van stromen in Copilot Studio omvat.

Een stroom maken die u met een agent kunt gebruiken

In dit voorbeeld maakt u een stroom die de huidige weersvoorspelling ophaalt uit MSN Weer. U voegt de flow als tool toe aan een bestaand thema van de agent.

Een lege nieuwe agentstroom aan een onderwerp toevoegen en opslaan

1. Ga naar de pagina Onderwerpen voor uw agent.

2. Open het onderwerp van waaruit u een stroom wilt aanroepen.

3. Selecteer het pictogram Knooppunt toevoegen onder een knooppunt en selecteer Een hulpmiddel toevoegen.

4. Selecteer op het tabblad Basishulpmiddelen de optie Nieuwe agentstroom.

   De pagina Agentstromen wordt geopend, waarbij een sjabloon voor een startstroom geopend is in de ontwerpfunctie voor agentstromen voor bewerking. De stroom omvat de vereiste trigger Wanneer een agent de stroom aanroept en de actie Reageren op de agent.

5. Selecteer Publiceren om de stroom op te slaan voordat u wijzigingen aanbrengt. Er verschijnt een melding wanneer de flow succesvol is aangemaakt.

6. Selecteer Terug naar agent om terug te keren naar uw onderwerp. Er wordt een nieuw Actie-knooppunt toegevoegd aan uw onderdeel in de flow.

7. Selecteer Opslaan om het toevoegen van de flow als hulpmiddel aan uw agent te voltooien.

Acties toevoegen en de stroom configureren

Nu een basis-template is gemaakt voor de flow en de flow aan uw agentonderwerp is toegevoegd, kunt u terugkeren om acties toe te voegen aan uw flow. In dit voorbeeld voegt u een actie toe die de huidige voorspelling ophaalt van MSN Weer.

1. Selecteer voor het knooppunt Actie met de stroom de koppeling Stroomdetails weergeven om terug te keren naar de agentstroom.

2. Geef op de pagina Overzicht onder Details een betekenisvolle naam op voor de stroom, zoals "Weerbericht ophalen".

3. Ga naar de ontwerper, selecteer de stroomtrigger Wanneer een agent de stroom oproept en voeg de volgende invoerparameters toe:

   • Stad (tekst)
   • Postcode (nummer)

4. Selecteer het pictogram Toevoegen onder de flow-trigger Wanneer een agent de flow oproept.

5. Zoek in Een actie toevoegen naar 'MSN weer' en selecteer de actie Weergave voor vandaag ontvangen.

6. Voer in het paneel Weergave voor vandaag ontvangen in het vak Locatie een schuine streep (/) in, selecteer Dynamische inhoud invoegen en selecteer vervolgens uw invoerparameter Stad.

7. Ga op dezelfde manier te werk om de invoerparameter Postcode toe te voegen.

8. Voeg in de actie Reageren op de agent de volgende uitvoerparameters en variabelen toe:

   Uitvoerparameter	Type	Variabele
   day_summary	Tekst	Dagoverzicht
   location	Tekst	Locatie
   chance_of_rain	Aantal	Kans op regen overdag

   

9. Selecteer Publiceren. Er verschijnt een melding wanneer de flow succesvol is aangemaakt.

Om door te gaan, volgt u de instructies in Een agentenstroom starten vanuit een agent.

Beheren welke verbindingen door de stroom worden gebruikt

In een ondersteunde, geverifieerde agent kunnen cloudstromen worden geconfigureerd om gebruikersreferenties te gebruiken wanneer ze worden uitgevoerd als onderdeel van een generatief orkestratieplan of worden aangeroepen vanuit een onderwerp. Voor het gebruik van de stroom in een ondersteund kanaal is geen speciale configuratie in uw agent vereist. Klanten kunnen hun verbindingen beheren terwijl ze de agent gebruiken.

Cloudflows in omgevingen die gebruikmaken van door de klant beheerde sleutels (CMK) kunnen op dit moment nog niet worden uitgevoerd met klantgegevens als onderdeel van generatieve orkestratieplannen of vanuit topics. Zorg ervoor dat de instellingen voor alleen-uitvoeren van cloudstromen in CMK-omgevingen zijn ingesteld op specifieke verbindingen in plaats van geleverd door alleen-uitvoergebruikers.

Gerelateerde inhoud

• Een stroom aanroepen als een actie
• In- en uitvoervariabelen gebruiken om informatie door te geven
• Verificatie voor gebruikers toevoegen aan onderwerpen