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

Коннекторы в Workflows

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

О чём урок

Используйте коннекторы внутри Workflows — объявляйте зависимости коннекторов на воркере, вызывайте инструменты коннекторов из активностей с определёнными учётными данными и выполняйте workflow с автоматической обработкой OAuth.

Статус API: Интеграция коннекторов workflow использует mistralai-workflows-plugins-mistralai. Это бета-функции, которые могут измениться.

Это руководство охватывает две отдельные роли:

Для выполнения этого руководства вам понадобится API key Mistral. В Studio перейдите в раздел API keys и создайте новый API key.

  • Выделите рабочее пространство Mistral для запуска вашего workflow. Выполнение workflow должно использовать то же рабочее пространство, что и определение workflow.
  • Как минимум один зарегистрированный коннектор. См. Создание агента-советника по базам данных для полного примера жизненного цикла коннектора или создайте его непосредственно в Studio.
  • Для коннекторов, аутентифицированных через OAuth, таких как Notion и Gmail: предварительно существующих учётных данных не требуется — поток аутентификации запускается автоматически во время выполнения workflow; для коннекторов, аутентифицированных через bearer token (например, GitHub PAT), учётные данные должны быть сохранены в консоли Mistral перед запуском workflow.

Workflow, использующий коннекторы, состоит из трёх основных компонентов:

ConnectorAuthInterceptor автоматически регистрируется плагином при запуске run_worker. Он выполняет предварительную проверку аутентификации перед каждым выполнением workflow: если существуют действительные учётные данные (соответствующие credentials_name, если указано, или если существуют учётные данные по умолчанию), workflow немедленно продолжается; в противном случае он запускает поток OAuth и ожидает аутентификации пользователя. Аутентификация Bearer «на лету» в настоящее время не поддерживается.

Чтобы настроить предварительно собранную среду воркера и workflow, выполните следующую команду:

Это создаёт готовый к запуску проект на Python с уже настроенным Workflows SDK, минимальным примером workflow и вспомогательными командами для запуска вашего воркера и инициирования выполнений.

Команда предложит вам сгенерировать API key Mistral в консоли Mistral. Следуйте инструкциям для генерации API key, а затем передайте его команде по запросу. API keys доступны только один раз.

Создайте новый файл Python в директории workflows (например, workflows/connectors_example.py).

Слоты коннекторов объявляются на уровне модуля…

План урока

  1. Предварительные требования
  2. Что вам понадобится перед началом
  3. Создание воркера с коннекторами
  4. Концепции
  5. Установка воркера и примера клиента
  6. Шаг 1 — Объявление слотов коннекторов
  7. Шаг 2 — Написание активности, вызывающей инструмент коннектора
  8. Шаг 3 — Определение класса workflow

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

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

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

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

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

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