О чём урок
Вызывайте отдельные инструменты 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. Создание Connector
Урок входит в полный доступ. Полный текст и видео открываются после оплаты. Первые уроки каждого курса бесплатны.