Von einer JSON-Antwort zu einem zuverlässigen Workflow

Felder angeben, Struktur und Fakten validieren und unvollständige Ausgaben vor der Automatisierung behandeln.

Ein strukturiertes JSON-Objekt passiert einen Validierungs-Checkpoint in einen Workflow, während ein unvollständiges Fragment zurückgehalten wird.
Auf dieser Seite

Beginnen Sie mit dem empfangenden System

Bevor Sie ein Modell um JSON bitten, entscheiden Sie, was das nächste System benötigt. Wählen Sie Feldnamen, Typen, Pflichtfelder und eine Darstellung für fehlende Informationen. Ein vorhersehbares Objekt ist nur nützlich, wenn seine Bedeutung zur Aufgabe passt. Führen Sie ein kleines versioniertes Schema mit der konsumierenden Anwendung.

Fordern Sie eine explizite Struktur an

Wählen Sie JSON im Playground und beschreiben Sie die erwarteten Felder. Bitten Sie beispielsweise um eine summary-Zeichenkette, ein next_steps-Array aus Zeichenketten und ein missing_information-Array. Geben Sie an, dass das Ergebnis die bereitgestellte Quelle verwenden muss, nicht externe Vermutungen. Das folgende Objekt ist illustrativ, kein generiertes Modellergebnis.

Code
{
  "summary": "The launch date has not been supplied.",
  "next_steps": ["Confirm the owner and launch date."],
  "missing_information": ["owner", "launch_date"]
}

Validieren Sie Syntax, Struktur und Belege

Parsen Sie zuerst das JSON. Lehnen Sie dann unerwartete Typen, ausgelassene Pflichtfelder oder Zeichenketten jenseits Ihrer Geschäftsgrenzen ab. Prüfen Sie schließlich faktische Felder anhand der Quelle. Ein Schema validiert die Form eines Objekts; es kann nicht feststellen, ob ein Datum oder ein Verantwortlicher wahr ist. Bewahren Sie Quellkennungen auf, wenn der nächste Schritt Rückverfolgbarkeit benötigt.

FehlerBehebung
Ungültiges JSONEinmal mit der Parser-Fehlermeldung und der ursprünglichen Aufgabe wiederholen
Fehlendes FeldDie erforderliche Struktur anfordern oder einen Validierungsfehler zurückgeben
Nicht unterstützte TatsacheAls unbekannt markieren; Quellbeleg anfordern
Abgeschnittene AusgabeBudget erhöhen oder Extraktionsumfang reduzieren

Behandeln Sie unvollständige Ausgaben als unvollständig

Eine gestoppte Antwort kann mitten in einer Zeichenkette oder einem Objekt enden. Führen Sie sie nicht aus und reparieren Sie sie nicht stillschweigend zu einem selbstbewussten Ergebnis. Prüfen Sie in einer Provider-Integration den Abschlussstatus und behalten Sie den Fehler bei. Reasoning kann Ausgabetoken verbrauchen, kalkulieren Sie dies bei hohem Aufwand ein. Der API-Leitfaden erklärt die Antwortverarbeitung.

Setzen Sie eine Grenze vor Nebenwirkungen

Ein geparstes Objekt sollte nicht automatisch eine E-Mail senden, eine Bestellung ändern oder einen Befehl ausführen. Validieren Sie Berechtigungen und die Geschäftsaktion unabhängig voneinander. Verwenden Sie einen Genehmigungsschritt, wo Ihre Anwendung einen erfordert. Testen Sie negative Fälle – falsche Typen, unbekannte Kennungen, zusätzliche Felder und unterbrochene Streams – bevor Sie Automatisierung aktivieren. Lesen Sie den Tool-Calling-Abschnitt für die Verantwortung der Anwendung.

Versuchen Sie eine Aufgabe aus Ihrer eigenen Arbeit.

Nimm das Ausgangsmaterial und überprüfe das Ergebnis.

Arbeitsbereich öffnen