Configurar Agente

​

1. Motor: O Cérebro do Seu Agente 🧠

​

✏️ Prompt

• Exemplo Amigável:

  “Você é um assistente amigável e direto 🌞. Responda em português em 2–3 frases. Se não souber a resposta, ofereça transferir para um humano.”

• Exemplo Especialista:

  “Você é um técnico sênior 🛠️. Forneça passos numerados e concretos. Seja breve e profissional.”

​

⚙️ Recursos Adicionais

💡 Dica Pro: Sempre teste alterações de toggle no Playground antes de publicar. Um recurso que parece inofensivo pode quebrar a experiência em certos canais.

​

2. Guardrails: Ninguém Quer um Robô Descontrolado! 🚧

​

🛡️ O que você deve configurar aqui?

1. Segurança (PII): Proíba solicitar senhas ou dados de cartão.
2. Tom e Escopo: Impeça um bot de farmácia de aconselhar sobre reparos de carros.
3. Escalação: Diga quando desistir e chamar um humano.

​

📝 Template Copiar e Colar (Segurança Básica)

- Estas regras são OBRIGATÓRIAS.
- 🚫 Nunca solicite ou revele senhas ou dados bancários/cartão.
- Se o assunto for sensível, diga: "Não posso lidar com isso, posso conectá-lo com um humano?".
- Mantenha um tom profissional. Não use gírias ofensivas.
- Se perguntarem sobre concorrentes, diga educadamente que não possui essa informação.

💡 Dica Pro: Se você alterar um guardrail, sempre teste no Playground. Uma regra mal configurada pode silenciar seu bot!

​

3. Tópicos e FAQs: Guie a Conversa 📋

​

🗂️ Prompt de Tópico

• Exemplo: “Quando o usuário perguntar sobre faturamento, guie-o pela nossa política de reembolso passo a passo antes de oferecer escalação.”

​

⭐ Avaliação de FAQs

• Mensagem: O texto mostrado ao usuário no final (ex.: “Esta resposta foi útil?”).
• Botão #1 / Botão #2: Opções de resposta rápida (ex.: 👍 Sim / 👎 Não).

💡 Dica Pro: Use mensagens de avaliação claras e amigáveis. Ciclos curtos de feedback melhoram seu agente ao longo do tempo!

​

4. Campos com Instruções: Dados Inteligentes 💡

​

⚙️ Como funciona (Adicionar campo)

1. Nome: O nome interno (ex.: horario_loja). Use snake_case.
2. Tipo: Que tipo de dado é? As opções incluem String, Number, Boolean, List.
3. Instruções: A mágica. Diga ao bot como e quando usar esses dados.
   • Ruim: “Horário”.
   • Bom: “Se o usuário perguntar quando abrimos, responda com este valor exato.”
4. Valor de retorno: A resposta real que o bot vai exibir.

​

🚀 Exemplos Prontos para Usar

• 📅 Horário de Funcionamento Fixo
  • Instruções: “Se perguntarem sobre horário de funcionamento, use este valor com o texto ‘Nosso horário de funcionamento é…’.”
  • Valor: 09:00 - 18:00 Segunda a Sexta
• 📍 Endereço
  • Instruções: “Forneça este endereço completo quando perguntarem pela localização.”
  • Valor: Rua Exemplo, 123, São Paulo
• 📦 Fazemos entregas? (Booleano)
  • Instruções: “Se verdadeiro, confirme que fazemos entregas; se falso, diga que é apenas retirada.”
  • Valor: true

​

5. Eventos: Superpoderes e Ações ⚡

​

🔗 Para que servem?

• 👨‍💻 Hand-off: A clássica transferência para um humano.
• 🎟️ Criar Tickets: Relatar bugs ao Jira ou Zendesk automaticamente.
• 📡 Webhooks: Enviar dados para seu CRM ou API.

​

🛠️ Configure seu primeiro evento

1. Nome: Identificador único (ex.: intent-agent-step-1, criar_ticket).
2. Descrição: CRUCIAL! Explique quando ele é disparado. O bot lê isso para decidir quando ativá-lo.
   • Exemplo: “Dispare este evento quando o usuário disser ‘Quero falar com uma pessoa’ ou parecer irritado.”

​

🌟 Evento mais usado: Transferência para Humano

• Nome: intent-agent-step-1
• Descrição: “Ative isso imediatamente se o usuário pedir para falar com um consultor, suporte humano ou uma pessoa real.”
• Ação (no seu backend): Configure o webhook para atribuir o chat a um agente ao vivo.

​

6. Ferramentas e Escalação: Configurações de Transferência 🤝

​

🔧 Ferramentas

• Configuração do Fluxo de Transferência do Agente: Quando habilitado, permite que você defina exatamente como o agente de IA transferirá uma conversa para um agente humano. Configure a lógica de transferência, gatilhos e etapas do fluxo aqui.

​

👤 Configurações de Conversa Humana

​

⭐ Avaliação do Agente

• Mensagem: O que o usuário vê (ex.: “Como você avaliaria nosso suporte hoje?”).
• + Adicionar Botão de Resposta: Adicione opções de avaliação rápida (ex.: ⭐ Excelente, 👍 Bom, 👎 Poderia melhorar).

💡 Dica Pro: Combine Atribuição automática + Idioma obrigatório para uma experiência de roteamento inteligente onde o agente certo sempre recebe a conversa certa.

​

7. Voz: Dê Voz ao Seu Agente 🎙️

​

🔛 Configuração de Voz IA

​

🌐 Idioma e Modelo

​

🔊 Configurações de Áudio

​

⏱️ Tempos e Timeouts

​

🔑 Palavras-chave

💡 Dica Pro: Mantenha o Timeout de Turno curto (5–8s) para uma experiência de voz ágil. Aumente o Timeout de Silêncio para Encerrar Chamada se seus usuários tendem a pausar enquanto pensam.

​

8. Configurações de Chat: Sessão e Comportamento ⚙️

​

📊 Configuração NPS

​

💬 Limite de Histórico

⚠️ Atenção: Um limite muito baixo (ex.: 2) pode fazer o agente “esquecer” o contexto do início da mesma conversa.

​

⏳ Timeout de Sessão

• Tempo de Inatividade do Agente IA (Minutos): O tempo de inatividade em minutos antes que a sessão do agente de IA termine (padrão: 1440 = 24 horas, mínimo: 10 minutos).

​

🔕 Regras de Inatividade

💡 Dica Pro: Habilite Inatividade do usuário com uma mensagem amigável como “Você ainda está aí? 😊” para manter as conversas vivas e reduzir chats abandonados.

​

🎓 Resumo de Boas Práticas (Cola Rápida)

• 🧪 Playground é seu amigo: Nunca publique sem testar primeiro. Finja ser um cliente difícil.
• 🚦 Clareza acima de tudo: Em Prompts e Instruções, seja direto. O bot não entende indiretas.
• 🔁 Mantenha atualizado: Se seu horário de funcionamento mudar, atualize o Campo. Se a política mudar, atualize os Guardrails.
• 🤝 Escalação suave: Sempre forneça uma saída para falar com um humano. Nada é mais frustrante do que um bot preso em um loop.
• 🎙️ Teste voz separadamente: O comportamento de voz difere do chat — sempre teste fluxos de áudio independentemente antes de ir ao vivo.

​

🆘 Solução Rápida de Problemas