Saída estruturada em JSON: planos e relatórios do agente

Nem toda resposta de um agente precisa ser um parágrafo de texto. Quando o cliente recebe um plano de treino, um cardápio, um calendário ou um relatório, ler tudo corrido no chat é cansativo. O ideal é exibir cada informação em um formato visual adequado: cartões, tabelas, listas e destaques. Para isso, o agente pode entregar a resposta de forma estruturada, em JSON, que o aplicativo converte em telas organizadas. Neste artigo, você entenderá como funciona esse modelo e quais cuidados ele exige. --- ## 1. A ideia: separar conteúdo de apresentação O agente decide o conteúdo, e o aplicativo decide como mostrá-lo. Em vez de escrever o texto formatado, o agente devolve um documento com blocos nomeados, como títulos, listas, calendários e tabelas. O aplicativo conhece esses blocos e os renderiza com o visual da marca. --- ## 2. Vantagens - **Leitura mais fácil:** informações organizadas em blocos, em vez de texto corrido. - **Consistência visual:** o mesmo tipo de conteúdo aparece sempre no mesmo formato. - **Reuso:** o mesmo documento pode ser consultado depois, em uma tela dedicada. - **Controle de qualidade:** o formato pode ser validado automaticamente. --- ## 3. O contrato entre agente e aplicativo Um ponto essencial: o formato é um contrato. O agente só deve usar blocos e campos que o aplicativo realmente sabe exibir. Se um campo novo for inventado nas instruções sem que o aplicativo o suporte, ele não aparecerá, ou aparecerá quebrado. Por isso, qualquer alteração no formato deve ser feita em conjunto: instruções do agente e o aplicativo. --- ## 4. Instruções para o agente As instruções de entrega estruturada precisam ser completas e precisas: - Descrever o formato do documento e os tipos de bloco permitidos. - Mostrar exemplos válidos. - Informar o que fazer quando faltam dados. - Reforçar que a resposta deve seguir o formato à risca, sem texto fora do documento. --- ## 5. Validação Gerar uma saída estruturada exige verificar se o documento é válido. Ferramentas de validação conferem se os campos obrigatórios existem, se os tipos de bloco são permitidos e se o JSON está bem formado. Teste com amostras reais antes de colocar no ar. --- ## 6. Cuidados com o conteúdo Em áreas como saúde e nutrição, os planos devem respeitar as regras de segurança do agente, incluindo avisos e orientação a profissionais quando necessário. O formato visual não muda essa responsabilidade. --- ## Conclusão Saídas estruturadas transformam respostas de IA em experiências visuais claras. Com um contrato bem definido entre agente e aplicativo, e com validação, o cliente recebe planos e relatórios fáceis de ler e consultar.