Documentação / Tools
Tools
Estenda as capacidades do seu agente de voz dando a ele ferramentas para executar ações durante conversas ao vivo.
As ferramentas permitem que seu agente de IA execute ações durante uma conversa — transferir chamadas, encerrar chamadas ou chamar APIs externas — com base no contexto da conversa e nas suas instruções de prompt.
Quando uma ferramenta é anexada ao agente de prompt, o LLM decide quando invocá-la e quais parâmetros passar, com base na intenção falada do usuário e nas suas instruções do agente.
Tipos de ferramentas
O Tigy AI fornece duas categorias de ferramentas:
Ferramentas integradas (Built-in Tools)
Ferramentas pré-configuradas que lidam com operações comuns de telefonia de imediato:
- Call Transfer — Transfere a chamada ativa para um número de telefone ou endpoint SIP
- End Call — Encerra a chamada quando a conversa é concluída
Ferramentas personalizadas (Custom Tools)
Ferramentas que você define para integrar-se a qualquer sistema externo:
- HTTP API — Chama qualquer endpoint de API REST durante uma conversa (por exemplo, atualizações de CRM, consultas de dados, disparo de automações)
Como as ferramentas funcionam
- Você define uma ferramenta com nome, descrição e parâmetros
- Você anexa a ferramenta nas configurações do agente
- Durante uma chamada, o LLM lê o prompt do agente, a descrição da ferramenta e a intenção do chamador para decidir se a invoca
- A ferramenta executa e retorna um resultado que o agente pode usar para continuar a conversa
Práticas recomendadas
- Anexe apenas ferramentas relevantes ao agente — menos ferramentas significam invocações mais confiáveis
- Escreva descrições claras das ferramentas — o LLM as usa para decidir quando chamar a ferramenta
- Guie o LLM no prompt do agente — descreva explicitamente quando uma ferramenta deve ser usada
- Teste o comportamento das ferramentas — verifique se seu agente invoca as ferramentas nos momentos certos usando chamadas web ou telefônicas
