Pattern
Variablenhygiene für Tool-Ergebnisse
Ganze Tool-Ergebnisobjekte werden in Variablen gespeichert, wodurch Metadaten-JSON an Endnutzer gelangt und der Konversationsstatus aufgebläht wird, bis harte Grenzwerte erreicht sind.
Zuletzt geprüft 8. Juli 2026
Automatisch übersetzte Fassung — massgeblich ist das englische Original.
Das Pattern
Geben Sie nie ein ganzes Tool-Ergebnisobjekt weiter.
Speichern Sie nur die benötigte Eigenschaft, zum Beispiel toolResult.responseText, in einer Thema-Variablen.
Richten Sie Nachrichtenknoten auf diese Textvariable aus, nie auf das vollständige Objekt.
Spätere Themen erben, was Sie gespeichert haben, und ein vollständiges Objekt schleppt sein Metadaten-JSON mit.
So bleibt internes JSON von den Nutzern fern und der Konversationsstatus klein.
Wann Sie es einsetzen
- Jedes Mal, wenn ein Tool, ein Connector oder ein Flow ein Objekt zurückgibt und Sie das Ergebnis speichern.
- Wenn Nutzer nach der Veröffentlichung rohes JSON wie
{\"explanation_of_tool_call\": …}sehen. - Wenn Sie auf "Conversation state size exceeds the maximum allowed limit" stossen.
- Wenn ein Kanal Nachrichten als zu gross ablehnt, etwa beim 256-KB-Limit von Direct Line.
Schritte
- Fügen Sie nach der Tool- oder Connector-Aktion einen Knoten "Set variable value" hinzu.
- Speichern Sie nur die lesbare Eigenschaft, zum Beispiel
toolResult.responseText, in einer Themenvariablen. - Richten Sie den Nachrichtenknoten auf diese Textvariable aus, nicht auf das Tool-Objekt.
- Wiederholen Sie dies in jedem Thema, das Tool-Ergebnisse berührt; spätere Themen erben gespeicherte Objekte.
- Halten Sie grosse Datenmengen aus Variablen heraus; speichern und holen Sie sie stattdessen über einen Agent-Flow.
- Übergeben Sie einzelne Eigenschaften zwischen Themen, nie ganze Objekte oder Kartennutzlasten.