Tool Code
Ejecuta código JavaScript o Python en un sandbox seguro dentro de Pulbot. Para lógica que no encaja en los otros tipos de tool: algoritmos complejos, parseo de formatos propietarios, cálculos financieros, manipulación de arrays.
¿Cuándo usarlo?
Cuando necesitas lógica que ningún otro tipo de tool puede expresar de forma limpia.
Pasos
- 1Crea una tool → elige tipo «Code».
- 2Selecciona el lenguaje: JavaScript o Python.
- 3Escribe el código. Las variables del flow se inyectan como objeto global context: accede con context.nombre_variable.
- 4El código debe retornar un valor (return en JS, o la última expresión evaluada en Python).
- 5Guarda y prueba con un contexto de muestra.
Referencia
- context
- Objeto con todas las variables del flow disponibles en ese punto. Ej: context.mensaje, context.usuario_id.
- return
- El valor retornado queda disponible en nodos posteriores como salida del nodo.
- Librerías disponibles (JS)
- Módulos nativos de Node.js (crypto, path, url). No se permiten imports de npm externos.
- Librerías disponibles (Python)
- json, math, re, datetime, collections, itertools. No se permiten imports pip externos.
- Timeout
- El código tiene un límite de ejecución. Operaciones muy lentas se abortan.
Errores comunes
- «SyntaxError»
- Error de sintaxis en el código. Verifica la consola de prueba para el número de línea exacto.
- «context.X is undefined»
- La variable X no existe en el flow en ese punto. Verifica el nombre y que el nodo que la genera esté antes en el flow.
- Timeout de ejecución
- El código tardó más del límite. Optimiza loops o elimina operaciones bloqueantes (no hay I/O async disponible).
Siguiente paso
Aprende a probar cualquier tool antes de usarla en un flow.