Skip to main content

Escrever boas instruções (prompt) para o agente

Escreva instruções claras para o agente saber quem é, o que deve fazer e o que nunca pode fazer — é o que separa um atendimento bom de um genérico.

🧩 Este recurso faz parte do módulo Agentes Inteligentes. Se ele não aparecer na sua conta, fale com o administrador para ativá-lo. Veja Planos e módulos.

Objetivo

Preencher bem as Instruções (system prompt) e o Objetivo do agente para que ele responda no tom e nos limites certos.

Pré-requisitos

  • Perfil Administrador
  • Módulo Agentes Inteligentes ativo
  • Um agente criado (veja Criar um agente de IA no buildercriar-agente-ia)
  • Acesse pelo computador — esta tela não está disponível no celular

Tempo estimado

15 minutos.

Caminho de acesso

Bots → Agentes InteligentesIA → abamenu Agentesdo card do agente → abra o agenteEditar → passo Comportamento

Passo a passo

  1. AbraNa lista de Agentes IA, abra o menu (ícone ⋮) do card do agente e václique em Editar. Vá ao passo Comportamento.

🖼️ PRINT — Passo Comportamento com o campo Instruções (system prompt), o editor Estágios da conversa e o campo OutrasComportamento e regras /específicas restrições(opcional).

  1. No campo Instruções (system prompt), descreva em texto corrido: quem é o agente, o público que atende, o objetivo da conversa e como ele deve se comportar. Seja específico — "Você é o atendente virtual da Loja X, especializado em tênis de corrida" funciona melhor do que "Seja útil".
  2. Se quiser guiar a conversa por etapas, use Estágios da conversa: até 12 estágios, cada um com um nome (ex.: "Qualificação") e uma descrição do que fazer ali. É opcional — o agente também funciona sem nenhum estágio definido.
Liste no campo OutrasComportamento e regras /específicas restrições(opcional) os limites inegociáveis, um por linha (ex.: "Nunca prometer descontos", "Não falar de concorrentes", "Quando não souber, transferir para um humano"). No passo Perfil, alinhe o Tom (Consultivo e Acolhedor, Neutro e Equilibrado ou Formal e Institucional), o Formato / comprimento e o Objetivo com o que você escreveu nas instruções — eles se reforçam. Para ajustar o tamanho das respostas, o campo Formato da resposta fica no passo Configurações, dentro de Configurações avançadas. Clique em Salvar e teste o agente em uma conversa real (botão Conversar, na lista de agentes) antes de deixá-lo Ativo.

Resultado esperado

O agente responde no tom escolhido, mantém o foco no objetivo e respeita as restrições que você listou. Ao pré-visualizarescolher oum Tom e o Formato / comprimento no passo Perfil, você vê um exemplo de resposta no estilo selecionado.selecionado; o mesmo vale para o Formato da resposta, no passo Configurações.

Erros comuns

  • Sintoma: o agente foge do assunto ou inventa informação. Solução: deixe as Instruções mais específicas e vincule uma base de conhecimento com as respostas oficiais (veja Alimentar a base de base-conhecimento (upload de documentos / RAG)).
  • Sintoma: as respostas ficam longas ou curtas demais. Solução: ajuste o Formato /da comprimentoresposta, no passo Configurações → Configurações avançadas, e reforce o tamanho desejado nas Instruções.
  • Sintoma: o agente não transfere quando deveria. Solução: deixe explícito nas regras quando transferir e configure a habilidade TransferênciaTransferir paraatendimento, humanono passo Comportamento (veja Definir supervisão humana e hand-off para agente humanosupervisao-handoff).

Artigos relacionados