Вызов инструментов из кода
Вызовите инструмент сервера и прочитайте результат.
«Вызов инструментов из кода» — бесплатный урок MCP Academy на CoddyKit. Это урок 3 из 4. Ты можешь прочитать весь урок бесплатно ниже — а потом практиковать его прямо в браузере с встроенным редактором кода и ИИ-репетитором 24/7. Это часть пути обучения MCP Academy, и твой прогресс синхронизируется между веб-версией и приложением CoddyKit. Курс MCP Academy содержит 4 уроков всего.
От списка к действию
Обнаружение показало, что доступно. Теперь Вы действительно invoke инструмент, передаёте аргументы и читаете результат в своём коде.
Вызов по имени
Используйте session.call_tool() с названием инструмента и словарём аргументов. Названия должны соответствовать обнаруженной схеме inputSchema.
result = await session.call_tool(
"add",
{"a": 2, "b": 3},
)Аргументы должны пройти проверку
Словарь arguments должен соответствовать inputSchema инструмента. Передача данных неправильной структуры приведёт к отклонению вызова сервером.
await session.call_tool("greet", {"name": "Ada"})Прочитайте содержимое
Результат содержит список блоков content. Большинство инструментов возвращает текст, поэтому текст читают из первого блока.
print(result.content[0].text)Проверьте наличие ошибок
Если инструмент завершается с ошибкой, в результате устанавливается значение true для isError, а исключение не создаётся. Проверьте этот признак, чтобы клиент мог корректно отреагировать.
if result.isError:
print("tool failed")Структурированный вывод тоже возможен
Новые инструменты также могут возвращать structuredContent — типизированный объект вместе с текстом, если сервер определяет схему вывода.
print(result.structuredContent)Передавайте реальные аргументы
Аргументы могут поступать из Вашей программы, от пользователя или от модели. Клиент просто передаёт их указанному инструменту в виде обычного словаря.
args = {"city": "Paris"}
await session.call_tool("weather", args)Это по-прежнему асинхронно
Как и любой сетевой вызов, call_tool нужно ожидать. Ожидание приостанавливает выполнение, пока сервер не завершит работу и не вернёт результат.
Один вызов — один результат
Каждый вызов представляет собой пару «запрос — ответ». Сеанс сопоставляет ответ с запросом по идентификатору, поэтому результаты не путаются.
Обрабатывайте медленные инструменты
Некоторые инструменты выполняются долго. Надёжный клиент задаёт timeout, чтобы зависший инструмент не остановил всю программу.
Вы управляете процессом
Когда программа вызывает инструменты, именно она определяет порядок действий, объединяет результаты и превращает необработанный вывод в нечто полезное для пользователя.
Быстрая проверка
Как запустить обнаруженный инструмент из кода клиента?
Итоги: выполнение вызова
Вы полностью invoked инструменты: вызвали их по имени с допустимыми аргументами, прочитали блоки содержимого и проверили isError, прежде чем доверять выводу.
Часто задаваемые вопросы
Урок «Вызов инструментов из кода» бесплатный?
Да — полный текст урока «Вызов инструментов из кода» бесплатно доступен здесь в веб-версии. Чтобы практиковать его интерактивно (встроенный редактор кода и ИИ-репетитор 24/7) и разблокировать остальной курс MCP Academy, подпишись на CoddyKit PRO. Курс MCP Academy содержит 4 уроков всего.
Чему я научусь в уроке «Вызов инструментов из кода»?
Вызовите инструмент сервера и прочитайте результат. Ты практикуешь MCP Academy с помощью реального кода, который запускаешь прямо в браузере, и ИИ-репетитор 24/7 отвечает на твои вопросы во время урока.
Нужен ли мне опыт, чтобы начать MCP Academy?
Предыдущий опыт не требуется. MCP Academy на CoddyKit структурирован для всех уровней — от новичков до продвинутых, поэтому ты можешь начать отсюда или с самого начала и учиться в своем темпе. Это урок 3 из 4.
Сколько времени занимает урок «Вызов инструментов из кода»?
Большинство уроков CoddyKit занимают около 5–10 минут. Каждый из них компактный и интерактивный, поэтому ты постоянно делаешь прогресс и продолжаешь с того же места в веб-версии и приложении.
Можно ли писать и запускать код в этом уроке MCP Academy?
Да. Каждый урок MCP Academy включает встроенный редактор кода, поэтому ты пишешь и запускаешь реальный код прямо в браузере и получаешь моментальную обратную связь от AI — локальная установка не требуется.
Все уроки этого курса
- Открытие сеанса клиента
- Обнаружение инструментов и ресурсов
- Вызов инструментов из кода
- Маршрутизация вызовов инструментов через LLM