Tool Transform
Transforma, filtra, mapea o construye datos usando expresiones. No hace llamadas externas. Opera solo sobre los datos que viajan por el flow.
¿Cuándo usarlo?
Cuando necesitas remapear una respuesta de API, extraer un campo específico, formatear una fecha, construir un mensaje a partir de variables o limpiar datos antes de usarlos.
Pasos
- 1Crea una tool → elige tipo «Transform».
- 2Define el output: un objeto JSON con las claves que quieres generar.
- 3En el valor de cada clave, usa expresiones {{...}} para referenciar variables del flow.
- 4Guarda y prueba con un payload de muestra para verificar el output.
Referencia
- Expresiones {{...}}
- Acceden a cualquier variable del flow. Soportan dot notation: {{nodo_anterior.data.nombre}}
- Funciones helpers
- Disponibles dentro de expresiones: .toUpperCase(), .toLowerCase(), .trim(), .split(), .join(), .slice(), parseInt(), parseFloat().
- Condicional ternario
- {{condicion ? valor_true : valor_false}} para lógica simple sin usar una tool condition.
- Output
- El objeto completo que retorna la tool. Disponible en nodos posteriores como {{nombre_nodo.output}}.
Errores comunes
- Variable undefined
- La variable que referencias no existe en el contexto del flow en ese punto. Verifica el nombre y que el nodo anterior la genere.
- Output vacío o null
- Si la expresión falla silenciosamente, el campo queda null. Prueba la tool con datos reales para verificar.
Siguiente paso
Aprende Tool Condition para bifurcar el flow según una condición.