Представляем 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, создавая цикл обратной связи, в котором ИИ находит пробелы, а человек их заполняет.
📖 Read the full source: r/ClaudeAI
👀 Смотрите также
Voxlert: Голосовые уведомления для сессий Claude Code с голосами персонажей
Voxlert — это инструмент, который подключается к событиям Claude Code и озвучивает уведомления с помощью характерных голосов, таких как адъютант из StarCraft, SHODAN, GLaDOS и костюм HEV. Он использует LLM через OpenRouter для генерации реплик в стиле персонажей и работает локально после установки через npm.
ConnectSafely AI MCP Server связывает LinkedIn с Claude для прямого управления
ConnectSafely AI предоставляет MCP-сервер, который напрямую подключает LinkedIn к Claude, позволяя пользователям отправлять сообщения, искать людей, проверять посетителей профиля и отслеживать беседы с помощью промптов без переключения вкладок.
Открытый MCP-сервер подключает Claude к API Mailchimp
Разработчик создал MCP-сервер для Mailchimp с использованием Claude Code, предоставляющий 53 инструмента для кампаний, аудиторий, отчетов, автоматизации и электронной коммерции со встроенными режимами безопасности и конфигурацией только для чтения.
E2a: Открытый почтовый шлюз для ИИ-агентов с верификацией SPF/DKIM и доставкой через Webhook/WebSocket
E2a — это аутентифицированный почтовый шлюз для AI-агентов, который проверяет SPF/DKIM для входящих писем, доставляет их через вебхук или WebSocket и поддерживает исходящую почту с подтверждением человеком.