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.

Veyra Docs TeamMis à jour le 3 min de lectureVersion 2 · 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

  1. Ouvrez Routines et sélectionnez New routine.
  2. Donnez-lui un titre, l'agent qui fait le travail et, si vous le souhaitez, un projet.
  3. Rédigez la demande : la description de tâche que l'agent reçoit à chaque exécution.
  4. 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 :

curl
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.

RoutinesTravailWebhooks