AI Prompt Engineering · Aula

Adicionando detalhes concretos

Números, nomes, formatos e exemplos que orientam os resultados da IA.

Aula 3 de 413 etapas

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.'

  1. Adicione a função: 'Para um engenheiro sênior de aprendizado de máquina'
  2. Adicione uma entidade nomeada: 'em uma startup de IA Série B em Londres'
  3. Adicione a contagem de palavras: '350-400 palavras'
  4. Adicione o público-alvo: 'para candidatos com mais de 5 anos de experiência'
  5. Adicione a estrutura: 'Formato: introdução, responsabilidades (8 tópicos), requisitos (5 tópicos), diferenciais (3 tópicos)'
  6. 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:

  1. Posso substituir alguma palavra vaga por um número?
  2. Posso indicar uma ferramenta, tecnologia ou pessoa específica?
  3. Posso descrever o público-alvo com mais precisão?
  4. Posso adicionar um exemplo do que desejo?
  5. Posso adicionar pelo menos uma restrição do tipo 'não incluir'?
  6. 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
Grátis para começar

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

  1. Por que a especificidade é importante
  2. Removendo ambiguidades das solicitações
  3. Adicionando detalhes concretos
  4. Comparando solicitações vagas e específicas
← Voltar para AI Prompt Engineering