Stroom maken

Meer informatie over het gebruiken van een cloudstroom in Copilot Studio door een agent de mogelijkheid te geven om op aanvraag een weersvoorspelling te genereren. In dit eerste voorbeeld maakt u een stroom die een weerbericht ophaalt. In het volgende voorbeeld roept u de stroom aan als een actie vanuit een onderwerp zodat de agent kan reageren met de weersverwachting wanneer een klant vraagt naar het weer.

Een Power Automate-stroom vereist specifieke stroomtrigger en -responsactie om met agenten te kunnen werken.

• Stroomtrigger: Een stroom uitvoeren vanuit Copilot

  

• Responsactie: Reageren op Copilot

  

Wanneer u een stroom maakt vanuit Copilot Studio, worden de trigger en de actie voor u toegevoegd. U kunt een bestaande stroom wijzigen voor gebruik met agenten door de stroom te wijzigen om deze acties te gebruiken.

Belangrijk

Om cloudstromen in aangepaste agenten in Copilot Studio te gebruiken, moeten de stromen:

• De trigger Een stroom uitvoeren vanuit Copilot hebben.
• Zich in een oplossing binnen dezelfde omgeving als de agent bevinden. Bestaande stromen kunnen worden toegevoegd aan een oplossing zodat ze beschikbaar zijn wanneer u acties toevoegt aan uw agent.
• Een reactie synchroon met de actie Reageren op Copilot retourneren, binnen de actielimiet van 100 seconden. Om time-outs te voorkomen, optimaliseert u de stroomlogica, vragen en de hoeveelheid geretourneerde gegevens, zodat een normale uitvoering onder deze limiet ligt. Acties die langer moeten worden uitgevoerd, kunnen na de actie Reageren op Copilot worden geplaatst om door te gaan met uitvoeren tot aan de limiet voor de duur van stroomuitvoeringen, doorgaans 30 dagen.

Vereisten

• Toegang tot Copilot Studio met een licentie die het gebruik van stromen binnen de context van Copilot Studio-creaties omvat.

Maak een flow om te gebruiken met een agent

1. Ga naar de pagina Onderwerpen voor uw agent.

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

3. Selecteer Knooppunt toevoegen (+) onder een bestaand knooppunt om een nieuw knooppunt toe te voegen.

4. Selecteer in het knooppuntselectievenster Een actie aanroepen, Basisactie en selecteer vervolgens Een stroom maken.

   

   De Power Automate-portal wordt geopend in een nieuw tabblad, met een geopend startstroomsjabloon om te bewerken. De portal wordt geopend in dezelfde omgeving als de agent en gebruikt dezelfde gebruikersreferenties.

   

   Tip

   Geef knooppunten een nieuwe naam, zodat u ze gemakkelijker kunt identificeren. Selecteer het naamveld van het knooppunt om de naam rechtstreeks bij te werken of selecteer het pictogram Meer (…) van het knooppunt en vervolgens Naam wijzigen in het menu. U kunt ook de namen van knooppunten wijzigen in de code-editor.

   Het is niet mogelijk om Trigger-knooppunten en Ga naar stap-knooppunten te hernoemen.

   Namen van knooppunten mogen maximaal 500 tekens lang zijn.

Voeg nu acties aan de stroom toe. In dit voorbeeld voegt u een actie toe die de huidige voorspelling ophaalt van MSN Weer.

1. Selecteer de naam van de stroom en hernoem deze Weerbericht ophalen.

   

2. Voeg de volgende invoerparameters toe aan de trigger Een stroom uitvoeren vanuit Copilot:

   • Stad (tekst)
   • Postcode (nummer)

   

3. Selecteer Een actie toevoegen om een nieuwe actie te maken onder de stroomtrigger Een stroom uitvoeren vanuit Copilot.

   

4. Zoek MSN weather en selecteer de actie Weerbericht voor vandaag ontvangen.

   

5. Selecteer in de actie Weerbericht voor vandaag ontvangen in het vak Locatie de optie Dynamische inhoud toevoegen en selecteer dan Stad en Postcode.

   

6. Voeg in de actie Reageren op Copilot de volgende uitvoerparameters en variabelen toe:

   Uitvoerparameter	Type	Variabele
   day_summary	String	Dagoverzicht
   location	String	Locatie
   chance_of_rain	Aantal	Regenkans dag

   

7. Selecteer Opslaan.

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. Als u de stroom in een ondersteund kanaal gebruikt, vereist dit geen speciale configuratie in uw agentdialoog en kunnen gebruikers hun verbindingen beheren terwijl ze de agent gebruiken.

Cloudstromen in omgevingen die gebruikmaken van door de klant beheerde sleutels (CMK) kunnen nog niet worden uitgevoerd met klantreferenties als onderdeel van generatieve orkestratieplannen of vanuit onderwerpen. Zorg ervoor dat de alleen-uitvoereninstellingen voor cloudstromen in CMK-omgevingen zijn ingesteld op specifieke verbindingen in plaats van Geleverd door alleen uitvoeren-gebruiker.

Een bestaande stroom wijzigen voor gebruik met een agent

Als u een flow hebt met een andere trigger die u wilt gebruiken met uw agent, kunt u de flow wijzigen om de responsactie Voer een flow uit vanuit Copilot en Reageer op Copilot te gebruiken. Zorg er ook voor dat deze zich in een oplossing in dezelfde omgeving bevindt als de aangepaste agent.

1. Ga naar de Power Automate-portal en gebruik de omgevingskiezer in de rechterbovenhoek om de omgeving te kiezen waarin uw stroom is opgeslagen.

2. Navigeer naar Mijn stromen aan de linkerkant en zoek naar de stroom.

3. Selecteer de stroom.

   

De Copilot-trigger en -responsactie toevoegen

Als uw stroom nog niet de Copilot-trigger en -responsactie bevat, moet u deze toevoegen voordat u de stroom met uw agent kunt gebruiken.

1. Selecteer Nieuwe stap.

2. Zoek naar Copilot en selecteer Een stroom uitvoeren vanuit Copilot.

3. Selecteer Nieuwe stap.

4. Zoek naar de connector Copilot en selecteer Reageren op Copilot. De responsactie kan voor meerdere vertakkingen in de stroom worden gebruikt, maar moet bij elk gebruik dezelfde uitvoer hebben.

5. Sla de stroom op en publiceer deze.

Ervoor zorgen dat de responsactie in realtime wordt geretourneerd

Stromen die u in een agent wilt gebruiken, moeten waarden in realtime of synchroon retourneren. Stromen die op de achtergrond of asynchroon worden uitgevoerd, kunnen een fout veroorzaken wanneer uw agent deze probeert uit te voeren. In plaats van de stroom uit te voeren, zegt de agent: "Er is een onverwachte fout opgetreden. Wij onderzoeken de zaak. Foutcode: 3000."

Wanneer u een stroom maakt van Copilot Studio, zijn asynchrone responsen standaard uitgeschakeld. Als u een bestaande stroom hebt gewijzigd waarvoor asynchrone reacties zijn ingeschakeld, volgt u deze stappen om de instelling te controleren en ervoor te zorgen dat deze is uitgeschakeld:

1. Open uw stroom en vind de actie(s) voor Reageren op Copilot.

2. Selecteer het tabblad Instellingen.

3. Stel Asynchrone respons in op Uit en selecteer vervolgens Gereed.

   

De stroom toevoegen aan een oplossing

Als u wilt dat stromen beschikbaar zijn voor agenten, moeten ze worden opgeslagen in een oplossing in dezelfde Power Platform-omgeving. Als een stroom zich in een oplossing bevindt, is er een tegel Oplossingen zichtbaar op de detailpagina van de stroom, waar wordt vermeld in welke oplossingen de stroom zich bevindt. Stromen kunnen worden toegevoegd aan de standaardoplossing voor gebruik met agenten, of worden verplaatst naar een andere oplossing met behulp van de onderstaande stappen:

1. Ga naar de Power Automate-portal.

2. Ga naar Oplossingen en selecteer een bestaande oplossing of maak zelf een oplossing voor uw stromen.

   Als u een oplossing wilt maken, selecteert u Nieuwe oplossing.

   

   Geef uw nieuwe oplossing een naam en selecteer CDS-standaarduitgever in het veld Uitgever, voer een nummer in voor Versie en selecteer vervolgens Maken.

   

3. Ga op het tabblad Oplossingen naar de oplossing die u wilt gebruiken. Selecteer Bestaande toevoegen om een stroom eraan toe te voegen.

   

4. Selecteer op de pagina Bestaande stroom toevoegen het tabblad Van oplossingen, selecteer de gewenste stroom en daarna Toevoegen.

   

   Om een stroom te verplaatsen van het tabblad Mijn stromen naar een oplossing, selecteert u Externe oplossingen en daarna Toevoegen om uw stroom aan de oplossing toe te voegen.

   

Gerelateerde inhoud

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