Guia de Engenharia de Prompts

Instale o skill via CLI belt: npx skills add belt-sh/cli

O que Guia de Engenharia de Prompts faz?

Domine a engenharia de prompts para modelos de IA via inference.sh CLI.

Início Rápido

Requer a CLI inference.sh (belt). Instruções de instalação

belt login

# Prompt LLM bem estruturado
belt app run openrouter/claude-sonnet-45 --input '{
  "prompt": "Você é um engenheiro de software sênior. Revise este código em busca de vulnerabilidades de segurança:\n\n```python\nuser_input = request.args.get(\"query\")\nresult = db.execute(f\"SELECT * FROM users WHERE name = {user_input}\")\n```\n\nForneça problemas específicos e correções."
}'

Prompts para LLM

Estrutura Básica

[Papel/Contexto] + [Tarefa] + [Restrições] + [Formato de Saída]

Definição de Papel

belt app run openrouter/claude-sonnet-45 --input '{
  "prompt": "Você é um cientista de dados especialista com 15 anos de experiência em aprendizado de máquina. Explique gradiente descendente para um iniciante, usando analogias simples."
}'

Clareza da Tarefa

# Ruim: vago
"Ajude-me com meu código"

# Bom: específico
"Depure esta função Python que deveria retornar a soma de números pares de uma lista, mas retorna 0 para todas as entradas:

def soma_pares(numeros):
    total = 0
    for n in numeros:
        if n % 2 == 0:
            total += n
        return total

Identifique o bug e forneça o código corrigido."

Cadeia de Pensamento (Chain-of-Thought)

belt app run openrouter/claude-sonnet-45 --input '{
  "prompt": "Resolva passo a passo:\n\nUma loja vende maçãs por R$ 2 cada e laranjas por R$ 3 cada. Se alguém comprar 5 frutas e gastar R$ 12, quantas de cada fruta comprou?\n\nPense passo a passo antes de dar a resposta final."
}'

Exemplos Few-Shot

belt app run openrouter/claude-sonnet-45 --input '{
  "prompt": "Converta estas frases para inglês empresarial formal:\n\nExemplo 1:\nEntrada: Vou te mandar o relatório amanhã\nSaída: Irei enviar-lhe o relatório amanhã.\n\nExemplo 2:\nEntrada: Não posso ir à reunião, surgiu um imprevisto\nSaída: Peço desculpas, mas não poderei comparecer à reunião devido a uma circunstância imprevista.\n\nAgora converta:\nEntrada: Ei, podemos adiar um pouco o prazo?"
}'

Especificação de Formato de Saída

belt app run openrouter/claude-sonnet-45 --input '{
  "prompt": "Analise o sentimento destas avaliações de clientes. Retorne um array JSON com objetos contendo \"texto\", \"sentimento\" (positivo/negativo/neutro) e \"confiança\" (0-1).\n\nAvaliações:\n1. \"Ótimo produto, entrega rápida!\"\n2. \"Hmm, é ok, eu acho\"\n3. \"Pior compra de todas, perda total de dinheiro\"\n\nRetorne apenas JSON válido, sem explicação."
}'

Definição de Restrições

belt app run openrouter/claude-sonnet-45 --input '{
  "prompt": "Resuma este artigo em exatamente 3 marcadores. Cada marcador deve ter menos de 20 palavras. Foque apenas em insights acionáveis, não em informações de contexto.\n\n[texto do artigo]"
}'

Prompts para Geração de Imagens

Estrutura Básica

[Assunto] + [Estilo] + [Composição] + [Iluminação] + [Técnico]

Descrição do Assunto

# Ruim: vago
"um gato"

# Bom: específico
belt app run falai/flux-dev --input '{
  "prompt": "Um gato laranja felpudo com olhos verdes, sentado em uma poltrona de couro vintage"
}'

Palavras-chave de Estilo

belt app run falai/flux-dev --input '{
  "prompt": "Fotografia de retrato de uma mulher, filmada com filme Kodak Portra 400, iluminação natural suave, profundidade de campo rasa, clima nostálgico, estética de fotografia analógica"
}'

Controle de Composição

belt app run falai/flux-dev --input '{
  "prompt": "Plano geral de abertura de um horizonte de cidade cyberpunk à noite, composição regra dos terços, letreiros de neon em primeiro plano, arranha-céus imponentes ao fundo, ruas molhadas pela chuva"
}'

Palavras-chave de Qualidade

fotorrealista, 8K, ultra detalhado, foco nítido, profissional,
obra-prima, alta qualidade, melhor qualidade, detalhes intrincados

Prompts Negativos

belt app run falai/flux-dev --input '{
  "prompt": "Retrato profissional, fundo limpo",
  "negative_prompt": "borrado, distorcido, membros extras, marca d\'água, texto, baixa qualidade, cartoon, anime"
}'

Prompts para Vídeo

Estrutura Básica

[Tipo de Plano] + [Assunto] + [Ação] + [Cenário] + [Estilo]

Movimento de Câmera

belt app run google/veo-3-1-fast --input '{
  "prompt": "Movimento lento de câmera seguindo uma mulher caminhando por uma floresta ensolarada, iluminação de hora dourada, profundidade de campo rasa, cinematográfico, 4K"
}'

Descrição de Ação

belt app run google/veo-3-1-fast --input '{
  "prompt": "Close das mãos amassando massa de pão em uma superfície de madeira, farinha flutuando na luz da manhã, câmera lenta, estética acolhedora de padaria"
}'

Palavras-chave Temporais

câmera lenta, timelapse, tempo real, movimento suave,
plano contínuo, cortes rápidos, momento congelado

Técnicas Avançadas

Prompts de Sistema

belt app run openrouter/claude-sonnet-45 --input '{
  "system": "Você é um assistente de codificação útil. Sempre forneça código com comentários. Se não tiver certeza sobre algo, diga em vez de adivinhar.",
  "prompt": "Escreva uma função Python para validar endereços de e-mail usando regex."
}'

Saída Estruturada

belt app run openrouter/claude-sonnet-45 --input '{
  "prompt": "Extraia informações deste texto e retorne como JSON:\n\n\"João Silva, CEO da TechCorp, anunciou ontem que a empresa levantou R$ 50 milhões em rodada Série B. A rodada foi liderada pela Venture Partners.\"\n\nSchema:\n{\n  \"pessoa\": string,\n  \"cargo\": string,\n  \"empresa\": string,\n  \"evento\": string,\n  \"valor\": string,\n  \"investidor\": string\n}"
}'

Refinamento Iterativo

# Comece amplo
belt app run falai/flux-dev --input '{
  "prompt": "Um castelo em uma colina"
}'

# Adicione especificidades
belt app run falai/flux-dev --input '{
  "prompt": "Um castelo medieval de pedra em uma colina gramada"
}'

# Adicione estilo
belt app run falai/flux-dev --input '{
  "prompt": "Um castelo medieval de pedra em uma colina gramada, pôr do sol dramático, arte fantástica, composição épica"
}'

# Adicione técnica
belt app run falai/flux-dev --input '{
  "prompt": "Um castelo medieval de pedra em uma colina gramada, pôr do sol dramático, arte fantástica no estilo de Greg Rutkowski, composição épica, 8K, altamente detalhado"
}'

Raciocínio em Múltiplas Etapas

# Primeiro: analise
belt app run openrouter/claude-sonnet-45 --input '{
  "prompt": "Analise este problema de negócio: Nosso site de e-commerce tem uma taxa de abandono de carrinho de 70%. Liste possíveis causas."
}'

# Segundo: priorize
belt app run openrouter/claude-sonnet-45 --input '{
  "prompt": "Dadas estas causas de abandono de carrinho: [saída anterior], classifique-as por impacto provável e facilidade de correção. Formate como uma matriz de prioridades."
}'

# Terceiro: plano de ação
belt app run openrouter/claude-sonnet-45 --input '{
  "prompt": "Para as 3 principais causas identificadas, forneça testes A/B específicos que podemos realizar para validar e corrigir cada problema."
}'

Dicas Específicas por Modelo

Claude

• Excelente em instruções com nuances
• Responde bem a interpretação de papéis
• Bom em seguir restrições complexas
• Prefere formatos de saída explícitos

GPT-4

• Forte em geração de código
• Funciona bem com exemplos
• Boa saída estruturada
• Responde a "vamos pensar passo a passo"

FLUX

• Descrições detalhadas de assunto
• Referências de estilo funcionam bem
• Palavras-chave de iluminação importantes
• Prompts negativos suportados

Veo

• Palavras-chave de movimento de câmera
• Linguagem cinematográfica funciona bem
• Descrições de ação importantes
• Incluir contexto temporal

Erros Comuns

Erro	Problema	Solução
Muito vago	Saída imprevisível	Adicione especificidades
Muito longo	Modelo perde o foco	Priorize informações-chave
Conflitante	Confunde o modelo	Remova contradições
Sem formato	Saída inconsistente	Especifique o formato
Sem exemplos	Expectativas pouco claras	Adicione few-shot

Modelos de Prompt

Revisão de Código

Revise este código [linguagem] para:
1. Bugs e erros de lógica
2. Vulnerabilidades de segurança
3. Problemas de desempenho
4. Estilo de código/melhores práticas

Código:
[código]

Para cada problema encontrado, forneça:
- Número da linha
- Descrição do problema
- Severidade (alta/média/baixa)
- Correção sugerida

Escrita de Conteúdo

Escreva um [tipo de conteúdo] sobre [tópico].

Público-alvo: [público-alvo]
Tom: [formal/casual/profissional]
Extensão: [contagem de palavras]
Pontos-chave a abordar:
1. [ponto 1]
2. [ponto 2]
3. [ponto 3]

Incluir: [elementos específicos]
Evitar: [coisas a excluir]

Geração de Imagens

[Assunto com detalhes], [cenário/fundo], [tipo de iluminação],
[estilo de arte ou fotografia], [composição], [palavras-chave de qualidade]

Skills Relacionados

# Guia de prompts para vídeo
npx skills add inference-sh/skills@video-prompting-guide

# Modelos LLM
npx skills add inference-sh/skills@llm-models

# Geração de imagens
npx skills add inference-sh/skills@ai-image-generation

# Skill completo da plataforma
npx skills add inference-sh/skills@infsh-cli

Navegue por todos os apps: belt app list