Uw agentstroom of werkstroom bewerken en beheren in de ontwerpfunctie

Als u een agentstroom of werkstroom wilt weergeven in de ontwerpfunctie, opent u Copilot Studio, selecteert u Flows, selecteert u de stroom en selecteert u vervolgens het tabblad Build.

Als u een agentstroom wilt weergeven in de ontwerpfunctie, opent u Copilot Studio, selecteert u Stromen, selecteert u de stroom en selecteert u vervolgens het tabblad Ontwerper.

Legenda:

1. Inzoomen: Vergroot de grootte van de werkstroom op het canvas.
2. Uitzoomen: Verklein de grootte van de werkstroom op het canvas.
3. Weergave passend maken: pas het formaat van de weergave aan zodat deze past bij de hele werkstroom op het canvas.
4. Opschonen: De werkstroom en vertakkingen opnieuw organiseren voor een schonere end-to-end weergave.
5. Verticale indeling: Overschakelen naar een verticale indelingsweergave van de werkstroom.

Legenda:

1. Uit-/samenvouwen: Vouw alle actiegroepen uit of samen. Als een actie bijvoorbeeld meerdere voorwaarden heeft, selecteert u dit pictogram om de details van de voorwaarden weer te geven.
2. Inzoomen: Vergroot de stroom in het canvas.
3. Uitzoomen: Verklein de stroom in het canvas.
4. Weergave passend maken: Pas de weergave aan zodat deze het gehele proces op het canvas weergeeft.
5. Minikaart: Navigeer naar een specifiek gedeelte van een grote stroom.
6. Zoeken: Zoek naar een bewerking in uw flow.

1. Selecteer een stap toevoegen op de kaart waarna u de actie wilt toevoegen. Het deelvenster Toevoegen wordt geopend.

2. Begin met typen onder Toevoegen van de actie die u uw flow wilt laten uitvoeren of de connector die u wilt toevoegen, en selecteer deze vervolgens in de lijst. Afhankelijk van uw selectie moet u mogelijk aanvullende informatie opgeven om de actie te voltooien.

Als u vaststelt dat een actie niet nodig is, selecteert u het pictogram Verwijderen in de rechterbovenhoek van de actie.

1. Selecteer onder de kaart waaraan u de actie wilt toevoegen een nieuwe actie invoegen. Het paneel Actie toevoegen wordt geopend.

2. Begin onder Actie toevoegen met het typen van de actie die u door uw stroom wilt laten uitvoeren en selecteer deze vervolgens in de lijst. Afhankelijk van uw selectie moet u mogelijk aanvullende informatie opgeven om de actie te voltooien.

Als je merkt dat een actie niet nodig is, selecteer die dan in je flow en selecteer vervolgens de drie stippen (⋮) >Verwijderen. Selecteer OK om het verwijderen te bevestigen.

Als u de parameters voor een trigger of actie in uw werkstroom wilt weergeven, selecteert u de kaart. Het configuratiepaneel wordt aan de rechterkant geopend. Als u een waarde voor een parameter wilt invoeren, selecteert u een optie in de vervolgkeuzelijst of voert u een expressie in om de waarde dynamisch in te stellen.

Als u de parameters voor een trigger of actie in uw agentstroom wilt bekijken, selecteert u de kaart ervan. Het configuratiescherm wordt geopend en het tabblad Parameters wordt standaard weergegeven. Als u een waarde voor een parameter wilt invoeren, selecteert u een optie in de vervolgkeuzelijst of voert u een expressie in om de waarde dynamisch in te stellen.

Fouten in werkstroomacties worden rood aangegeven. Om details van een fout in één actie te bekijken, selecteert u de fout. Als u alle fouten in het hele proces wilt weergeven, opent u het banner van het gezondheidscentrum. Selecteer de fout om de details van afzonderlijke fouten weer te geven.

Fouten in agentflowacties worden in het rood weergegeven. Om details van een fout in één actie te bekijken, selecteert u de fout. Om alle fouten in de volledige stroom weer te geven, selecteert u in het menu bovenaan het canvas de optie Stroomcontrole. Selecteer de fout om de details van afzonderlijke fouten weer te geven. U kunt ook Bewerking openen selecteren om de bewerking in het paneel Stroomcontrole te openen en de fout te corrigeren.

Met testuitvoeringen kunt u een stap of een volledige stroom verifiëren zonder de ontwerper te verlaten, met behulp van echte upstreamgegevens, waarden die u zelf simuleert, of uitvoer van een vorige uitvoering.

Er zijn twee manieren om een test uit te voeren:

Beide oppervlakken delen hetzelfde idee: invoer geven (echt of gesimuleerd), uitvoeren en vervolgens de uitvoer inspecteren.

Een enkel knooppunt in een werkstroom testen

Open een actie of knooppunt in uw werkstroom en selecteer de knop Afspelen of Testen. Er zijn drie secties:

1. Test uitvoeren/opnieuw instellen: hiermee wordt de stap op aanvraag uitgevoerd of worden de huidige invoer en uitvoer gewist.

   

2. Laadwaarden uit de vorige uitvoering: een vervolgkeuzelijst met recente uitvoeringen van deze stroom. Wanneer u er een kiest, worden de uitvoerresultaten van die run van de upstream-stap in de onderstaande invoervelden gehaald.

3. Invoer: Één bewerkbaar veld per upstream-stap voert de knooppuntverwijzingen uit. In de badge rechts van elke rij wordt het verwachte type veld weergegeven (tekenreeks, e-mail, datum/tijd, getal, enzovoort).

4. Uitvoer: het liveresultaat van de meest recente test, opgemaakt voor het knooppunttype (JSON, promptresultaat, connectorantwoord, enzovoort).

Mock-invoer

Standaard zijn de invoervelden leeg. U kunt:

• Typ een willekeurige waarde rechtstreeks in een veld. Het veld accepteert het type dat wordt weergegeven op de rechterbadge.
• Laat een veld leeg als uw stap er niet van afhankelijk is.

Waarden laden van een eerdere sessie

Als uw flow al eerder is uitgevoerd, kunt u echte gegevens opnieuw afspelen in plaats van deze in te typen:

1. Kies een run in de vervolgkeuzelijst Laden uit de vorige run. Elke vermelding wordt gelabeld met de datum/tijd en status van de uitvoering (bijvoorbeeld 24 april 09:12 — Geslaagd).

2. De ontwerper haalt de uitvoer van die run op en projecteert deze op het invoerschema van uw knooppunt. Overeenkomende waarden worden in de invoervelden geschreven.

3. Bewerk daarna een veld als u het scenario wilt aanpassen.

In het dropdown-menu worden de 10 meest recente uitvoeringen van elke status weergegeven. Als een uitvoering geen uitvoer bevat voor een van uw upstream-stappen (omdat die stap is overgeslagen of het pad niet gevolgd is), worden alleen de beschikbare velden ingevuld. De rest van de velden blijven zoals ze waren.

Als de stroom nog niet eerder is uitgevoerd, worden er geen eerdere uitvoeringen weergegeven en is de vervolgkeuzelijst verborgen.

Voer de test uit

Selecteer Test uitvoeren. De knop geeft een drukke status weer terwijl de oproep onderweg is; in de sectie Uitvoer ziet u een spinner en vervolgens het resultaat of een fout.

• Met de resettest worden zowel de invoer als de laatste uitvoer gewist.
• Tijdens de test wordt het knooppunt geïsoleerd uitgevoerd tegen de API van de connector. De test activeert de rest van het proces niet.

De hele stroom testen

Selecteer in de bovenste opdrachtbalk de afspeelknop (Test). Test voert uw proces end-to-end uit in de live omgeving.

Voordat de run begint, ontwerpt de ontwerper:

1. Slaat de stroom op en publiceert deze als u niet-opgeslagen wijzigingen hebt (of als dit de eerste keer is).
2. Installeert nieuwe verbindingen bij de eerste keer dat het wordt uitgevoerd.
3. Hiermee wordt de uitvoering gestart. Het pad is afhankelijk van het type trigger.

Mock-invoer (handmatige trigger)

Voor handmatige triggers wordt in het dialoogvenster Handmatige triggerinvoer invoeren één veld weergegeven per invoer die u hebt gedefinieerd voor de trigger:

• Tekst/nummer/e-mail/datum: Geschikt invoerbeheer.
• Booleaanse waarde: Wisselknop.
• Eén keuze (enum): vervolgkeuzelijst.
• Meervoudige selectie: vervolgkeuzelijst voor meerdere items.
• Bestand: Bestandskiezer (de inhoud wordt geüpload als onderdeel van de uitvoering).
• Object/matrix: tekstgebied met meerdere regels waar u JSON kunt plakken.

Selecteer Uitvoeren om de flow te starten met deze input, of Annuleren om af te sluiten zonder uit te voeren. Vereiste velden worden gemarkeerd met een sterretje. Als er waarden ontbreken of ongeldig zijn, worden inlinevalidatieberichten weergegeven en wordt de uitvoering geblokkeerd totdat ze zijn opgelost.

Het dialoogvenster wordt elke keer weergegeven wanneer u Testen selecteert. Waarden worden niet opgeslagen tussen uitvoeringen, zodat u snel verschillende scenario's kunt proberen.

Bekijk de uitvoering

Zodra een vlucht is uitgevoerd:

• Op de opdrachtbalk wordt een knop Annuleren weergegeven terwijl de uitvoering actief is.
• In het deelvenster Activiteit (rechts) wordt de huidige uitvoering bovenaan weergegeven met een statusbadge: Actief, Wachten, Geslaagd, Mislukt of Geannuleerd. Selecteer een run om deze op het canvas te openen en de invoer en uitvoer van elke stap te inspecteren.

Selecteer eerdere uitvoeringen

Het deelvenster Activiteit dient als de uitvoeringsgeschiedenis van uw workflow:

• Filter door op Alle / Geslaagd / Mislukt / Wordt uitgevoerd te selecteren in de vervolgkeuzelijst bovenaan.
• Klik op Herladen om de lijst opnieuw op te halen.
• Selecteer Meer laden onderaan om verder terug te gaan.
• Wanneer u een run selecteert, wordt deze op het canvas geladen, waarbij elk knooppunt de invoer toont die het heeft ontvangen en de uitvoer die het heeft geproduceerd voor die run. De gegevens zijn dezelfde als die het testtabblad op knooppuntniveau gebruikt wanneer u een uitvoering kiest uit de vervolgkeuzelijst.

Wanneer gebruikt u elk type test

• Itereren op een enkele AI-stap of connectoractie?: Test dit knooppunt. Het is sneller, publiceert niet, en laat u alleen de upstream-waarden simuleren die belangrijk zijn.
• End-to-endgedrag of triggerlogica valideren?: Voer een flowtest uit. Het test de volledige grafiek tegenover de werkelijke runtime.
• Een productieprobleem reproduceren?: Open de mislukte uitvoering vanuit het deelvenster Activiteit, open vervolgens het mislukte knooppunt en gebruik loadwaarden uit de vorige uitvoering op het tabblad Test om de exacte upstream-gegevens opnieuw af te spelen in de actie.

Omdat uw stroom geen fouten bevat en kan worden gepubliceerd, betekent dit niet dat het gaat doen wat u wilt. Nadat u de agentflow hebt gepubliceerd, test u de flow zodat deze werkt zoals verwacht.

U kunt een test handmatig of automatisch uitvoeren. Nadat de tests zijn uitgevoerd, kunt u de uitvoer van elke actie controleren om te bevestigen dat de werkstroom werkt.

1. Sla uw werkstroom op en publiceer deze.

2. Selecteer in het menu bovenaan het canvas de optie Testen. Het paneel Stroom testen wordt geopend.

3. Selecteer of u de test Handmatig of Automatisch wilt uitvoeren.

4. Selecteer in het paneel Stroom uitvoeren de opties Testen>Stroom uitvoeren. Een groen vinkje geeft aan dat de werkstroom succesvol is afgerond.

5. Selecteer Gereed.

Het testen van een agentflow in de ontwerper verbruikt geen capaciteit van Copilot Studio.