Pular para o conteúdo principal
As Ferramentas são funções reutilizáveis que executam ações específicas dentro dos seus fluxos: consultar APIs, realizar cálculos, atualizar dados ou automatizar tarefas. Elas são executadas instantaneamente, retornam um resultado e podem ser usadas em múltiplos Skills 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
https://api.weather.com/v1/current
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 Skill.
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 Skills arrastando-a do painel de Ferramentas e configurando a entrada city.