Instruções excessivamente vagas
A principal falha das solicitações: pedir “algo bom” sem definir o que é bom.
Instruções excessivamente vagas é uma aula grátis de AI Prompt Engineering no CoddyKit. Esta é a aula 1 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.
A armadilha da imprecisão
O erro mais comum de iniciantes ao escrever instruções é a imprecisão: escrever instruções tão gerais que o modelo não consegue produzir de forma confiável aquilo que você realmente deseja.
"Escreva algo bom sobre IA."
Esta instrução não contém informações sobre formato, público, extensão, tom, abordagem ou finalidade. O modelo produzirá alguma coisa — mas a probabilidade de ela corresponder ao que você tinha em mente é baixa. Instruções imprecisas produzem saídas inconsistentes e difíceis de prever, que exigem muita edição.
O que torna uma instrução imprecisa?
Uma instrução é imprecisa quando não contém uma ou mais das dimensões de que o modelo precisa para tomar uma boa decisão. As principais dimensões são:
- O quê — o tópico ou a tarefa específicos
- Quem — o público-alvo
- Por quê — a finalidade ou o objetivo
- Como — o formato, a estrutura e o estilo
- Quanto — a extensão ou o escopo
Você nem sempre precisa das cinco, mas, quanto mais dimensões estiverem ausentes, mais o modelo terá de adivinhar — e as suposições introduzem variabilidade.
Diagnosticando a imprecisão: as cinco perguntas
Antes de enviar uma instrução, faça estas cinco perguntas de diagnóstico:
- O que está sendo solicitado especificamente? (não apenas "escreva sobre X" — que tipo de saída é desejada?)
- Quem é o público? (um especialista no assunto? um iniciante? uma pessoa específica?)
- Para que a saída será usada?
- Em que formato e com que extensão ela precisa ser?
- Há alguma restrição ou algo que deve ser evitado?
Se não conseguir responder à maioria dessas perguntas, a instrução está imprecisa demais. Dedique 60 segundos a acrescentar as respostas antes de enviá-la.
Impreciso vs. específico: lado a lado
Impreciso: "Fale sobre aprendizado de máquina."
Específico: "Escreva uma explicação de 200 palavras sobre o que é aprendizado de máquina, destinada a um pequeno empresário sem conhecimentos técnicos que está avaliando se deve usar uma ferramenta de IA no atendimento ao cliente. Use linguagem cotidiana, sem termos técnicos. Concentre-se no que ele faz, não em como funciona internamente."
A versão específica fornece ao modelo tudo de que ele precisa: tópico, público, extensão, nível de vocabulário e área de foco. A saída será muito mais útil já na primeira tentativa.
O problema da tarefa pouco especificada
Muitas instruções imprecisas sofrem com uma tarefa pouco especificada — o tipo de saída não está claro. "Escreva sobre mudanças climáticas" pode significar:
- Um artigo explicativo baseado em fatos
- Um ensaio persuasivo
- Um poema
- Uma publicação para redes sociais
- Uma análise de riscos empresariais
- Uma história infantil
Todas essas são saídas válidas para essa instrução. Quando o tipo de tarefa não é especificado, o modelo recorre ao padrão mais comum em seus dados de treinamento — geralmente um ensaio informativo genérico, que pode não ser o que você precisa.
O problema da ausência de público
O público-alvo é uma das dimensões de maior impacto em uma instrução. O mesmo tópico deve ser explicado de maneiras completamente diferentes para públicos diferentes:
- "Explique redes neurais a um engenheiro de aprendizado de máquina" → profundidade técnica, terminologia específica e exemplos de código
- "Explique redes neurais a uma criança de 12 anos" → baseado em analogias, sem equações e com exemplos concretos
- "Explique redes neurais a um executivo de marketing" → impacto empresarial, não funcionamento, com foco em ROI
Sem especificar o público, o modelo escolhe um aleatoriamente. Essa escolha costuma estar errada para o seu caso de uso real.
Corrigindo a imprecisão de forma sistemática
Uma abordagem sistemática para transformar instruções imprecisas em instruções específicas: use o framework WHO-WHAT-FOR-HOW-HOW-MUCH para expandir cada dimensão:
VAGUE_PROMPT = 'Write something about productivity.'
# Expand each dimension:
who = 'remote software engineers who struggle with context-switching between tasks'
what = 'a practical guide to the Pomodoro Technique'
for_what = 'a company internal newsletter'
how = 'numbered steps, conversational tone, include one counterintuitive tip'
how_much = '250 words'
SPECIFIC_PROMPT = (
f'Write {what} for {who}. '
f'This will appear in {for_what}. '
f'Format: {how}. '
f'Length: {how_much}.'
)
print(SPECIFIC_PROMPT)
# Output: Write a practical guide to the Pomodoro Technique for remote software engineers
# who struggle with context-switching between tasks. This will appear in a company internal
# newsletter. Format: numbered steps, conversational tone, include one counterintuitive tip.
# Length: 250 words.Palavras imprecisas comuns às quais se deve estar atento
Certas palavras em instruções quase sempre são imprecisas e devem acionar uma verificação de especificidade:
- Bom — bom segundo qual padrão? Quem decide o que é bom?
- Melhor — melhor do que o quê?
- Apropriado — apropriado para qual contexto ou público?
- Profissional — profissional em qual setor? Em qual nível de formalidade?
- Melhorar — melhorar em qual dimensão? Clareza? Extensão? Precisão?
- Interessante — interessante para quem?
Quando encontrar essas palavras na sua própria instrução, faça a pergunta complementar que elas sugerem. A resposta se torna a instrução específica.
O espectro da especificidade
A especificidade existe em um espectro — você nem sempre precisa do nível máximo de especificidade. O nível adequado depende da tarefa:
- Exploração criativa — uma especificidade menor é intencional. Instruções imprecisas produzem uma variedade surpreendente.
- Produção rotineira — é necessária alta especificidade para garantir consistência e reutilização
- Recuperação de informações factuais — uma alta especificidade ajuda o modelo a se concentrar no aspecto correto
- Tempestade de ideias — especificidade média: defina o domínio, mas mantenha as ideias abertas
A imprecisão é um erro quando você precisa de uma saída específica. Ela é uma característica útil quando você deseja liberdade criativa.
Usando exemplos de saída para substituir instruções imprecisas
Às vezes, a maneira mais eficiente de corrigir uma instrução imprecisa é acrescentar um exemplo da saída desejada, em vez de tentar descrevê-la com palavras:
"Escreva um slogan de produto neste estilo: 'Faça mais com menos.' 'Pense diferente.' 'Apenas faça.'"
Os exemplos eliminam a necessidade de definir abstratamente termos como 'conciso', 'impactante', 'voz da marca' e 'memorável'. O modelo extrai o padrão dos exemplos com mais confiabilidade do que o infere a partir de descritores. Os exemplos costumam ser a correção de especificidade mais eficiente disponível.
Calibrando a especificidade: nem de menos, nem demais
O excesso de especificação é o erro oposto à imprecisão. Uma instrução com 15 restrições altamente específicas pode produzir uma saída que atende tecnicamente a todas elas, mas parece mecânica e inadequada.
Faça a calibração perguntando: "Se eu entregar esta instrução a alguém que nunca trabalhou comigo, o que essa pessoa produzirá?" Se uma pessoa competente conseguir produzir o que você precisa a partir da instrução, ela é específica o suficiente. Se essa pessoa precisar fazer perguntas de esclarecimento, acrescente as respostas à instrução. Se ela se sentir excessivamente limitada, remova algumas restrições.
Verificação de conhecimento: identificando a imprecisão
Classifique estas quatro instruções da mais imprecisa à mais específica:
(A) "Escreva sobre liderança."
(B) "Escreva um artigo de 300 palavras sobre liderança servidora para gestores em seu primeiro cargo de gestão em uma empresa de tecnologia em fase inicial, com foco em três comportamentos específicos que eles possam praticar nos primeiros 30 dias."
(C) "Escreva um artigo sobre liderança que seja bom."
(D) "Escreva um artigo sobre estilos de liderança para gestores."
Recapitulação: instruções excessivamente imprecisas
A imprecisão é o erro mais comum ao escrever instruções porque é fácil redigi-las rapidamente de forma imprecisa. O custo é uma saída inconsistente e imprevisível que exige muita edição.
A solução é sistemática: especifique WHO (público), WHAT (tipo de tarefa), FOR (finalidade), HOW (formato e estilo) e HOW MUCH (extensão). Fique atento a palavras imprecisas comuns (bom, melhor, apropriado, profissional) e substitua-as por respostas específicas à pergunta que elas sugerem. Quando a descrição não for suficiente, use exemplos.
Na próxima lição, você abordará requisitos contraditórios — o problema oposto à imprecisão.
Perguntas Frequentes
A aula “Instruções excessivamente vagas” é grátis?
Sim — o texto completo de “Instruções excessivamente vagas” é 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 “Instruções excessivamente vagas”?
A principal falha das solicitações: pedir “algo bom” sem definir o que é bom. 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 1 de 4.
Quanto tempo leva a aula “Instruções excessivamente vagas”?
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
- Instruções excessivamente vagas
- Requisitos contraditórios
- Erros por falta de contexto
- Diagnosticando e corrigindo solicitações ruins