> ## 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.

# Tu Primer Tool

> Crea tu primer Tool desde cero: arma el flujo, define entradas y salidas, y publícala para reutilizarla en tus workflows.

Las **Tools** son funciones reutilizables que ejecutan <u>acciones específicas</u> dentro de tus workflows: consultar APIs, hacer cálculos, actualizar datos o automatizar tareas. Se ejecutan al instante, devuelven un resultado y pueden usarse en múltiples Workflows y proyectos. Jelou incluye Tools nativas listas para usar, pero también puedes crear las tuyas cuando necesites algo específico para tu negocio.\
\
En esta guía vas a construir tu primer Tool: una función simple que consulta el clima de una ciudad y devuelve la temperatura.

<Steps>
  <Step title="Crea una nueva Tool">
    En el panel izquierdo de Brain Studio, accede a la pestaña **Tools** y haz clic en crear una nueva Tool. Asigna el nombre: **Consultar Clima**.
  </Step>

  <Step title="Arrastra un nodo API">
    En el canvas, arrastra un nodo **API** desde el panel de nodos. En la pestaña **URL**, ingresa:

    ```txt url.txt theme={null}
    https://api.weather.com/v1/current
    ```

    En **Variables**, selecciona o crea una variable de entorno para tu API key (márcala como secreta si contiene credenciales).
  </Step>

  <Step title="Configura los inputs">
    En la configuración de la Tool, agrega un input:

    * **Nombre**: `ciudad`
    * **Tipo**: `string`
    * **Requerido**: Sí

    Configura cómo este input se envía al nodo API (por ejemplo, como parámetro en la URL: `{{$input.ciudad}}`).
  </Step>

  <Step title="Configura los outputs">
    Define qué información devolverá la Tool. En la configuración de outputs, mapea:

    * `temperatura`: Extrae el valor de la respuesta de la API
    * `descripcion`: Extrae la descripción del clima

    Estos valores estarán disponibles cuando uses la Tool en un Flujo.
  </Step>

  <Step title="Prueba tu Tool">
    Usa la funcionalidad de prueba e ingresa un valor de ejemplo, como "Madrid". Verifica que la respuesta sea correcta y que los outputs estén mapeados correctamente.
  </Step>

  <Step title="Publica la Tool">
    Haz clic en **Publicar**. Se generará una versión (v1.0.0) y quedará disponible para usarla en cualquier proyecto de tu compañía.
  </Step>
</Steps>

¡Y listo! Ya puedes usar esta Tool en tus Workflows arrastrándola desde el panel de Tools y configurando el input `ciudad`.