Starting a workflow execution

Make the workflow public so that any user can run it.

  1. In the AI Studio UI, select the folder in which you want to execute a workflow.
  2. In the left-hand panel, expand Agent Atelier and select Workflows.
  3. Click next to the workflow in question and select Execute.
  4. In the window that opens, click Start and wait for the workflow to complete.

If you do not have the Yandex Cloud CLI yet, install and initialize it.

The folder used by default is the one specified when creating the CLI profile. To change the default folder, use the yc config set folder-id <folder_ID> command. You can also specify a different folder for any command using --folder-name or --folder-id.

If you access a resource by its name, the search will be limited to the default folder. If you access a resource by its ID, the search will be global, i.e., through all folders based on access permissions.

  1. See the description of the CLI command for starting a workflow:

    yc serverless workflow execution start --help

  2. Get a list of workflows:

    yc serverless workflow list

    Result:

    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. Start a workflow by specifying its name or ID:

    yc serverless workflow execution start <workflow_ID>

    Result:

    execution_id: dfqapb31gq758qil1r8b-b3e3dade-4903-4a6f-9df7-a4b6********

To start a workflow, use the start REST API method for the Execution resource or the ExecutionService/Start gRPC API call.

Useful links

Previous
Getting information on the progress of each step
Next
On a timer