Обращения к ИИ-агентам в документации: помогают или мешают? Эксперимент показал, что нет
Does whispering to agents in docs help?
Автор замечает растущую тенденцию обращаться к ИИ-агентам прямо в документации и README-файлах, что создаёт неловкость для людей. Он провёл серию экспериментов с GPT 5.6 и Sonnet 4.6, чтобы проверить, влияют ли такие обращения на поведение моделей. Результаты показали, что явные рекомендации в документации значительно повышают вероятность выбора модели, но маркировка «Для агентов» не даёт никакого преимущества перед обычными заголовками. Автор приходит к выводу, что вместо специальных обращений к агентам лучше улучшать качество документации в целом, делая её чёткой, сжатой и с полными примерами.
Если вы пишете краткие, явные и актуальные инструкции и приводите полные примеры, вы, возможно, уже даёте агентам то, что им нужно; вам не нужно называть их по имени или портить качество документации, штампуя «Для агентов» повсюду, потому что это не даёт никакого преимущества.