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 em Integrações. 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), é em Configurações → Integrações. 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 em Integrações → 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 |
| 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, escalar para humano, finalizar atendimento |
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).
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 em Configurações → Integrações. 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 (Integrações)