Présentation de operate.txt : Une spécification YAML pour les agents IA naviguant dans les produits SaaS

✍️ OpenClawRadar📅 Publié: March 24, 2026🔗 Source
Présentation de operate.txt : Une spécification YAML pour les agents IA naviguant dans les produits SaaS
Ad

Un développeur a créé operate.txt, une spécification pour documenter comment les agents IA doivent interagir avec les applications web. Le fichier aborde les problèmes rencontrés lors de l'utilisation de la fonctionnalité d'utilisation informatique de Claude pour naviguer dans un produit SaaS, où l'agent IA remettait constamment en question si les écrans de chargement indiquaient un dysfonctionnement.

Problème et solution

En utilisant Claude Code + utilisation informatique pour naviguer dans BrandyBee (un produit SaaS) en tant qu'utilisateur pour la première fois, le développeur a identifié des points de friction spécifiques où Claude a rencontré des difficultés :

  • Pendant une analyse de marque qui prend 90 à 120 secondes, Claude a demandé "Est-ce un état de chargement ou y a-t-il un problème ?" à 28 % d'avancement
  • Un bouton "Approuver" qui déclenche des appels API payants sans interface de confirmation
  • Une liste déroulante de langue qui ne se remplit qu'après la sélection du pays
  • Des processus asynchrones prenant 2 à 5 minutes qui semblent bloqués

À chaque fois, la réponse était "non, c'est normal, attendez simplement". Cela a conduit à la création d'operate.txt comme équivalent de robots.txt pour les robots d'indexation ou de sitemap.xml pour les moteurs de recherche, mais spécifiquement pour les agents IA opérant des produits.

Ad

Spécification operate.txt

Le fichier operate.txt est un fichier YAML hébergé à yourdomain.com/operate.txt qui documente :

  • Ce qu'est chaque écran
  • À quoi ressemblent les états de chargement et combien de temps ils prennent
  • Quelles actions sont irréversibles
  • Le chemin étape par étape pour les tâches courantes
  • Ce que les agents ne doivent jamais faire

La section la plus utile est async_actions, qui indique aux agents des détails comme "ce processus prend 90 à 120 secondes, ne pas actualiser, ne pas naviguer ailleurs, voici les étapes qu'il traverse".

Processus de création et exemples

Le développeur a ouvert la spécification avec des exemples réels incluant son propre SaaS, un modèle de commerce électronique et un modèle de tableau de bord SaaS sur https://github.com/serdem1/operate.txt.

Le processus de création implique de faire naviguer Claude dans votre produit, d'observer où il hésite, puis de faire rédiger le fichier operate.txt par Claude. Le développeur corrige ce que Claude comprend mal, créant une boucle de rétroaction où l'IA trouve les lacunes et l'humain les comble.

📖 Read the full source: r/ClaudeAI

Ad

👀 See Also

Stagent : Couche opérationnelle open-source pour le SDK Agent Claude avec gouvernance locale et orchestration de flux de travail
Tools

Stagent : Couche opérationnelle open-source pour le SDK Agent Claude avec gouvernance locale et orchestration de flux de travail

Stagent est un espace de coordination open-source, local-first, construit sur le SDK Agent Claude et l'API Claude, qui fournit l'orchestration des workflows, des garde-fous budgétaires et une gouvernance avec intervention humaine pour les agents IA. Il comprend 15 interfaces produit, 6 modèles de workflow, plus de 52 profils d'agents réutilisables, et fonctionne entièrement en local avec SQLite.

OpenClawRadar
AgentPeek : Tableau de bord open source pour surveiller les équipes d'agents Claude Code
Tools

AgentPeek : Tableau de bord open source pour surveiller les équipes d'agents Claude Code

AgentPeek est un tableau de bord local qui s'intègre à Claude Code pour offrir une visibilité sur les équipes d'agents, en affichant les hiérarchies d'orchestration, les traces d'exécution, les coûts en tokens et les opérations sur fichiers. L'installation nécessite de cloner le dépôt GitHub et d'exécuter pipx install.

OpenClawRadar
LightMem : Système de mémoire léger pour agents LLM avec des gains de 10×+ et un coût 100× inférieur
Tools

LightMem : Système de mémoire léger pour agents LLM avec des gains de 10×+ et un coût 100× inférieur

LightMem est un système de mémoire modulaire pour les agents LLM qui permet d'améliorer la précision jusqu'à 10,9 % tout en réduisant les tokens jusqu'à 117 fois, les appels API jusqu'à 159 fois et le temps d'exécution de plus de 12 fois. Il est conçu pour un raisonnement à contexte long et évolutif dans les flux de travail des agents.

OpenClawRadar
Le goulot d'étranglement dans les agents IA parallèles : la file d'attente d'approbation humaine
Tools

Le goulot d'étranglement dans les agents IA parallèles : la file d'attente d'approbation humaine

Un développeur exécutant des agents Claude Code en parallèle décrit le « bottleself » — le point où le parallélisme cesse d'augmenter la production et commence à créer un backlog d'approbations humaines. Sa solution : un planificateur qui décompose les objectifs en sous-tâches, lance des agents, et n'interrompt que pour les décisions non résolues.

OpenClawRadar