Tools As Tools (Ferramentas) são recursos configuráveis que expandem as capacidades dos seus agentes de IA durante as conversas. Com elas, seu agente pode executar ações específicas como consultar APIs ou transferir para atendimento humano.
Endpoint Integre com APIs externas para buscar dados em tempo real durante a conversa.
Handoff Transfira o atendimento para um humano quando necessário.
Como funcionam?
Crie a Tool
Configure uma Tool com as especificações necessárias (URL, departamento, etc.)
Vincule ao Agente
Conecte a Tool aos agentes que devem utilizá-la
Agente usa automaticamente
Durante a conversa, o agente identifica quando usar cada Tool baseado na descrição configurada
Resultado integrado
A Tool executa a ação e retorna o resultado para o agente continuar a conversa
Uma mesma Tool pode ser vinculada a múltiplos agentes, permitindo reutilização e consistência.
Permite que seu agente faça chamadas HTTP para APIs externas durante a conversa. Ideal para integrar com sistemas existentes. Exemplos de uso:
Consultar CEP para obter endereço
Buscar preço de produto
Verificar disponibilidade de estoque
Consultar status de pedido
Campos de Configuração Campo Obrigatório Descrição Nome Sim Identificador único (ex: consultar_cep) Descrição Sim Explica ao agente o que a Tool faz Método HTTP Sim GET, POST, PUT ou DELETE URL Sim Endereço do endpoint Headers Não Cabeçalhos HTTP (ex: Authorization) Query Params Schema Não Esquema JSON dos parâmetros de URL Body Schema Não Esquema JSON do corpo da requisição Template de Resposta Não Formato da resposta para o agente Quando Usar Não Instruções de quando acionar a Tool Requer Confirmação Não Se deve confirmar antes de executar
Exemplo de Configuração { "name" : "consultar_cep" , "description" : "Consulta o endereço completo a partir do CEP informado" , "method" : "GET" , "url" : "https://viacep.com.br/ws/{cep}/json/" , "when_to_use" : "Quando o cliente informar um CEP ou perguntar sobre endereço" }
Permite transferir a conversa para um atendente humano. Essencial para casos que exigem intervenção humana. Exemplos de uso:
Suporte técnico avançado
Negociações de vendas
Tratamento de reclamações
Assuntos sensíveis
Campos de Configuração Campo Obrigatório Descrição Nome Sim Identificador único (ex: transferir_suporte) Descrição Sim Explica quando usar esta transferência Departamento Sim Setor de destino (suporte, vendas, etc.) Prioridade Sim Nível de urgência na fila Webhook URL Não URL para notificar sistemas externos Coletar Contexto Não Enviar histórico da conversa ao atendente Quando Usar Não Instruções de quando transferir Requer Confirmação Não Confirmar com usuário antes de transferir
Níveis de Prioridade Prioridade Descrição Baixa Atendimento pode aguardar Normal Atendimento padrão Alta Atendimento prioritário Urgente Atendimento imediato
Exemplo de Configuração { "name" : "transferir_vendas" , "description" : "Transfere para o time de vendas" , "department" : "vendas" , "priority" : "high" , "collect_context" : true , "requires_confirmation" : true , "when_to_use" : "Quando o cliente quiser fazer uma compra ou pedir proposta" }
Navegue para Tools
No menu lateral, clique em Tools
Visualize suas ferramentas
A página mostra cards de estatísticas, filtros e a lista de Tools criadas
Interface da Página A página de Tools oferece:
Cards de Estatísticas : Total de Tools e quantidade por tipoCampo de Busca : Pesquise por nome ou descriçãoFiltro de Tipo : Filtre por Endpoint ou HandoffGrid de Cards : Visualize todas as suas Tools
Clique em Nova Tool
No canto superior direito, clique no botão Nova Tool
Selecione Endpoint
No diálogo de seleção, escolha Endpoint
Preencha as informações básicas
Nome : Identificador sem espaços (ex: consultar_produto)Descrição : Explique claramente o que a Tool faz
Configure o endpoint
Método : Selecione GET, POST, PUT ou DELETEURL : Informe o endereço completo da API
Adicione Headers (opcional)
Clique em Adicionar e configure os cabeçalhos HTTP necessários
Configure Schemas (opcional)
Defina os schemas JSON para parâmetros e body se necessário
Finalize
Configure o Template de Resposta e Quando Usar , depois clique em Criar Tool
Clique em Nova Tool
No canto superior direito, clique no botão Nova Tool
Selecione Handoff
No diálogo de seleção, escolha Handoff
Preencha as informações básicas
Nome : Identificador (ex: transferir_suporte)Descrição : Explique quando usar esta transferência
Configure o handoff
Departamento : Informe o setor de destinoPrioridade : Selecione o nível de urgência
Configure opções
Coletar Contexto : Ative para enviar histórico ao atendenteRequer Confirmação : Ative para confirmar antes de transferir
Finalize
Preencha Quando Usar e clique em Criar Tool
Após criar uma Tool, você precisa vinculá-la aos agentes que devem utilizá-la:
Acesse o Agente
Vá para a página Agentes e clique no agente desejado
Localize a seção Tools
Role até encontrar a seção Tools
Clique em Vincular Tool
Clique no botão Vincular Tool
Selecione a Tool
Na aba Tools Existentes , busque e selecione a Tool desejada, ou crie uma nova na aba Criar Nova
Para desvincular uma Tool, clique no ícone de lixeira ao lado dela na seção Tools do agente. A Tool não será excluída, apenas desvinculada.
Exemplos Práticos Consulta de CEP { "type" : "endpoint" , "name" : "consultar_cep" , "description" : "Busca o endereço completo a partir do CEP" , "config" : { "method" : "GET" , "url" : "https://viacep.com.br/ws/{cep}/json/" , "response_template" : "Endereço: {logradouro}, {bairro} - {localidade}/{uf}" , "when_to_use" : "Quando o cliente informar um CEP" } }
Transferência para Vendas { "type" : "handoff" , "name" : "transferir_vendas" , "description" : "Transfere para equipe de vendas" , "config" : { "department" : "vendas" , "priority" : "high" , "collect_context" : true , "requires_confirmation" : true , "when_to_use" : "Quando o cliente quiser comprar ou pedir proposta" } }
Boas Práticas
Nomenclatura Use nomes descritivos em snake_case: consultar_pedido, calcular_frete. Evite nomes genéricos.
Descrições Seja específico sobre o que a Tool faz. A descrição ajuda o agente a decidir quando usá-la.
Campo Quando Usar Descreva cenários concretos e palavras-chave que devem acionar a Tool.
Segurança Nunca exponha credenciais na URL. Use headers para autenticação.
Ao excluir uma Tool, ela será automaticamente desvinculada de todos os agentes. Esta ação não pode ser desfeita.
Resolução de Problemas Problema Solução Tool não é acionada pelo agente Verifique se está vinculada e se a descrição está clara Endpoint retornando erro Confirme URL, headers e teste a API diretamente Handoff não transfere Confirme departamento e se “Requer Confirmação” não está bloqueando
Próximos Passos Agora que você sabe como usar Tools, explore outros recursos:
