Routines
Lancez du travail selon un calendrier ou depuis un webhook. Créez une routine, ajoutez des déclencheurs, définissez variables et règles de chevauchement, lancez-la à la main et consultez son historique.
Une routine crée une tâche pour un agent encore et encore : selon un calendrier, quand l'un de vos systèmes appelle un webhook, ou quand vous appuyez sur Run now. Utilisez-la pour des rapports quotidiens, des revues hebdomadaires, des réactions à des alertes, ou tout ce qui doit se faire sans que quelqu'un pense à le demander.
Avant de commencer
Il vous faut l'autorisation Manage routines (routines:manage) et au moins un agent.
Créer une routine
- Ouvrez Routines et sélectionnez New routine.
- Donnez-lui un titre, l'agent qui fait le travail et, si vous le souhaitez, un projet.
- Rédigez la demande : la description de tâche que l'agent reçoit à chaque exécution.
- Sélectionnez Create. La routine existe mais ne fait rien tant qu'elle n'a pas de déclencheur ou que vous ne la lancez pas.
Variables
Écrivez {{name}} dans la demande pour déclarer une variable, par exemple Summarize tickets from {{week}}. Chaque variable peut avoir un libellé, un type (texte, nombre, oui/non, choix, date), une valeur par défaut et un interrupteur Required. Une exécution doit fournir chaque variable obligatoire sans valeur par défaut.
Ajouter un déclencheur
Ouvrez la section Triggers de la routine et sélectionnez Add trigger.
| Type | Lance une exécution quand | Réglages |
|---|---|---|
| Schedule | L'expression cron arrive à échéance dans le fuseau choisi. | Expression cron, fuseau horaire. |
| Webhook | Votre système envoie une requête signée à l'URL du déclencheur. | Mode de signature, fenêtre anti-rejeu. |
| API | Quelqu'un appelle l'endpoint d'exécution avec ce déclencheur. | Aucun. |
Un calendrier comme 0 9 * * 1-5 avec le fuseau Europe/Istanbul s'exécute à 9 h, heure d'Istanbul, chaque jour ouvré.
Pour un webhook, la console affiche l'URL et, une seule fois, le secret. Votre émetteur signe chaque requête avec lui. Les webhooks ont leur propre page : Webhook de déclenchement de routine.
Quand des exécutions se chevauchent
Choisissez ce qui se passe quand une exécution arrive à échéance alors que la précédente travaille encore :
| Réglage | Effet |
|---|---|
| Coalesce if active | La nouvelle exécution se fond dans celle en cours au lieu d'en lancer une autre. |
| Skip if active | La nouvelle exécution est sautée et enregistrée comme telle. |
| Always enqueue | Chaque exécution est conservée et démarre à son tour. |
Et ce qu'il advient des exécutions manquées pendant que la routine était en pause :
| Réglage | Effet |
|---|---|
| Skip missed | Les exécutions manquées sont abandonnées. |
| Enqueue missed (with a cap) | Les exécutions manquées sont créées à la reprise, dans une certaine limite. |
La lancer à la main
Sélectionnez Run now, renseignez les éventuelles variables et confirmez. L'exécution crée sa tâche immédiatement.
Ce que fait une exécution
Chaque exécution crée une tâche, attribuée à l'agent de la routine (ou à l'agent choisi pour cette exécution), et réveille cet agent. La tâche est ordinaire : vous pouvez la suivre, y répondre et voir son coût. Les limites de pause, d'accès et de budget s'appliquent toujours : une routine ne dépense jamais au-delà d'un budget.
Historique et révisions
- Runs liste chaque exécution avec sa source (calendrier, webhook, API ou manuelle), son statut et la tâche créée.
- History liste les versions de configuration : chaque modification de la demande, de l'agent ou des déclencheurs crée une révision que vous pouvez restaurer.
Mettre en pause ou archiver
Passez la routine au statut Paused pour arrêter les nouvelles exécutions tout en gardant les déclencheurs, ou Archived pour la retirer. Les appels webhook vers une routine en pause ou archivée sont refusés avec 409.
Depuis l'API
Créez une routine, ajoutez un calendrier et lancez une exécution :
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 répété renvoie la première exécution au lieu d'en lancer une autre : les relances sont sans risque.
Voir Create a routine, Create a routine trigger, Manually run a routine et tous les endpoints dans Routines.