Saída Estruturada de LLMs
Ir para notas que citam estaSaída estruturada de LLMs é a prática de pedir ao modelo uma resposta em formato definido, como JSON, e extraí-la corretamente do texto retornado, já que o modelo devolve tudo como string.
Essa é a fronteira entre o agente e o resto da aplicação. Enquanto a resposta for lida por uma pessoa, texto livre basta; no momento em que outro nó do fluxo precisa decidir algo a partir dela, o conteúdo tem que virar objeto. É nessa conversão que aparecem os erros mais irritantes de um sistema de agentes, porque eles não parecem erros de modelo: parecem erros de código.
Por que o JSON chega stringificado
Pedir JSON ao modelo não faz o modelo devolver um objeto. Ele devolve uma string que contém JSON, muitas vezes já escapada dentro de outra estrutura. Uma aplicação Java que entrega esse conteúdo direto à biblioteca de serialização quebra na formatação, porque está tentando ler como objeto algo que ainda é texto. O sintoma é dupla serialização: existe uma camada a mais de string entre a resposta e o dado.
A solução tem dois passos, e o segundo costuma ser esquecido: extrair a string da resposta e só então convertê-la em objeto. O comportamento não é particularidade de uma linguagem — em Python, um fluxo com LangGraph passa pelo mesmo caminho, recebendo a resposta como string e exigindo uma conversão explícita para obter o objeto.
Um tratamento de falha que monta um JSON de erro dentro da estrutura esperada de resposta válida esconde o problema: o fluxo segue como se tivesse funcionado, e o defeito só aparece quando alguém inspeciona o conteúdo e encontra, no campo de resumo, a mensagem de que a geração falhou. Vale sempre validar a etapa de extração antes de assumir que o dado já está no formato da aplicação.
Formato como contrato entre agentes
Quando a saída estruturada deixa de ser conveniência e vira contrato, o desenho muda. Um nó analisador que roteia a mensagem do usuário para o agente certo pode exigir JSON obrigatório e interromper a execução se a resposta sair fora do formato — o fluxo não avança com dado malformado. É uma escolha de projeto: o framework de grafo não garante por si a aderência estrita ao formato, então a verificação precisa estar no nó, e é ela que sustenta o comportamento de um Agente Roteador.
O que cabe dentro do objeto
A estrutura pedida é o que torna a resposta comparável entre execuções. Um Agente Especialista em Histórias de Usuário devolve, em campos separados, a persona, a necessidade, o benefício, os componentes identificados, os critérios de aceitação em cenários no formato de dado/quando/então e a lista de problemas encontrados na história original. Assim a saída pode ser renderizada, revisada campo a campo e passada adiante a outro agente sem interpretação ambígua no meio do caminho.