Adicionando detalhes concretos
Números, nomes, formatos e exemplos que orientam os resultados da IA.
Adicionando detalhes concretos é uma aula grátis de AI Prompt Engineering no CoddyKit. Esta é a aula 3 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de AI Prompt Engineering, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de AI Prompt Engineering inclui 4 aulas no total.
Detalhes concretos são âncoras
Detalhes concretos são informações específicas, mensuráveis e verificáveis. Eles ancoram a saída do modelo à sua situação real, em vez de deixá-la baseada em uma interpretação genérica.
Sem âncoras, o modelo gera conteúdo para o usuário médio imaginário. Com âncoras, gera conteúdo para você.
A contagem de palavras como restrição concreta
A contagem de palavras é um dos detalhes concretos mais simples e eficazes que você pode adicionar. Compare:
- Vago: 'Escreva uma descrição curta'
- Concreto: 'Escreva uma descrição de 75 palavras'
O modelo contará os tokens e buscará atingir sua meta. Se errar um pouco, você poderá pedir uma nova contagem exata. A contagem de palavras elimina categorias inteiras de reescrita.
import anthropic
client = anthropic.Anthropic(api_key='sk-ant-your-key-here')
response = client.messages.create(
model='claude-opus-4-5',
max_tokens=200,
messages=[{
'role': 'user',
'content': (
'Write a product description for a noise-cancelling travel pillow in exactly 60 words. '
'After the description, output the word count in parentheses on a new line.'
)
}]
)
print(response.content[0].text)O público-alvo como detalhe concreto
Indicar um público específico e concreto altera drasticamente o vocabulário, os exemplos e a profundidade da saída.
- Vago: 'Explique redes neurais'
- Concreto: 'Explique redes neurais a um gerente de marketing de uma empresa da Fortune 500 que não tem conhecimento de programação, mas entende tabelas dinâmicas do Excel'
A segunda instrução fornece ao modelo uma imagem mental de um leitor real e permite calibrar perfeitamente a complexidade.
import openai
client = openai.OpenAI(api_key='sk-your-key-here')
concrete_audience_prompt = (
'Explain what a REST API is.\n\n'
'Audience: a non-technical product manager who uses Salesforce daily '
'and understands the concept of a form submission on a website. '
'They will use this explanation to brief their engineering team tomorrow. '
'Use one real-world analogy. Max 100 words.'
)
response = client.chat.completions.create(
model='gpt-4o',
messages=[{'role': 'user', 'content': concrete_audience_prompt}]
)
print(response.choices[0].message.content)Entidades nomeadas em vez de generalizações
Usar entidades nomeadas — nomes reais de produtos, empresas, pessoas, tecnologias e datas — tira o modelo do território genérico.
- Vago: 'Escreva uma análise competitiva'
- Concreto: 'Escreva uma análise competitiva do Notion versus Obsidian versus Roam Research para um usuário avançado que gerencia uma equipe remota de 10 pessoas, escreve diariamente e precisa de acesso sem conexão'
As entidades nomeadas ancoram o modelo no conhecimento do mundo real que ele adquiriu durante o treinamento.
import anthropic
client = anthropic.Anthropic(api_key='sk-ant-your-key-here')
response = client.messages.create(
model='claude-opus-4-5',
max_tokens=400,
messages=[{
'role': 'user',
'content': (
'Compare FastAPI vs Flask vs Django REST Framework '
'for building a production API that will serve a React frontend. '
'Context: 2-person startup team, Python 3.11, needs async support, '
'expects < 50 ms response time, and will deploy on AWS Lambda. '
'Format: 3-column markdown table with rows: setup complexity, '
'async support, performance, learning curve, community size.'
)
}]
)
print(response.content[0].text)Restrições quantitativas
Os números não são ambíguos. Sempre que tiver uma exigência numérica, inclua-a na instrução:
- Liste exatamente N itens (não 'alguns' ou 'vários')
- Contagens máximas ou mínimas de palavras ou caracteres
- Porcentagens ou proporções específicas ('70% prático, 30% teórico')
- Restrições de tempo ('explique como se eu tivesse 3 minutos para ler isto')
- Metas de desempenho ('sugira abordagens que atinjam complexidade temporal O(n)')
import openai
client = openai.OpenAI(api_key='sk-your-key-here')
response = client.chat.completions.create(
model='gpt-4o',
messages=[{
'role': 'user',
'content': (
'Generate exactly 8 onboarding email subject lines for a B2B SaaS product. '
'Requirements:\n'
'- Exactly 8 lines, no more, no fewer\n'
'- Each subject line between 40 and 60 characters\n'
'- 4 must emphasize value, 4 must create urgency\n'
'- Label each line: [VALUE] or [URGENCY]\n'
'- No emojis\n'
'- No duplicate words across all 8 lines'
)
}]
)
print(response.choices[0].message.content)Enquadramento por prazo e tempo
Fornecer um contexto temporal altera a profundidade e o foco das saídas. Diga ao modelo quando este conteúdo será usado e quais restrições isso impõe:
- 'Este e-mail será enviado em 2 horas — mantenha-o breve'
- 'Isto é para uma apresentação ao conselho na segunda-feira — use linguagem para executivos'
- 'Esta explicação precisa funcionar em uma reunião diária de 5 minutos'
- 'Escreva isto para uma equipe que tem 10 minutos para revisar o conteúdo antes da ligação com o cliente'
import anthropic
client = anthropic.Anthropic(api_key='sk-ant-your-key-here')
response = client.messages.create(
model='claude-opus-4-5',
max_tokens=256,
messages=[{
'role': 'user',
'content': (
'Write a project status update for our AI chatbot project. '
'This will be read aloud at a 5-minute Monday morning stand-up. '
'The audience has zero technical background. '
'Talking time: max 2 minutes (approximately 300 words). '
'Cover: what we shipped last week, one current blocker, one upcoming milestone. '
'Tone: confident and factual. No jargon.'
)
}]
)
print(response.content[0].text)Exemplos específicos na instrução
Incluir exemplos específicos de o que você deseja ou o que não deseja é uma das técnicas de maior impacto. Os exemplos ensinam formato, voz e estilo simultaneamente.
Você pode incluir:
- Um exemplo da saída ideal (de uma só vez)
- Vários exemplos com rótulos (com poucos exemplos)
- Um exemplo do que deu errado antes (exemplo negativo)
import openai
client = openai.OpenAI(api_key='sk-your-key-here')
prompt = '''
Write 3 feature announcement tweets for a new developer tool.
Here is an example of the style I want:
"We just shipped inline type errors in the editor. No more tab-switching to find
what broke. Your flow stays unbroken. Try it now: [link]"
Characteristics of this style:
- Opens with what shipped, not with excitement words
- Describes the user benefit in the second sentence
- Ends with a CTA
- No hashtags. No emojis. Under 200 characters.
New feature: autocomplete that learns from your codebase.
'''
response = client.chat.completions.create(
model='gpt-4o',
messages=[{'role': 'user', 'content': prompt}]
)
print(response.choices[0].message.content)Vocabulário específico do domínio
Incluir termos específicos do domínio sinaliza ao modelo o nível de conhecimento esperado na saída.
- 'Explique o armazenamento em cache' → resposta generic
- 'Explique a política de remoção LRU do Redis para um engenheiro de software de servidor que está migrando do Memcached para o Redis 7.x' → resposta de nível especializado, fundamentada no domínio
Use o vocabulário da sua área na instrução, e o modelo o reproduzirá na saída.
import anthropic
client = anthropic.Anthropic(api_key='sk-ant-your-key-here')
# Generic prompt vs domain-vocabulary prompt
generic = 'Explain caching strategies.'
domain_anchored = (
'Compare write-through, write-behind, and cache-aside patterns '
'for a microservices architecture using Redis 7.x as the cache layer and '
'PostgreSQL 15 as the source of truth. '
'Focus on consistency guarantees, latency tradeoffs, and failure modes. '
'Audience: senior backend engineers familiar with CAP theorem.'
)
response = client.messages.create(
model='claude-opus-4-5',
max_tokens=400,
messages=[{'role': 'user', 'content': domain_anchored}]
)
print(response.content[0].text)Restrições sobre o que excluir
Restrições negativas concretas (exclusões) evitam que o modelo recorra a caminhos previsíveis e genéricos:
- 'Não sugira soluções que exijam uma chave de API paga'
- 'Não mencione concorrentes pelo nome'
- 'Não use as palavras alavancagem ou sinergia'
- 'Não inclua conteúdo teórico — apenas conteúdo prático'
- 'Exclua abordagens que exijam mais de 5 minutos para serem implementadas'
Cada regra de exclusão aprimora a saída ao eliminar mais um caminho para conteúdo genérico.
import openai
client = openai.OpenAI(api_key='sk-your-key-here')
response = client.chat.completions.create(
model='gpt-4o',
messages=[{
'role': 'user',
'content': (
'Suggest 5 ways to speed up a slow Python script. '
'EXCLUDE:\n'
'- Suggestions requiring third-party libraries (stdlib only)\n'
'- Suggestions about hardware upgrades\n'
'- Rewrites of the entire script\n'
'- Suggestions that take more than 30 minutes to implement\n'
'Each suggestion: one sentence describing what to do, one sentence on expected speedup.'
)
}]
)
print(response.choices[0].message.content)Reunindo tudo
Vamos construir uma instrução totalmente concreta passo a passo. Começando por: 'Escreva uma descrição de vaga.'
- Adicione a função: 'Para um engenheiro sênior de aprendizado de máquina'
- Adicione uma entidade nomeada: 'em uma startup de IA Série B em Londres'
- Adicione a contagem de palavras: '350-400 palavras'
- Adicione o público-alvo: 'para candidatos com mais de 5 anos de experiência'
- Adicione a estrutura: 'Formato: introdução, responsabilidades (8 tópicos), requisitos (5 tópicos), diferenciais (3 tópicos)'
- Adicione a exclusão: 'Sem clichês como ritmo acelerado ou apaixonado'
import anthropic
client = anthropic.Anthropic(api_key='sk-ant-your-key-here')
concrete_prompt = (
'Write a job description for a Senior ML Engineer position '
'at a Series B AI startup in London. '
'Target candidate: 5+ years ML experience, strong Python, familiar with LLMs. '
'Length: 350-400 words. '
'Structure:\n'
'1. 3-sentence company intro (no fluff — focus on product and mission)\n'
'2. Responsibilities: exactly 8 bullet points\n'
'3. Requirements: exactly 5 bullet points\n'
'4. Nice-to-haves: exactly 3 bullet points\n'
'EXCLUDE: phrases like "fast-paced", "passionate", "ninja", "rockstar", "self-starter".'
)
response = client.messages.create(
model='claude-opus-4-5',
max_tokens=600,
messages=[{'role': 'user', 'content': concrete_prompt}]
)
print(response.content[0].text)O hábito de enriquecer instruções
Desenvolva o hábito de enriquecer cada instrução antes de enviá-la. Faça esta rápida análise mental de enriquecimento:
- Posso substituir alguma palavra vaga por um número?
- Posso indicar uma ferramenta, tecnologia ou pessoa específica?
- Posso descrever o público-alvo com mais precisão?
- Posso adicionar um exemplo do que desejo?
- Posso adicionar pelo menos uma restrição do tipo 'não incluir'?
- Posso especificar o formato da saída com mais precisão?
Mesmo dois ou três enriquecimentos melhoram drasticamente a qualidade da saída.
# Prompt enrichment in code form: before/after comparison
before = 'Give me ideas for my presentation.'
after = (
'Generate 6 opening hook ideas for a 15-minute conference talk '
'titled "Why Your AI Prompts Are Failing You" at PyCon 2025. '
'Audience: Python developers, mostly backend, some ML experience. '
'Each hook: 2 sentences max. '
'Mix: 2 provocative statistics, 2 counterintuitive questions, 2 short stories. '
'EXCLUDE: "Did you know..." openers and rhetorical questions about the future of AI.'
)
print('BEFORE:', before)
print()
print('AFTER:', after)Verificação de conhecimento
Um fundador de startup envia esta instrução: 'Ajude-me a escrever um texto de marketing.' Qual instrução revisada usa os detalhes concretos mais eficazes?
Adicionando detalhes concretos — Recapitulação
Detalhes concretos transformam instruções vagas em instruções precisas. Use estas técnicas de ancoragem:
- Contagem de palavras: substitua 'curto/longo' por números exatos
- Entidades nomeadas: produtos, ferramentas, empresas e pessoas específicas
- Público-alvo: função, nível de experiência e o que essas pessoas já sabem
- Restrições quantitativas: exatamente N itens, N% de cada tipo
- Vocabulário do domínio: use os próprios termos da área para indicar a profundidade esperada
- Exemplos: mostre como é uma boa saída
- Exclusões: indique o que o modelo deve evitar
Aprenda AI Prompt Engineering com um tutor de IA — grátis
Escreva e execute código real no seu navegador, obtenha ajuda instantânea de um tutor de IA 24/7 e continue de onde parou na web ou no app.
- Cursos
- 53
- Aulas
- 199
Perguntas Frequentes
A aula “Adicionando detalhes concretos” é grátis?
Sim — o texto completo de “Adicionando detalhes concretos” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de AI Prompt Engineering, atualize para CoddyKit PRO. O curso de AI Prompt Engineering inclui 4 aulas no total.
O que vou aprender em “Adicionando detalhes concretos”?
Números, nomes, formatos e exemplos que orientam os resultados da IA. Você pratica AI Prompt Engineering com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.
Preciso ter experiência prévia para começar AI Prompt Engineering?
Nenhuma experiência prévia é necessária. AI Prompt Engineering no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 3 de 4.
Quanto tempo leva a aula “Adicionando detalhes concretos”?
A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.
Posso escrever e executar código nesta aula de AI Prompt Engineering?
Sim. Cada aula de AI Prompt Engineering inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.
Todas as aulas deste curso
- Por que a especificidade é importante
- Removendo ambiguidades das solicitações
- Adicionando detalhes concretos
- Comparando solicitações vagas e específicas