Claude Fable 5.2 Output Strutturati: Genera JSON Affidabile Senza Uso Forzato di Strumenti
Genera JSON valido per schema e parametri affidabili per strumenti con Claude Fable 5.2 utilizzando output JSON, uso rigoroso degli strumenti e validazione semantica locale

Claude Fable 5.2 non supporta la scelta forzata dello strumento con tool_choice impostato su any o su uno strumento nominato; tali configurazioni restituiscono un errore 400. Ciò non impedisce un'automazione affidabile. Utilizza la funzionalità giusta per il contratto di cui hai bisogno:
- Output JSON vincolano la risposta finale del modello.
- Uso rigoroso degli strumenti convalida il nome e l'input di qualsiasi chiamata a strumenti che Claude sceglie di effettuare.
- Utilizzare entrambi quando un agente necessita di parametri di funzione affidabili e di un risultato finale strutturato.
La validità dello schema non è validità fattuale o commerciale. La tua applicazione deve comunque verificare permessi, identificatori, date, totali e se un'azione è consentita.
Opzione 1: Output JSON
Usa output_config.format quando la risposta stessa deve seguire uno schema JSON.
from anthropic import Anthropic
client = Anthropic()
schema = {
"type": "object",
"properties": {
"risk_level": {
"type": "string",
"enum": ["basso", "medio", "alto"]
},
"risultati": {
"type": "array",
"elementi": {
"type": "object",
"properties": {
"claim": {"type": "string"},
"source": {"type": "string"}
},
"richiesto": ["reclamo", "fonte"],
"additionalProperties": False
}
}
},
"richiesto": ["risk_level", "risultati"],
"additionalProperties": False
}
= client.messages.create(
model="claude-fable-5-2",
max_tokens=4096,
messages=[{
"role": "utente",
"content": "Valuta il changelog fornito e cita le prove per ogni riscontro."
}],
output_config={
"formato": {
"type": "json_schema",
"schema": schema
}
}
)
Il campo di produzione corrente è output_config.format. Esempi beta più vecchi potrebbero utilizzare output_format; aggiorna l'SDK e la forma della richiesta invece di copiare codice transitorio.
Opzione 2: uso rigoroso degli strumenti
Imposta strict: true su una definizione di strumento per garantire che gli input dello strumento corrispondano al suo schema quando Claude chiama lo strumento. Mantieni tool_choice su auto.
tools = [{
"name": "create_review_ticket",
"description": "Crea un ticket di revisione solo dopo che l'utente ha approvato.",
"strict": True,
"input_schema": {
"type": "object",
"properties": {
"title": {"type": "string"},
"severity": {
"type": "string",
"enum": ["basso", "medio", "alto"]
},
"evidence_ids": {
"type": "array",
"items": {"type": "string"}
}
},
"richiesto": ["titolo", "gravità", "evidence_ids"],
"additionalProperties": False
}
}]
La rigidità garantisce la forma, non l'autorizzazione. Il server deve comunque confermare che l'utente ha approvato l'azione e che ogni ID di prova esiste.
Non simulare con leggerezza l'uso forzato degli strumenti
Se per il turno corrente è richiesto uno strumento specifico, istruisci chiaramente il modello e utilizza, dove disponibile, le indicazioni di sistema supportate durante la conversazione. Il tuo livello di orchestrazione dovrebbe quindi verificare che la chiamata prevista sia avvenuta. Non eseguire testo libero come soluzione di ripiego.
Se il vero requisito è "restituire JSON valido", usa output JSON invece di inventare uno strumento fittizio.
Progettare schemi per l'affidabilità del modello e dell'applicazione
Mantieni lo schema ristretto
Usa enumerazioni significative, campi obbligatori e additionalProperties: false. Evita un oggetto "metadata" universale che possa nascondere contenuti arbitrari.
Separare le prove dalle conclusioni
Richiedi identificatori di fonte o estratti insieme ai risultati. Un valore high valido è ancora non supportato se non è accompagnato da prove.
Rappresenta l'incertezza in modo esplicito
Utilizza campi come status: confirmed | inferred | unresolved invece di forzare prove incerte in un booleano definitivo.
Convalida la semantica dopo l'analisi
Verifica intervalli, esistenza del database, permessi, coerenza valutaria e regole tra campi nel codice dell'applicazione. Il supporto attuale per Output Strutturati presenta limitazioni dello Schema JSON, tra cui nessuno schema ricorsivo e vincoli numerici, di stringa, array e regex limitati.
Considerazioni sulla cache e sui token
Gli Output Strutturati iniettano indicazioni sul formato nel prompt di sistema, aumentando leggermente i token di input. Modificare output_config.format invalida la cache del prompt per quella conversazione. Versiona gli schemi ed evita di generare uno schema leggermente diverso per ogni richiesta.
Limitazione della chiave di crittografia
Anthropic documenta che le organizzazioni che utilizzano chiavi di crittografia gestite dal cliente non possono utilizzare Output Strutturati con Claude Fable 5.2 o Mythos 5.2. Ciò include output JSON e uso rigoroso degli strumenti. In tale configurazione, utilizzare la scelta automatica dello strumento, omettere strict, convalidare gli input localmente e progettare un percorso sicuro di riprova o riparazione.
Strategia di gestione degli errori
- Convalida lo schema prima di inviarlo.
- Tratta le funzionalità dello schema non supportate come errori di sviluppo, non come guasti transitori.
- Analizza la risposta solo dopo aver verificato il risultato dell'API.
- Convalida le regole aziendali localmente.
- Non eseguire mai uno strumento solo perché il JSON è stato analizzato.
- Versione dello schema di log e ID della richiesta.
Domande frequenti
Perché tool_choice: {"type":"strumento"} fallire su Fable 5.2?
Le scelte forzate tool e any non sono supportate. Utilizza auto con uso rigoroso degli strumenti, output JSON o istruzioni di orchestrazione supportate.
Un JSON valido significa che la risposta è corretta?
No. Garantisce il formato, non la verità, le prove, l'autorizzazione o un comportamento commerciale sicuro.
È possibile utilizzare insieme output JSON e strumenti rigorosi?
Sì, dove la configurazione dell'account supporta Output Strutturati. Controllano diverse parti dell'interazione.

















































































































