Skip to main content
As Ferramentas são funções reutilizáveis que executam ações específicas dentro dos seus workflows: consultar APIs, realizar cálculos, atualizar dados ou automatizar tarefas. Elas retornam um resultado e podem ser usadas em múltiplos Workflows e projetos. O Jelou inclui Ferramentas nativas prontas para uso, mas você também pode criar as suas quando precisar de algo específico para o seu negócio.

Neste guia você construirá sua primeira Ferramenta: uma função simples que consulta o clima de uma cidade e retorna a temperatura.
1

Criar uma nova Ferramenta

No painel esquerdo do Brain Studio, vá à aba Ferramentas e clique para criar uma nova Ferramenta. Atribua o nome: Verificar Clima.
2

Arrastar um nó API

No canvas, arraste um nó API do painel de nós. Na aba URL, insira:
url.txt
Em Variáveis, selecione ou crie uma variável de ambiente para sua chave de API (marque-a como secreta se contiver credenciais).
3

Configurar as entradas

Na configuração da Ferramenta, adicione uma entrada:
  • Nome: city
  • Tipo: string
  • Obrigatório: Sim
Configure como essa entrada é enviada para o nó API (por exemplo, como parâmetro de URL: {{$input.city}}).
4

Configurar as saídas

Defina quais informações a Ferramenta retornará. Na configuração de saídas, mapeie:
  • temperature: Extraia o valor da resposta da API
  • description: Extraia a descrição do clima
Esses valores estarão disponíveis quando você usar a Ferramenta em um Fluxo.
5

Testar sua Ferramenta

Use a funcionalidade de testes e insira um valor de exemplo, como “São Paulo”. Verifique se a resposta está correta e se as saídas estão mapeadas adequadamente.
6

Publicar a Ferramenta

Clique em Publicar. Uma versão (v1.0.0) será gerada e ela ficará disponível para uso em qualquer projeto da sua empresa.
E é isso! Agora você pode usar essa Ferramenta nos seus Workflows arrastando-a do painel de Ferramentas e configurando a entrada city.

​
Bloquear o usuário enquanto a Tool é executada

Quando a Ferramenta é invocada a partir de um workflow, a execução é assíncrona: enquanto ela trabalha, o usuário fica livre e, se escrever, a mensagem sai do workflow e é atendida pelo router do projeto. Se você preferir que ele aguarde, habilite Bloquear fluxo no nó Tool e configure uma Mensagem de espera. As mensagens enviadas durante o bloqueio são sempre descartadas: não entram no workflow, então os nós posteriores — incluindo um Agente de IA — não as veem. Só recebem resposta se você configurou uma mensagem de espera. O bloqueio é liberado sozinho assim que a Tool termina, tanto pela rota de sucesso quanto pela de erro, e o fluxo continua. Como respaldo, tem um limite de 5 minutos: se a Tool demorar mais, o usuário volta a conversar com o router e o workflow segue do mesmo jeito quando ela responde.
Não se aplica às Tools invocadas por um Agente de IA — essa execução é síncrona e não suspende nada — nem a um nó Tool que roda dentro de outra Tool: apenas o workflow que conversa com o usuário pode retê-lo. Também não se aplica em testes a partir do canvas, nem depois que um operador assume a conversa. O nó Pausa tem a mesma opção; consulte Pausa.
Também pode usar o nó Tool dentro de outras. Veja a guia de Composição de Tools.