Copilot Studio Friction
Chat zeigt rohes JSON statt einer Antwort
Zuletzt verifiziert
Details & Verwandtes
Einschätzung
- Vertrauensstufe
- Offiziell bestätigtDurch Microsoft-Dokumentation oder eine offizielle Aussage bestätigt.
- Schweregrad
- Beeinträchtigend
- Typischer Zeitverlust
- Stunden
Identifikation
Verifikation & Änderungen
Verifiziert
Doku-Check durch Mensch: Official HTTP-node and list-of-results docs plus practitioner tutorial re-read during seed migration; parse requirement 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).
Automatisch übersetzte Fassung — massgeblich ist das englische Original.
Sind Sie hier richtig?
- Ihr Agent ruft ein Tool, einen Connector, eine HTTP-Anforderung oder einen Flow auf.
- Der Chat zeigt das Ergebnis als rohes JSON, mit geschweiften Klammern, Anführungszeichen und Feldnamen.
- Die Daten innerhalb des JSON sind korrekt — sie sind nur unlesbar.
- Oder: Das Parsen hat vorher funktioniert und schlägt jetzt fehl, obwohl Sie nichts geändert haben.
Falls Benutzer nur in der Produktion {"explanation_of_tool_call": …} sehen → siehe Raw explanation_of_tool_call JSON visible.
Dieses JSON sind Orchestrator-Metadaten, kein Tool-Ergebnis.
Falls ein Prompt mit "A JSON could not be generated. Edit your prompt instruction…" fehlschlägt → siehe "A JSON could not be generated".
Falls die Ausgabe des Flows gar nicht ankommt → siehe "No output was received from flow".
Was passiert
Ursache 1: Das Ergebnis wurde nie geparst. Tools, Connectors, HTTP-Anforderungen und Flows geben Ergebnisse als reinen Text zurück. Copilot Studio wandelt diesen Text nicht von allein in Felder um. Wenn ein Nachrichtenknoten die rohe Variable anzeigt, sehen Benutzer das JSON unverändert. Stellen Sie sich einen Brief vor, der noch im Umschlag ankommt: Der Inhalt ist da, aber niemand hat ihn geöffnet. Ein Parse value-Knoten öffnet den Umschlag und wandelt den Text in benannte Felder um.
Ursache 2: Das Parsen ist nach einer vorgelagerten API-Änderung kaputtgegangen. Das Schema des Knotens stammt aus einem eingefügten Beispiel. Dieses Beispielschema ist eingefroren; es aktualisiert sich nie selbst. Wenn die API hinter dem Tool ihre Struktur ändert, bricht das Parsen stillschweigend ab. Sie haben nichts geändert — und der Chat fällt auf rohe oder fehlerhafte Ausgabe zurück.
Für Techniker
Die Fehlerantwort-Variable des HTTP-Anforderungsknotens hat den Datentyp Any und benötigt vor der Verwendung Parse value. Flow-Ausgaben kommen als Zeichenfolgen an; um sie als Frageoptionen zu verwenden, muss das JSON zuerst in eine Tabelle geparst werden. Selbst das Ergebnislisten-Tutorial von Microsoft selbst fügt einen Parse JSON-Schritt mit einem manuell eingefügten Schema ein. Das aus einem Beispiel abgeleitete Schema friert eine Strukturmomentaufnahme der vorgelagerten API ein. Es gibt keinen Schema-Drift-Alarm; eine vorgelagerte Änderung zeigt sich nur als fehlerhafte Ausgabe im Chat.
So beheben Sie es
Lösung 1
Offizieller WorkaroundEinen Parse value-Knoten direkt nach der Aktion hinzufügen
- Führen Sie das Tool oder die Aktion einmal aus und kopieren Sie das rohe JSON aus dem Chat.
- Öffnen Sie das Thema, das die Aktion aufruft.
- Wählen Sie "+" direkt nach dem Aktionsknoten aus.
- Wählen Sie "Variablenverwaltung" → "Parse value" aus.
- Wählen Sie im Knoten die Ausgabevariable der Aktion als zu parsenden Wert aus.
- Setzen Sie den Datentyp auf "From sample data".
- Wählen Sie "Get schema from sample JSON" aus und fügen Sie das kopierte Beispiel ein.
- Speichern Sie das geparste Ergebnis in einer neuen Variablen.
- Richten Sie Ihren Nachrichtenknoten auf die geparsten Felder aus, nicht auf die rohe Variable.
✅ Sie sollten jetzt sehen: lesbare Felder im Chat anstelle von rohem JSON.
Lösung 2
Community-WorkaroundDas Beispielschema nach einer vorgelagerten Änderung erneut abrufen
Verwenden Sie dies, wenn das Parsen vorher funktioniert hat und ohne Änderung Ihrerseits kaputtgegangen ist.
- Rufen Sie die API oder den Flow einmal ausserhalb des Agents auf und kopieren Sie ein frisches Antwortbeispiel.
- Öffnen Sie den bestehenden "Parse value"-Knoten.
- Wählen Sie erneut "Get schema from sample JSON" aus.
- Fügen Sie das frische Beispiel ein und bestätigen Sie das abgeleitete Schema.
- Prüfen Sie jeden späteren Knoten, der die geparsten Felder liest; umbenannte Felder müssen neu zugeordnet werden.
✅ Sie sollten jetzt sehen: geparste Felder, die wieder mit aktuellen Daten gefüllt sind.
Prüfen, ob es funktioniert hat
Lösen Sie das Tool einmal im Testbereich (Test your agent) und einmal in Ihrem veröffentlichten Kanal aus. Erwartet: Die Antwort zeigt lesbaren Text, ohne geschweifte Klammern, eckige Klammern oder Feldnamen.
Falls es nicht funktioniert hat
- Die vorgelagerte API hat sich geändert. Dies ist der häufigste Rückfall. Das eingefrorene Beispielschema entspricht nicht mehr der Realität. Rufen Sie das Schema aus einem frischen Beispiel erneut ab, wie in der zweiten Lösung.
- Sie haben die falsche Variable geparst. Prüfen Sie, ob der Parse value-Knoten die Ausgabe der Aktion liest und nicht eine andere Variable.
- Das Beispiel war unvollständig. Ein Beispiel, dem optionale Felder fehlen, leitet ein Schema ohne diese ab. Erfassen Sie ein Beispiel aus einer Antwort, die jedes Feld enthält, das Sie benötigen.
- Der Kanal führt noch Ihre alte Agent-Version aus. Veröffentlichen und Verzögerung bei der Verbreitung sind Verdächtiger Nummer eins. Siehe Teams answers with an old version of your agent.
So verhindern Sie es künftig
- Befolgen Sie die Parse value-Disziplin: ein Parse value-Knoten nach jedem Tool, jedem Connector oder jeder HTTP-Aktion.
- Behandeln Sie jede vorgelagerte API-Änderung als Auslöser für eine Schema-Überprüfung; rufen Sie das Beispiel erneut ab, bevor Benutzer fehlerhafte Ausgabe sehen.
- Notieren Sie neben dem Thema, aus welcher API-Version jedes Beispiel stammt.
Belege
Offizielle Dokumentationlearn.microsoft.com
Die Fehlerantwort-Variable des HTTP-Anforderungsknotens hat den Datentyp Any und muss mit einem Parse value-Knoten konvertiert werden, bevor sie verwendet werden kann.
Offizielle Dokumentationlearn.microsoft.com
Selbst das Ergebnislisten-Tutorial von Microsoft selbst erfordert einen Parse JSON-Schritt mit einem manuell eingefügten Schema, bevor Flow-Daten nutzbar werden.
MVP-Blogippu-biz.com
Ein Connector liefert korrekte Daten, aber der Chat zeigt rohes JSON, bis nach der Aktion ein Parse value-Knoten mit einem aus einem Beispiel abgeleiteten Schema hinzugefügt wird.