Skip to main content
Antes de comenzar con esta guía, asegúrate de haber leído Qué son las Tools, donde se explican conceptos basicos, cuando usarlas y diferencias entre Tools y HTTPS para saber que tipo crear dentro de tu flujo.

​
Pasos para crear una Tool

​
1. Navega a la sección de Tools

En el panel izquierdo de Brain Studio, accede a la pestaña Tools. Aquí encontrarás todas las Tools disponibles en tu proyecto y podrás crear nuevas.

​
2. Crea un nuevo Tool

Haz clic en el botón para crear una nueva Tool. Se abrirá el canvas, donde podrás construir el flujo de tu Tool.

​
3. Construye el flujo

Arrastra y conecta los nodos necesarios para definir cómo funciona tu Tool. Los nodos soportados incluyen:
  • API: Para conectarte con servicios externos
  • Código: Para procesar datos o aplicar reglas personalizadas
  • Datum: Para consultar o actualizar información almacenada
  • Otros nodos disponibles según la documentación de la plataforma

​
4. Configura inputs y outputs

Define qué información necesita tu Tool (inputs) y qué devolverá al ejecutarse (outputs). Esta configuración permite que la Tool se integre correctamente cuando se use dentro de una Skill. Inputs:
  • Valores que debes proporcionar a la Tool para que funcione
  • Se configuran cuando arrastras la Tool a tu flujo (Skill)
Outputs:
  • Resultados que la Tool devuelve después de ejecutarse
  • Puedes usar estos valores en los siguientes pasos del flujo
Al configurar inputs, puedes definir:
  • Tipo de dato
  • Valores por defecto
  • Validaciones según el uso de la Tool

​
5. Configura variables de entorno

Si tu Tool necesita autenticación o configuración adicional, crea variables de entorno. Puedes marcarlas como secretas para proteger información sensible. Variables secretas:
  • Datos encriptados que no son visibles para otros usuarios
  • Útiles para API keys, tokens y credenciales

​
6. Prueba tu Tool

Usa la funcionalidad de pruebas para asegurarte de que la Tool funciona correctamente antes de publicarla.
  • Prueba con distintos valores de entrada
  • Verifica que los outputs sean los esperados

​
7. Publica la Tool

Una vez lista, publica la Tool. Al hacerlo:
  • Se genera una versión (v1.0.0, v2.0.0, etc.)
  • Puedes publicarla en el Marketplace (privada por defecto en self-service)
  • Queda disponible para usarla en cualquier proyecto de tu compañía

​
Dónde se configura

La configuración de Tools se realiza desde:
  • Panel de Tools: Acceso principal desde el menú lateral izquierdo
  • Canvas de la Tool: Donde se construye el flujo con nodos
  • Configuración de publicación: Ventana que aparece al publicar
  • Documentación API: Generada automáticamente y accesible desde la Tool publicada

​
Ejemplo práctico: Tool para consultar el clima

Vamos a crear una Tool que consulta el clima de una ciudad conectándose con un servicio externo.

​
Paso 1: Crear la Tool

  1. Ve a la sección Tools en el panel izquierdo
  2. Haz clic en Crear nueva Tool
  3. Asigna el nombre: Consultar Clima

​
Paso 2: Configurar el nodo API

  1. Arrastra un nodo API al canvas
  2. En la pestaña URL, ingresa la dirección del servicio de clima (ejemplo: https://api.weather.com/v1/current)
  3. En Headers, agrega los datos necesarios
  4. En Auth, configura la autenticación usando una variable de entorno secreta
  5. En Variables, selecciona la variable que contiene tu API key

​
Paso 3: Configurar variables de entorno

  1. Ve a la configuración de variables de entorno
  2. Crea una nueva variable:
    • Nombre: WEATHER_API_KEY
    • Valor: Tu API key del servicio de clima
    • Secreto: Activado (la variable queda encriptada)
  3. Guarda la variable

​
Paso 4: Configurar inputs

En la configuración de la Tool:
  1. Agrega un input:
    • Nombre: ciudad
    • Tipo: string
    • Requerido: Sí
    • Descripción: “Nombre de la ciudad para consultar el clima”
  2. Configura cómo este input se envía al nodo API (por ejemplo, como parámetro en la URL)

​
Paso 5: Configurar outputs

Define qué información devolverá la Tool:
  • temperatura: Temperatura actual
  • descripcion: Descripción del clima
  • humedad: Porcentaje de humedad

​
Paso 6: Probar la Tool

  1. Usa la opción de prueba
  2. Ingresa un valor de ejemplo, como “Madrid”
  3. Verifica que la respuesta sea correcta

​
Paso 7: Publicar la Tool

  1. Haz clic en Publicar
  2. Activa Publicar en el Marketplace si deseas compartirla
  3. Selecciona la versión inicial (v1.0.0)
  4. Confirma la publicación

​
Paso 8: Usar la Tool en una Skill

  1. Abre o crea una Skill
  2. Arrastra la Tool Consultar Clima desde el panel de Tools
  3. Selecciona la versión que deseas usar
  4. Configura el input ciudad (puede venir del contexto o ser un valor fijo)
  5. Conecta el output a un nodo de texto para mostrar el resultado al usuario

​
Ejemplo de uso con un agente de IA

Si usas esta Tool con un agente de IA, puedes incluir en el prompt:
“Cuando el usuario pregunte por el clima de una ciudad, utiliza la Tool ‘Consultar Clima’ y envía el nombre de la ciudad como input.”

​
Inputs y outputs

Input: 
{
  "ciudad": "Barcelona"
}
Output: 
{
  "temperatura": 22,
  "descripcion": "Parcialmente nublado",
  "humedad": 65
}

​
Checklist de validación

Antes de publicar un Tool, verifica:
  • El Tool tiene un nombre descriptivo y claro
  • Todos los inputs están configurados con tipos y descripciones
  • Los outputs están correctamente mapeados
  • Las variables de entorno necesarias están creadas (y marcadas como secretas si aplica)
  • El Tool ha sido probado con diferentes valores de entrada
  • Se manejan correctamente los casos de error
  • La documentación de inputs y outputs es clara
  • No hay valores hardcodeados que deberían ser variables
  • El Tool funciona correctamente cuando se consume desde una Skill
  • Si es Tool HTTPS, la documentación API está disponible y es correcta

​
Errores comunes y cómo resolverlos

Verifica que la Tool esté marcada como publicable y que la opción de publicación esté activa.
Verifica que los nombres de los inputs coincidan exactamente entre la Tool y la Skill (incluyendo mayúsculas y minúsculas).
Verifica que las variables secretas estén correctamente configuradas y asociadas al nodo que las usa.