MODULO 1.5

๐Ÿ“„ Formato de Saida

Domine Markdown, JSON, tabelas e formatos estruturados para obter saidas consistentes, legiveis e processaveis por outros sistemas.

6
Topicos
30
Minutos
Basico
Nivel
Pratica
Tipo
1

๐Ÿ“ Markdown como Padrao

Markdown e o formato mais versatil para saidas de LLMs. Ele e legivel como texto puro, renderiza bonito em qualquer plataforma e oferece estrutura suficiente para a maioria dos casos.

๐Ÿ“‹ Elementos Essenciais

## Headers โ€” para secoes e hierarquia

- Listas โ€” para itens sem ordem

1. Numeradas โ€” para passos sequenciais

**Negrito** โ€” para destaques

| Tabelas | โ€” para dados comparativos

```codigo``` โ€” para trechos tecnicos

๐Ÿ’ก Quando Usar Markdown

Use Markdown quando a saida sera lida por humanos: relatorios, resumos, analises, emails, documentacao. E o formato padrao para a maioria das interacoes com LLMs.

2

๐Ÿ”ง JSON Estruturado

JSON e o formato ideal quando a saida sera processada por outro sistema โ€” APIs, automacoes, bancos de dados. Voce define o schema e o modelo preenche.

๐Ÿ“‹ Como Pedir JSON

Formato de saida: JSON com a seguinte estrutura:

{

"titulo": "string, max 50 caracteres",

"resumo": "string, max 100 palavras",

"tags": ["array de 3-5 strings"],

"prioridade": "alta | media | baixa",

"acionavel": true/false

}

๐Ÿ“Š Boas Praticas JSON

  • Defina tipos: string, number, boolean, array โ€” evita surpresas
  • Marque obrigatorios: "campo (obrigatorio)" vs "campo (opcional, default: null)"
  • De um exemplo: Incluir um JSON de exemplo reduz erros em 90%
  • Peca "somente JSON": "Responda APENAS com o JSON, sem texto antes ou depois"
3

๐Ÿ“Š Tabelas e Comparativos

Tabelas sao ideais para comparacoes lado a lado, listas estruturadas e dados que precisam de multiplas dimensoes. Defina colunas, limites por celula e criterios de preenchimento.

๐Ÿ“‹ Como Pedir Tabelas

Formato: Tabela Markdown com as colunas:

| Ferramenta | Preco | Ponto Forte | Limitacao |

|------------|-------|-------------|-----------|

Restricoes:

- Exatamente 5 linhas

- Maximo 15 palavras por celula

- Ordenar por preco (menor โ†’ maior)

๐Ÿ’ก Tabela vs Lista vs JSON

Tabela: para comparar itens em multiplas dimensoes. Lista: para itens sequenciais ou sem comparacao. JSON: para dados que serao processados por codigo. Escolha pelo consumidor da saida.

4

๐Ÿ“ Campos Obrigatorios e Opcionais

Definir quais campos a resposta DEVE ter e quais sao opcionais garante completude sem rigidez excessiva. E como definir o schema de um formulario.

Campos Obrigatorios

  • โœ“Titulo (sempre presente)
  • โœ“Descricao (1-2 frases)
  • โœ“Classificacao (categoria)
  • โœ“Acao recomendada

Campos Opcionais

  • ~Exemplo (se aplicavel)
  • ~Fonte/referencia
  • ~Nivel de confianca
  • ~Notas adicionais
5

๐ŸŽจ Tom e Estilo na Saida

O tom define como o modelo se comunica. O mesmo conteudo pode ser entregue de formas radicalmente diferentes conforme o tom especificado.

๐ŸŽญ Espectro de Tom

  • โ€ขFormal/tecnico: Relatorios executivos, documentacao tecnica, pareceres
  • โ€ขProfissional acessivel: Posts LinkedIn, emails corporativos, apresentacoes
  • โ€ขDidatico: Tutoriais, explicacoes, material de treinamento
  • โ€ขCasual/conversacional: Redes sociais, blogs, comunicacao interna
  • โ€ขPersuasivo: Copy de vendas, landing pages, CTAs

๐Ÿ’ก Como Especificar Tom

Nao basta dizer "tom profissional". Seja especifico: "Tom profissional mas acessivel. Sem jargao tecnico. Frases curtas (max 20 palavras). Use 'voce' em vez de 'o usuario'. Inclua exemplos praticos."

6

๐Ÿงช Exercicio: Formatos na Pratica

Pegue uma unica tarefa e peca a saida em 3 formatos diferentes: Markdown, JSON e tabela. Compare os resultados e entenda quando cada formato funciona melhor.

๐Ÿ“‹ Tarefa do Exercicio

Tarefa: Analisar 3 ferramentas de IA para criacao de conteudo

Contexto: Para equipe de marketing de PME, orcamento limitado

Versao A: Formato Markdown (headers + listas)

Versao B: Formato JSON (array de objetos)

Versao C: Formato Tabela (colunas comparativas)

Compare: qual formato e mais legivel? Qual e mais processavel? Qual seu publico prefere?

๐Ÿ“ Resumo do Modulo

โœ“
Markdown para humanos โ€” Versatil, legivel, renderiza em qualquer plataforma
โœ“
JSON para maquinas โ€” Processavel, com schema definido e tipos claros
โœ“
Tabelas para comparacao โ€” Dados lado a lado com colunas definidas
โœ“
Campos obrigatorios e opcionais โ€” Schema garante completude sem rigidez
โœ“
Tom e especifico por contexto โ€” Nao basta "profissional" โ€” detalhe o estilo

Proximo Modulo:

1.6 โ€” Clareza e Escopo: elimine ambiguidade e defina limites claros