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.
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
- 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."
- Dê contexto do negócio: o que a empresa vende, horários, políticas, o que NÃO deve prometer.
- 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.
- 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.
- Indique o tom e o formato: respostas curtas, sem jargão, uma pergunta por vez. O Tom também se ajusta na aba Comportamento.
- Liste as ações disponíveis. Se o agente tem ferramentas (agendar consulta, atualizar contato, transferir), explique quando usar cada uma.
- 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
Artigos relacionados
-
Crie seu primeiro agente de IA
Aprenda o que um agente de IA faz no Omnifox, como dar instrucoes, conecta-lo a um canal e testa-lo no sandbox antes de falar com clientes reais.
-
Como escrever boas instruções para seu agente de IA
Aprenda a redigir instruções claras para que seu agente de IA responda com o tom, os limites e as ações corretas.
-
Guia completo dos Agentes de IA
Os Agentes de IA a fundo, em 65 capítulos: criar, instruções, ferramentas, conhecimento, comportamento, teste, caixa de entrada, fluxos, análise e consumo, com cada opção explicada.
-
Conectar seu agente de IA ao WhatsApp, Instagram, Messenger e chat do site
Um agente sem canais não atende ninguém. Conecte-o ao seu WhatsApp, Instagram, Messenger ou ao chat do seu site na seção Conexões e ative-o para ele começar a responder.
-
Comece aqui: os Agentes de IA em 8 minutos
O essencial dos Agentes de IA em um vídeo curto: criar um agente, as instruções, ferramentas, conhecimento, canais, o teste, o horário e a passagem para uma pessoa.