Boas práticas: escrever prompts eficazes e checklist de testes

Como redigir as instruções do sistema do seu agente de IA e um checklist para testá-las antes de publicar.

Jun 26, 2026

Veja este passo no vídeo · Como escrever boas instruções

As Instruções do sistema (o prompt) são o que define como o seu agente de IA pensa, responde e age. Um bom prompt é a diferença entre um bot que confunde o cliente e um que resolve. Este guia reúne práticas concretas para escrever prompts eficazes no Omnifox, além de um checklist para testá-los antes de publicar.

Onde fica o prompt

Abra o seu agente em Agentes de IA e vá até a aba Instruções. Lá está o campo Instruções do sistema, com Modelos de instruções (Vendas, Suporte, FAQ, Recepção e mais), Variáveis inseríveis e o botão Otimizar com IA.

Como escrever um bom prompt

  1. Defina o papel e o objetivo na primeira linha. Ex.: "Você é o assistente de vendas da [empresa]. Seu objetivo é qualificar o lead e agendar uma demonstração."
  2. Dê contexto do negócio: o que a empresa vende, horários, políticas, o que NÃO deve prometer.
  3. Estabeleça limites claros. Diga o que fazer quando não souber algo: "Se não tiver o dado, ofereça transferir para um humano" em vez de inventar.
  4. Use variáveis em vez de texto fixo: insira Nome do contato, Idioma, Canal, Data de hoje pelo painel Variáveis. A mensagem se personaliza sozinha.
  5. Indique o tom e o formato: respostas curtas, sem jargão, uma pergunta por vez. O Tom também se ajusta na aba Comportamento.
  6. Liste as ações disponíveis. Se o agente tem ferramentas (agendar consulta, atualizar contato, transferir), explique quando usar cada uma.
  7. Evite instruções contraditórias. "Seja breve" e "explique em detalhes" no mesmo prompt confundem o modelo.

Quando tiver um rascunho, use Otimizar com IA: ele gera uma versão otimizada do prompt que você pode revisar e aplicar.

Checklist de testes (antes de publicar)

Use o Sandbox (Testador ao vivo) do agente. Percorra esta lista:

  • Saudação e caso feliz: o agente se apresenta bem e resolve a consulta típica.
  • Pergunta fora de escopo: ele transfere para um humano em vez de inventar?
  • Dados faltando: ele pede a informação necessária antes de agir?
  • Personalização: carregue um contato real com Carregar contato real e confirme que ele usa o nome/idioma.
  • Ferramentas: ele dispara a ação certa (agendar, etiquetar, transferir) no momento certo?
  • Tom e idioma: ele responde no idioma do cliente e com o tom definido?
  • Mensagens hostis ou ambíguas: ele mantém a calma e não sai do papel?
  • Tamanho da resposta: ele respeita o limite de Máx. de tokens por resposta?

Use Reiniciar conversa entre cenários para que o histórico não contamine o teste.

Se não funcionar

  • O agente ignora uma instrução: coloque-a mais acima e mais explícita; os modelos priorizam o que vem primeiro.
  • Ele inventa dados: adicione uma regra anti-alucinação e conecte uma Base de conhecimento.
  • Respostas longas demais: reduza o Máx. de tokens por resposta na aba Comportamento.

Dicas

  • Mude uma coisa de cada vez e teste de novo: assim você sabe o que causou a melhora.
  • Salve versões: o Histórico da aba Instruções permite comparar e voltar atrás.

Artigos relacionados

Isso foi útil?

Artigos relacionados

Fale conosco no WhatsApp