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

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.

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.