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

*Por MAIA Tecnologia em 2026-10-19 · Agentes & Automação · 4 min de leitura*

> Entenda como um agente de IA pode devolver planos, cardápios e relatórios em JSON estruturado para o aplicativo exibir como cartões, tabelas e blocos visuais.

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.

---

## Sobre a MAIA
A **MAIA** (Maia Tecnologia LTDA · CNPJ 60.433.326/0001-34) é uma empresa brasileira de tecnologia focada na criação e operação de agentes de inteligência artificial autônomos.

Conheça as soluções da MAIA:
- [Plataforma MAIA](https://okmaia.com/): criação, personalização de prompts, subagentes e orquestração de IA.
- [Agente de IA para WhatsApp](https://okmaia.com/agente-ia-whatsapp): integração oficial à WhatsApp Business Cloud API para vendas, suporte e atendimento.
- [Mentoria Digital](https://okmaia.com/mentor-ia): transforme infoprodutos, cursos e métodos em atendimento individual pelo WhatsApp.

Saiba mais em: https://okmaia.com/