Depois que o Amazon Bedrock tornou GA as saídas estruturadas do Claude em 20 de outubro, como escrever JSON Schema em output_config.format e ferramentas strict?

Em 22 de outubro de 2026: saídas estruturadas em runtime e mantle. InvokeModel com objeto json_schema em output_config.format; mantle com strict true. Cada object exige additionalProperties false; leia stop_reason antes de JSON.parse.

Em 20 de outubro o Amazon Bedrock tornou as saídas estruturadas do Claude GA em bedrock-runtime e bedrock-mantle. Texto via output_config.format com json_schema e objeto schema aninhado. No mantle, strict: true nas ferramentas. Leia stop_reason antes de parsear.

Texto de 22 de outubro de 2026. Ontem: usage do cache de 12 h. Mudar a estrutura do schema recompila a gramática; só descrições costuma manter o cache de 24 h.

O que saiu em 20 de outubro

Todos os modelos Claude disponíveis: JSON Schema e strict tool use com decodificação restrita.

InvokeModel

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

Ferramentas strict

strict: true limita tool_use.input. JSON de texto e input de ferramenta são contratos distintos.

Do corpo ao JSON

Com end_turn, parse do bloco text. Com max_tokens, não confiar. Validador JSON.

Subconjunto de schema

Subconjunto Draft 2020-12: sem recursão, sem $ref externo, additionalProperties só false.

Cache 24 h

Primeiro pedido com schema novo mais lento. Reutilize estrutura fixa e varie messages.

FAQ

output_config igual à API Claude direta?

Mesmo caminho, corpo InvokeModel no Bedrock. additionalProperties false em ambos.

Por que additionalProperties false?

Exigência Bedrock; sem isso o schema é rejeitado.

JSON confiável com max_tokens?

Não. Aumente max_tokens ou encurte prompt e schema.

Recompila ao mudar description?

Quase nunca; mudança estrutural sim.

json_schema vs strict?

Texto final vs tool_use.input; versionar separado.

Apagar todo JSON.parse?

Não. Corpo externo e recusas permanecem.

Resumo

20 de outubro: contrato JSON no Bedrock. output_config no runtime, strict no mantle; testar stop_reason.