Formatando a saída: JSON, markdown, tabelas e listas

O formato de saída é a peça mais subestimada da anatomia. Muita gente trata o modelo como "ele responde do jeito que quiser" - e aí recebe texto-prosa quando queria JSON, recebe markdown quando queria tabela, ou recebe uma resposta que mistura os dois e dá trabalho pra parsear.

O modelo é obediente. Se você disser o formato, ele segue. Se você não disser, ele vai no default - que é prosa com markdown, e vai te dar trabalho.

Os 4 formatos que você vai usar 95% do tempo

1. Prosa natural

Pra conversa, explicações, e-mails, redações.

"Responda em 2-3 parágrafos, em tom profissional mas humano."

2. Listas e bullets

Pra enumerar opções, passos, critérios, prós/contras.

"Responda em formato de lista numerada, com no máximo 5 itens, cada um com 1-2 frases."

3. Tabelas

Pra comparar opções, mapear features, organizar dados estruturados.

"Responda em formato de tabela markdown com as colunas: Ferramenta, Linguagem principal, Caso de uso ideal, Curva de aprendizado."

4. JSON

Pra saída que vira código. A peça que mais economiza tempo de dev.

"Responda apenas com JSON válido no schema:

copiar

{
  \"titulo\": string,
  \"resumo\": string,
  \"tags\": string[],
  \"confianca\": number  // 0.0 a 1.0
}
```"

Carregando diagrama...

Truques que melhoram formatação

Diga "apenas"

Sem "apenas", o modelo às vezes prefixa com "Claro! Aqui está o JSON:" - e quebra seu parser. Com "apenas", ele tende a ir direto.

Dê um exemplo curto

Mostrar 1 linha do formato desejado vale mais que 3 frases explicando.

"Responda em JSON. Exemplo de formato:

copiar

{\"nome\": \"João\", \"idade\": 30}
```"

Use "se e somente se" pra regras estritas

"Responda apenas com JSON válido. Não inclua texto antes ou depois. Não use markdown code fences."

Para JSON em produção: use JSON Schema (structured outputs)

A maioria dos providers tem structured outputs - você dá um JSON Schema e o modelo é garantido (não "espera-se", garantido) a produzir um JSON que casa com ele. Em 2026, é o padrão pra qualquer uso sério. Detalhes no nó function-calling da Fase 2.

• Formato de saída é parte do prompt, não detalhe. Se você não disser, o modelo decide por você.
• Os 4 que resolvem 95% dos casos: prosa, listas, tabelas, JSON.
• "Apenas" + exemplo curto é a combinação que mais aumenta aderência.
• Para JSON em produção, use structured outputs / JSON Schema - garantia, não esperança (detalhes em function-calling).
• Markdown code fences (```json) na resposta vão te morder se você não pedir pra omitir.

Dica: a primeira coisa a testar quando o output vem "mais ou menos" é "o que eu disse sobre formato?". Em 70% dos casos, a resposta é "nada" ou "algo vago". Corrija isso e o problema some.

No próximo nó, vamos falar de uma habilidade que muda tudo: iterar o prompt em vez de reescrever do zero a cada vez.