AIStudioAgent

Written by

Updated at August 18, 2026

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.

Interacting with AI Studio agents.

Field name	Type	Required	Default value	Templating supported	Description
`promptTemplateId`	`string`	Yes	None	None	Agent ID.
`message`	`string`	None	None	Yes	Incoming message to provide to the agent together with the prompt. To provide full workflow status, specify `\(.)`.
`variables`	`map<string,string>`	None	None	Yes	Variables for substitution in the prompt, where key is the name of the variable, and value is its value. Templating is supported for variable values.
`auto_approve`	`bool`	None	`false`	None	If set to `true`, tools are automatically allowed. If set to `false`, and the tool requires confirmation of use, the step will end with an error.