Skip to main content
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.
1

Crea un nuevo Tool

En Brain Studio, haz clic en el botón flotante con el nombre del skill y el ícono de carpeta para abrir el panel de Skills & Tools. Accede a la pestaña Tools y haz clic en crear una nueva Tool. Asigna el nombre: Consultar Clima.
2

Arrastra un nodo API

En el canvas, arrastra un nodo API desde el panel de nodos. En la pestaña URL, ingresa:
url.txt
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).
3

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}}).
4

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 una Skill.
5

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

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.
¡Y listo! Ya puedes usar esta Tool en tus Skills arrastrándola desde el panel de Tools y configurando el input ciudad.