Ferramentas (Tools)
Uma ferramenta é uma ação que o agente executa de verdade durante o atendimento. Não só responder, mas fazer: consultar a conexão do cliente, enviar a 2ª via, abrir um chamado, agendar uma visita. As ferramentas transformam a IA de consultora em executora.
Onde o agente escolhe suas ferramentas
Cada agente tem as suas ferramentas habilitadas na área Ferramentas da tela de detalhe (/ia/agentes/[id]). Lá você encontra:
- Um interruptor “Acesso a todas as ferramentas”: quando ligado, o agente recebe automaticamente qualquer ferramenta nova que for registrada.
- Quando desligado, uma grade por domínio para escolher tool a tool.
- Seções separadas para as ferramentas HTTP e MCP da sua organização.
A definição das ferramentas fica na Loja. A tela do agente decide quais ele pode usar. Criar, editar e testar ferramentas HTTP/MCP, e ligar as integrações que as alimentam (como o IXC), é na Loja. Veja Ferramentas nativas e IXC.
Como o agente usa as ferramentas
A IA decide sozinha quando uma ferramenta é necessária. Quando o cliente diz “quero a 2ª via do boleto”, em vez de só explicar onde achar, o agente chama a ferramenta de 2ª via, gera o boleto e envia.
Ações nativas por domínio
O catálogo nativo é agrupado em 7 domínios. As ações mais sensíveis (que mexem na conexão ou no plano do cliente) são marcadas como destrutivas, e algumas já vêm desligadas por padrão. Você controla cada uma na Loja → IXC → Capacidades.
| Domínio | O que faz | Exemplos |
|---|---|---|
| Identificação | Descobre quem é o cliente | Buscar assinante por documento |
| Diagnóstico | Consulta o estado da conexão | Status da conexão, histórico de quedas, consumo diário, incidentes ativos |
| Reparo | Age no acesso do cliente | Reiniciar/resetar ONU, forçar reauth, desbloqueio de confiança, liberar FUP |
| Financeiro | Boletos e pagamentos | Boletos abertos, 2ª via, PIX copia-cola, estender vencimento (onde o seu sistema permite; no IXC, temporariamente indisponível) |
| Fiscal | Notas fiscais | Enviar última NFSe, listar e enviar NFSe específica |
| Agendamento | Visitas e chamados | Agendar visita, horários disponíveis, chamados/atendimentos abertos |
| Coordenação | Conduz a conversa | Aplicar tags, transferir para outro agente, voltar ao primário, passar para a equipe, finalizar atendimento |
A 2ª via e o escalonamento têm opções próprias. No painel de cada ferramenta, que abre ao clicar nela na Loja → Ferramentas nativas, você escolhe qual fatura sai, qual meio de pagamento vem primeiro, se fatura muito atrasada vai para a equipe, se a IA confirma o CPF ou CNPJ do cliente e se cliente com CNPJ vai direto para a equipe. A configuração mora dentro da própria ferramenta. Veja as opções de comportamento.
Venda para cliente novo não pede documento. Quem quer contratar ainda não tem cadastro, então a IA segue a venda sem pedir CPF ou CNPJ. Para registrar, ela passa o pós-venda para a equipe com o resumo e os dados, em vez de tentar abrir um atendimento num cadastro que não existe.
As ações mais impactantes vêm desligadas. Na aba Capacidades do IXC, seis ações são marcadas como destrutivas (⚠). Reboot ONU, Reset ONU e Trocar plano vêm desligadas por padrão: ligue só quando decidir que quer a IA fazendo isso sozinha. As outras três (desbloqueio de confiança, liberar FUP, forçar reauth RADIUS) vêm ligadas, mas continuam sendo destrutivas. Revise se fazem sentido para a sua operação. Você mesmo controla cada uma ali (requer permissão de editar integrações).
Verificar cobertura
Com o módulo Conecta Maps, a ferramenta Verificar cobertura consulta as áreas de cobertura publicadas para responder se um endereço está dentro da área. Ela precisa ser marcada uma a uma no agente (o modo “Acesso a TODAS as ferramentas” não a inclui) e só fica disponível com pelo menos uma área publicada. A IA nunca confirma a instalação: a viabilidade final é sempre do comercial. Detalhes em como a IA usa o mapa.
Conferir se o pagamento entrou
A ferramenta Conferir se o pagamento entrou lê no ERP se a fatura do cliente consta paga, quando ele diz que pagou. Ela vem desligada em todo agente e precisa ser marcada uma a uma: o modo “Acesso a todas as ferramentas” não a inclui. Só funciona num ERP que registra o pagamento (hoje o IXC), e a IA só confirma o pagamento quando a fatura consta paga, com a data. Não vale no chat do site nem no telefone. Detalhes em Ferramentas nativas.
Ferramentas HTTP e MCP
Além das nativas, você pode conectar a IA a outros sistemas:
- HTTP: ferramentas que chamam uma API sua (método, URL, cabeçalhos, parâmetros e mapeamento da resposta). Servem para tudo que é específico do seu provedor.
- MCP: ferramentas expostas por servidores MCP conectados à sua organização.
A criação, o teste e a ativação dessas ferramentas ficam na Loja. Na tela do agente elas só são ligadas ou desligadas.
Paridade parcial na voz
No telefone, o agente usa hoje só um subconjunto das ferramentas nativas. A seleção de ferramentas vale integralmente para o atendimento por texto/WhatsApp. Na voz, apenas parte das ações nativas está exposta ao agente por enquanto; a paridade completa está no roteiro. Se uma ação é crítica para o atendimento telefônico, confirme com a conecta/ai que ela já está disponível na voz.
Próximo passo
→ Entenda seu agente → Ferramentas nativas (Loja)