наблюдаемость: измерять бюджет каталога MCP

2026-07-21 01:59:09 +03:00
parent 0241d186ea
commit 63f8ee333f
10 changed files with 284 additions and 4 deletions
@@ -154,6 +154,10 @@ Crank возвращает структурированные ошибки. MCP-

 Если у агента слишком много похожих инструментов, модель чаще ошибается при выборе.

+Crank измеряет опубликованный каталог по тому же компактному JSON, который возвращается в `tools/list`. В расчёт входят имя, заголовок, описание, входная JSON-схема и добавляемое Crank описание подтверждения опасной операции. Для сравнения используется независимая от конкретной модели консервативная оценка: один токен на три байта UTF-8. Это не счётчик токенов конкретного поставщика, а стабильная инженерная метрика для поиска регрессий.
+
+Рекомендуемый бюджет одного агентского каталога — не более 4096 оценочных токенов. Превышение не блокирует публикацию, потому что допустимый объём зависит от модели, но создаёт предупреждение. Сначала сокращайте лишние описания и схемы. Если инструменты решают разные задачи, разделяйте их между специализированными агентами. Выбор нужного агента и постепенное раскрытие каталогов выполняет оркестратор Drivetrain, а не Crank.
+
 ## Проверочный список

 - Имя инструмента конкретное и не похоже на `call_api`.
@@ -164,3 +168,4 @@ Crank возвращает структурированные ошибки. MCP-
 - Для POST/PATCH задан idempotency key, если повторный вызов может создать дубль.
 - Для DELETE пользователь видит двухшаговое подтверждение.
 - Агенту привязаны только инструменты, нужные для его задачи.
+- Опубликованный каталог укладывается в выбранный бюджет контекста модели.