Visão geral da chamada de ferramentas
As ferramentas permitem que o seu agente realize ações do mundo real durante uma conversa — como consultar o status de um pedido, abrir um ticket de suporte, enviar uma notificação ou acionar um fluxo de trabalho — sem sair da conversa.
Ferramentas implícitas vs. explícitas
- Ferramentas implícitas— A plataforma envia o nome e os argumentos da ferramenta para o seu aplicativo. Seu código do lado cliente processa a lógica e retorna o resultado. Ideal para ações que residem no seu frontend.
- Ferramentas explícitas— A plataforma encaminha a chamada da ferramenta para um endpoint HTTP ou WebSocket do lado do servidor, configurado por você. Seu servidor executa a lógica. Ideal para operações de infraestrutura seguras.
Em ambos os casos, o agente recebe o resultado e continua a conversa naturalmente.
Criar ferramentas
Defina as ferramentas pelo painel ou por meio dePOST /public/functions. Anexe-as a uma sessão incluindo os IDs delas no arrayfunctionsao criar uma conexão.
Dica:Ferramentas e bases de conhecimento podem ser combinadas — seu agente pode procurar algo em um documento e realizar uma ação com base no que encontrar.