Bearbeiten und verwalten Sie den Agentenfluss oder das Workflow im Designer.

Um einen Agentfluss oder -workflow im Designer anzuzeigen, öffnen Sie Copilot Studio, wählen Sie Flows aus, wählen Sie den Fluss aus, und wählen Sie dann die Registerkarte Build aus.

Um einen Agentfluss im Designer anzuzeigen, öffnen Sie Copilot Studio, wählen Sie Flows aus, wählen Sie den Fluss aus, und wählen Sie dann die Registerkarte Designer aus.

Legende:

1. Vergrößern: Erhöhen Sie die Größe des Workflows auf der Arbeitsfläche.
2. Verkleinern: Verringern Sie die Größe des Workflows auf der Leinwand.
3. Ansicht anpassen: Ändern Sie die Größe der Ansicht so, dass sie dem gesamten Workflow auf der Canvas entspricht.
4. Aufräumen: Organisieren Sie den Workflow und die Verzweigungen für eine übersichtlichere End-to-End-Ansicht.
5. Vertikales Layout: Wechseln sie zu einer vertikalen Layoutansicht des Workflows.

Legende:

1. Erweitern/reduzieren: Alle Aktionsgruppen erweitern oder reduzieren. Wenn eine Aktion beispielsweise mehrere Bedingungen hat, wählen Sie dieses Symbol aus, um die Details zu den Bedingungen anzuzeigen.
2. Vergrößern: Vergrößern Sie den Flow auf der Canvas.
3. Verkleinern: Verkleinern Sie den Flow auf der Canvas.
4. Ansicht einpassen: Passen Sie die Ansicht so an, dass der gesamte Flow auf den Canvas passt.
5. Minikarte: Zu einem bestimmten Abschnitt eines großen Flows navigieren.
6. Suche: Suchen Sie in Ihrem Flow nach einem Vorgang.

1. Wählen Sie auf der Karte, nach der Sie die Aktion hinzufügen möchten, "Schritt hinzufügen" aus. Der Bereich "Hinzufügen " wird geöffnet.

2. Beginnen Sie unter "Hinzufügen" mit der Eingabe der Aktion, die der Flow ausführen soll, oder des Connectors, den Sie hinzufügen möchten, und wählen Sie ihn dann aus der Liste aus. Abhängig von Ihrer Auswahl müssen Sie möglicherweise zusätzliche Informationen angeben, um die Aktion abzuschließen.

Wenn Sie feststellen, dass eine Aktion nicht benötigt wird, wählen Sie das Symbol "Löschen " in der oberen rechten Ecke der Aktion aus.

1. Wählen Sie unter der Karte, auf der Sie die Aktion hinzufügen möchten, eine neue Aktion einfügen aus. Der Bereich Aktion hinzufügen wird geöffnet.

2. Beginnen Sie unter Aktion hinzufügen mit der Eingabe der Aktion, die Ihr Flow ausführen soll, und wählen Sie sie dann aus der Liste aus. Abhängig von Ihrer Auswahl müssen Sie möglicherweise zusätzliche Informationen angeben, um die Aktion abzuschließen.

Wenn du festgestellt hast, dass eine Aktion nicht benötigt wird, wähle sie in deinem Flow aus und wähle dann die drei Punkte (⋮) >Löschen. Wählen Sie OK aus, um das Löschen zu bestätigen.

Um die Parameter für einen Trigger oder eine Aktion in Ihrem Workflow anzuzeigen, wählen Sie dessen Karte aus. Der Konfigurationsbereich wird auf der rechten Seite geöffnet. Um einen Wert für einen Parameter einzugeben, wählen Sie eine Option aus der Dropdownliste aus. Alternativ können Sie einen Ausdruck eingeben, um den Wert dynamisch festzulegen.

Wählen Sie die Karte aus, um die Einstellungen eines Triggers oder einer Aktion in Ihrem Agent-Flow anzuzeigen. Das Konfigurationsfenster wird geöffnet, wobei die Registerkarte Parameter standardmäßig angezeigt wird. Um einen Wert für einen Parameter einzugeben, wählen Sie eine Option aus der Dropdownliste aus. Alternativ können Sie einen Ausdruck eingeben, um den Wert dynamisch festzulegen.

Fehler in Workflowaktionen werden rot angezeigt. Um Details zu einem Fehler in einer Aktion anzuzeigen, wählen Sie den Fehler aus. Um alle Fehler im gesamten Ablauf aufzulisten, öffnen Sie das Banner des Sicherheitscenters. Um die Details er einzelnen Fehler anzuzeien, wählen Sie den Fehler aus.

Fehler in Agent-Flow-Aktionen werden rot angezeigt. Um Details zu einem Fehler in einer Aktion anzuzeigen, wählen Sie den Fehler aus. Um alle Fehler im gesamten Flow aufzulisten, wählen Sie im Menü oben in der Canvas die Option Flowprüfung aus. Um die Details er einzelnen Fehler anzuzeien, wählen Sie den Fehler aus. Alternativ können Sie Vorgang öffnen auswählen, um den Vorgang im Bereich Flow Checker zu öffnen und den Fehler zu beheben.

Mit Testläufen können Sie einen Schritt oder einen gesamten Ablauf überprüfen, ohne den Designer verlassen zu müssen. Dabei können Sie entweder echte Upstream-Daten, von Ihnen selbst modellierte Werte oder Ausgaben aus einer vorherigen Ausführung verwenden.

Es gibt zwei Möglichkeiten zum Ausführen eines Tests:

Beide Oberflächen basieren auf dem gleichen Konzept: Eingaben (real oder simuliert) bereitzustellen, auszuführen und dann das Ergebnis zu überprüfen.

Testen eines einzelnen Knotens in einem Workflow

Öffnen Sie eine beliebige Aktion oder einen Knoten in Ihrem Workflow, und wählen Sie die Schaltfläche "Wiedergeben" oder "Testen" aus. Drei Abschnitte stehen zur Verfügung:

1. Run-/Reset-Test: Führt den Schritt bei Bedarf aus oder setzt die aktuellen Eingaben und Ausgaben zurück.

   

2. Laden von Werten aus der vorherigen Ausführung: Eine Dropdownliste der letzten Ausführungen dieses Flows. Wenn Sie eine Option auswählen, werden die Ergebnisse der Vorlaufschritte aus diesem Lauf übernommen und in die unten stehenden Eingabefelder eingefügt.

3. Eingaben: Ein bearbeitbares Feld pro Upstreamschritt gibt die Knotenverweise aus. Das Abzeichen auf der rechten Seite jeder Zeile zeigt den erwarteten Typ des Felds an (Zeichenfolge, E-Mail, Datum-Uhrzeit, Zahl usw.).

4. Ausgabe: Das Liveergebnis des letzten Tests, formatiert für den Knotentyp (JSON, Eingabeaufforderungsergebnis, Connectorantwort usw.).

Simulierte Eingaben

Standardmäßig sind die Eingabefelder leer. Sie haben folgende Möglichkeiten:

• Geben Sie einen beliebigen Wert direkt in ein Feld ein. Das Feld akzeptiert den Typ, der auf dem rechten Abzeichen angezeigt wird.
• Lassen Sie ein Feld leer, wenn Ihr Schritt nicht davon abhängt.

Laden von Werten aus einer vorherigen Ausführung

Wenn ihr Fluss vorher ausgeführt wurde, können Sie echte Daten wiedergeben, anstatt ihn einzugeben:

1. Wählen Sie in der Dropdownliste " Laden von Werten aus der vorherigen Ausführung " eine Ausführung aus. Jeder Eintrag ist mit dem Datum/Zeitpunkt des Laufs und seinem Status bezeichnet (z. B. 24. Apr., 09:12 — Erfolgreich).

2. Der Designer ruft die Ergebnisse der Ausführungsschritte ab und projiziert sie durch das Eingabeschema Ihres Knotens. Übereinstimmende Werte werden in die Eingabefelder geschrieben.

3. Bearbeiten Sie anschließend ein beliebiges Feld, wenn Sie das Szenario optimieren möchten.

Im Dropdown-Menü werden die 10 neuesten Ausführungen eines beliebigen Status angezeigt. Wenn eine Ausführung keine Ausgaben für einen Ihrer Upstreamschritte enthält (da dieser Schritt übersprungen wurde oder der Pfad nicht ausgeführt wurde), werden nur die verfügbaren Felder ausgefüllt. Die restlichen Felder bleiben so, wie sie waren.

Wenn der Flow noch nicht ausgeführt wurde, wird Keine vorherigen Ausführungsläufe sind verfügbar angezeigt, und das Dropdown ist ausgeblendet.

Test ausführen

Wählen Sie "Test ausführen" aus. Die Schaltfläche zeigt einen Beschäftigt-Zustand an, während der Anruf ausgeführt wird. Der Ausgabebereich zeigt ein Ladesymbol, dann das Ergebnis oder einen Fehler an.

• Der Test zum Zurücksetzen löscht sowohl die Eingaben als auch die letzte Ausgabe.
• Der Test führt den Knoten isoliert gegenüber der API des Connectors aus. Der Test löst den Rest des Ablaufs nicht aus.

Testen des gesamten Flusses

Wählen Sie in der oberen Befehlsleiste die Wiedergabeschaltfläche (Test) aus. Der Test führt Ihren Flow End-to-End gegen die Live-Laufzeit aus.

Vor Beginn der Ausführung muss der Designer:

1. Speichert und veröffentlicht den Fluss, wenn Sie nicht gespeicherte Änderungen haben (oder wenn er das erste Mal ist).
2. Installiert alle neuen Verbindungen bei der ersten Ausführung.
3. Löst die Ausführung aus. Der Pfad hängt vom Triggertyp ab.

Testeingaben (manueller Auslöser)

Bei manuellen Triggern rendert das Dialogfeld " Manuelle Triggereingaben eingeben " ein Feld pro Eingabe, die Sie für den Trigger definiert haben:

• Text/Zahl/E-Mail/Datum: Entsprechendes Eingabefeld.
• Boolescher Wert: Umschaltknopf.
• Einzelauswahl (Aufzählung): Dropdown.
• Mehrfachauswahl: Dropdown-Menü für Mehrfachauswahl.
• Datei: Dateiauswahl (der Inhalt wird als Teil der Ausführung hochgeladen).
• Objekt/Array: Mehrzeiligen Textbereich, in den Sie JSON einfügen können.

Wählen Sie "Ausführen" aus, um den Fluss mit diesen Eingaben zu starten, oder "Abbrechen ", um den Vorgang ohne Ausführung zu schließen. Erforderliche Felder sind mit einem Sternchen gekennzeichnet. Wenn Werte fehlen oder ungültig sind, werden Inlineüberprüfungsmeldungen angezeigt, und die Ausführung wird blockiert, bis sie behoben sind.

Das Dialogfeld wird jedes Mal angezeigt, wenn Sie "Testen" auswählen. Werte werden nicht zwischen Ausführungsläufen gespeichert, sodass Sie schnell verschiedene Szenarien ausprobieren können.

Beobachten Sie den Lauf

Sobald sich eine Ausführung im Test-Flight befindet:

• In der Befehlsleiste wird eine Schaltfläche "Abbrechen " angezeigt, während die Ausführung aktiv ist.
• Im Bereich "Aktivität" (rechts) wird die aktuelle Ausführung oben mit einem Statussignal aufgelistet: "Running", "Waiting", "Succeeded", "Failed" oder "Canceled". Wählen Sie eine beliebige Ausführung aus, um sie auf der Canvas zu öffnen und die Eingaben und Ausgaben der einzelnen Schritte zu prüfen.

Vergangene Ausführungen auswählen

Der Aktivitätsbereich dient gleichzeitig als Ausführungsverlauf Ihres Workflows.

• Filtern nach Alle/Erfolgreich/Fehlgeschlagen/Laufend, mithilfe des Dropdown-Menüs oben.
• Wählen Sie "Aktualisieren" aus, um die Liste wieder zu löschen.
• Wählen Sie unten auf "Mehr laden", um weiter zurück zu blättern.
• Wenn Sie eine Ausführung auswählen, wird sie auf der Canvas geladen, wobei jeder Knoten die empfangenen Eingaben und die ausgaben anzeigt, die für diese Ausführung erstellt wurden. Die Daten sind identisch mit der Verwendung der Registerkarte "Test auf Knotenebene", wenn Sie eine Ausführung aus der Dropdownliste auswählen.

Wann sollten Sie jeden Testtyp verwenden?

• Iterieren Sie über einen einzelnen KI-Schritt oder eine Connector-Aktion?: Testen Sie diesen Knoten. Es ist schneller, wird nicht veröffentlicht, und Sie können nur die wichtigen Upstream-Werte simulieren.
• Validieren des End-to-End-Verhaltens oder der Triggerlogik?: Ausführen des Ablauftests. Es übt das gesamte Diagramm gegen die reale Laufzeit aus.
• Wiedergabe eines Produktionsproblems?: Öffnen Sie die fehlerhafte Ausführung aus dem Aktivitätsbereich, öffnen Sie dann den fehlerhaften Knoten, und verwenden Sie die Ladewerte aus der vorherigen Ausführung auf der Registerkarte "Test", um die genauen Upstreamdaten in der Aktion wiederzuverwenden.

Nur weil Ihr Fluss keine Fehler aufweist und veröffentlicht werden kann, bedeutet dies nicht, dass er die gewünschten Aktionen ausführt. Testen Sie nach der Veröffentlichung des Agentablaufs den Ablauf, um sicherzustellen, dass er wie erwartet funktioniert.

Sie können einen Test manuell oder automatisch durchführen. Nach den Testläufen können Sie die Ausgabe jeder Aktion überprüfen, um zu bestätigen, dass der Flow funktioniert.

1. Speichern und veröffentlichen Sie Ihren Flow.

2. Wählen Sie im Menü oben im Canvas Test aus. Der Bereich Testflow wird geöffnet.

3. Wählen Sie aus, ob der Test manuell oder automatisch erstellt wurde.

4. Wählen Sie im Fensterbereich Flow ausführen zuerst Test>und dann Flow ausführen aus. Ein grünes Häkchen zeigt an, dass der Flow erfolgreich ausgeführt wurde.

5. Wählen Sie Fertig.

Das Testen eines Agent-Flows im Designer verbraucht keine Kapazität von Copilot Studio.