Урок из полного доступа, первые уроки курса бесплатно Официальный курс Mistral AI Cookbook на русском
Урок 37 · Текст · ~5 мин

Вызов инструментов через коннекторы

Урок 37 из 154 курса «Mistral AI Cookbook»: официальный курс Mistral AI Cookbook (Мистраль) на русском языке. Урок входит в платный доступ; первые уроки курса бесплатно.

О чём урок

Вызывайте отдельные инструменты Connector напрямую, минуя диалог.

Статус API: Вызов инструментов использует client.beta.connectors.call_tool. Это бета-версия конечной точки, и она может измениться.

Для выполнения этого сборника рецептов вам понадобится API-ключ Mistral. В Studio перейдите в раздел API-ключей и создайте новый API-ключ.

Создайте файл .env в корне вашего проекта и добавьте ваш API-ключ Mistral:

  • Рабочий client (см. Рецепт 1)
  • Существующий Connector — см. Создание агента-советника по базам данных для полного примера жизненного цикла Connector, или создайте его в Studio

Прямой вызов инструментов (call_tool) позволяет вызывать отдельный инструмент MCP на Connector без начала диалога. Это полезно, когда:

  • Вы уже знаете, какой инструмент вызвать — модели не нужно принимать решение.
  • Вам нужен необработанный вывод инструмента — например, для получения структурированных данных для последующей обработки.
  • Создание конвейеров — программное связывание вызовов инструментов вместо использования оркестрации модели.
  • Отладка — проверка корректной работы инструментов Connector перед их использованием в диалогах.

Для сценариев, когда модель должна самостоятельно выбирать, какие инструменты вызывать, используйте Conversations API.

Предварительные требования: MISTRAL_API_KEY установлен в вашей среде или файле .env.

Python:

TypeScript:

curl:

Вывод: Отсутствует — клиент готов к использованию.

Распространенные ошибки и их исправления:

Цель: Зарегистрировать Connector, чтобы его инструменты можно было вызывать напрямую.

Когда использовать:

  • Первый шаг перед вызовом инструментов — вам нужен Connector для целевого вызова.
  • Если у вас уже есть Connector, перейдите к Рецепту 3.

Предварительные требования: Инициализированный client (Рецепт 1).

Python:

TypeScript:

curl:

Вывод:

Как это работает:

  • См. Создание агента-советника по базам данных для полного пошагового руководства по созданию, обновлению и удалению Connectors.
  • Connector должен быть создан, прежде чем вы сможете вызывать его инструменты.

Распространенные ошибки и их исправления:

Цель: Вызвать конкретный инструмент, предоставляемый Connector, и получить необработанный результат.

Когда использовать:

  • Вы точно знаете, какой инструмент вызвать и какие аргументы передать.
  • Вам нужен необработанный вывод инструмента без интерпретации моделью.
  • Создание автоматизированных конвейеров, связывающих вызовы инструментов.
  • Отладка или проверка корректности…

План урока

  1. Предварительные требования
  2. Установка
  3. Необходимые переменные окружения
  4. Что вам понадобится перед началом
  5. Когда использовать прямой вызов инструментов
  6. Рецепты
  7. 1. Инициализация клиента
  8. 2. Создание Connector

Урок входит в полный доступ. Полный текст и видео открываются после оплаты. Первые уроки каждого курса бесплатны.

Откройте полный доступ

Вы прошли бесплатные уроки. Выберите тариф, чтобы продолжить обучение.

Курсы Mistral AI 1 490 ₽ Разовый платёж, навсегда
  • Все курсы от Mistral AI (1 шт.)
  • Именной сертификат по каждому пройденному курсу
Оплатить
Полный доступ 4 900 ₽ Разовый платёж, навсегда
  • Все 77 курсов от 11 AI-провайдеров
  • Библиотека промптов и новые курсы
Оплатить

Безопасная оплата через Robokassa: СБП, карты, электронные кошельки. Доступ откроется в этом браузере и придёт письмом. Уже оплатили? Восстановить доступ

Полезные гиды