Saída estruturada
Structured Output / JSON Schema
Capacidade
BásicoCategoria: Prompt e context engineeringSubcategoria: Técnicas de prompting
O que significa
É a capacidade de fazer o modelo responder em um formato definido, geralmente JSON com campos e tipos fixos, validado por um esquema. Em vez de um texto livre, a saída é um objeto que sistemas conseguem ler diretamente.
Isso elimina a etapa frágil de “extrair a resposta do texto” e transforma o LLM em um componente de software, e não apenas em um gerador de prosa.
Os principais fornecedores oferecem modos em que a aderência ao esquema é garantida, o que reduz erros de formato a praticamente zero.
Como usar na prática de produto
Em Produto, toda capacidade generativa cuja saída alimenta outro sistema deve retornar saída estruturada. Isso vale para extração de dados, classificação, roteamento e qualquer chamada de ferramenta.
O esquema deve ser definido no contrato da capacidade: quais campos são obrigatórios, quais tipos, quais valores são permitidos. Vale incluir campos de apoio, como um nível de confiança ou uma justificativa curta, que facilitam avaliação, registro e fallback.
Por exemplo, um extrator de laudos pode retornar um objeto com o tipo de ocorrência, as peças afetadas, a confiança e um indicador de se precisa de revisão humana.
Quando usar este termo ou outro
Use saída estruturada sempre que a resposta vai para um sistema, uma base de dados ou outra etapa automatizada.
Use texto livre apenas quando o destino é uma pessoa lendo.
Use function calling quando a saída estruturada representa uma ação a ser executada, e não apenas dados.
Uma forma simples de diferenciar: texto livre é para pessoas; saída estruturada é para sistemas.
Exemplos de aplicação
- Extração de documentos: retornar campos como valor, data e categoria em JSON validado.
- Classificação: responder com a categoria, a confiança e uma justificativa curta.
- Roteamento: indicar o destino da solicitação em um campo com valores permitidos.
- Análise de feedback: estruturar cada comentário em tema, sentimento e urgência.
- Integrações: gerar dados prontos para serem gravados no CRM ou em outro sistema.
Origem do termo
JSON mode (OpenAI, 2023) e Structured Outputs com aderência garantida a JSON Schema (OpenAI, 2024); suportado por Anthropic e Google.
Fonte técnica
OpenAI Platform docs, Structured Outputs; Anthropic docs, Structured outputs
