Запустить рабочий процесс по таймеру

Примечание

На данный момент Workflows поддерживается в двух интерфейсах — Yandex Cloud и Yandex AI Studio. При этом:

  • рабочие процессы, созданные в интерфейсе Yandex Cloud, автоматически доступны в интерфейсе AI Studio;
  • рабочие процессы, созданные в интерфейсе AI Studio, недоступны в интерфейсе Yandex Cloud.

С 3 сентября 2026 года Workflows перестанет поддерживаться в интерфейсе Yandex Cloud. Для создания рабочих процессов и управления ими используйте интерфейс AI Studio.

Вы можете задать расписание при создании или изменении рабочего процесса.

Задать расписание

  1. В интерфейсе AI Studio выберите каталог, в котором находится рабочий процесс.
  2. На панели слева разверните раздел atom Agent Atelier и выберите graph-node Workflows.
  3. В строке с нужным рабочим процессом нажмите image и выберите image Редактировать.
  4. На графической схеме рабочего процесса нажмите на блок Старт и выберите clock Таймер.
  5. Задайте расписание в одном из форматов:
    • Интервал — укажите интервал запуска рабочего процесса, например «запускать рабочий процесс каждые 15 минут»;
    • Дни недели — укажите время запуска рабочего процесса, например «запускать рабочий процесс каждые понедельник и четверг в 10:00»;
    • Другое — укажите расписание запуска рабочего процесса в формате cron-выражения.
  6. Нажмите Сохранить.

Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.

По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --folder-name или --folder-id.

Если вы обращаетесь к ресурсу по имени, поиск будет выполнен в каталоге по умолчанию. Если вы обращаетесь к ресурсу по идентификатору, поиск будет выполнен глобально — во всех каталогах с учетом прав доступа.

  1. Посмотрите описание команды CLI для изменения рабочего процесса:

    yc serverless workflow update --help

  2. Получите список рабочих процессов:

    yc serverless workflow list

    Результат:

    workflows:
          - id: dfqdi6ic7c5j********
            folder_id: b1g681qpemb4********
            created_at: "2025-03-10T13:31:55.387059Z"
            name: workflow895
            status: ACTIVE
            log_options:
              folder_id: b1g681qpemb4********
          ...
          - id: dfqud9cbc4k5********
            folder_id: b1g681qpemb4********
            created_at: "2025-03-10T12:57:48.679682Z"
            name: workflow203
            status: ACTIVE
            log_options:
              folder_id: b1g681qpemb4********

  3. Задайте расписание:

    yc serverless workflow update <имя_или_идентификатор_рабочего_процесса> \
          --schedule-cron-expression "<cron-выражение>" \
          --schedule-timezone "<часовой_пояс>"

    Где:

    • --schedule-cron-expression — cron-выражение, например: "0 * * * * *". Подробнее о формате cron-выражений в Cron-выражения в Workflows.
    • --schedule-timezone — часовой пояс, например Europe/Moscow.

    Результат:

    id: dfqai557kgv0********
        folder_id: b1g681qpemb4********
        specification:
          spec_yaml: ...
        created_at: "2025-09-19T09:11:38.826207Z"
        name: cron-flow
        status: ACTIVE
        log_options:
          folder_id: b1g681qpemb4********
        service_account_id: ajelprpohp7r********
        schedule:
          cron_expression: 0 * * * * *
          timezone: Europe/Moscow

Воспользуйтесь методом REST API Update для ресурса Workflows или вызовом gRPC API workflow/Update. В поле schedule задайте расписание и укажите часовой пояс.

Удалить расписание

  1. В интерфейсе AI Studio выберите каталог, в котором находится рабочий процесс.
  2. На панели слева разверните раздел atom Agent Atelier и выберите graph-node Workflows.
  3. В строке с нужным рабочим процессом нажмите image и выберите image Редактировать.
  4. На графической схеме рабочего процесса удалите блок с таймером.
  5. Нажмите Сохранить.

  1. Посмотрите описание команды CLI для изменения рабочего процесса:

    yc serverless workflow update --help

  2. Получите список рабочих процессов:

    yc serverless workflow list

    Результат:

    workflows:
          - id: dfqdi6ic7c5j********
            folder_id: b1g681qpemb4********
            created_at: "2025-03-10T13:31:55.387059Z"
            name: workflow895
            status: ACTIVE
            log_options:
              folder_id: b1g681qpemb4********
          ...
          - id: dfqud9cbc4k5********
            folder_id: b1g681qpemb4********
            created_at: "2025-03-10T12:57:48.679682Z"
            name: workflow203
            status: ACTIVE
            log_options:
              folder_id: b1g681qpemb4********

  3. Удалите расписание:

    yc serverless workflow update <имя_или_идентификатор_рабочего_процесса> \
          --remove-schedule

    Результат:

    id: dfqai557kgv0********
        folder_id: b1g681qpemb4********
        specification:
          spec_yaml: ...
        created_at: "2025-09-19T09:11:38.826207Z"
        name: cron-flow
        status: ACTIVE
        log_options:
          folder_id: b1g681qpemb4********
        service_account_id: ajelprpohp7r********

Воспользуйтесь методом REST API Update для ресурса Workflows или вызовом gRPC API workflow/Update. В поле schedule укажите null.

Полезные ссылки

Предыдущая
С помощью консоли управления, CLI и API
Следующая
По ссылке