Completion аргументов

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

Мне всегда неудобно помнить точное имя проекта. Completion решает небольшую задачу: предложить допустимые значения аргумента prompt или URI-шаблона. Это помощь при вводе, а не генерация ответа моделью и не автоматическое выполнение операции.

Предварительно: L08 · L09

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

completion/complete получает ref, имя аргумента и введённое значение. Сервер возвращает варианты и информацию о продолжении. Фильтруйте предложения по правам пользователя: название закрытого проекта тоже может быть чувствительной информацией. Ограничьте количество вариантов и стоимость поиска, добавьте debounce на клиенте.

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

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

{
  "method": "completion/complete",
  "params": {
    "ref": {
      "type": "ref/prompt",
      "name": "review-task"
    },
    "argument": {
      "name": "project",
      "value": "dem"
    },
    "_meta": {
      "io.modelcontextprotocol/protocolVersion": "2026-07-28",
      "io.modelcontextprotocol/clientCapabilities": {},
      "io.modelcontextprotocol/clientInfo": {
        "name": "course-client",
        "version": "1.0.0"
      }
    }
  }
}

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

Не подставляйте подсказку как окончательное решение без выбора пользователя. Также нельзя обещать, что отсутствие подсказки означает несуществующий объект: каталог мог быть ограничен правами, префиксом или лимитом результатов.

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

Дополнить аргумент prompt или resource template. Проверить поведение при отсутствии вариантов и неполной поддержке.

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

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

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

• completion: первичный источник

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