Saltar para o conteúdo principal

​
Visão geral

O campo Instruções (também chamado de prompt do sistema) é onde você define a personalidade do seu agente, estilo conversacional, objetivos e regras comportamentais. Esta é a configuração mais importante para o sucesso do seu agente. As instruções são um bloco de texto enviado ao modelo de IA a cada turno de conversa. Elas dizem ao modelo:
  • Quem ele é (papel e identidade)
  • Como se comportar (tom, estilo, limites)
  • O que alcançar (objetivos e metas)
  • Quando usar ferramentas (ações, conhecimento, transferências)
A plataforma fornece automaticamente histórico de conversação, dados de contato e conteúdo da base de conhecimento. Foque suas instruções em regras e orientações que só você pode fornecer.

​
O editor de instruções

O editor de instruções inclui recursos úteis para facilitar a escrita de instruções:

Editor de texto grande

Editor espaçoso para escrever instruções detalhadas

Suporte Jinja

Templates Jinja2 completos com variáveis e condicionais

Templates de prompts

Templates pré-construídos para casos de uso comuns

Destaque de sintaxe

Destaque de sintaxe Jinja e detecção de erros
Editor de instruções do agente mostrando área de texto com botões Templates e Guia de escrita, assistente de variáveis, contador de tokens e controles de salvamento
Editor de instruções do agente mostrando área de texto com botões Templates e Guia de escrita, assistente de variáveis, contador de tokens e controles de salvamento

​
Uso de templates de prompts

O editor de instruções inclui uma Biblioteca de prompts com templates prontos para uso:
  • Qualificação de leads - Vendas B2B com framework BANT
  • Agendamento de consultas - Agendamento de serviços com confirmações
  • Feedback de clientes - Pesquisas NPS com fluxos de recuperação
  • Coleta de informações - Pesquisa e coleta de dados
  • Prospecção - Cold calling com abordagem focada em valor
  • Específicos do setor - Saúde, imobiliário, serviços domésticos e mais
Para usar um template:
  1. Clique em “Navegar templates” no editor de instruções
  2. Selecione um template que corresponda ao seu caso de uso
  3. Personalize os espaços reservados (company_name, service_type, etc.)
  4. Teste e refine com base em suas necessidades específicas
Biblioteca de templates de prompts mostrando templates disponíveis em modo claro
Os templates seguem uma estrutura comprovada: Papel → Objetivo → Fluxo de conversa → Referência rápida. Comece com um template e adapte em vez de começar do zero.

​
Estrutura básica de instruções

Aqui está um template simples para começar: 
Você é [NOME/PAPEL] para [NOME DA EMPRESA].

Seu papel:
- [Responsabilidade principal]
- [Responsabilidade secundária]
- [Tarefas adicionais]

Tom: [Descrever estilo de comunicação]

Diretrizes importantes:
- [Regra chave 1]
- [Regra chave 2]
- [Regra chave 3]

Quando [SITUAÇÃO], você deve [AÇÃO].

​
Exemplo: Agente de suporte ao cliente

Você é Alex, um agente de suporte ao cliente amigável para Acme Software.

Seu papel:
- Responder perguntas de clientes sobre nossos produtos e serviços
- Solucionar problemas técnicos comuns
- Fornecer informações de conta quando solicitado
- Escalar problemas complexos para suporte humano

Tom: Profissional mas caloroso, paciente e prestativo. Mantenha respostas concisas e claras.

Diretrizes importantes:
- Sempre cumprimente os clientes calorosamente e pergunte como pode ajudar
- Nunca faça promessas sobre recursos ou preços sobre os quais não tem certeza
- Se não souber algo, admita honestamente e ofereça transferir
- Confirme o entendimento antes de passar para as soluções
- Termine perguntando se há mais alguma coisa com que possa ajudar

Quando um cliente mencionar problemas de faturamento, forneça informações básicas mas sempre ofereça transferir para o departamento de faturamento para ajuda detalhada.

​
O que o agente já sabe

A plataforma fornece automaticamente o seguinte contexto ao seu agente a cada turno de conversa. Você não precisa incluí-los em suas instruções:
O histórico completo da conversa entre o agente e o contato, incluindo todas as mensagens e chamadas de ferramentas.
Dados de contato como nome, e-mail e número de telefone. Acessível via variáveis como {{ contact.first_name }}.
Quando relevante, a plataforma recupera e inclui automaticamente conteúdo de suas bases de conhecimento.
A plataforma informa ao agente quais ações estão disponíveis (transferir, agendar consulta, ações API personalizadas). Você só precisa explicar quando usá-las.
O agente sabe automaticamente a data, hora e fuso horário atuais.

​
Erros comuns

Mantenha instruções abaixo de 3000 palavras. Instruções longas confundem o modelo e diminuem tempos de resposta.Solução: Foque em regras essenciais e fluxo de conversa. Mova fatos e políticas para bases de conhecimento.
“Seja prestativo” não fornece orientação acionável.Solução: Seja específico. Em vez disso escreva: “Responda perguntas em menos de 30 segundos, faça uma pergunta de esclarecimento por vez e confirme o entendimento antes de fornecer soluções.”
Instruções conflitantes confundem o agente.Solução: Revise cuidadosamente para garantir que as diretrizes não se contradigam. Teste minuciosamente.
Fatos, detalhes de produtos e políticas pertencem a bases de conhecimento, não a instruções.Solução: Mova todo conteúdo factual para bases de conhecimento. Instruções devem conter apenas regras comportamentais e orientação de conversa.
Condicionais profundamente aninhadas e lógica Jinja complexa frequentemente falham.Solução: Mantenha a lógica simples e clara. Use instruções if/then diretas.Alternativa: Construa uma equipe de agentes que possam se transferir mutuamente, cada um com uma tarefa dedicada e instruções mais simples.
Nomes de ações incompatíveis impedem que o agente use ações corretamente.Solução: Sempre referencie nomes de ações exatos da seção Ações. Copie-os diretamente da interface.

​
Próximos passos

Guia de engenharia de prompts

Técnicas avançadas para escrever instruções eficazes

Mensagens de saudação

Configure como conversas começam

Variáveis e conteúdo dinâmico

Domine templates Jinja e variáveis

Teste seu agente

Aprenda a testar seu agente efetivamente