Copilot Studio Friction
Flow schlägt mit "FlowActionBadRequest" fehl
Zuletzt verifiziert
Details & Verwandtes
Einschätzung
- Vertrauensstufe
- Offiziell bestätigtDurch Microsoft-Dokumentation oder eine offizielle Aussage bestätigt.
- Schweregrad
- Blockierend
- Typischer Zeitverlust
- Stunden
Identifikation
Verifikation & Änderungen
Verifiziert
Doku-Check durch Mensch: Official troubleshooting article, CAT blog post and input/output doc re-read during seed migration; causes and refresh fix still documented.
Änderung
Vorläufig durch den Product Owner freigegeben; externe LLM-Qualitätsprüfung ausstehend.
Änderung
Erster Eintrag aus dem Seed-Dossier erstellt (Migrationswelle 1).
Verwandt
- Ihr Flow erscheint nicht als Tool im Agent Eintrag
- «No output was received from flow» — Ausgaben treffen nie ein Eintrag
- Agent-Flow schlägt nach etwa 100 Sekunden mit FlowActionTimedOut fehl Eintrag
- Teams antwortet nach dem Veröffentlichen mit einer alten Version Ihres Agents Eintrag
- Disziplin bei Parse value Pattern
Automatisch übersetzte Fassung — massgeblich ist das englische Original.
Sind Sie hier richtig?
- Ihr Agent ruft einen Agent-Flow auf, und der Aufruf schlägt sofort mit
FlowActionBadRequestfehl. - Der Fehler begann, nachdem Sie die Eingaben oder Ausgaben des Flows geändert haben.
- Oder der Aufruf funktioniert im Testbereich (Test your agent), schlägt aber in Teams weiterhin fehl.
- Der Flow läuft einwandfrei, wenn Sie ihn direkt in Power Automate testen.
Falls der Flow stattdessen nach etwa 100 Sekunden fehlschlägt → siehe Agent-Flow schlägt mit FlowActionTimedOut fehl. Falls der Flow stattdessen läuft, aber keine Ausgaben eintreffen → siehe „No output was received from flow". Falls der Flow stattdessen nie als Tool erscheint → siehe Ihr Flow erscheint nicht als Tool.
Was passiert
Ursache 1: Der Aufruf entspricht nicht mehr dem Vertrag des Flows. Wenn Sie einen Flow hinzufügen, speichert Copilot Studio eine Kopie seiner Eingaben und Ausgaben. Ändern Sie den Flow später, ruft der Agent weiterhin die alte Form auf — der Flow lehnt die Anfrage ab. Es ist wie eine Bestellung mit dem Bestellformular vom letzten Jahr: Die Felder haben sich verschoben, deshalb weist das Lager den Beleg zurück. Nicht unterstützte Typen verursachen dieselbe Ablehnung: Agent-Flows akzeptieren nur Text, Boolean und Number. Eine leer gelassene Eingabe (ein „null"-Wert) kann den Fehler ebenfalls auslösen.
Ursache 2: Teams spielt einen veralteten Konversationsstatus erneut ab. Teams speichert manchmal einen alten Status der Agent-Konversation zwischen. Der Fehler bleibt dann bestehen, selbst nachdem Sie alles korrekt behoben und aktualisiert haben.
Für Technikerinnen und Techniker
Es gibt keine automatische Erkennung von Schemaabweichungen; die Aktualisierung ist ein manueller, obligatorischer Schritt nach jeder Eingabe-/Ausgabeänderung. Die Typbeschränkung bedeutet, dass jeder strukturierte Wert (Liste, Datensatz, JSON) als serialisierte Zeichenfolge übertragen wird. Die empfangende Seite muss ihn zurück parsen, typischerweise mit einem Parse value-Knoten im Thema.
So beheben Sie es
Lösung 1
Offizieller FixTool-Konfiguration im Thema aktualisieren
- Öffnen Sie Ihren Agent in Copilot Studio.
- Öffnen Sie das Thema, das den Flow aufruft.
- Wählen Sie das Menü „…" (Auslassungspunkte) am Tool-Knoten des Flows aus.
- Wählen Sie „Refresh" aus.
✅ Sie sollten jetzt sehen: Die Eingaben und Ausgaben des Knotens entsprechen der aktuellen Definition des Flows.
- Vergleichen Sie jede Eingabe und Ausgabe einzeln mit dem Flow.
- Speichern Sie das Thema.
- Veröffentlichen Sie den Agent.
Lösung 2
Offizieller WorkaroundNicht unterstützte Eingabewerte konvertieren
- Öffnen Sie die Eingabeparameter des Flows im Flow-Designer.
- Prüfen Sie den Typ jedes Parameters: Nur „Text", „Boolean" und „Number" funktionieren.
- Konvertieren Sie Listen, Datensätze oder JSON in einen Textwert, bevor Sie sie übergeben.
- Stellen Sie sicher, dass jede Eingabe zur Laufzeit einen Wert erhält — übergeben Sie nie eine leere Eingabe.
✅ Sie sollten jetzt sehen: Der Aufruf trägt nur unterstützte, ausgefüllte Werte.
Lösung 3
Offizieller WorkaroundZwischengespeicherten Konversationsstatus in Teams löschen
- Öffnen Sie die Konversation mit Ihrem Agent in Teams.
- Geben Sie „start over" ein.
- Wenn der Fehler weiterhin besteht, geben Sie „goodbye" ein, um die Konversation zu beenden.
- Stellen Sie Ihre Frage in einer neuen Konversation erneut.
✅ Sie sollten jetzt sehen: Der Flow-Aufruf gelingt gegen die aktualisierte Konfiguration.
Prüfen, ob es funktioniert hat
Lösen Sie den Flow über den Agent im veröffentlichten Kanal aus, den Ihre Nutzer verwenden, mit realistischen Werten für jede Eingabe.
Erwartet: kein FlowActionBadRequest, und der Ausführungsverlauf von Power Automate zeigt eine erfolgreiche Ausführung.
Falls es nicht funktioniert hat
- Der Kanal führt weiterhin Ihre alte Agent-Version aus. Verzögerung bei Veröffentlichung und Verteilung ist Verdächtiger Nummer eins. Siehe Teams antwortet mit einer alten Version.
- Sie haben den Flow nach der Aktualisierung erneut geändert. Jede Eingabe-/Ausgabeänderung erfordert eine erneute Aktualisierung. Wiederholen Sie den Aktualisierungsvorgang.
- Ein komplexes Objekt rutscht weiterhin durch. Prüfen Sie jede Eingabe erneut; Listen und Datensätze müssen als serialisierter Text übertragen werden.
- Eine Eingabe ist zur Laufzeit leer. Verfolgen Sie, welche Variable sie füllt, und geben Sie ihr einen Fallback-Wert.
So verhindern Sie es künftig
- Behandeln Sie jede Eingabe-/Ausgabeänderung eines Flows als unfertig, bis Sie die Tool-Konfiguration im Thema aktualisiert haben.
- Beschränken Sie Flow-Parameter auf Text, Boolean und Number. Übergeben Sie Struktur als serialisierten Text — siehe das Pattern Parse-value-Disziplin.
- Testen Sie nach jeder Änderung in einer neuen Teams-Konversation erneut, nie in einer alten.
Belege
Offizielle Dokumentationlearn.microsoft.com
Der offizielle Artikel zur Fehlerbehebung nennt Null-Eingabewerte und einen zwischengespeicherten Teams-Konversationsstatus als Auslöser, die durch Eingabe von 'start over' bereinigt werden.
Microsoft-Aussagemicrosoft.github.io
Das CAT-Team von Microsoft bezeichnet FlowActionBadRequest als häufigsten Laufzeitfehler und führt ihn auf eine Schemaabweichung nach Eingabe-/Ausgabeänderungen ohne Tool-Aktualisierung zurück.
Offizielle Dokumentationlearn.microsoft.com
Die offizielle Doku beschränkt die Eingabe- und Ausgabeparameter von Agent-Flows auf die Typen Text, Boolean und Number.