VoltarTake Sales

Criando seu primeiro agente

Guia passo a passo para criar, testar e publicar seu primeiro agente de IA no Take Sales.

Criando um agente

No menu lateral, acesse Agentes e clique em Novo Agente. O assistente percorre os passos abaixo — tudo pode ser alterado depois no formulário completo do agente.

PassoO que você define
IdentidadeNome do agente e avatar (opcional)
PersonaUm template de diretrizes pronto por nicho, ou começar do zero
CanaisChat por texto, voz ou ambos
VozVoz e idioma padrão (quando a voz está ligada)
ComportamentoSaudação inicial e diretrizes do agente
RecursosColeta de contato, respostas rápidas, compartilhamento de tela e outros
AparênciaOrigens permitidas e cores do widget
AvançadoTemperatura, top-p, nível de raciocínio, filtros de segurança
💡

Seja específico nas diretrizes. Em vez de "seja educado", escreva "cumprimente o visitante pelo nome quando disponível e use linguagem formal mas acessível".

Escrevendo boas diretrizes

As diretrizes (o system prompt do agente) definem quem ele é, como se comporta e o que ele não pode fazer. É a parte mais importante da configuração.

O que boas diretrizes contêm

  • Papel claro — Quem o agente é e qual empresa representa
  • Tom e linguagem — Formal, informal, técnico, amigável
  • Limites de atuação — O que o agente NÃO deve fazer (inventar informação, prometer desconto)
  • Contexto do negócio — Informações básicas para responder perguntas gerais
  • Ações esperadas — O que fazer nas situações comuns (agendar, coletar dados, transferir)
  • Comportamento de fallback — O que fazer quando não souber a resposta

Exemplos por segmento

Imobiliária:

Você é a Clara, assistente virtual da Imobiliária XYZ. Seu objetivo é ajudar
visitantes a encontrar imóveis que atendam às suas necessidades.

Comportamento:
- Pergunte sobre a região desejada, número de quartos, faixa de preço e tipo
  de imóvel (casa, apartamento, terreno)
- Consulte a base de conhecimento para sugerir imóveis compatíveis
- Ofereça agendar uma visita presencial, coletando nome, telefone e melhor
  horário
- Se não houver imóveis compatíveis, registre o interesse do visitante para
  contato futuro

Tom: Profissional e acolhedor. Use linguagem formal mas acessível.
Limite: Nunca invente imóveis ou valores. Use apenas os dados da base de
conhecimento.

E-commerce:

Você é o assistente de vendas da Loja ABC, especializada em eletrônicos.

Comportamento:
- Ajude clientes a encontrar produtos, consultando o estoque em tempo real
- Recomende produtos baseado nas necessidades do cliente (ex: "preciso de um
  notebook para trabalho" → sugira modelos adequados)
- Informe sobre prazos de entrega, formas de pagamento e políticas de troca
- Para reclamações ou problemas com pedidos, colete o número do pedido e
  encaminhe para o suporte humano

Tom: Informal e prestativo. Pode usar emojis com moderação.
Limite: Não ofereça descontos ou condições especiais sem que estejam na base
de conhecimento.

SaaS B2B:

Você é o assistente de suporte da Empresa DEF, uma plataforma de gestão
financeira para empresas.

Comportamento:
- Responda dúvidas técnicas usando a base de conhecimento do produto
- Para problemas que requerem investigação, colete detalhes (nome da empresa,
  email, descrição do problema) e crie um ticket
- Sugira artigos da central de ajuda quando relevante
- Para questões sobre preços e planos, direcione para o time comercial

Tom: Técnico mas acessível. Evite jargões desnecessários.
Limite: Não faça alterações em contas de clientes. Apenas oriente e colete
informações.

Agência (whitelabel):

Você é o assistente virtual do [NOME DO CLIENTE]. Seu papel é atender
visitantes do site, responder dúvidas sobre os serviços oferecidos e
qualificar leads.

Comportamento:
- Apresente os serviços da empresa com base na base de conhecimento
- Colete nome, email e telefone de visitantes interessados
- Agende reuniões com o time comercial quando solicitado
- Para dúvidas fora do seu escopo, informe que um especialista entrará em
  contato

Tom: Adapte ao perfil do cliente (definido na base de conhecimento).
Limite: Nunca mencione o Take Sales ou qualquer plataforma de terceiros.
Represente exclusivamente a marca do cliente.
⚠️

Erros comuns:

  • Prompt vago demais — "Seja um assistente útil" não dá contexto. Diga quem ele é, o que a empresa faz e como agir.
  • Sem limites definidos — Sem dizer o que NÃO fazer, o agente inventa informação e promete o que a empresa não oferece.
  • Sem fallback — Sempre defina: "Se não souber a resposta, diga X e faça Y".
  • Excesso de informação no prompt — Preço, catálogo e especificação vão para a base de conhecimento; o prompt guarda só o comportamento.

Base de conhecimento

Alimente o agente com informações do seu negócio:

  1. Acesse Base de Conhecimento no menu lateral e crie uma base
  2. Adicione itens: texto, arquivo (PDF, TXT, CSV, Markdown, imagens — até 50 MB) ou website (descoberta de páginas por sitemap/crawl)
  3. Escolha o modo de uso: Injetar como prompt (conteúdo inteiro no contexto, bom para textos curtos) ou Busca semântica / RAG (indexado, só os trechos relevantes entram na resposta)
  4. Em Gerenciar acesso, vincule a base aos agentes que podem consultá-la
ℹ️

Upload de arquivo só está disponível no modo Busca semântica (RAG). Conteúdos grandes sempre devem usar RAG.

Testando o agente

Há três formas de testar, todas a partir do card do agente:

  • Teste rápido — Abre /agents/<id>/test com o widget real embutido, mais um resumo da configuração e o script de incorporação.
  • Teste de cenário — Informe a URL do seu site e abra uma aba com o site real e o widget sobreposto.
  • Chamada de teste — Com um canal de voz conectado, a plataforma liga para o seu número, com contexto inicial opcional.
ℹ️

Conversas de teste são salvas normalmente, mas ficam marcadas como Teste no histórico — e o filtro padrão de Conversas mostra só as reais.

O que testar

  • Saudação inicial — O agente se apresenta corretamente? O tom está adequado?
  • Perguntas frequentes — As respostas batem com a base de conhecimento?
  • Perguntas fora do escopo — Ele lida bem com o que não deveria responder?
  • Casos extremos — Mensagens vagas, com erro de digitação ou em outro idioma
  • Execução de ferramentas — As integrações são acionadas na hora certa?
  • Fluxo completo — Uma conversa do início ao fim, como um visitante real
💡

Peça para alguém que NÃO configurou o agente testá-lo. Quem configura tende a fazer perguntas "perfeitas".

Resolução de problemas

  • Respostas genéricas ou incorretas — Revise a base de conhecimento: o conteúdo existe? Está atualizado? Use a aba Logs da conversa para ver os chunks recuperados.
  • Agente ignorando instruções — Instruções ambíguas ou contraditórias confundem o modelo. Simplifique.
  • Agente inventando informações — Ligue os guardrails (correção de afirmações, detector de contradições, verificação de fidelidade) nas configurações do agente.
  • Respostas muito longas ou curtas — Defina o tamanho esperado nas diretrizes.
  • Ferramentas não executadas — Confirme que a ferramenta está ativa no agente e que a descrição dela deixa claro quando usá-la.

Publicando no seu site

  1. Acesse Canais no menu lateral
  2. Selecione Web Chat e escolha o agente
  3. Copie o código de instalação
  4. Cole no HTML do seu site, antes de </body>
<!-- TakeSales Voice Agent Widget -->
<script>
  window.TakeSalesConfig = {
    agentId: 'SEU_AGENT_ID',
    httpUrl: 'https://api-agent.takesales.ai'
  };
</script>
<script src="https://api-agent.takesales.ai/takesales-widget.min.js"></script>
⚠️

Em Origens permitidas (na mesma tela, ou em Agentes → Segurança), liste os domínios que podem incorporar o widget. Vazio significa qualquer origem.

Pronto — o agente está no ar.

Próximos passos