O que são saídas estruturadas de IA?

Estrutura significa que o código downstream pode confiar no formato

Uma saída estruturada restringe uma resposta a um formato definido — um conjunto fixo de campos, tipos específicos, uma enumeração de valores permitidos — em vez de um parágrafo de texto livre. Não se trata de estilo; um programa que lê a resposta consegue extrair um valor num caminho conhecido em vez de analisar frases e adivinhar o significado.

Há duas formas diferentes de pedir isso

A primeira é baseada em prompt: instruções dizem ao modelo para responder só em JSON conforme um formato descrito. Isso funciona com praticamente qualquer modelo e não precisa de suporte especial de API, mas é uma solicitação que o modelo ainda pode ignorar, fazer parcialmente errado, ou envolver em texto explicativo que você não pediu. A segunda é imposta pelo provedor: alguns provedores oferecem um modo, muitas vezes chamado de saídas estruturadas ou modo JSON, em que a própria geração é restrita para que só possam ser produzidos tokens compatíveis com o esquema a cada passo. Esse é um mecanismo mais forte que uma instrução, não só um que soa mais rígido — e é um recurso distinto da chamada de ferramentas (veja como funciona a chamada de ferramentas), que molda os argumentos de uma função nomeada em vez da própria resposta do modelo.

Uma instrução no prompt é uma solicitação, não uma garantia

Quando a estrutura vem só da redação do prompt, o modelo ainda pode produzir uma saída que não bate — um campo a mais, um faltando, texto antes do JSON, um valor do tipo errado. Qualquer sistema que dependa só de estrutura via prompt precisa de um plano real para quando a interpretação falhar, não da suposição de que isso nunca vai acontecer.

Estrutura imposta pelo provedor é um tipo diferente de garantia

Quando um provedor restringe a geração diretamente contra um esquema, a saída fica muito mais confiavelmente bem formada, porque tokens malformados são excluídos de serem gerados desde o início, em vez de apenas desencorajados. Exatamente quais provedores e modelos suportam isso, e com que rigor, varia e muda com o tempo — trate estrutura via prompt e estrutura imposta pelo provedor como níveis de confiabilidade diferentes, não como formas intercambiáveis de chegar ao mesmo resultado.

Um formato válido não é a mesma coisa que uma resposta correta

Mesmo com a aplicação mais forte, o esquema só restringe a forma, não o significado. Um campo de resumo pode ser JSON sintaticamente válido e mesmo assim conter três frases divagantes em vez de uma, ou um número errado afirmado com confiança num campo rotulado como contagem. Um esquema vago ou permissivo demais tende a produzir saída tecnicamente válida mas ainda assim pouco confiável de usar.

Interpretar com sucesso não é a mesma coisa que poder confiar

Quer a estrutura venha de um prompt ou da imposição do provedor, interpretar uma resposta com sucesso só confirma que o formato foi seguido — não diz nada sobre se os valores dos campos são precisos, estão dentro do intervalo ou fazem sentido. Tratar um objeto interpretado como dado verificado, em vez de como uma alegação a conferir, é onde os sistemas de saída estruturada mais falham em produção.

Perguntas frequentes

Uma saída estruturada é a mesma coisa que uma chamada de ferramenta?

Não. A chamada de ferramentas propõe uma função nomeada e seus argumentos para sua aplicação possivelmente executar; uma saída estruturada molda a própria resposta do modelo num formato definido. Os dois mecanismos podem ser usados separadamente ou juntos.

Pedir JSON ao modelo no prompt garante receber JSON válido de volta?

Não. É uma solicitação que o modelo ainda pode errar — texto a mais, um campo faltando, um tipo incorreto. Sistemas que dependem só da redação do prompt precisam de um fallback definido para quando a interpretação falhar, não da suposição de que ela sempre vai funcionar.

Se um provedor impõe um esquema, o resultado é garantidamente correto?

É garantido que fica bem formado de acordo com o esquema — os campos certos, os tipos certos. Não é garantido que os valores dentro desses campos sejam precisos ou façam sentido; a imposição restringe a forma, não a verdade.

Ainda preciso validar uma resposta estruturada antes de usá-la?

Sim. Interpretar uma resposta com sucesso confirma que o formato bateu, não que o conteúdo está correto. Verificações de intervalo, tipo e sanidade dos valores continuam necessárias, independentemente de como a estrutura foi produzida.