Claude Fable 5.2 Strukturierte Ausgaben: Zuverlässiges JSON generieren ohne erzwungene Tool-Nutzung
Generieren Sie schema-konformes JSON und zuverlässige Tool-Parameter mit Claude Fable 5.2 unter Verwendung von JSON-Ausgaben, strenger Tool-Nutzung und lokaler semantischer Validierung

Claude Fable 5.2 unterstützt keine erzwungene Tool-Auswahl mit tool_choice auf any oder einem benannten tool gesetzt; diese Konfigurationen geben einen 400-Fehler zurück. Das verhindert keine zuverlässige Automatisierung. Verwenden Sie die richtige Funktion für den Vertrag, den Sie benötigen:
- JSON-Ausgaben schränken die endgültige Antwort des Modells ein.
- Strenge Werkzeugnutzung validiert den Namen und die Eingabe jedes Werkzeugaufrufs, den Claude auszuführen wählt.
- Verwenden Sie beide, wenn ein Agent zuverlässige Funktionsparameter und ein strukturiertes Endergebnis benötigt.
Die Gültigkeit eines Schemas ist keine faktische oder geschäftliche Gültigkeit. Ihre Anwendung muss dennoch Berechtigungen, Kennungen, Daten, Summen und die Zulässigkeit einer Aktion überprüfen.
Option 1: JSON-Ausgaben
Verwende output_config.format, wenn die Antwort selbst einem JSON-Schema folgen muss.
from anthropic import Anthropic
client = Anthropic()
schema = {
"type": "object",
"properties": {
"risk_level": {
"type": "string",
"enum": ["niedrig", "mittel", "hoch"]
},
"Ergebnisse": {
"type": "array",
"items": {
"type": "object",
"Eigenschaften": {
"claim": {"type": "string"},
"source": {"type": "string"}
},
"erforderlich": ["Anspruch", "Quelle"],
"additionalProperties": False
}
}
},
"erforderlich": ["risk_level", "Ergebnisse"],
"additionalProperties": False
}
= client.messages.create(
model="claude-fable-5-2",
max_tokens=4096,
messages=[{
"role": "Benutzer",
"content": "Bewerten Sie das bereitgestellte Änderungsprotokoll und führen Sie Belege für jede Feststellung an."
}],
output_config={
"format": {
"type": "json_schema",
"schema": schema
}
}
)
Das aktuelle Produktionsfeld ist output_config.format. Ältere Beta-Beispiele verwenden möglicherweise output_format; aktualisieren Sie das SDK und die Anfragestruktur, anstatt Übergangscode zu kopieren.
Option 2: Strikte Werkzeugnutzung
Setze strict: true in einer Tool-Definition, um sicherzustellen, dass die Tool-Eingaben mit dem Schema übereinstimmen, wenn Claude das Tool aufruft. Behalte tool_choice bei auto.
tools = [{
"name": "create_review_ticket",
"description": "Erstelle ein Überprüfungs-Ticket erst, nachdem der Benutzer zugestimmt hat.",
"strict": True,
"input_schema": {
"type": "object",
"Eigenschaften": {
"title": {"type": "string"},
"severity": {
"type": "string",
"enum": ["niedrig", "mittel", "hoch"]
},
"evidence_ids": {
"type": "array",
"items": {"type": "string"}
}
},
"erforderlich": ["Titel", "Schweregrad", "evidence_ids"],
"additionalProperties": False
}
}]
Strenge garantiert Form, nicht Autorisierung. Der Server muss weiterhin bestätigen, dass der Benutzer die Aktion genehmigt hat und dass jede Beweis-ID existiert.
Simulieren Sie erzwungene Werkzeugnutzung nicht leichtfertig
Wenn ein bestimmtes Werkzeug für den aktuellen Zug benötigt wird, weisen Sie das Modell klar an und nutzen Sie, wo verfügbar, unterstützte Systemanweisungen während des Gesprächs. Ihre Orchestrierungsschicht sollte dann überprüfen, ob der erwartete Aufruf erfolgt ist. Führen Sie keinen Freitext als Fallback aus.
Wenn die tatsächliche Anforderung "gültiges JSON zurückgeben" lautet, verwenden Sie JSON-Ausgaben anstatt ein gefälschtes Tool zu erfinden.
Entwurfsschemata für Modell- und Anwendungszuverlässigkeit
Halte das Schema schmal
Verwende aussagekräftige Enums, erforderliche Felder und additionalProperties: false. Vermeide ein universelles „Metadaten“-Objekt, das beliebige Inhalte verbergen kann.
Beweise von Schlussfolgerungen trennen
Erfordern Sie Quellenkennungen oder Auszüge neben den Ergebnissen. Ein gültiger high-Wert wird weiterhin nicht unterstützt, wenn keine Belege beigefügt sind.
Unsicherheit explizit darstellen
Verwenden Sie Felder wie status: confirmed | inferred | unresolved anstatt unsichere Beweise in einen definitiven Boolean zu zwingen.
Semantik nach dem Parsen validieren
Überprüfen Sie Bereiche, Datenbankexistenz, Berechtigungen, Währungskonsistenz und feldübergreifende Regeln im Anwendungscode. Die aktuelle Unterstützung für strukturierte Ausgaben weist JSON-Schema-Einschränkungen auf, darunter keine rekursiven Schemata und eingeschränkte numerische, Zeichenfolgen-, Array- und Regex-Einschränkungen.
Caching und Token-Überlegungen
Structured Outputs fügen Formatierungsanweisungen in den System-Prompt ein, was die Eingabe-Token geringfügig erhöht. Eine Änderung von output_config.format macht den Prompt-Cache für diese Konversation ungültig. Versionieren Sie Schemata und vermeiden Sie es, für jede Anfrage ein leicht abweichendes Schema zu generieren.
Einschränkung des Verschlüsselungsschlüssels
Anthropic dokumentiert, dass Organisationen, die kundenverwaltete Verschlüsselungsschlüssel verwenden, Structured Outputs mit Claude Fable 5.2 oder Mythos 5.2 nicht nutzen können. Das umfasst JSON-Ausgaben und strikte Tool-Nutzung. Verwenden Sie in dieser Konfiguration die automatische Tool-Auswahl, lassen Sie strict weg, validieren Sie Eingaben lokal und entwerfen Sie einen sicheren Wiederholungs- oder Reparaturpfad.
Fehlerbehandlungsstrategie
- Validieren Sie das Schema, bevor Sie es senden.
- Behandeln Sie nicht unterstützte Schemafunktionen als Entwicklungsfehler, nicht als vorübergehende Fehler.
- Analysieren Sie die Antwort erst, nachdem Sie das API-Ergebnis überprüft haben.
- Validieren Sie Geschäftsregeln lokal.
- Führen Sie ein Tool niemals allein aufgrund des geparsten JSON aus.
- Log-Schemaversion und Anfrage-ID.
Häufig gestellte Fragen
Warum tool_choice: {"type":"Werkzeug"} Fehler bei Fable 5.2?
Erzwungene tool- und any-Auswahlen werden nicht unterstützt. Verwenden Sie auto mit strenger Tool-Nutzung, JSON-Ausgaben oder unterstützten Orchestrierungsanweisungen.
Bedeutet gültiges JSON, dass die Antwort korrekt ist?
Nein. Es garantiert Format, nicht Wahrheit, Beweise, Autorisierung oder sicheres Geschäftsverhalten.
Können JSON-Ausgaben und strenge Tools zusammen verwendet werden?
Ja, wo die Kontokonfiguration strukturierte Ausgaben unterstützt. Sie steuern verschiedene Teile der Interaktion.


















































































































