Описание MCP tool: как объяснить риск параметров модели
Опишите назначение, единицы измерения и опасные условия параметров, а критичные ограничения закрепите на сервере. Расплывчатая подсказка «обновить данные» плохо помогает выбрать безопасный вызов.
Разберём рабочий случай
Инструмент set_discount принимает value, но не говорит, это проценты или доля. Агент передаёт 20 вместо 0,2. Сервис принимает число и устанавливает недопустимую скидку. Другой параметр apply_to_all подразумевает все товары, хотя пользователь говорил о выбранной категории. Ошибка рождается из неоднозначного контракта до любого сложного рассуждения модели.
Что изменить
Замените абстрактные названия на понятные: discount_percent с диапазоном и явный набор идентификаторов вместо широкого флага, если это соответствует продукту. Укажите, что именно изменится, какие поля необязательны и как трактуется отсутствие значения. Отдельно ограничьте размер пакета, максимальную скидку и доступную область данных. Описание может уменьшить число неверных вызовов, но сервер обязан отклонять опасные значения независимо от уверенного объяснения модели.
Как проверить результат
| Проверка | Ожидаемое поведение |
|---|---|
| Скидка двадцать процентов для двух товаров | Единицы и список объектов однозначны; действие не распространяется на остальной каталог по умолчанию. |
| Число за пределами разрешённого диапазона | Сервер отклоняет запрос до изменения данных и возвращает полезную безопасную ошибку. |
| Пользователь не назвал область применения | Клиент запрашивает уточнение либо строит предварительный просмотр, а не выбирает весь каталог самостоятельно. |
Пример допустимого значения полезнее неопределённого слова «число». Укажите единицу, диапазон и смысл округления, особенно если результат влияет на цену, лимит, срок или массовое изменение объектов.
Избыточно длинное описание тоже мешает выбору: важные ограничения теряются среди повторов. Оставляйте в контракте решающие свойства и проверяйте его на неоднозначных формулировках пользователей.
Хороший MCP-интерфейс соединяет понятный язык описания с типами, проверками и реальными ограничениями бизнес-операции. В платном курсе AI Agent Integrations PRO: MCP можно продолжить изучение соответствующего инженерного направления. Перед покупкой сравните программу и открытые материалы со своей задачей.
Документация для проверки технических деталей: MCP tools: спецификация 2025-06-18, Объекты JSON Schema.
Следующий шаг: MCP-интеграции: контракты инструментов, ошибки и доступ. По смежным вопросам: Структурированный ответ MCP tool: как не потерять типы данных, Пагинация MCP tool: как не потерять данные между страницами.
