Schedule Flow Run

Schedule Flow Run programa que un flujo tuyo se ejecute una sola vez, más adelante, en la fecha y hora que elijas, con los valores que quieras para sus entradas. También puede cambiar una ejecución pendiente, cancelarla o listar las que tienes. Es la forma de que un flujo, o un agente, diga “haz esto mañana a las 9” sin que nadie abra el Programador.

Solo crea programaciones de una sola vez, nunca recurrentes. Para algo que se repite cada semana o cada día, crea la programación en la página del Programador.

En este vídeo, un agente con Schedule Flow Run como herramienta programa un recordatorio para dentro de dos minutos; lo ves pendiente en el Programador, con el filtro Una vez, y después ejecutado con Éxito.

Cuándo usarlo

Recordatorios y seguimientos: “recuérdame mañana a las 9”, “vuelve a llamar al cliente dentro de dos horas”.
Envíos diferidos: un correo, un mensaje o un informe que debe salir a una hora concreta.
Un agente que planifica trabajo para más tarde y que también puede cancelarlo o decirte qué hay pendiente.
Una ejecución por cada fila de una lista, por ejemplo un seguimiento por cliente, cada uno en su fecha.

Operaciones

Operación	Qué hace
Schedule	Crea una ejecución única del flujo elegido.
Reschedule	Cambia la fecha o los valores de las entradas de una ejecución pendiente.
Cancel	Cancela una ejecución pendiente.
List	Lista las ejecuciones únicas del flujo elegido, pendientes o ya hechas.

Reschedule, Cancel y List solo actúan sobre las programaciones únicas del flujo elegido en el nodo. Una programación recurrente, o de otro flujo, responde que no hay ninguna programación pendiente con ese id.

Configuración

Campo	Qué hace
Operation	Schedule, Reschedule, Cancel o List. Los campos de abajo cambian con ella.
Flow	El flujo que se ejecutará, a elegir entre tus flujos desplegados (los que tienen versión de producción; esa versión es la que se ejecuta). Pulsa el botón de refrescar para recargar la lista. El flujo al que pertenece este nodo no se ofrece.
Entradas del flujo elegido	Al elegir el flujo, cada una de sus entradas aparece como un campo, igual que en Sub Project flow. Escribe un valor fijo, conecta otro componente o déjalo para que lo rellene un agente en modo herramienta. Se muestran en Schedule y Reschedule.
Run At	Cuándo ejecutarlo, en formato ISO 8601, por ejemplo `2026-10-23T09:00`. Obligatorio en Schedule; en Reschedule, déjalo vacío para conservar la hora guardada.
Time Zone	Avanzado. La zona que se usa para una hora escrita sin desfase, por ejemplo `America/New_York`. Por defecto, `Europe/Madrid`.
Schedule Name	El nombre que se ve en la página del Programador. Si está vacío, se usan el nombre del flujo y la fecha. Solo en Schedule.
Schedule ID	El id de la programación que quieres cambiar o cancelar, el que se devolvió al programarla o al listarla. En Reschedule y Cancel.
Status	En List: Pending (por defecto) muestra las ejecuciones por venir o en curso, Done las que ya se ejecutaron, All ambas.
From / To	En List: solo las ejecuciones programadas dentro de esas fechas, por ejemplo `2026-10-23`. Una fecha sola cubre el día entero. Vacío, sin límite.
Max Results	En List: cuántas programaciones devolver, de 1 a 200. Por defecto, 50.

Si una entrada del flujo de destino se deja vacía en Schedule, se aplica el valor por defecto del propio flujo. En Reschedule, una entrada vacía conserva el valor ya guardado.

Fechas y zonas horarias

Escribe la hora como 2026-10-23T09:00, o con desfase como 2026-10-23T09:00+02:00. Sin desfase, la hora se lee en la Time Zone del nodo.
Una hora que ya ha pasado, o que no es una fecha válida, devuelve un error que incluye la hora actual, para que una persona o un agente pueda corregirla.
Los resultados muestran la hora dos veces: en UTC y en la zona horaria del nodo.

Salida

Data devuelve un elemento por programación con su schedule_id, el flujo, el nombre, la hora de ejecución en UTC (run_at_utc) y en la zona local (run_at_local), su estado y las inputs con las que se ejecutará. Cancel devuelve el id con cancelled: true.

Guarda el schedule_id si más adelante necesitas cambiar o cancelar la ejecución. En modo herramienta, un agente lo recibe en la respuesta y puede usarlo en su siguiente llamada; consulta Tool Mode.

Dónde aparecen las programaciones

Cada programación que creas aparece en la página del Programador, con el filtro One-time, marcada como creada por un flujo. Una vez que se ha ejecutado, sigue en la lista durante 30 días.

La ejecución es tuya: se ejecuta como tu usuario, con una de tus claves API que no tenga restricciones de IP ni de dominio. Si no tienes ninguna así, el nodo devuelve un error, así que crea una antes.

Ejemplo: un recordatorio por cliente (lote)

Un flujo tiene una lista de clientes, cada uno con un correo, una fecha y un mensaje. El flujo “Enviar seguimiento” está desplegado y tiene las entradas Email y Message.

Conecta la lista a la Batch Input de Schedule Flow Run y deja activado Batch Mode.
En Operation, elige Schedule; en Flow, “Enviar seguimiento”.
Conecta la fecha de cada fila a Run At, y el correo y el mensaje a los campos que aparecen.
Ejecuta el flujo: se crea una programación por fila, cada una en su fecha, y las ves en la página del Programador.

Ejemplo: un agente que planifica y cancela

Un asistente que organiza tus recordatorios, con un Agent y tres nodos Schedule Flow Run en modo herramienta, todos apuntando al flujo “Enviar recordatorio”: uno con Schedule, otro con Cancel y otro con List. El agente rellena Run At y el texto del recordatorio.

“Recuérdame mañana a las 9 que llame a Marta” llama a Schedule con Run At = mañana a las 09:00 y te devuelve el id de la programación.
“Cancélalo” llama a Cancel con ese id.
“¿Qué tengo programado?” llama a List y el agente te lee las ejecuciones pendientes.

Dile al agente la fecha de hoy en su prompt (por ejemplo con Current Date), para que “mañana” se convierta en el día correcto.

Consejos

Despliega primero el flujo de destino: solo los flujos con versión de producción aparecen en Flow.
Ponle a las programaciones un Schedule Name reconocible si vas a buscarlas en la página del Programador.
Para cambiar muchas ejecuciones, usa List primero y luego Reschedule con cada id.

Componentes relacionados

Sub Project flow: ejecuta otro flujo ahora, como un paso de este.
Programador: donde se gestionan todas las programaciones, también las recurrentes.
Publicar un flujo: despliega el flujo que quieres programar.