Roots и Sampling

L31 · MCP 2026-07-28 · открытая бета · редакция 2026.10-beta1

Roots и sampling часто встречаются в старых quickstart. Я объясняю их, чтобы вы понимали существующие интеграции, но маркирую как deprecated в современном профиле. Наличие старого API в SDK не делает его рекомендуемой основой нового проекта.

Предварительно: L30

Как я это использую

Roots описывали корневые области, предоставляемые клиентом, а sampling позволял серверу запрашивать работу модели через клиента. В обоих случаях host сохраняет контроль доступа и пользователя. Root не равен полноценной файловой песочнице: реальная изоляция зависит от процесса и ОС. Sampling не должен давать серверу неограниченные затраты и доступ ко всему контексту.

Разбираем конкретный контракт

Это учебный fixture: поля с доменом .example и идентификаторы вымышлены. Если показан фрагмент, его нужно поместить в соответствующий envelope выбранного профиля.

{
  "profile": "2025-11-25 compatibility",
  "features": [
    "roots/list",
    "sampling/createMessage"
  ],
  "modernStatus": "deprecated; explicit compatibility adapter"
}

Что легко сломать

При поддержке старого клиента используйте отдельный адаптер и лимиты. Если современные возможности не предоставляют эквивалентный сценарий, явно опишите ограничение. Не маскируйте отсутствие поддержки бесконтрольным локальным запуском.

Практика и самопроверка

Прочитать legacy-обмен и выбрать путь миграции. Разобрать includeContext и отсутствие гарантий изоляции файловой системы.

Я советую сначала предсказать результат, затем изменить один параметр в лаборатории и объяснить разницу. Сохраните небольшой fixture с нормальным и ошибочным случаем для своего проекта. Тренажёр открыт без регистрации; для сохранения ответов на тесты и завершения урока войдите в аккаунт.

В конце страницы — три вопроса. После правильных ответов можно завершить урок; ошибка в следующей тренировке не стирает уже полученное подтверждение этой редакции теста.

На что я опирался

• deprecated: первичный источник
• roots: первичный источник
• sampling: первичный источник

Профиль и ссылки проверены 15 октября 2026. Core, deprecated compatibility и extensions в этом курсе помечены отдельно. Примеры объясняют выбранные сценарии; для реализации сверяйте нормативные MUST/SHOULD и schema соответствующей версии.