Claude Fable 5.2 Salidas Estructuradas: Genera JSON Confiable Sin Uso Forzado de Herramientas
Genera JSON válido según esquema y parámetros de herramientas fiables con Claude Fable 5.2 usando salidas JSON, uso estricto de herramientas y validación semántica local

Claude Fable 5.2 no admite la selección forzada de herramientas con tool_choice configurado como any o una tool nombrada; esas configuraciones devuelven un error 400. Eso no impide una automatización confiable. Usa la función correcta para el contrato que necesitas:
- Las salidas JSON restringen la respuesta final del modelo.
- Uso estricto de herramientas valida el nombre y la entrada de cualquier llamada a herramienta que Claude decida realizar.
- Utilice ambos cuando un agente necesite parámetros de función confiables y un resultado final estructurado.
La validez del esquema no es validez fáctica o empresarial. Su aplicación aún debe verificar permisos, identificadores, fechas, totales y si una acción está permitida.
Opción 1: Salidas JSON
Usa output_config.format cuando la respuesta en sí misma deba seguir un esquema JSON.
from anthropic import Anthropic
client = Anthropic()
schema = { "type": "object", "propiedades": { "risk_level": { "type": "string", "enum": ["bajo", "mediano", "alto"] }, "hallazgos": { "type": "array", "items": { "type": "object", "propiedades": { "claim": {"type": "string"}, "source": {"type": "string"} }, "requerido": ["reclamar", "fuente"], "additionalProperties": False } } }, "requerido": ["risk_level", "hallazgos"], "additionalProperties": False }
= client.messages.create( model="claude-fable-5-2", max_tokens=4096, messages=[{ "role": "usuario", "content": "Evalúa el registro de cambios proporcionado y cita evidencia para cada hallazgo." }], output_config={ "formato": { "type": "json_schema", "schema": esquema } } )
El campo de producción actual es `output_config.format`. Los ejemplos beta antiguos pueden usar `output_format`; actualiza el SDK y la forma de la solicitud en lugar de copiar código de transición.
## Opción 2: uso estricto de herramientas
Establece `strict: true` en una definición de herramienta para garantizar que las entradas de la herramienta coincidan con su esquema cuando Claude la llame. Mantén `tool_choice` en `auto`.
```python
tools = [{
"name": "create_review_ticket",
"description": "Crea un ticket de revisión solo después de que el usuario lo apruebe.",
"strict": True,
"input_schema": {
"type": "object",
"propiedades": {
"title": {"type": "string"},
"severity": {
"type": "string",
"enum": ["bajo", "mediano", "alto"]
},
"evidence_ids": {
"type": "array",
"items": {"type": "string"}
}
},
"requerido": ["título", "gravedad", "evidence_ids"],
"additionalProperties": False
}
}]
La rigurosidad garantiza la forma, no la autorización. El servidor aún debe confirmar que el usuario aprobó la acción y que cada ID de evidencia existe.
No simules el uso forzado de herramientas sin cuidado
Si se requiere una herramienta específica para el turno actual, indíquelo claramente al modelo y utilice la guía del sistema de medioconversación compatible cuando esté disponible. Su capa de orquestación debe verificar entonces que se haya realizado la llamada esperada. No ejecute texto de formato libre como alternativa.
Si el requisito real es "devolver JSON válido", usa salidas JSON en lugar de inventar una herramienta falsa.
Diseñar esquemas para la fiabilidad del modelo y la aplicación
Mantén el esquema reducido
Usa enumeraciones significativas, campos obligatorios y additionalProperties: false. Evita un objeto "metadata" universal que pueda ocultar contenido arbitrario.
Separar la evidencia de las conclusiones
Requerir identificadores de fuente o extractos junto con los hallazgos. Un valor high válido aún no es compatible si no va acompañado de evidencia.
Representar la incertidumbre explícitamente
Usa campos como status: confirmed | inferred | unresolved en lugar de forzar evidencia incierta en un booleano definitivo.
Validar semántica después del análisis
Verifique rangos, existencia de base de datos, permisos, consistencia de moneda y reglas entre campos en el código de la aplicación. El soporte actual de Structured Outputs tiene limitaciones de JSON Schema, incluyendo la ausencia de esquemas recursivos y restricciones numéricas, de cadenas, de arreglos y de expresiones regulares.
Consideraciones sobre el almacenamiento en caché y los tokens
Las Salidas Estructuradas inyectan guía de formato en el prompt del sistema, aumentando ligeramente los tokens de entrada. Cambiar output_config.format invalida la caché del prompt para esa conversación. Versiona los esquemas y evita generar un esquema ligeramente diferente para cada solicitud.
Limitación de la clave de cifrado
Anthropic documenta que las organizaciones que utilizan claves de cifrado gestionadas por el cliente no pueden usar Salidas Estructuradas con Claude Fable 5.2 o Mythos 5.2. Esto incluye salidas JSON y uso estricto de herramientas. En esa configuración, use la opción automática de herramientas, omita strict, valide las entradas localmente y diseñe una ruta segura de reintento o reparación.
Estrategia de manejo de errores
- Valida el esquema antes de enviarlo.
- Tratar las características de esquema no compatibles como errores de desarrollo, no como fallos transitorios.
- Analiza la respuesta solo después de verificar el resultado de la API.
- Validar reglas de negocio localmente.
- Nunca ejecutes una herramienta únicamente porque el JSON se haya analizado.
- Versión del esquema de registro y ID de solicitud.
Preguntas frecuentes
¿Por qué tool_choice: {"type":"herramienta"}¿falla en Fable 5.2?
Las opciones forzadas tool y any no son compatibles. Use auto con uso estricto de herramientas, salidas JSON o instrucciones de orquestación compatibles.
¿Significa un JSON válido que la respuesta es correcta?
No. Garantiza el formato, no la verdad, la evidencia, la autorización ni un comportamiento comercial seguro.
¿Se pueden usar las salidas JSON y las herramientas estrictas juntas?
Sí, donde la configuración de la cuenta admite Salidas Estructuradas. Controlan diferentes partes de la interacción.

















































































































