Criar e configurar agentes
Guia completo para criar, configurar e otimizar agentes de voz com IA no Take Sales.
Visao geral
Agentes sao o coracao do Take Sales. Cada agente e um assistente de IA personalizado que conversa com os visitantes do seu site via texto ou voz. Voce pode criar multiplos agentes para diferentes finalidades — atendimento ao cliente, vendas, suporte tecnico, qualificacao de leads — cada um com personalidade, instrucoes e base de conhecimento proprias.
Criando um novo agente
No menu lateral, acesse Agentes → Novo Agente.
Principais configuracoes
| Campo | Obrigatorio | Descricao |
|---|---|---|
| Nome | Sim | Nome do agente, exibido no widget |
| Diretrizes (system prompt) | Sim | Comportamento, personalidade e limites |
| Saudacao | Sim | Primeira mensagem enviada ao visitante |
| Idioma | Sim | Idioma padrao das conversas (com modo multilingue opcional) |
| Persona | Nao | Template de diretrizes por nicho, aplicado no assistente de criacao |
| Instrucoes adicionais | Nao | Complemento das diretrizes (regras de negocio, detalhes do produto) |
| Voz | Condicional | Obrigatoria quando a voz esta habilitada |
| Avatar e icone | Nao | Imagem do agente e do botao flutuante |
| Fonte/provider de LLM | Nao | Provider global ou credencial propria (BYOL) |
| Temperatura, top P, raciocinio | Nao | Ajustes de geracao |
| Orcamento de tokens por sessao | Nao | Teto de tokens por conversa |
| Base de conhecimento | Nao | Bases vinculadas ao agente (RAG) |
| Ferramentas | Nao | Acoes que o agente pode executar |
| Canais | Nao | Widget, WhatsApp, Instagram, Telegram, Freshchat, voz |
| Transferencia para humano | Nao | Habilita o handoff e as politicas de escalacao |
| Respostas rapidas | Nao | Sugestoes exibidas na tela inicial do widget |
| Origens permitidas | Nao | Dominios que podem incorporar o widget |
System prompt eficaz
O system prompt e o que define a personalidade e capacidade do agente. Boas praticas:
- Defina o papel — "Voce e o assistente de vendas da [Empresa]..."
- Estabeleca limites — "Nunca invente informacoes. Se nao souber, diga que vai verificar."
- Defina o tom — "Use linguagem profissional mas acessivel."
- Inclua contexto — "A empresa vende [produtos/servicos] para [publico-alvo]."
- Defina acoes — "Quando o visitante demonstrar interesse, colete nome e email."
Exemplos de system prompts
Exemplo 1 — Agente de vendas para e-commerce:
Voce e o assistente de vendas da Loja TechBrasil, especializada em eletronicos e acessorios.
Seu objetivo principal e ajudar visitantes a encontrar o produto ideal e concluir a compra.
Regras:
- Sempre pergunte o que o cliente esta buscando antes de sugerir produtos.
- Use informacoes da base de conhecimento para recomendar produtos reais com precos corretos.
- Se o cliente demonstrar interesse, envie o link direto do produto.
- Nunca invente precos ou disponibilidade. Se nao souber, diga "Vou verificar com a equipe e ja retorno."
- Colete nome e email quando o cliente pedir orcamento.
Tom: Amigavel, direto e prestativo. Use emojis com moderacao.
Este prompt funciona bem porque define um objetivo claro (vender), estabelece regras especificas sobre o que fazer e nao fazer, e instrui o agente sobre como lidar com situacoes de incerteza.
Exemplo 2 — Agente de suporte tecnico:
Voce e o assistente de suporte tecnico da SaaS Corp. Sua funcao e resolver duvidas e problemas tecnicos dos clientes.
Diretrizes:
- Sempre peca ao cliente para descrever o problema com detalhes (navegador, sistema operacional, mensagem de erro).
- Consulte a base de conhecimento antes de responder.
- Forneca instrucoes passo a passo numeradas.
- Se o problema nao puder ser resolvido via chat, transfira para o suporte humano.
- Nunca peca dados sensiveis como senhas.
Tom: Profissional, paciente e tecnico. Evite jargoes quando possivel.
Este prompt e eficaz porque orienta o agente a coletar informacoes diagnosticas antes de responder e define uma rota de escalacao clara.
Exemplo 3 — Agente de qualificacao de leads:
Voce e o assistente comercial da Consultoria ABC. Seu papel e qualificar visitantes interessados nos servicos da empresa.
Fluxo da conversa:
1. Cumprimente e pergunte como pode ajudar.
2. Entenda a necessidade do visitante.
3. Colete: nome, empresa, cargo, email e telefone.
4. Pergunte o orcamento estimado e prazo desejado.
5. Agradeca e informe que um consultor entrara em contato em ate 24h.
Regras:
- Nao faca perguntas demais de uma vez. Colete dados de forma natural ao longo da conversa.
- Se o visitante nao quiser informar algum dado, nao insista.
- Use a base de conhecimento para responder duvidas sobre servicos e precos.
Este prompt funciona porque define um fluxo conversacional claro e natural, evitando que o agente faca um "interrogatorio" com o visitante.
Itere continuamente no system prompt com base em conversas reais. Acesse o historico de conversas no dashboard, identifique onde o agente errou ou poderia ter respondido melhor, e ajuste as instrucoes. Os melhores agentes sao refinados ao longo de semanas com dados reais.
Modelo de IA
Por padrao o agente usa o provider global da plataforma. Voce pode escolher outro provider para o pipeline de texto ou usar a sua propria chave (BYOL), cadastrada em Workspace -> Provedores LLM. A voz roda no pipeline de streaming em tempo real. Detalhes em configuracao avancada.
Configuracoes avancadas
Ferramentas (Tools)
Agentes podem executar acoes alem de conversar: consultar um sistema, criar um lead no CRM, agendar na agenda, chamar a sua API.
- Conecte a conta do sistema em Integracoes (ou crie uma custom tool apontando para o seu endpoint)
- As acoes aparecem na pagina Ferramentas
- No agente, ative as ferramentas que ele pode usar
- Opcionalmente, escreva regras por ferramenta dizendo quando usa-la e o que nunca fazer
Cada agente pode ativar um conjunto diferente de ferramentas e ter regras proprias para a mesma ferramenta. Veja o guia de ferramentas.
Handoff para humanos
Ligue Habilitar transferencia para humano para o agente poder chamar alguem do time. A partir dai:
- A IA decide — Instrua nas diretrizes quando transferir (pedido do visitante, assunto fora do escopo, reclamacao)
- Politicas de escalacao — Regras deterministicas que escalam sem depender da IA
- Freshchat — Handoff rules definem os motivos e o grupo de destino
As conversas transferidas aparecem no Inbox.
Se o visitante mencionar cancelamento, reclamacao formal ou questoes
juridicas, transfira imediatamente para o atendimento humano.
Clonagem de agentes
Voce pode clonar um agente existente para outro workspace. Isso e util quando:
- Voce gerencia multiplos clientes e quer usar um agente como modelo base.
- Voce precisa de um agente identico em um ambiente de staging/testes.
- Voce quer criar uma variacao de um agente existente sem partir do zero.
Para clonar, acesse o agente desejado, clique no menu de opcoes (...) e selecione Clonar agente. Escolha o workspace de destino e confirme. O agente clonado copia todas as configuracoes, incluindo system prompt, ferramentas e configuracoes de voz, mas nao copia a base de conhecimento (que deve ser configurada separadamente no workspace de destino).
Boas praticas
- Comece simples — Crie um agente focado em um objetivo especifico
- Itere com dados — Analise conversas reais para melhorar o prompt
- Teste antes de publicar — Use o modo de teste extensivamente
- Monitore metricas — Acompanhe taxa de resolucao e satisfacao
- Versione seus prompts — Mantenha um historico das versoes do system prompt para poder reverter se necessario
- Segmente por funcao — Prefira agentes especializados (vendas, suporte, qualificacao) e conecte-os com roteamento e transferencia