Onde fica: Agentes › [nome do agente] › Receptivo › Tools
Tools são as ações que o Receptivo pode executar durante uma conversa: consultar a base, checar a agenda, mover uma oportunidade, aplicar uma tag, chamar uma API sua. Nesta sub-aba você ativa, instrui e configura cada uma.
A sub-aba fica dentro do Agente Receptivo de cada agente, e o rótulo mostra quantas tools estão ativas.
A lista
No topo ficam os contadores: ativas, com instrução adicional, sem instrução e desativadas. Use Buscar tool... para achar uma pelo nome e o filtro para ver Todas, Ativas, Desativadas, Com instrução adicional ou Sem instrução.
Cada tool mostra o estado:
| Estado | O que significa |
|---|---|
| Pronta | Ativa, com instrução e com credencial quando precisa |
| Sem instrução | Ativa, mas sem instrução adicional sua |
| Sem credencial | Precisa de uma integração que ainda não está configurada |
| Inativa | Desligada. O agente não usa |
A marca escrita aparece nas tools que mudam dados, como mover oportunidade ou atualizar contato.
O detalhe de uma tool
Clique na tool para abrir o detalhe.
- Descrição do sistema: o texto que já vai para o agente explicando o que a tool faz. Você não precisa repetir. Ver description completa mostra o texto inteiro.
- Instruções adicionais: aqui você escreve quando usar a tool no seu negócio. Por exemplo: "Só consulte a agenda depois que o cliente disser qual serviço quer".
A tool que envia template para outro contato tem o bloco Templates para outro contato. Em Configurar templates da tool, marque os templates que ela pode usar e, para cada um, Quando usar. O agente só vê os templates marcados ali.
Tools de integração
As tools que chamam uma integração sua não aparecem nesta lista. O mapeamento e as regras de tags delas ficam no cadastro do endpoint, em Configuração › Integrações › Agente, com dois blocos:
- Mapeamento de campos (atualização automática no CRM): quais dados da resposta viram campos do contato. Clique em Salvar mapeamento.
- Regras de tags (auto-apply): quais tags aplicar conforme a resposta. Clique em Salvar regras.
As integrações em si são configuradas em Integrações.
Como confirmar
- Na aba Visão geral do agente, confira o item "Tools prontas" em "Antes de ir para produção".
- Na lista, filtre por Sem instrução e confira se sobrou alguma tool ativa sem instrução.
- Clique em Testar conversa, faça um pedido que deveria usar a tool e confira na aba Log IA do Teste Go Live se ela foi chamada.
Erros comuns
- Deixar tool ativa sem instrução. O agente usa só a descrição geral e pode chamar a tool na hora errada.
- Repetir a descrição do sistema nas instruções adicionais. Ela já vai para o agente. Escreva só a regra do seu negócio.
- Editar aqui uma instrução auto-gerenciada. Ela vem de Funis, Tags ou Campos customizados. Mude lá.
- Ignorar "Sem credencial". A tool está ativa, mas falha até a integração ser configurada.
- Julgar pelo texto da resposta. Confira no Log IA se a tool foi chamada de fato.