Tu código en los flujos

Python Code te deja escribir tu propia lógica en Python dentro de un flujo, cuando ningún componente hace justo lo que necesitas: calcular, limpiar o combinar datos, aplicar reglas de tu negocio, leer y guardar archivos o recorrer una lista entera de una vez.

En este vídeo verás todos sus usos: paquetes, volúmenes de almacenamiento, herramientas y modelos llamados desde el código, y el componente como herramienta de un agente.

Cómo funciona

El componente recibe los datos del paso anterior, ejecuta tu código de forma aislada y entrega lo que tu código devuelve.

# Los datos de entrada llegan en "data"
total = data["cantidad"] * data["precio"]
print("Pedido", data["pedido"], "calculado")   # aparece en el registro de la ejecución
return {"pedido": data["pedido"], "total": round(total, 2)}   # pasa al siguiente componente

En tu código	Qué es
data	Los datos que llegan por Input Data: un registro con sus campos o una lista de registros.
return	Lo que entregas al siguiente componente. Sin return, el componente no entrega nada.
print()	Mensajes que aparecen en el registro de la ejecución, sin formar parte del resultado.
env	Las variables del entorno asignado al flujo, por ejemplo env.get("MONEDA").
volume	La carpeta de tu almacenamiento donde guardar archivos. Ver Paquetes y volúmenes.
tools y models	Las herramientas y los modelos conectados. Ver Herramientas y modelos.
args	Los datos que envía un agente cuando el componente es su herramienta. Ver Como herramienta de un agente.
components	Lo que han devuelto otros componentes del flujo en esta ejecución, por su identificador.

Las fechas y los importes que llegan de una base de datos se convierten solos en texto, y puedes usar await directamente si tu código es asíncrono.

Escribir el código

• En el panel del componente, el campo Python Code se abre a pantalla completa con su botón de ampliar.
• Si arrastras un campo de la ejecución anterior al editor, se escribe solo la forma de leerlo, por ejemplo data.get("importe", None). Lo mismo con una variable del entorno: se escribe env.get("CLAVE", None).
• Para ver cómo llegan tus datos, empieza con return data y ejecuta el componente.

Dónde se ejecuta

Cada ejecución corre aislada del resto: tu código no puede tocar otros flujos ni la plataforma, pero sí conectarse a internet para llamar a otros servicios. Los archivos que guardes fuera del volumen se borran al terminar. Cada ejecución tiene memoria y tiempo limitados, hasta una hora.

Un perfil de ejecución puede bloquear el uso de Python Code en las ejecuciones de tu cuenta.

Sigue leyendo

Para…	Lee
Instalar paquetes y guardar archivos entre ejecuciones	Paquetes y volúmenes
Usar herramientas y modelos de IA desde el código	Herramientas y modelos
Dar tu código a un agente como herramienta	Como herramienta de un agente