Les ordres permanents accordent à votre agent une autorité opérationnelle permanente pour des programmes définis. Au lieu de solliciter l’agent pour chaque tâche, vous définissez des programmes avec un périmètre, des déclencheurs et des règles d’escalade clairs, puis l’agent s’exécute de manière autonome dans ces limites : « Vous êtes responsable du rapport hebdomadaire. Compilez-le chaque vendredi, envoyez-le et ne faites remonter la situation que si quelque chose semble anormal. »
Pourquoi utiliser des ordres permanents
Sans ordres permanents : vous sollicitez l’agent pour chaque tâche, les activités courantes sont oubliées ou retardées, et vous devenez le goulot d’étranglement.
Avec des ordres permanents : l’agent s’exécute de manière autonome dans des limites définies, les activités courantes sont effectuées selon le calendrier prévu, et vous n’intervenez que pour les exceptions et les approbations.
Fonctionnement
Les ordres permanents sont définis dans les fichiers de votre espace de travail de l’agent. L’approche recommandée consiste à les inclure directement dans AGENTS.md (qui est injecté automatiquement à chaque session), afin que l’agent les ait toujours dans son contexte. Pour les configurations plus volumineuses, vous pouvez également les placer dans un fichier dédié, tel que standing-orders.md, et le référencer depuis AGENTS.md.
Chaque programme précise :
- Périmètre - ce que l’agent est autorisé à faire
- Déclencheurs - quand l’exécuter (calendrier, événement ou condition)
- Points de contrôle d’approbation - ce qui nécessite une validation humaine avant d’agir
- Règles d’escalade - quand s’arrêter et demander de l’aide
L’agent charge ces instructions à chaque session par l’intermédiaire des fichiers d’amorçage de l’espace de travail (consultez Espace de travail de l’agent pour obtenir la liste complète des fichiers injectés automatiquement) et les exécute en association avec les tâches Cron pour garantir leur application selon un calendrier.
Placez les ordres permanents dans AGENTS.md afin de garantir leur chargement à chaque session. L’amorçage de l’espace de travail injecte automatiquement AGENTS.md, SOUL.md, TOOLS.md, IDENTITY.md, USER.md, HEARTBEAT.md, BOOTSTRAP.md et MEMORY.md, mais pas les fichiers arbitraires situés dans des sous-répertoires.
Anatomie d’un ordre permanent
Ordres permanents et tâches Cron
Les ordres permanents définissent ce que l’agent est autorisé à faire. Les tâches Cron définissent quand cela se produit. Ils fonctionnent ensemble :
L’invite de la tâche Cron doit référencer l’ordre permanent plutôt que de le dupliquer :
Exemples
Exemple 1 : contenu et réseaux sociaux (cycle hebdomadaire)
Exemple 2 : opérations financières (déclenchées par un événement)
Exemple 3 : surveillance et alertes (en continu)
Modèle Exécuter-Vérifier-Rendre compte
Les ordres permanents sont plus efficaces lorsqu’ils sont associés à une discipline d’exécution stricte. Chaque tâche d’un ordre permanent doit suivre cette boucle :
- Exécuter - Effectuer réellement le travail (ne pas se contenter d’accuser réception de l’instruction)
- Vérifier - Confirmer que le résultat est correct (le fichier existe, le message a été transmis, les données ont été analysées)
- Rendre compte - Indiquer au propriétaire ce qui a été fait et vérifié
Ce modèle évite le mode d’échec le plus courant des agents : accuser réception d’une tâche sans l’accomplir.
Architecture à plusieurs programmes
Pour les agents qui gèrent plusieurs domaines, organisez les ordres permanents sous forme de programmes distincts aux limites claires :
Chaque programme doit disposer :
- De sa propre cadence de déclenchement (hebdomadaire, mensuelle, événementielle ou continue)
- De ses propres points de contrôle d’approbation (certains programmes nécessitent davantage de supervision que d’autres)
- De limites claires (l’agent doit savoir où se termine un programme et où commence un autre)
Bonnes pratiques
À faire
- Commencer avec une autorité limitée et l’étendre à mesure que la confiance s’établit
- Définir des points de contrôle d’approbation explicites pour les actions à haut risque
- Inclure des sections « Ce qu’il ne faut PAS faire » : les limites sont aussi importantes que les autorisations
- Associer les ordres permanents à des tâches Cron pour une exécution fiable selon un calendrier
- Examiner chaque semaine les journaux de l’agent afin de vérifier que les ordres permanents sont respectés
- Mettre à jour les ordres permanents à mesure que vos besoins évoluent : ce sont des documents vivants
À éviter
- Accorder une autorité étendue dès le premier jour (« faites ce qui vous semble le mieux »)
- Omettre les règles d’escalade : chaque programme doit comporter une clause indiquant « quand s’arrêter et demander »
- Supposer que l’agent se souviendra des instructions verbales : consignez tout dans le fichier
- Mélanger plusieurs domaines dans un même programme : utilisez des programmes distincts pour des domaines distincts
- Oublier d’imposer l’exécution avec des tâches Cron : des ordres permanents sans déclencheurs ne sont que des suggestions
Voir aussi
- Automatisation : aperçu de tous les mécanismes d’automatisation.
- Tâches Cron : application du calendrier des ordres permanents.
- Hooks : scripts déclenchés par des événements du cycle de vie de l’agent.
- Webhooks : déclencheurs d’événements HTTP entrants.
- Espace de travail de l’agent : emplacement des ordres permanents, avec la liste complète des fichiers d’amorçage injectés automatiquement (
AGENTS.md, SOUL.md, etc.).