2 хв читання

Як agents.md впливає на вартість кодового агента

agents.mdкодовые агентыпромпт-инжиниринг

Короткий agents.md знижує вартість циклічного кодового агента, бо його інструкції знову потрапляють у кожен виклик моделі. Мінімальні виклики інструментів і звіти додатково скорочують вихідні токени та ріст історії. У наведеному бенчмарку стартові префікси агентів відрізнялися у 12–15 разів.

Бюджет з'їдає повторюваний контекст

Я б насамперед дивився не на довжину патчу, а на текст, який агент несе крізь увесь цикл. В оригінальному обговоренні циклічного завдання описано жорсткий режим: пошук бага, гіпотеза, виправлення і тестування, причому агент переважно виводить виклики інструментів і короткі звіти.

Ключова деталь полягає в тому, що інструкції з agents.md потрапляють у повторні виклики моделі. Зайва фраза один раз здається нешкідливою, але стає постійним податком на кожному новому кроці. Паралельно зростає історія, а багатослівні відповіді повертаються до контексту наступного виклику.

Масштаб проблеми добре видно в наведеному бенчмарку префіксів. Один агент передавав від 1 147 до 1 642 токенів ще до змістовної роботи, інший — від 15 983 до 20 330. Це різниця приблизно у 12–15 разів для тривіального запиту, коли завдання ще фактично не почалося.

Пов'язаний аналіз контексту репозиторію також повідомляє, що файли на кшталт AGENTS.md можуть збільшити вартість інференсу більш ніж на 20% за сесію, іноді без помітного покращення результату. Це не аргумент повністю видаляти інструкції. Радше кожен рядок має виправдовувати свою присутність впливом на поведінку агента.

Короткий цикл важливіший за дешеву модель

Головний виграш дає не мовчазність сама по собі, а менша кількість токенів до робочого виправлення. Компактний agents.md одночасно скорочує постійний префікс і зменшує ймовірність того, що агент супроводжуватиме кожен виклик інструмента зайвим коментарем.

Для довгих завдань ефект накопичується найшвидше: інструкції повторюються, історія роздувається, а результати тестів і плани патчу знову надсилаються моделі. Тому варто окремо відстежувати розмір стартового контексту, кількість проходів циклу й обсяг проміжних звітів. Загальна ціна сесії корисніша за вартість одного виклику.

Та надмірне стискання теж ламає роботу. Якщо з agents.md зникнуть критерії завершення, правила тестування або обмеження на зміни, агент може зробити більше помилкових ітерацій і з'їсти всю економію. Справжня оптимізація починається там, де короткий промпт зберігає потрібні обмеження, а не просто містить менше слів.

Зрештою найдешевший кодовий агент — не той, що менше говорить, а той, що досягає перевіреного виправлення за мінімальну кількість змістовних циклів.

Раніше ми розглядали, як вартість контексту та налаштування режиму міркування в Claude Opus 4.6 впливають на підсумкову ціну запитів. Це доповнює розмову про те, чому лаконічне формулювання завдань для агентів зменшує витрати токенів.