Adding the While loop

Note

Currently, there are two UIs that support Workflows: Yandex Cloud and Yandex AI Studio. In this case, the following applies:

  • Workflows created in the Yandex Cloud UI are automatically available in the AI Studio UI.
  • Workflows created in the AI Studio UI are not available in the Yandex Cloud UI.

Starting September 3, 2026, Workflows will no longer be supported in the Yandex Cloud UI. To create and manage workflows, use the AI Studio UI.

You can use the While control step to set a sequence of steps to apply within a loop. The step will apply while the condition from Execution condition template is true, but only as many times as set in Maximum number of iterations. If no condition is set, the step is performed the specified number of times. If the number of iterations is not specified, the loop will continue until the condition is no longer met or the workflow timeout is reached.

Each execution branch within the While step (including all Switch steps) must contain an integration step or a Success, Fail, or Wait step.

Tip

There is an icon next to some fields in the Yandex AI Studio UI. These fields support templates for dynamic data retrieval from previous workflow steps. To avoid typing a template manually, click and enter {{ in the field.

  1. When creating a new workflow or editing an existing one, select Constructor in the top-right corner of the AI Studio UI.

  2. Click the Add first step section or the icon next to the step you want the new one to follow.

  3. Under Control steps, select While.

  4. On the right side of the window:

    1. In the Execution condition template field, specify a condition in jq format that returns either the true or false string. This is a required field if the Maximum number of iterations field is not set.
    2. In the Maximum number of iterations field, specify the maximum number of iterations the loop can complete. This is a required field if the Execution condition template value is not set.

    3. Optionally, expand the Additional parameters section:

      1. Specify a description for the workflow step.
      2. In the Step input filter field, specify a jq template to filter the workflow state provided to the step.
      3. In the Step output filter field, specify a jq template to filter the step output data added into the workflow state.

  5. To add a new step to the execution branch, click the Add first step of cycle section or the icon next to the step you want the new one to follow.

Useful links

Previous
Foreach
Next
Parallel