Мы начали писать документацию для агентов ИИ, а не для людей, и сделали это открытым стандартом.

Большинство людей сейчас устанавливают наши инструменты через агента. Мы создаем несколько продуктов для разработчиков — базу данных реестра событий, S3-совместимую хранилище объектов и другие. За последние несколько месяцев мы заметили сдвиг: большинство люди, которые их пробуют, не начинают в браузере. Они говорят агенту кодирования: «добавь это в мой проект», и агент выполнит установку и подключение проводов. Итак, мы начали наблюдать за тем, как агенты работают против нашей документации. Наблюдаю за догадкой агента Большую часть времени все шло нормально. Но время от времени агент изобретал флаг конфигурации, которого не существовало, или обратитесь к неправильному порту, или вызовите конечную точку это было почти правильно. Дело не в том, что модель была тупой — наши документы были написаны чтобы убедить и взять на борт человека, а агент восстанавливал факты на основе проза через три абзаца. Факт, который агент должен сделать вывод, — это факт, что вы потерпели неудачу. заявить. Второй документ для другого читателя Поэтому для каждого выпуска мы начали поставлять второй файл: document.ai.md. Не более краткий перевод человеческих документов — другой документ, для другого читатель, придерживающийся более строгих стандартов точности. Это английский, насыщенный и самодостаточный: агент, который прочитал только этот файл. могу установить, конфиденциально