Ferramentas (Tools) do Workspace

Gerencie e configure as ferramentas que seus agentes podem usar durante conversas.

Visão geral

Ferramentas (tools) são ações que seus agentes podem executar durante uma conversa, como consultar um sistema externo, criar um registro no CRM ou verificar o status de um pedido. No Take Sales, as ferramentas são gerenciadas no nível do workspace e depois atribuídas aos agentes que precisam delas.

Acesse a página de ferramentas em Menu lateral → Ferramentas.

Ferramentas de integração

Ferramentas de integração aparecem sozinhas quando você conecta uma conta em Integrações (HubSpot, Google Calendar, Salesforce, Slack, SendGrid, servidores MCP e outras). Elas ficam agrupadas por integração na página de ferramentas.

Características

• Agrupadas por integração — Cada integração conectada exibe suas ferramentas em um grupo separado (ex: HubSpot mostra "create_contact", "update_deal", "search_contacts").
• Toggle de ativação — Cada ferramenta individual tem um toggle para habilitar ou desabilitar.
• Badge de nível de risco — Cada ferramenta exibe um badge indicando se ela é executada automaticamente (auto) ou se pede confirmação ao visitante antes de executar (confirm).

Gerenciando ferramentas de integração

1. Conecte uma integração na página Integrações
2. As ferramentas da integração aparecem automaticamente na página Ferramentas
3. Habilite ou desabilite ferramentas individuais conforme necessário
4. Atribua as ferramentas desejadas a cada agente nas configurações do agente

Custom Tools

Custom tools são ferramentas que você cria manualmente, definindo o endpoint HTTP que será chamado, os parâmetros e o formato da requisição.

Criando uma custom tool

1. Na página Ferramentas, clique em Nova ferramenta
2. Preencha as informações básicas:
   • Function name — Identificador único da ferramenta (ex: consultar_estoque). Use snake_case, sem espaços.
   • Título — Nome amigável exibido na interface (ex: "Consultar Estoque").
   • Descrição — Explique quando o agente deve usar esta ferramenta. Esta descrição é lida pela IA para decidir quando ativá-la.

3. Configure o endpoint HTTP:

   • Método — GET, POST, PUT ou PATCH
   • URL — Endpoint completo da API (ex: https://api.suaempresa.com/estoque)

4. Adicione parâmetros:

   • Nome — Identificador do parâmetro (ex: produto_id)
   • Tipo — string, number, integer, boolean ou enum
   • Obrigatório — Se o parâmetro é requerido
   • Descrição — Descreve o parâmetro para a IA (ex: "ID ou nome do produto a consultar")

5. Para métodos POST, PUT e PATCH, configure o body template:

   {
     "product_id": "{{produto_id}}",
     "quantity": "{{quantidade}}"
   }

   Use {{nome_do_parametro}} como placeholder para os valores coletados pela IA.

6. Configure o nível de risco:

   • Auto — A ferramenta é executada imediatamente quando o agente decide usá-la.
   • Confirm — O agente pede confirmação ao visitante antes de executar.

7. Clique em Salvar

Importando via cURL

Se você já tem um comando cURL funcional, use o recurso de importação:

1. No formulário de criação, clique em Importar de cURL
2. Cole o comando cURL completo
3. O sistema preenche automaticamente: método, URL, headers e body
4. Revise e ajuste os campos conforme necessário

Salvando dados da resposta

Na aba Resposta da ferramenta, você pode guardar valores retornados pela API em variáveis da conversa (com caminho tipo customer.items[0].id) e vincular a pessoa da conversa a partir de ID externo, CPF, telefone ou e-mail. Detalhes em Custom Tools.

Validando a ferramenta

Não há um botão de teste isolado: valide conversando com o agente no modo de teste e depois abra a conversa em Conversas → Logs. O log da execução traz os parâmetros enviados, a resposta da API e a requisição em cURL para você reproduzir fora da plataforma.

Conectando ferramentas aos agentes

As ferramentas são gerenciadas no workspace, mas precisam ser atribuídas a cada agente individualmente.

1. Acesse Agentes → Editar o agente desejado
2. Vá até a aba Ferramentas
3. Selecione as ferramentas que este agente pode usar
4. Para cada ferramenta, opcionalmente adicione instruções específicas por agente que complementam a descrição original

Regras por agente

Cada ferramenta aceita regras próprias no contexto de um agente — dizendo quando usá-la e o que nunca fazer com ela. Exemplo:

• Ferramenta: consultar_estoque
• Instrução no agente de vendas: "Sempre ofereça alternativas quando o produto estiver fora de estoque."
• Instrução no agente de suporte: "Informe a previsão de reposição quando disponível."

Boas práticas

1. Descrições claras — Escreva descrições que ajudem a IA a entender exatamente quando usar cada ferramenta.
2. Teste antes de publicar — Sempre teste o endpoint antes de ativar a ferramenta em um agente de produção.
3. Comece com auto — Use o nível de risco "auto" para consultas (GET). Reserve "confirm" para ações que modificam dados (POST, PUT, DELETE).
4. Nomeie consistentemente — Use snake_case e nomes descritivos (ex: buscar_pedido, criar_contato, agendar_visita).
5. Monitore execuções — Acompanhe em Conversas → Logs se as ferramentas estão sendo ativadas nos momentos corretos.

Próximos passos

• Configure seu agente com opções avançadas para aproveitar ao máximo as ferramentas
• Aprenda a capturar leads combinando ferramentas com coleta de dados
• Teste seus agentes para validar que as ferramentas funcionam corretamente