Share via


Stroom maken

Leer hoe u een cloudstroom in Copilot Studio kunt gebruiken door een copilot de mogelijkheid te geven om op verzoek een weersvoorspelling te maken. 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 copilot kan reageren met de voorspelling als een klant naar het weer vraagt.

Om met copilots te werken, vereist een Power Automate-stroom specifieke stroomtrigger en -responsactie.

  • Stroomtrigger: Een stroom uitvoeren vanuit Copilot

    Schermopname van de stroomtrigger Een stroom uitvoeren vanuit Copilot.

  • Responsactie: Reageren op Copilot

    Schermopname van de 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 copilots door de stroom te wijzigen om deze acties te gebruiken.

Belangrijk

Als u cloudstromen wilt gebruiken in aangepaste copilots in Copilot Studio, moeten de stromen:

  • De trigger Een stroom uitvoeren vanuit Copilot hebben.
  • Zich in een oplossing binnen dezelfde omgeving als de copilot bevinden. Bestaande stromen kunnen worden toegevoegd aan een oplossing zodat ze beschikbaar zijn bij het toevoegen van acties aan uw copilot.
  • 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

Een stroom maken voor gebruik met een copilot

  1. Ga naar de pagina Onderwerpen voor uw copilot.

  2. Open het ontwerpcanvas voor 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.

    Schermopname van de optie Een flow maken in het menu Een actie aanroepen.

    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 copilot en gebruikt dezelfde gebruikersreferenties.

    Schermopname van de Power Automate-stroomsjabloon aangeroepen vanuit Copilot Studio.

    Fooi

    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 knooppunten ook hernoemen in de code-editor.

    Het is niet mogelijk om trigger nodes en Ga naar stap nodes 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.

    Schermopname van geselecteerde stroomnaam.

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

    • Stad (tekst)
    • Postcode (nummer)

    Schermopname van invoerparameters voor Power Automate-stroom.

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

    Schermopname van de knop Stroomactie toevoegen.

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

    Schermopname van de actie Weerbericht voor vandaag ontvangen onder de MSN Weather-connector.

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

    Schermopname van variabelen toegevoegd aan de actie Weerbericht voor vandaag ontvangen

  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

    Schermopname van dynamische uitvoervariabelen toegevoegd aan de stroomresponsactie.

  7. Selecteer Opslaan.

Beheren welke verbindingen door de stroom worden gebruikt

In een ondersteunde, geverifieerde copilot kunnen cloudstromen worden geconfigureerd om inloggegevens van eindgebruikers te gebruiken wanneer ze worden uitgevoerd als een generatieve actie of vanuit een onderwerp. Als u de stroom in een ondersteund kanaal gebruikt, vereist dit geen speciale configuratie in uw copilot-dialoog en kunnen eindgebruikers hun verbindingen beheren terwijl ze de copilot gebruiken.

Cloudstromen in omgevingen die door de klant beheerde sleutels (CMK) gebruiken, kunnen nog niet worden uitgevoerd met inloggegevens van eindgebruikers als generatieve acties 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 copilot

Als u een stroom met een andere trigger hebt die u met uw copilot wilt gebruiken, kunt u de stroom wijzigen om de trigger Een stroom uitvoeren vanuit Copilot en de responsactie Reageren op Copilot te gebruiken en moet u ervoor zorgen dat deze zich in een oplossing in dezelfde omgeving als de aangepaste copilot bevinden.

  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.

    Schermopname van de stroom Weerbericht ophalen in de standaardoplossing.

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 copilot 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 copilot wilt gebruiken, moeten waarden retourneren in realtime of synchroon. Stromen die op de achtergrond of asynchroon worden uitgevoerd, kunnen een fout veroorzaken wanneer uw copilot deze probeert uit te voeren. In plaats van de stroom uit te voeren, zegt de copilot: "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) Reageren op Copilot.

  2. Selecteer het tabblad Instellingen.

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

    Schermopname van de wisselknop Asynchrone respons.

De stroom toevoegen aan een oplossing

Als u wilt dat stromen beschikbaar zijn voor copilots, 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 copilots 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.

    Schermopname van de knop 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.

    Schermopname van de eigenschappen van de oplossing.

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

    Schermopname van de knop Bestaande toevoegen.

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

    Schermopname van de lijst met bestaande stromen in oplossingen.

    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.

    Schermopname van de lijst met bestaande stromen buiten oplossingen.