> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jelou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Sua Primeira Ferramenta

> Crie sua primeira Ferramenta do zero: construa o fluxo, defina entradas e saídas, e publique-a para reutilizar em seus workflows.

As **Ferramentas** são funções reutilizáveis que executam <u>ações específicas</u> dentro dos seus workflows: 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 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.

<Steps>
  <Step title="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**.
  </Step>

  <Step title="Arrastar um nó API">
    No canvas, arraste um nó **API** do painel de nós. Na aba **URL**, insira:

    ```txt url.txt theme={null}
    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).
  </Step>

  <Step title="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}}`).
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>
</Steps>

E é isso! Agora você pode usar essa Ferramenta nos seus Workflows arrastando-a do painel de Ferramentas e configurando a entrada `city`.