Capítulo 1: Anatomia de um Prompt
🎯 Objetivos de Aprendizagem
Após concluir este capítulo, você será capaz de:
- Identificar os quatro componentes-chave de um prompt
- Entender como cada componente afeta a saída da IA
- Construir prompts com todos os elementos necessários
- Reconhecer quando componentes estão ausentes ou fracos
📚 Introdução
Assim como uma frase bem construída possui sujeito, verbo e objeto, um prompt bem elaborado possui componentes distintos que trabalham juntos para produzir o resultado desejado. Compreender esses componentes é fundamental para se tornar um engenheiro de prompts eficaz.
Os Quatro Componentes de um Prompt
Todo prompt eficaz pode ser dividido em quatro componentes principais:
┌─────────────────────────────────────────────────────────────┐
│ PROMPT ANATOMY │
├─────────────────────────────────────────────────────────────┤
│ │
│ ┌─────────────────┐ │
│ │ 1. INSTRUCTION │ → What task to perform │
│ └────────┬────────┘ │
│ │ │
│ ┌────────▼────────┐ │
│ │ 2. CONTEXT │ → Background information │
│ └────────┬────────┘ │
│ │ │
│ ┌────────▼────────┐ │
│ │ 3. INPUT │ → Data to process │
│ └────────┬────────┘ │
│ │ │
│ ┌────────▼────────┐ │
│ │ 4. OUTPUT FORMAT│ → Desired response structure │
│ └─────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────┘
Nem todo prompt precisa dos quatro componentes, mas entender quando e como usar cada um é crucial.
Componente 1: Instrução
A instrução informa à IA qual tarefa deve ser realizada. É a parte orientada à ação do seu prompt.
Características de Boas Instruções
| Característica | Exemplo |
|---|---|
| Clara | "Resuma" e não "Faça algo com" |
| Específica | "Liste 5 benefícios" e não "Fale sobre benefícios" |
| Orientada à ação | Usa verbos: escreva, analise, explique, compare |
| Não ambígua | Apenas uma interpretação possível |
Exemplos
Instruções Fracas:
❌ "Cachorros"
❌ "Me fale coisas sobre marketing"
❌ "Código"
Instruções Fortes:
✓ "Explique as 3 principais técnicas de treinamento para filhotes"
✓ "Escreva um texto de e-mail marketing de 200 palavras para um app de fitness"
✓ "Depure esta função Python e explique as correções"
Biblioteca de Verbos para Instrução
| Categoria | Verbos |
|---|---|
| Gerar | Escreva, crie, componha, elabore, produza |
| Analisar | Examine, avalie, analise, revise, critique |
| Transformar | Converta, traduza, reescreva, simplifique, expanda |
| Explicar | Descreva, esclareça, defina, ilustre, detalhe |
| Comparar | Compare, diferencie, distinga, relacione |
| Organizar | Liste, categorize, classifique, priorize, esquematize |
Componente 2: Contexto
O contexto fornece informações de fundo que ajudam a IA a entender a situação e produzir respostas mais relevantes.
Tipos de Contexto
┌──────────────────────────────────────────────────────────────┐
│ TYPES OF CONTEXT │
├─────────────────┬────────────────────────────────────────────┤
│ Role/Persona │ "Você é um analista financeiro sênior..." │
├─────────────────┼────────────────────────────────────────────┤
│ Audience │ "...explicando para estudantes do ensino médio" │
├─────────────────┼────────────────────────────────────────────┤
│ Purpose │ "...para um relatório trimestral de investidores" │
├─────────────────┼────────────────────────────────────────────┤
│ Constraints │ "...em até 500 palavras, evitando jargões" │
├─────────────────┼────────────────────────────────────────────┤
│ Background │ "Considerando que as vendas caíram 15% no ano passado" │
└─────────────────┴────────────────────────────────────────────┘
Exemplo de Contexto
Sem Contexto:
Escreva sobre energia renovável.
Resultado: Conteúdo genérico e sem foco
Com Contexto:
Você é um especialista em políticas ambientais escrevendo para
um documento de briefing governamental.
Público-alvo: Legisladores com pouco conhecimento técnico
Propósito: Informar decisões de política sobre investimento em energia renovável
Tom: Profissional, objetivo, baseado em evidências
Restrições: Foque em energia solar e eólica na América do Norte
Escreva sobre energia renovável.
Resultado: Conteúdo focado e apropriado para o caso de uso específico
Quanto Contexto é Suficiente?
Rule of Thumb
Inclua contexto até que você possa responder claramente a estas perguntas:
- Quem está se comunicando?
- Quem é o público?
- Qual é o propósito?
- Quais restrições se aplicam?
Componente 3: Input
O input é o dado, texto ou informação específica que você deseja que a IA processe.
Tipos de Input
| Tipo | Exemplo de Uso |
|---|---|
| Texto | Documento para resumir, artigo para analisar |
| Código | Função para depurar, script para otimizar |
| Dados | Números para interpretar, listas para processar |
| Perguntas | Consultas para responder |
| Exemplos | Amostras para aprender |
Boas Práticas de Formatação de Input
Delimitadores Claros:
Analise a seguinte avaliação de cliente:
"""
Comprei este produto na semana passada e é incrível!
A qualidade superou minhas expectativas. Com certeza
recomendaria aos amigos.
"""
Forneça análise de sentimento e temas principais.
Seções Rotuladas:
Compare estes dois trechos de código quanto à eficiência:
[CODE A]
def sum_list(numbers):
total = 0
for n in numbers:
total += n
return total
[CODE B]
def sum_list(numbers):
return sum(numbers)
Qual é mais eficiente e por quê?
Delimitadores Comuns de Input
Aspas triplas: """conteúdo"""
Crases triplas: ```conteúdo```
Tags XML: <input>conteúdo</input>
Colchetes: [INPUT] conteúdo [/INPUT]
Traços: ---conteúdo---
Componente 4: Formato de Saída
O formato de saída especifica como você deseja que a IA estruture sua resposta.
Especificações de Formato
| Tipo de Formato | Quando Usar |
|---|---|
| Prosa/Parágrafo | Explicações, histórias, artigos |
| Tópicos | Listas, funcionalidades, leitura rápida |
| Listas Numeradas | Passos, rankings, sequências |
| Tabelas | Comparações, dados estruturados |
| Código | Saídas técnicas |
| JSON/XML | Processamento programático |
| Markdown | Documentação formatada |
Exemplos de Formato
Solicitando Tópicos:
Liste os benefícios do trabalho remoto.
Formato: Tópicos (5-7 itens)
Cada ponto: Uma frase com breve explicação
Solicitando uma Tabela:
Compare Python e JavaScript para desenvolvimento web.
Formate sua resposta como uma tabela markdown com as colunas:
| Aspecto | Python | JavaScript |
Solicitando JSON:
Extraia informações desta vaga de emprego e retorne em JSON:
{
"title": "",
"company": "",
"location": "",
"salary_range": "",
"required_skills": [],
"experience_years": ""
}
Juntando Tudo
Veja um prompt completo utilizando os quatro componentes:
┌─────────────────────────────────────────────────────────────┐
│ INSTRUCTION │
│ Analyze the following customer feedback and provide │
│ actionable insights for our product team. │
├─────────────────────────────────────────────────────────────┤
│ CONTEXT │
│ You are a customer experience analyst at a SaaS company. │
│ This feedback is from users of our project management tool. │
│ We're preparing for our Q1 product planning meeting. │
├─────────────────────────────────────────────────────────────┤
│ INPUT │
│ """ │
│ Feedback 1: "Love the collaboration features but the │
│ mobile app is really slow." │
│ Feedback 2: "Can't figure out how to set recurring tasks." │
│ Feedback 3: "Great tool! Wish there was dark mode." │
│ Feedback 4: "Integration with Slack keeps breaking." │
│ Feedback 5: "The calendar view is confusing." │
│ """ │
├─────────────────────────────────────────────────────────────┤
│ OUTPUT FORMAT │
│ Structure your response as: │
│ 1. Executive Summary (2-3 sentences) │
│ 2. Key Themes (bullet points) │
│ 3. Priority Recommendations (numbered, top 3) │
│ 4. Quick Wins vs Long-term Investments (table) │
└─────────────────────────────────────────────────────────────┘
Checklist de Componentes
Use este checklist ao criar prompts:
☐ INSTRUCTION
☐ Verbo de ação claro
☐ Tarefa específica definida
☐ Sem ambiguidade
☐ CONTEXT (se necessário)
☐ Papel/persona definido
☐ Público especificado
☐ Propósito declarado
☐ Restrições listadas
☐ INPUT (se aplicável)
☐ Delimitado claramente
☐ Formatado corretamente
☐ Informação completa
☐ OUTPUT FORMAT
☐ Estrutura especificada
☐ Diretrizes de tamanho
☐ Requisitos de estilo
Erros Comuns
Avoid These Errors
1. Instrução Ausente
❌ "Feedback de clientes sobre nosso app"
✓ "Analise este feedback de clientes e identifique as principais preocupações"
2. Contexto Vago
❌ "Você é um especialista. Escreva sobre tecnologia."
✓ "Você é um consultor de cibersegurança escrevendo para donos de pequenas empresas com pouco conhecimento técnico."
3. Input Não Delimitado
❌ Resuma: O produto era bom, mas a entrega foi lenta
✓ Resuma a seguinte avaliação:
"""
O produto era bom, mas a entrega foi lenta
"""
4. Formato de Saída Ausente
❌ "Me fale sobre a Revolução Francesa"
✓ "Explique as causas da Revolução Francesa em 3-5 tópicos, cada um com uma frase de contexto"
Exercício Prático
Exercício: Identificação de Componentes
Identifique os componentes neste prompt:
Você é um nutricionista criando conteúdo para um app de saúde
voltado para profissionais ocupados.
Analise o seguinte plano alimentar e sugira melhorias:
Café da manhã: Café e um muffin
Almoço: Hambúrguer de fast food e batatas fritas
Jantar: Pizza congelada
Lanches: Chips e refrigerante
Forneça sua resposta como:
1. Problemas atuais (tópicos)
2. Sugestões de melhorias (lista numerada)
3. Exemplo de plano alimentar de um dia (cronograma formatado)
Ver Resposta
Instrução: "Analise o seguinte plano alimentar e sugira melhorias"
Contexto:
- Papel: Nutricionista
- Propósito: Conteúdo para um app de saúde
- Público: Profissionais ocupados
Input: O plano alimentar (Café da manhã até Lanches)
Formato de Saída:
- Tópicos para problemas
- Lista numerada para melhorias
- Cronograma formatado para plano de exemplo
Principais Aprendizados
Summary
- Todo prompt possui quatro componentes potenciais: Instrução, Contexto, Input, Formato de Saída
- Instruções devem ser claras, específicas e orientadas à ação
- Contexto fornece o pano de fundo necessário para respostas relevantes
- Input deve ser claramente delimitado e formatado
- Formato de Saída melhora drasticamente a utilidade da resposta
- Nem todo prompt precisa dos quatro componentes, mas saber quando usar cada um é crucial
O que vem a seguir?
No próximo capítulo, vamos explorar tipos de prompts, incluindo os conceitos poderosos de zero-shot e few-shot prompting.