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