Passer au contenu principal
Afficher en Markdown

Cron et planification

Les tâches cron exécutent des tâches d'agent selon un horaire. Chaque tâche est une requête en langage naturel plus un horaire; au déclenchement, elle s'exécute dans sa propre session et le résultat est livré à votre message direct Slack et/ou au panneau de notifications du tableau de bord.

Ajouter une tâche cron

Depuis le tableau de bord (recommandé)

Ouvrez le panneau Schedule dans le tableau de bord et cliquez sur Add. Remplissez un nom, la requête et l'horaire (intervalle ou expression cron). Vous pouvez aussi simplement demander dans le clavardage : « Chaque jour de semaine à 9 h, résume mon travail en cours » — l'agent crée la tâche pour vous.

Depuis la CLI

bash
kirocrew cron add "briefing" "give me a morning status report" --cron "0 9 * * 1-5" kirocrew cron add "poll-status" "check the pipeline endpoint" --every 300 kirocrew cron add "reminder" "call the vet" --at "tomorrow 9am" kirocrew cron add "version-check" "" --every 3600 \ --script ~/.kiro/crew/crons/check.py:run --no-persistent-session --minimal-context kirocrew cron add "disk" "" --every 600 --command "df -h /" --timeout 30 \ --no-persistent-session --minimal-context

La CLI enregistre des tâches d'agent, de script, de commande, récurrentes et ponctuelles. Un fichier de script doit déjà se trouver sous ~/.kiro/crew/crons/. --script, --command et --agent ne peuvent pas être combinés, et chaque tâche prend un seul horaire parmi --every, --cron ou --at.

Laisser un outil posséder une tâche

Un installateur ou un autre outil peut enregistrer une tâche sous une clé de propriétaire avec --managed-by :

bash
kirocrew cron add "catalog-sync" "sync the asset catalog" --cron "0 2 * * *" \ --managed-by "mysystem:owner/asset-name"

La clé est unique dans tout le magasin. Un second cron add --managed-by avec la même clé est refusé et nomme l'identifiant de la tâche existante. Il n'y a pas de remplacement sur place : pour réinstaller, supprimez la tâche par clé, puis ajoutez-la de nouveau.

bash
kirocrew cron remove --managed-by "mysystem:owner/asset-name"

cron remove prend soit un identifiant de tâche, soit --managed-by KEY, pas les deux.

Limites des tâches cron de commande

Une tâche cron de commande s'exécute via sh -c sur un hôte POSIX. Crew la valide lorsque vous enregistrez la tâche et de nouveau avant chaque exécution. Elle refuse la substitution de commandes, les boucles, les paramètres spéciaux du shell, les guillemets ANSI-C et l'expansion d'accolades. Cela inclut les intervalles d'expression régulière entre guillemets tels que grep -E '[0-9]{1,3}'.

Utilisez une tâche cron de script lorsque la vérification a besoin de ces fonctionnalités du shell. Pour une expression régulière de base, les accolades échappées entre guillemets doubles restent disponibles, comme grep "[0-9]\{1,3\}".

Une tâche enregistrée qui utilise une forme nouvellement refusée échoue à chaque exécution jusqu'à sa modification. L'importation ignore cette tâche et indique pourquoi. Les tâches cron de commande s'exécutent sur les hôtes où /bin/sh est Bash, y compris Amazon Linux, RHEL et Fedora.

L'agent lui-même appelle l'outil MCP équivalent (cron_add) chaque fois que vous dites quelque chose comme « rappelle-moi chaque matin de vérifier… ». Aucune syntaxe à mémoriser.

Lister, mettre en pause, reprendre, supprimer

Depuis le tableau de bord

Le panneau Schedule affiche toutes les tâches avec leur statut, leur prochaine heure d'exécution et des contrôles : mettre en pause, reprendre, déclencher maintenant, modifier, supprimer.

Depuis la CLI

bash
kirocrew cron list kirocrew cron pause <job_id> kirocrew cron resume <job_id> kirocrew cron trigger <job_id> # run once manually kirocrew cron remove <job_id> kirocrew cron remove-all

Toutes ces commandes sont aussi exposées comme outils MCP (cron_list, cron_pause, cron_resume, cron_trigger, cron_remove, cron_remove_all).

Inspecter une exécution échouée

Sur la page Schedule, ouvrez une tâche et passez à son onglet Logs. Chaque exécution est listée avec un badge OK, Error, Timeout ou Cancelled, son heure de début, sa durée, son déclencheur et son résumé. Développez une exécution pour lire sa trace.

Une exécution marquée Error ou Timeout propose aussi Ask the agent. Elle ouvre un nouveau clavardage avec un rapport déjà dans le compositeur : l'identifiant de la tâche, l'identifiant de l'exécution, le déclencheur, l'heure de début, le résumé de l'exécution et la fin de la sortie de l'exécution (les 4 000 derniers caractères). Envoyez-le et l'agent peut inspecter l'échec et vous aider à corriger la tâche.

Il s'agit d'une passation pour enquête. Elle ne reprend ni ne relance la tâche; utilisez Run Now ou kirocrew cron trigger pour cela. Les exécutions réussies et annulées ne proposent pas le bouton.

Formats d'horaire

ChampSignification
--cron "0 9 * * 1-5"Expression cron standard
--every 300Toutes les N secondes
--timezone "America/Los_Angeles"Fuseau horaire IANA par tâche (par défaut : fuseau horaire de la configuration globale, puis UTC)
--skip-dates "2026-12-25,2027-01-01"Exclure des dates locales précises

Les expressions cron utilisent le format standard à cinq champs : minute, heure, jour du mois, mois et jour de la semaine. La page Schedule affiche l'expression et la prochaine exécution de chaque tâche dans le fuseau horaire de cette tâche.

Lorsqu'une tâche nomme une heure murale, fournissez toujours une valeur --timezone explicite. Sans elle, l'expression cron utilise le fuseau horaire de la configuration globale et ne se replie sur UTC que si aucun fuseau horaire global n'est configuré.

Options par tâche

OptionObjectif
--timeout-secs <n>Budget de temps par tâche (1800 s par défaut; jusqu'à 24 heures)
--agent <name>Agent utilisé pour l'exécution
--persistent-sessionRéutiliser une session entre les exécutions; la valeur persistante est celle enregistrée par défaut
--silentNe livrer rien à moins que la tâche n'envoie explicitement une notification
--strict-scheduleDésactiver la gigue d'exécution
--managed-by <key>Clé de propriétaire pour une tâche installée par un outil; unique dans tout le magasin (voir Laisser un outil posséder une tâche)
--auto-pause-after <n>Exécutions échouées consécutives avant que la tâche se mette elle-même en pause; 0 ne met jamais en pause

Le formulaire de tâche Schedule fixe les mêmes limites. Time limit arrête une exécution qui se poursuit encore après la limite et la signale comme un dépassement de délai; la valeur par défaut est de 30 minutes. Auto-pause after N failures in a row met la tâche en pause après ce nombre d'exécutions échouées, et 0 signifie jamais. Pendant qu'une tâche en échec attend entre deux nouvelles tentatives, le tableau Schedule indique qu'elle est en période d'attente après échec. Un commutateur Runs as choisit un Custom agent ou un Mate pour l'exécution, et la liste des tâches peut filtrer par mate.

Gigue d'exécution

Par défaut, les tâches reçoivent un petit délai aléatoire pour répartir le travail simultané. Utilisez --strict-schedule lorsque la minute planifiée exacte est importante.

Sessions persistantes et nouvelles

  • Persistante (par défaut) : réutilise une session lorsque la tâche accumule intentionnellement du contexte au fil du temps.
  • Nouvelle : donne à chaque exécution une session distincte. Définissez persistent_session: false via le tableau de bord ou l'outil MCP pour un agent de sondage ou de balayage qui ne doit pas accumuler de contexte antérieur.

Contexte minimal

Pour une tâche d'agent qui n'a pas besoin de l'historique enregistré, activez Minimal context dans le dialogue de création ou de modification de la planification, ou définissez minimal_context: true via l'outil MCP. Crew conserve les instructions de la tâche et les directives requises du membre ou du projet tout en omettant le contexte injecté complet. Cela réduit l'utilisation de jetons sans changer l'agent ni transformer la tâche en script.

Pour une vérification déterministe ne nécessitant pas de raisonnement par modèle, préférez une tâche en script. Demandez au Skill cron-cost-optimize d'inspecter l'historique des exécutions enregistrées et de recommander une exécution en script, en contexte minimal ou en contexte complet. Il fournit des recommandations et ne modifie jamais une tâche lui-même.

Où vont les résultats

La sortie de chaque tâche est livrée à votre message direct Slack (si configuré) et au panneau de notifications du tableau de bord. Dans le tableau de bord, la ligne de résultat d'une exécution porte le même pied de page d'utilisation qu'un tour de clavardage : temps écoulé, crédits et modèle. Consultez Utilisation : crédits et jetons estimés.

Vous pouvez remplacer la livraison par exécution avec des marqueurs deliver: dans la requête ou dans HEARTBEAT.md :

- [ ] Monitor pipeline for failures <!-- deliver:C0123CHANNEL -->

Cela achemine le résultat vers un canal Slack précis au lieu de votre message direct.

Démarrage et cycle de vie

Les tâches cron persistent dans ~/.kiro/crew/crons.json et se chargent au démarrage de la passerelle. Tant que la passerelle est en marche, les tâches se déclenchent selon l'horaire.

Si la passerelle est arrêtée au moment où une tâche aurait dû se déclencher, l'exécution planifiée est manquée; Crew ne rejoue pas chaque intervalle manqué au démarrage. Une exécution déjà en cours lorsque la passerelle s'est arrêtée peut redevenir due après le redémarrage car elle n'a pas d'horodatage d'exécution complétée. Vérifiez la page Schedule après un redémarrage inattendu lorsqu'une tâche a des effets externes non idempotents.

Éviter complètement le planificateur

Certaines configurations multi-instances ne veulent pas que le planificateur cron soit actif. Démarrez la passerelle avec --no-crons pour l'éviter :

bash
kirocrew gateway --no-crons

Les tâches restent lisibles via kirocrew cron list, mais elles ne se déclencheront pas sur cette instance.

Interaction avec l'exécuteur de tâches

Les tâches cron qui déclenchent le Task Runner n'apparaissent pas dans la page Tasks du tableau de bord — elles sont filtrées pour garder la vue centrée sur le travail initié par l'utilisateur. Les tâches s'exécutent toujours; l'état est simplement caché de la liste visible.

Gouvernance et sécurité

Les exécutions cron sont sans surveillance par définition, donc elles ne portent jamais de confiance par exécution. Tout appel d'outil à l'intérieur d'une tâche cron :

  • N'obtient jamais la confiance « approuver automatiquement cette session » propre au tableau de bord
  • Respecte toujours les listes de refus des hooks, les blocages de chemins sensibles et les politiques de gouvernance
  • Respecte toujours le remplacement global YOLO si celui-ci est actif

Étendre la confiance par exécution aux exécutions récurrentes n'est délibérément pas pris en charge — l'approbation automatique récurrente est un risque plus grand qu'une seule session interactive.

Heartbeats — surveillance réactive

Les Heartbeats permettent à Crew de surveiller quelque chose au fil du temps sans que vous ayez à surveiller une session. Demandez dans le clavardage — « surveille cette pull request et dis-moi quand des commentaires arrivent » ou « surveille le pipeline et alerte-moi s'il passe au rouge » — et Crew crée une tâche heartbeat qui vérifie toutes les 60 secondes.

Contrairement aux tâches cron (qui exécutent une requête selon un horaire fixe), les Heartbeats sont réactifs — ils ne font apparaître des résultats que lorsque quelque chose change.

Comment ça fonctionne

Les tâches Heartbeat vivent dans ~/.kiro/crew/workspace/HEARTBEAT.md. Le service heartbeat lit le fichier toutes les 60 secondes, exécute toutes les tâches en parallèle et :

  • En cas de succès — efface la tâche (la condition a été remplie)
  • En cas d'échec — la réécrit pour une nouvelle tentative au prochain cycle
  • Lors de la livraison — achemine les résultats vers votre surface configurée

Heartbeats vs cron

HeartbeatCron
DéclencheurChaque cycle de 60 sHoraire ou intervalle fixe
SortieSeulement quand quelque chose changeÀ chaque exécution
Durée de vieJusqu'à ce que la condition soit remplie ou que vous la supprimiezS'exécute indéfiniment jusqu'à mise en pause/suppression
Idéal pour« Dis-moi quand X se produit »« Fais Y chaque matin »

Acheminement de la livraison

Par défaut, les résultats vont vers votre message direct Slack ou les notifications du tableau de bord. Remplacez cela par tâche avec un marqueur de livraison dans le fichier heartbeat : <!-- deliver:C0123CHANNEL --> achemine vers un canal Slack précis.

Webhooks — déclencheurs externes

Des systèmes externes peuvent déclencher des sessions d'agent Crew via HTTP. Un pipeline d'intégration continue peut aviser Crew lorsqu'une build échoue, ou un outil de surveillance peut escalader une alerte — tout cela sans que personne soit au terminal.

Le point d'accès :

POST /api/hooks/agent Authorization: Bearer <token> Content-Type: application/json { "message": "Build failed for pipeline X. Check logs and report the root cause." }

Les requêtes nécessitent un jeton Bearer valide (générez-en un avec kirocrew token). Jusqu'à 6 sessions webhook simultanées; chacune a un délai d'expiration par défaut de 10 minutes.

Exemple — alerte d'échec d'intégration continue :

bash
curl -X POST http://localhost:5476/api/hooks/agent \ -H "Authorization: Bearer $KIROCREW_TOKEN" \ -H "Content-Type: application/json" \ -d '{"message": "Build failed. Summarize what went wrong."}'

Crew analyse l'échec et répond. Le résultat est acheminé vers votre surface de notification configurée.

Pour les flux de travail persistants qui transportent le contexte à travers plusieurs appels webhook (p. ex. un pipeline à plusieurs étapes), l'agent peut utiliser register_hook pour enregistrer l'état du flux de travail que le prochain appel webhook récupère.

Autonudge — surveillance en session

Pour une surveillance qui reste au sein d'une session active (plutôt qu'un heartbeat en arrière-plan), Crew dispose de l'autonudge — une boucle d'autovérification qui réinjecte vos instructions selon une minuterie d'inactivité.

Utilisez-le lorsque vous voulez que Crew continue de vérifier quelque chose dans votre conversation actuelle :

  • « Continue de vérifier ceci toutes les 5 minutes et dis-moi si ça change »
  • « Surveille ce déploiement et alerte-moi quand c'est terminé »

Autonudge fonctionne depuis le clavardage du tableau de bord, les fils Slack et les messages directs Discord. Arrêtez-le en envoyant un nouveau message qui prend le relais de la session, ou avec l'outil autonudge_stop.

Parler à une session de surveillance en cours de boucle ne redémarre plus son compte à rebours, de sorte que les vérifications surviennent au moment prévu. Un incident transitoire, comme une limitation ou une erreur serveur, est réessayé plutôt que comptabilisé en vue de la pause automatique; un cycle réussi réinitialise le compte d'échecs, et une boucle sans surveillance qui perd l'approbation d'un outil le signale au lieu de s'arrêter en silence.

Page mise à jour : 11 novembre 2026