Представляем operate.txt: спецификация в формате YAML для ИИ-агентов, взаимодействующих с SaaS-продуктами.

Разработчик создал operate.txt — спецификацию для документирования того, как ИИ-агенты должны взаимодействовать с веб-приложениями. Файл решает проблемы, возникающие при использовании функции компьютерного взаимодействия Claude для навигации по SaaS-продукту, где ИИ-агент неоднократно спрашивал, указывают ли экраны загрузки на неисправность.

Проблема и решение

Используя Claude Code + компьютерное взаимодействие для навигации по BrandyBee (SaaS-продукту) в качестве нового пользователя, разработчик выявил конкретные проблемные моменты, с которыми столкнулся Claude:

• Во время анализа бренда, который занимает 90–120 секунд, Claude спросил «Это состояние загрузки или что-то не так?» при 28% завершения
• Кнопка «Approve» (Подтвердить), которая запускает платные API-вызовы без UI подтверждения
• Выпадающий список «Language» (Язык), который заполняется только после выбора «Country» (Страна)
• Асинхронные процессы, занимающие 2–5 минут, которые кажутся зависшими

Каждый раз ответ был «нет, это нормально, просто подожди». Это привело к созданию operate.txt как эквивалента robots.txt для краулеров или sitemap.xml для поисковых систем, но специально для ИИ-агентов, управляющих продуктами.

Спецификация operate.txt

Файл operate.txt — это файл YAML, размещенный по адресу yourdomain.com/operate.txt, который документирует:

• Что представляет собой каждый экран
• Как выглядят состояния загрузки и сколько они занимают времени
• Какие действия являются необратимыми
• Пошаговый путь для распространенных задач
• Что агентам никогда не следует делать

Наиболее полезный раздел — async_actions, который сообщает агентам детали, такие как «этот процесс занимает 90–120 секунд, не обновляйте, не уходите со страницы, вот этапы, через которые он проходит».

Процесс создания и примеры

Разработчик открыл спецификацию с реальными примерами, включая собственный SaaS, шаблон электронной коммерции и шаблон SaaS-панели управления на https://github.com/serdem1/operate.txt.

Процесс создания включает навигацию Claude по вашему продукту, наблюдение за тем, где он колеблется, а затем поручение Claude составить файл operate.txt. Разработчик исправляет ошибки Claude, создавая цикл обратной связи, в котором ИИ находит пробелы, а человек их заполняет.