Configuração Avançada de Agentes

Domine todas as configurações avançadas para otimizar seus agentes de IA.

Visão geral

Após criar seu primeiro agente, é hora de ir além do básico. Este guia cobre todas as configurações avançadas disponíveis para que seus agentes entreguem a melhor experiência possível para os visitantes do seu site.

System prompt avançado

O system prompt é a peça mais importante do seu agente. É ele que define personalidade, comportamento, limites e ações. Abaixo, exemplos completos para diferentes segmentos.

Exemplo 1: Imobiliária

Você é a Ana, assistente virtual da Imobiliária Solar. Seu papel é ajudar visitantes a encontrar o imóvel ideal.
 
COMPORTAMENTO:
- Pergunte o tipo de imóvel desejado (apartamento, casa, terreno), localização preferida, faixa de preço e número de quartos.
- Apresente os imóveis disponíveis da base de conhecimento que correspondam aos critérios.
- Para cada imóvel, destaque: metragem, número de quartos/suítes, vagas de garagem, valor e diferenciais.
- Ofereça agendar uma visita quando o visitante demonstrar interesse.
- Colete nome, email e telefone antes de confirmar o agendamento.
 
RESTRIÇÕES:
- Nunca invente imóveis que não estão na base de conhecimento.
- Não negocie preços. Diga que o corretor responsável entrará em contato para condições especiais.
- Se o visitante perguntar sobre financiamento, forneça informações gerais e sugira falar com um especialista.

Exemplo 2: E-commerce

Você é o assistente virtual da TechStore. Ajude os clientes com dúvidas sobre produtos, status de pedidos e devoluções.
 
COMPORTAMENTO:
- Ao receber uma dúvida sobre produto, consulte a base de conhecimento para fornecer especificações e preços.
- Recomende produtos complementares quando fizer sentido (ex: capa para celular, película).
- Para consulta de pedido, peça o número do pedido e use a ferramenta consultar_pedido.
- Para devoluções, colete número do pedido e motivo, depois use a ferramenta solicitar_devolucao.
 
TOM:
- Informal e amigável, use emojis com moderação.
- Seja direto nas respostas, sem enrolação.
 
RESTRIÇÕES:
- Não ofereça descontos por conta própria.
- Se o produto estiver fora de estoque, sugira alternativas similares.

Exemplo 3: SaaS (Suporte Técnico)

Você é o assistente de suporte da plataforma CloudManager. Ajude os usuários a resolver problemas técnicos.
 
COMPORTAMENTO:
- Identifique o problema do usuário com perguntas objetivas.
- Consulte a documentação na base de conhecimento para fornecer soluções passo a passo.
- Se a solução envolver configurações, forneça instruções detalhadas com caminhos de menu.
- Se não conseguir resolver após 3 tentativas, faça handoff para um atendente humano.
 
ESCALAÇÃO:
- Problemas de cobrança → transfira imediatamente para humano.
- Bugs confirmados → colete detalhes (navegador, sistema operacional, prints) e transfira.
- Solicitações de funcionalidades → registre e agradeça pelo feedback.
 
TOM:
- Profissional e empático. Reconheça a frustração do usuário quando aplicável.

Exemplo 4: Clínica Médica

Você é a assistente virtual da Clínica Bem Estar. Ajude os pacientes com agendamentos e informações sobre procedimentos.
 
COMPORTAMENTO:
- Para agendamentos, pergunte: especialidade desejada, preferência de data/horário e se é primeira consulta.
- Consulte a base de conhecimento para informar sobre procedimentos, preparos necessários e valores.
- Colete nome completo, telefone e email para confirmar agendamentos.
- Use a ferramenta agendar_consulta após coletar todos os dados.
 
RESTRIÇÕES:
- NUNCA forneça diagnósticos ou recomendações médicas.
- Para urgências, oriente o paciente a ligar para o número (11) 9999-9999 ou ir ao pronto-socorro.
- Não confirme disponibilidade de horário sem consultar a ferramenta de agenda.

Modelo de IA

O agente usa, por padrão, o provider global da plataforma (Gemini). Duas coisas podem ser ajustadas no formulário do agente:

Com BYOL (Workspace → Provedores LLM), você cadastra a sua própria chave — inclusive de endpoints compatíveis com OpenAI — e define o modelo padrão dela. Veja Workspace.

Ajustes de geração

Configuração de voz

Para agentes com voz habilitada, configure em Agentes → Editar:

• Voz — Escolha entre as vozes disponíveis, cada uma com timbre e tom próprios; há prévia de áudio para ouvir antes de decidir
• Idioma — Idioma padrão das conversas
• Modo multilíngue — Detecta automaticamente o idioma do visitante e responde nele
• Saudação — A primeira frase, escrita no idioma selecionado

Limites de sessão

A plataforma cobra por modalidade: voz gasta minutos, texto gasta conversas e tokens. Cada agente controla os dois limites em Agentes → Editar → Limites de sessão.

Voz (widget e ligações)

• Duração máxima da sessão — Padrão de 15 min, ajustável entre 1 e 60. No motor Live (widget e ligações padrão) o máximo efetivo é sempre 15, mesmo com um valor maior configurado — só o motor pipeline chega a 60.
• Encerrar quando acabarem os minutos do workspace — Desligado por padrão: uma sessão que começou com saldo disponível pode terminar mesmo que o saldo do workspace zere no meio dela. Ligado, o servidor encerra a sessão assim que o saldo acaba.

Texto (widget, WhatsApp, Instagram, Telegram, Freshchat, HTTP API)

Texto não tem limite de tempo — só o teto de tokens por conversa (o mesmo campo que antes aparecia como "Orçamento de tokens por sessão", em Modelo de IA). Ao cruzar o teto, a resposta em andamento é sempre entregue e só depois a ação configurada roda:

Client Variables

Client Variables permitem que o agente extraia dados do navegador do visitante automaticamente. Isso é útil para personalizar a conversa com base no contexto do usuário.

Fontes disponíveis

Configurando uma variável

1. Acesse Agentes → Editar → Client Variables
2. Clique em Adicionar variável
3. Preencha o nome da variável (ex: user_plan)
4. Selecione a fonte (ex: localStorage)
5. Informe a chave ou seletor (ex: currentPlan)

Exemplo prático

Para um SaaS que salva o plano do usuário no localStorage:

• Nome: user_plan
• Fonte: localStorage
• Chave: subscription_plan

Nas diretrizes, referencie a variável com chaves duplas: O visitante está no plano {{user_plan}}. Ofereça upgrade se estiver no plano gratuito.

Handoff para humanos

O handoff transfere a conversa para uma pessoa do time. No formulário do agente:

• Habilitar transferência para humano — Dá ao agente a ação de chamar um humano. Desligado, ele não tem como transferir, nem a pedido do visitante
• Políticas de escalação — Regras determinísticas que chamam humano (ou trocam de agente) quando as condições casarem, sem depender da decisão da IA
• Handoff rules (Freshchat) — Os motivos disponíveis e o grupo de destino de cada um

Nas diretrizes, deixe explícito quando transferir:

Se o visitante pedir para falar com uma pessoa, ou se o assunto for
cancelamento, reclamação formal ou questão jurídica, transfira
imediatamente para o atendimento humano.

As conversas transferidas aparecem no Inbox. Detalhes de políticas e roteamento em vários agentes.

Coleta de contato do visitante

Configure um formulário exibido antes do início da conversa, em Agentes → Editar → Coleta de contato.

Cada campo tem rótulo, placeholder, obrigatoriedade e tipo:

Os textos do formulário (título, subtítulo, botão, mensagem de "conectando", sufixo de campo opcional e mensagem de campo inválido) também são personalizáveis.

Os dados coletados ficam na aba Dados da conversa, entram na exportação CSV e alimentam Pessoas.

Quick replies

Quick replies são botões de resposta rápida que aparecem na interface do chat, facilitando a interação do visitante.

Configurando

1. Acesse Agentes → Editar → Quick Replies
2. Adicione textos curtos para cada botão (ex: "Ver preços", "Falar com vendedor", "Agendar demo")
3. O visitante pode clicar nos botões em vez de digitar

Aparência do widget

Personalize a aparência do widget de chat para combinar com a identidade visual do seu site. Acesse Agentes → Editar → Aparência.

Opções de personalização

Guardrails

Controles de qualidade e segurança da resposta, em Agentes → Editar → Guardrails:

Privacidade e consentimento

• Exigir consentimento (LGPD/GDPR) — Bloqueia qualquer coleta (IP, user-agent, fingerprint) até o visitante consentir por window.TakeSalesWidget.consent.grant()
• URL da política de privacidade — Exibida junto ao pedido de consentimento
• Retenção de dados — Por quanto tempo transcrição, áudio e variáveis coletadas ficam guardados; depois do prazo os dados são anonimizados e as métricas são preservadas

Limites de uso por agente

Teto de consumo por janela de calendário (fuso America/São_Paulo, semana começando na segunda), em tokens e conversas, por hora, dia, semana e mês. Campo vazio = sem limite.

Event tracking

Rastreie ações do visitante no site (cliques, visualizações) e dê esse contexto ao agente. Para cada evento você define o nome, a descrição para o agente e as ações ao disparar:

• Enriquecer contexto — O agente passa a saber o que aconteceu
• Mensagem proativa — O agente puxa conversa
• Disparar webhook / Disparar automação

Com o tracking desativado, nenhum listener é injetado no site — zero overhead.

Recursos no navegador do visitante

Variáveis dinâmicas e extração pós-chamada

• Variáveis dinâmicas (/agents/<id>/variables) — Declare variáveis com tipo, valor padrão, estratégia de fallback, marcação de PII/secreta e persistência entre conversas. Use {{minha_variavel}} (ou {{namespace.variavel}} para as built-in) nas diretrizes e nos templates de ferramentas
• Extração pós-chamada (/agents/<id>/extraction) — Ao fim da conversa, um LLM lê a transcrição e emite variáveis tipadas conforme um schema JSON que você define; os valores aparecem na aba Dados da conversa

Prompts por estágio

Quando a conversa tem fases distintas, cada estágio pode ter seu próprio system prompt, com transições por regra ou por decisão do LLM. Veja vários agentes.

Origens permitidas

Liste os domínios que podem incorporar o widget deste agente. Vazio permite qualquer origem; o painel do Take Sales sempre tem acesso, para o modo de teste.

Clonando agentes

O recurso de clonagem permite copiar um agente completo para outro workspace. Isso é ideal para agências que gerenciam múltiplos clientes ou para criar templates reutilizáveis.

Como clonar

1. Acesse a página Agentes
2. No card do agente, clique no menu de opções (três pontos)
3. Selecione Clonar para workspace
4. Escolha o workspace de destino
5. O agente será copiado com todas as configurações: system prompt, modelo, ferramentas, aparência e configurações de voz

Próximos passos

• Configure ferramentas para ampliar as capacidades do seu agente
• Divida o atendimento entre vários agentes
• Aprenda a capturar leads de forma eficiente
• Teste seu agente antes de publicar