Delen via

Stroom maken

  • Artikel

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.

Leer hoe u een cloudstroom in Microsoft 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, zodat de copilot kan reageren met de voorspelling als een klant naar het weer vraagt.

U kunt een stroom maken voor gebruik met een copilot of een bestaande stroom wijzigen. Om geschikt te zijn voor copilots, moet een Power Automate-stroom een speciale Microsoft Copilot Studio-stroomtrigger en -responsactie hebben.

  • Stroomtrigger: Wanneer met Microsoft Copilot Studio een stroom wordt aangeroepen

    Schermopname van de Microsoft Copilot Studio-stroomtrigger.

  • Responsactie: Waarde(n) retourneren naar Microsoft Copilot Studio

    Schermopname van de Microsoft Copilot Studio-responsactie.

Wanneer u een stroom maakt vanaf het Microsoft Copilot Studio-ontwerpcanvas, worden de trigger en de actie automatisch toegevoegd. Wanneer u een bestaande stroom wijzigt voor gebruik met een copilot, moet u de Microsoft Copilot Studio-trigger- en responsactie toevoegen.

Belangrijk

Als u stromen wilt gebruiken binnen Copilot Studio, moeten deze aan de volgende vereisten voldoen:

  • Een stroom kan alleen worden aangeroepen vanuit een onderwerp dat zich in dezelfde Microsoft Dataverse-omgeving bevindt als uw copilot.

  • Stromen moeten ook zijn opgenomen in een oplossing in Power Automate. U kunt stromen naar oplossingen verplaatsen zodat ze beschikbaar zijn in het ontwerpcanvas.

  • Stroomwaarden moeten synchroon worden teruggestuurd naar Copilot Studio.

  • Een cloudstroom die wordt aangeroepen vanuit een Copilot Studio-copilot heeft een time-outlimiet van 100 seconden om te worden uitgevoerd en te retourneren naar de copilot. Om onder de limiet van 100 seconden te blijven, moet u de stroomlogica, query's en de geretourneerde gegevens optimaliseren. Als een deel van de cloudstroomlogica wel kan worden uitgevoerd nadat een resultaat naar de copilot is verzonden, kunt u overwegen om deze acties na de stap 'Waarde(n) retourneren naar Microsoft Copilot Studio' te plaatsen in uw cloudstroom.

Vereisten

Een stroom maken voor gebruik met een copilot

  1. Ga naar de Onderwerpenpagina van 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 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 Microsoft Copilot Studio.

  5. Doorgaan met ontwerpen van de stroom in Power Automate.

Een bestaande stroom wijzigen voor gebruik met een copilot

Wat moet u doen als u al een stroom hebt en er geen helemaal opnieuw wilt maken om met uw copilot te gebruiken? Voeg de speciale Microsoft Copilot Studio-stroomtrigger en responsactie zelf toe. U kunt een bestaande stroom op een aantal manieren openen voor wijziging.

Een stroom in het ontwerpcanvas openen

  1. In een onderwerp dat geopend is op het Microsoft Copilot Studio-ontwerpcanvas selecteert u Knooppunt toevoegen (+).

  2. Selecteer Een actie aanroepen.

  3. Selecteer Stroomdetails weergeven onder de stroom.

    Schermopname van de knop Een stroom wijzigen in de actiekiezer.

Een stroom openen vanuit Actieknooppunt

  1. In een onderwerp dat geopend is op het Microsoft Copilot Studio-ontwerpcanvas selecteert u het desbetreffende Actie-knooppunt.

  2. Selecteer Stroomdetails weergeven.

    Schermopname van de knop Een stroom wijzigen in een Actieknooppunt.

Een stroom openen in Power Automate

  1. Ga naar de Power Automate-portal.

  2. Ga naar Oplossingen en selecteer Standaardoplossing. Als u de stroom naar een andere oplossing hebt verplaatst, selecteert u die.

    Schermopname van de Standaardoplossing in de lijst Oplossingen.

  3. Selecteer de stroom.

    Schermopname van de stroom Weerbericht ophalen in de standaardoplossing.

De Microsoft Copilot Studio-stroomtrigger en responsactie toevoegen

Als uw stroom nog niet de speciale Microsoft Copilot Studio-stroomtrigger en responsactie bevat, moet u deze toevoegen voordat u de stroom met uw copilot kunt gebruiken.

  1. Selecteer Nieuwe stap.

  2. Zoek naar de Microsoft Copilot Studio-connector en selecteer Wanneer met Microsoft Copilot Studio een stroom wordt aangeroepen.

  3. Selecteer Nieuwe stap.

  4. Zoek naar de Microsoft Copilot Studio-connector en selecteer Waarde(n) retourneren naar Microsoft Copilot Studio.

  5. Selecteer Save.

De stroom ontwerpen in de Power Automate-portal

Voeg nu acties aan de stroom toe. In het huidige voorbeeld haalt de actie die u gaat toevoegen de huidige weersvoorspelling op uit MSN Weather.

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

    Schermopname van geselecteerde stroomnaam.

  2. Voeg de volgende invoerparameters toe aan de Microsoft Copilot Studio-stroomtrigger:

    • Stad (tekst)
    • Postcode (nummer)

    Schermopname van invoerparameters voor Power Automate-stroom.

  3. Selecteer Een actie toevoegen om een nieuwe actie te maken onder de Microsoft Copilot Studio-stroomtrigger.

    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 Waarde(n) retourneren naar Microsoft Copilot Studio de volgende uitvoerparameters en variabelen toe:

    Naam van 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 Save.

De volgende stap is om asynchrone responsen in uw stroom uit te schakelen.

De stroom eventueel naar een andere oplossing verplaatsen

Als u wilt dat stromen beschikbaar zijn voor copilots in uw omgeving, moeten ze worden opgeslagen in een oplossing in Power Automate. Als u de Standaardoplossing niet wilt gebruiken, kunt u uw stromen naar een andere oplossing verplaatsen.

  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.

Asynchrone responsen in de stroom uitschakelen

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 Microsoft Copilot Studio, zijn asynchrone responsen standaard uitgeschakeld. Als u een bestaande stroom hebt gewijzigd waarvoor asynchrone reacties zijn ingeschakeld, moet u de instelling wijzigen.

  1. Open uw stroom en zoek de stap Waarde(n) retourneren naar Microsoft Copilot Studio.

  2. Selecteer het pictogram Menu (…) en selecteer daarna Instellingen.

    Schermopname van het instellingenmenu voor een actie.

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

    Schermopname van de wisselknop Asynchrone respons.

De stroom aanroepen als een actie.

Lees meer over invoer- en uitvoervariabelen.