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

О чём урок

Используйте коннекторы внутри Workflows — объявляйте зависимости коннекторов на воркере, вызывайте инструменты коннекторов из активностей с определёнными учётными данными и выполняйте workflow с автоматической обработкой OAuth. Статус API: Интеграция коннекторов workflow использует mistralai-workflows-plugins-mistralai. Это бета-функции, которые могут измениться. Это руководство охватывает две отдельные роли: Роль Что делает Где выполняется Воркер Размещает workflow и вызывает инструменты коннекторов Долгоживущий серверный процесс, отдельный от клиентских скриптов Клиент Запускает выполнение workflow и обрабатывает перенаправления OAuth Любой скрипт или AI Studio Для выполнения этого руководства вам понадобится API key Mistral. В Studio перейдите в раздел API keys и создайте новый API key. Выделите рабочее пространство Mistral для запуска вашего workflow. Выполнение workflow должно использовать то же рабочее пространство, что и определение workflow. Как минимум один зарегистрированный коннектор. См. Создание агента-советника по базам данных для полного примера жизненного цикла коннектора или создайте его непосредственно в Studio. Для коннекторов, аутентифицированных через OAuth, таких как Notion и Gmail: предварительно существующих учётных данных не требуется — поток аутентификации запускается автоматически во время выполнения workflow; для коннекторов, аутентифицированных через bearer token (например, GitHub PAT), учётные данные должны быть сохранены в консоли Mistral перед запуском workflow. Workflow, использующий коннекторы, состоит из трёх основных компонентов: Компонент Что делает connector(name) Объявляет именованный слот коннектора — зависимость от коннектора @uses_connectors(slot, ...) Прикрепляет объявленные слоты к классу workflow, чтобы среда выполнения знала, какие коннекторы аутентифицировать ToolCallClient Клиент уровня активности для вызова инструментов коннектора, внедряемый через Depends ConnectorAuthInterceptor автоматически регистрируется плагином при запуске run_worker. Он выполняет предварительную проверку аутентификации перед каждым выполнением workflow: если существуют действительные учётные данные (соответствующие credentials_name, если указано, или если существуют учётные данные по умолчанию), workflow немедленно продолжается; в противном случае он запускает поток OAuth и ожидает аутентификации пользователя. Аутентификация Bearer «на лету» в настоящее время не поддерживается.

План урока

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