Después de que Amazon Bedrock hiciera GA las salidas estructuradas de Claude el 20 de octubre, ¿cómo escribir JSON Schema en output_config.format y herramientas strict?

A 22 de octubre de 2026: salidas estructuradas en runtime y mantle. InvokeModel con objeto json_schema en output_config.format; mantle con strict true. Cada object exige additionalProperties false; lea stop_reason antes de JSON.parse.

El 20 de octubre Amazon Bedrock llevó las salidas estructuradas de Claude a disponibilidad general en bedrock-runtime y bedrock-mantle. El texto usa output_config.format con json_schema y un objeto schema anidado. En mantle, strict: true en herramientas. Lea stop_reason antes de parsear.

Redactado el 22 de octubre de 2026. Ayer: usage del caché de 12 h. Cambiar la estructura del schema recompila la gramática; solo descripciones suele conservar la caché de 24 h.

Qué llegó el 20 de octubre

Todos los modelos Claude disponibles: JSON Schema y strict tool use con decodificación restringida.

InvokeModel

Schema bajo output_config.format como objeto. Cada object exige additionalProperties: false.

Herramientas strict

strict: true acota tool_use.input. JSON de texto e input de herramienta son contratos distintos.

Del cuerpo al JSON

Con end_turn, parse del bloque text. Con max_tokens, no confiar. Validador JSON.

Subconjunto de schema

Subconjunto Draft 2020-12: sin recursión, sin $ref externo, additionalProperties solo false.

Caché 24 h

Primera petición con schema nuevo más lenta. Reutilice estructura fija en messages variable.

FAQ

¿Igual output_config que la API directa?

Misma ruta, cuerpo InvokeModel en Bedrock. additionalProperties false en ambos.

¿Por qué additionalProperties false?

Requisito Bedrock; sin ello se rechaza el schema.

¿JSON fiable con max_tokens?

No. Suba max_tokens o acorte prompt y schema.

¿Recompila al cambiar description?

Casi nunca; sí al cambiar estructura.

¿json_schema vs strict?

Texto final vs tool_use.input; versionar por separado.

¿Eliminar todo JSON.parse?

No. Cuerpo externo y rechazos siguen.

Resumen

20 de octubre: contrato JSON en Bedrock. output_config en runtime, strict en mantle; probar stop_reason.