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

О чём урок

Вызывайте отдельные инструменты 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: Вывод: Отсутствует — клиент готов к использованию. Распространенные ошибки и их исправления: Ошибка Причина Исправление 401 Unauthorized Неверный API-ключ Перегенерируйте ключ на панели управления Mistral Цель: Зарегистрировать Connector, чтобы его инструменты можно было вызывать напрямую. Когда использовать: Первый шаг перед вызовом инструментов — вам нужен Connector для целевого вызова. Если у вас уже есть Connector, перейдите к Рецепту 3. Предварительные требования: Инициализированный client (Рецепт 1). Python: TypeScript: curl: Вывод: Как это работает: См. Создание агента-советника по базам данных для полного пошагового руководства по созданию, обновлению и удалению Connectors. Connector должен быть создан, прежде чем вы сможете вызывать его инструменты.

План урока

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