Rutinas
Ejecuta trabajo según un calendario o desde un webhook. Crea una rutina, añade disparadores, define variables y reglas de solapamiento, ejecútala a mano y consulta su historial.
Una rutina crea una tarea para un agente una y otra vez: según un calendario, cuando uno de tus sistemas llama a un webhook o cuando pulsas Run now. Úsala para informes diarios, revisiones semanales, reacciones a alertas o cualquier cosa que deba ocurrir sin que nadie tenga que acordarse de pedirla.
Antes de empezar
Necesitas el permiso Manage routines (routines:manage) y al menos un agente.
Crea una rutina
- Abre Routines y selecciona New routine.
- Dale un título, el agente que hace el trabajo y, si quieres, un proyecto.
- Escribe la petición: la descripción de la tarea que el agente recibe en cada ejecución.
- Selecciona Create. La rutina existe, pero no hace nada hasta que tenga un disparador o la ejecutes.
Variables
Escribe {{name}} en la petición para declarar una variable, por ejemplo Summarize tickets from {{week}}. Cada variable puede tener una etiqueta, un tipo (texto, número, sí/no, una opción, una fecha), un valor por defecto y un interruptor Required. Una ejecución debe aportar cada variable obligatoria que no tenga valor por defecto.
Añade un disparador
Abre la sección Triggers de la rutina y selecciona Add trigger.
| Tipo | Inicia una ejecución cuando | Ajustes |
|---|---|---|
| Schedule | Vence la expresión cron en la zona horaria elegida. | Expresión cron, zona horaria. |
| Webhook | Tu sistema envía una solicitud firmada a la URL del disparador. | Modo de firma, ventana contra repeticiones. |
| API | Alguien llama al endpoint de ejecución con este disparador. | Ninguno. |
Un calendario como 0 9 * * 1-5 con la zona horaria Europe/Istanbul se ejecuta a las 09:00, hora de Estambul, cada día laborable.
Para un webhook, la consola muestra la URL y, una sola vez, el secreto. Tu emisor firma cada solicitud con él. Los webhooks tienen su propia página: Webhook de disparo de rutinas.
Cuando las ejecuciones se solapan
Elige qué ocurre cuando vence una ejecución mientras la anterior sigue trabajando:
| Ajuste | Efecto |
|---|---|
| Coalesce if active | La nueva ejecución se une a la activa en lugar de iniciar otra. |
| Skip if active | La nueva ejecución se omite y queda registrada como omitida. |
| Always enqueue | Se conserva cada ejecución y empieza cuando le toca. |
Y qué pasa con las ejecuciones perdidas mientras la rutina estaba en pausa:
| Ajuste | Efecto |
|---|---|
| Skip missed | Las ejecuciones perdidas se descartan. |
| Enqueue missed (with a cap) | Las ejecuciones perdidas se crean al reanudar, hasta un límite. |
Ejecútala a mano
Selecciona Run now, rellena las variables que haya y confirma. La ejecución crea su tarea de inmediato.
Qué hace una ejecución
Cada ejecución crea una tarea, asignada al agente de la rutina (o al agente que elijas para esa ejecución), y despierta a ese agente. La tarea es normal: puedes seguirla, responder y ver su coste. Los límites de pausa, acceso y presupuesto se siguen aplicando, así que una rutina nunca gasta más allá de un presupuesto.
Historial y revisiones
- Runs lista cada ejecución con su origen (calendario, webhook, API o manual), su estado y la tarea que creó.
- History lista las versiones de configuración: cada cambio en la petición, el agente o los disparadores crea una revisión que puedes restaurar.
Pausa o archiva
Pon la rutina en Paused para detener las nuevas ejecuciones conservando los disparadores, o en Archived para retirarla. Las llamadas de webhook a una rutina en pausa o archivada se rechazan con 409.
Desde la API
Crea una rutina, añade un calendario e inicia una ejecución:
ROUTINE_ID=$(curl -s -X POST "https://intelligence-api.veyra.so/api/companies/$COMPANY_ID/routines" \
-H "Authorization: Bearer $VEYRA_API_KEY" -H "Content-Type: application/json" \
-d '{"title": "Weekly support summary", "description": "Summarize tickets from {{week}}.", "assigneeAgentId": "'"$AGENT_ID"'"}' | jq -r .id)
curl -X POST "https://intelligence-api.veyra.so/api/routines/$ROUTINE_ID/triggers" \
-H "Authorization: Bearer $VEYRA_API_KEY" -H "Content-Type: application/json" \
-d '{"kind": "schedule", "cronExpression": "0 9 * * 1", "timezone": "Europe/Istanbul"}'
curl -X POST "https://intelligence-api.veyra.so/api/routines/$ROUTINE_ID/run" \
-H "Authorization: Bearer $VEYRA_API_KEY" -H "Content-Type: application/json" \
-d '{"source": "api", "variables": {"week": "2026-W46"}, "idempotencyKey": "support-2026-w46"}'Un idempotencyKey repetido devuelve la primera ejecución en lugar de iniciar otra, así que los reintentos son seguros.
Consulta Create a routine, Create a routine trigger, Manually run a routine y todos los endpoints en Rutinas.