Skip to main content
Puedes usar el nodo Tool dentro de otras Tools. Así armas bloques reutilizables (validar identidad, cobrar, consultar stock) y los combinas sin duplicar el canvas. Disponible para todas las compañías.

​
Cómo usarla

1

Abre el canvas

En Brain Studio, ve a la pestaña Tools y abre la que quieres componer (o crea una nueva).
2

Arrastra otra desde el buscador

En el canvas aparece el buscador de Tools. Arrastra la que necesites; se inserta como nodo con su toolId.La Tool que estás editando no aparece en la lista: no puedes referenciarte a ti misma.
3

Configura inputs y outputs

Mapea los inputs de la Tool hija (variables de memoria, $input, o valores fijos). Los tipos declarados (NUMBER, BOOLEAN, OBJECT, ARRAY) se preservan al invocarla; no llegan como string.
4

Publica

Publica la Tool padre. Al guardar y publicar, la plataforma rechaza autorreferencias y detecta ciclos (por ejemplo, A → B → A).
Canvas mostrando el buscador para arrastrar otra Tool

Buscador en el canvas

​
Salvaguardas anti-recursión

Para evitar bucles infinitos:
  • Sin autorreferencia: la Tool actual no aparece en el buscador y el guardado bloquea si intentas referenciarla.
  • Límite de anidamiento: en tiempo de ejecución hay un tope de profundidad (por defecto 5 niveles). Si se supera, la ejecución falla de forma controlada.
  • Detección de ciclos: al publicar, un analizador detecta ciclos entre Tools.
Diseña Tools pequeñas y con una sola responsabilidad. Anidar en exceso dificulta depurar y acerca el límite de profundidad.

​
Trazabilidad y depuración

Cada ejecución de una Tool hija genera un executionId que queda registrado en la Tool padre, aunque la ejecución termine en timeout, error o éxito. Desde el Tester, en el nodo usa Debuggear Tool para inspeccionar la ejecución interna de la hija (nodos, inputs, outputs y errores) sin abrir el canvas por separado.

​
Timeout

Las Tools hijas tienen un timeout configurable. El valor por defecto es 30 segundos. Si se agota, el estado final de la padre incluye el executionId de la hija y el resultado TIMEOUT, para que puedas depurarla igual que en un error normal.

​
Tipos de inputs

Al mapear inputs hacia una Tool hija, el builder persiste el tipo junto con el valor. El motor convierte según el tipo declarado: Así evitas bugs silenciosos cuando la Tool hija espera un ID numérico o un objeto.

​
Buenas prácticas

  • Prefiere Tools genéricas y reutilizables como piezas de composición.
  • Documenta inputs y outputs de cada Tool hija para que el mapeo en la padre sea claro.
  • Prueba la composición en el Tester y usa Debuggear Tool en cada nivel anidado.
  • Mantén la profundidad baja; si necesitas más de unos pocos niveles, revisa si puedes aplanar el diseño.