Управление доступом в Yandex AI Studio
- Об управлении доступом
- Какие роли действуют в сервисе
- Сервисные роли
- Общие роли сервиса Yandex AI Studio
- ИИ-агенты
- Текстовые агенты
- Каналы публикации текстовых агентов
- Датасеты
- Модели генерации текста и изображений
- Модерация ответов моделей
- Синтез и распознавание речи
- Поисковые запросы
- Распознавание текста на изображениях и в PDF
- Перевод текста
- MCP-серверы
- Рабочие процессы
- Подписки
- Рабочие места пользователей
- Профили рабочих мест пользователей
- Примитивные роли
- Какие роли мне необходимы
Об управлении доступом
Yandex AI Studio использует сервис управления доступом Yandex Identity and Access Management (IAM) для контроля операций с ресурсами. Для этого Identity and Access Management использует механизмы ролей и политик авторизации. Роли определяют наборы разрешенных операций, а политики авторизации описывают ограничения доступа к ресурсами и операциям.
Примечание
Политики авторизации могут запрещать некоторые операции даже при наличии соответствующих ролей. Например, вызывать MCP-серверы и управлять ими или вызывать методы Responses API из определенных облачных сетей или с определенных IP-адресов, а также привязывать к MCP-серверам определенные облачные сети.
Роли и политики доступа назначаются субъекту на конкретный ресурс — организацию, облако и каталог. Права доступа наследуются от родительских ресурсов к дочерним. Например, если назначить роль на облако, разрешения этой роли будут распространяться и на все каталоги внутри него.
Перед выполнением любой операции в AI Studio сервис IAM проверяет:
- наличие у субъекта необходимых для выполнения операции ролей;
- отсутствие политик авторизации, запрещающих эту операцию.
Если проверки пройдены, операция будет выполнена. Если нет, сервис вернет ошибку доступа.
Подробнее об управлении доступом в Yandex Cloud читайте в разделе Как устроено управление доступом в Yandex Cloud.
Субъект — тот, кто выполняет операцию и кому могут быть назначены роли. К субъектам относятся пользователи, группы пользователей, сервисные и другие аккаунты в Yandex Cloud.
Подробнее в разделе Как устроено управление доступом в Yandex Cloud.
Какие роли действуют в сервисе
На диаграмме показано, какие роли есть в сервисе и как они наследуют разрешения друг друга. Например, в editor входят все разрешения viewer. После диаграммы дано описание всех ролей:
- Общие роли сервиса
- ИИ-агенты
- Текстовые агенты
- Каналы публикации текстовых агентов
- Датасеты
- Модели генерации текста и изображений
- Эксперименты
- Модерация ответов моделей
- Синтез и распознавание речи
- Распознавание текста
- Перевод текста
- Поисковые запросы
- MCP-серверы
- Рабочие процессы
- Подписки
- Рабочие места пользователей
- Профили рабочих мест пользователей
Сервисные роли
Общие роли сервиса Yandex AI Studio
ai.auditor
Роль ai.auditor позволяет просматривать информацию о моделях генерации текста и правилах модерации моделей, о текстовых агентах и каналах публикации текстовых агентов, а также о конфигурациях Responses API, подписках и других сущностях в Yandex AI Studio.
Пользователи с этой ролью могут:
- просматривать метаданные моделей генерации текста;
- просматривать список текстовых агентов в каталоге, информацию о них, их версиях и операциях с ними;
- просматривать информацию о каналах публикации текстовых агентов, а также список каналов в каталоге;
- просматривать информацию о назначенных правах доступа к текстовым агентам и каналам публикации текстовых агентов;
- просматривать информацию о конфигурациях Responses API, загруженных файлах и поисковых индексах;
- просматривать метаданные правил модерации моделей;
- просматривать метаданные своей подписки;
- просматривать метаданные профилей рабочих мест пользователей и назначенные права доступа к таким профилям;
- просматривать метаданные рабочих мест пользователей и назначенные права доступа к рабочим местам;
- просматривать метаданные датасетов;
- просматривать информацию о квотах сервиса Yandex AI Studio;
- просматривать информацию об облаке и каталоге.
Включает разрешения, предоставляемые ролями ai.agentChannels.auditor, ai.canvasAgents.auditor, ai.assistants.auditor, ai.datasets.auditor, ai.models.auditor, ai.guardrails.auditor, ai.subscriptions.auditor, ai.workProfiles.auditor и ai.workRuntimes.auditor.
ai.viewer
Роль ai.viewer позволяет просматривать информацию о моделях генерации текста и правилах модерации моделей, о текстовых агентах и каналах публикации текстовых агентов, а также о конфигурациях Responses API, подписках и других сущностях в Yandex AI Studio.
Пользователи с этой ролью могут:
- просматривать информацию о моделях генерации текста;
- просматривать список текстовых агентов в каталоге, информацию о них, их версиях и операциях с ними;
- просматривать информацию о каналах публикации текстовых агентов, а также список каналов в каталоге;
- просматривать информацию о назначенных правах доступа к текстовым агентам и каналам публикации текстовых агентов;
- просматривать информацию о конфигурациях Responses API;
- просматривать информацию о загруженных файлах и содержимое таких файлов;
- просматривать информацию о поисковых индексах, а также выполнять поиск по таким индексам;
- просматривать информацию о правилах модерации моделей;
- просматривать информацию о своей подписке;
- просматривать информацию о профилях рабочих мест пользователей и назначенных правах доступа к таким профилям;
- просматривать информацию о рабочих местах пользователей и назначенных правах доступа к рабочим местам;
- просматривать информацию о датасетах;
- просматривать информацию о квотах сервиса Yandex AI Studio;
- просматривать информацию об облаке и каталоге.
Включает разрешения, предоставляемые ролями ai.auditor, ai.agentChannels.viewer, ai.canvasAgents.viewer, ai.assistants.viewer, ai.datasets.viewer, ai.models.viewer, ai.guardrails.viewer, ai.subscriptions.viewer, ai.workRuntimes.viewer и ai.workProfiles.viewer.
ai.editor
Роль ai.editor позволяет использовать модели Yandex AI Studio, управлять текстовыми агентами, конфигурациями Responses API и другими сущностями в Yandex AI Studio.
Пользователи с этой ролью могут:
- просматривать информацию о моделях генерации текста, генерации изображений, векторного представления текста и классификаторов в сервисе Yandex AI Studio, а также использовать такие модели;
- просматривать список текстовых агентов в каталоге, информацию о них, их версиях и операциях с ними;
- создавать, изменять и удалять текстовых агентов;
- создавать версии текстовых агентов;
- тестировать в интерфейсе тестирования любую версию текстового агента, в том числе не опубликованную в канале: отправлять агенту сообщения и просматривать события выполнения;
- просматривать информацию о каналах публикации текстовых агентов, а также список каналов в каталоге;
- создавать, изменять и удалять каналы публикации текстовых агентов, приостанавливать и возобновлять их работу;
- публиковать версии текстовых агентов в каналах;
- просматривать информацию о назначенных правах доступа к текстовым агентам и каналам публикации текстовых агентов;
- просматривать информацию о конфигурациях Responses API, а также создавать, использовать, изменять и удалять их;
- просматривать информацию о загруженных файлах, а также загружать, изменять, просматривать и удалять такие файлы;
- просматривать информацию о поисковых индексах, создавать, изменять и удалять поисковые индексы, а также выполнять поиск по ним;
- просматривать информацию о правилах модерации моделей, а также создавать, применять, изменять и удалять такие правила;
- получать список всех подписок в облаке;
- просматривать информацию о своей подписке;
- покупать, использовать, изменять и удалять свою подписку;
- сбрасывать окна потребления по любой подписке в облаке;
- просматривать информацию о профилях рабочих мест пользователей и назначенных правах доступа к профилям рабочих мест;
- использовать и изменять профили рабочих мест пользователей;
- просматривать информацию о рабочих местах пользователей и назначенных правах доступа к рабочим местам;
- создавать рабочие места;
- использовать свое рабочее место;
- просматривать информацию о датасетах, а также создавать, использовать, изменять и удалять их;
- использовать функциональности распознавания речи, синтеза речи, перевода текста и распознавания текста на изображениях в сервисе Yandex AI Studio;
- просматривать информацию о квотах сервиса Yandex AI Studio;
- просматривать информацию об облаке и каталоге.
Включает разрешения, предоставляемые ролями ai.viewer, ai.speechkit-stt.user, ai.speechkit-tts.user, ai.vision.user, ai.translate.user, ai.languageModels.user, ai.imageGeneration.user, ai.agentChannels.editor, ai.canvasAgents.editor, ai.assistants.editor, ai.datasets.editor, ai.models.editor, ai.guardrails.editor, ai.subscriptions.editor, ai.workRuntimes.editor и ai.workProfiles.editor.
ai.admin
Роль ai.admin позволяет использовать модели Yandex AI Studio, управлять подписками, текстовыми агентами, конфигурациями Responses API и другими сущностями и доступом к ним в Yandex AI Studio.
Пользователи с этой ролью могут:
- просматривать информацию о моделях генерации текста, генерации изображений, векторного представления текста и классификаторов в сервисе Yandex AI Studio, а также использовать такие модели;
- просматривать список текстовых агентов в каталоге, информацию о них, их версиях и операциях с ними;
- создавать, изменять и удалять текстовых агентов;
- создавать версии текстовых агентов;
- тестировать в интерфейсе тестирования любую версию текстового агента, в том числе не опубликованную в канале: отправлять агенту сообщения и просматривать события выполнения;
- просматривать информацию о каналах публикации текстовых агентов, а также список каналов в каталоге;
- создавать, изменять и удалять каналы публикации текстовых агентов, приостанавливать и возобновлять их работу;
- публиковать версии текстовых агентов в каналах;
- просматривать информацию о назначенных правах доступа к текстовым агентам и каналам публикации текстовых агентов, а также изменять такие права доступа;
- просматривать информацию о конфигурациях Responses API, а также создавать, использовать, изменять и удалять их;
- просматривать информацию о загруженных файлах, а также загружать, изменять, просматривать и удалять такие файлы;
- просматривать информацию о поисковых индексах, создавать, изменять и удалять поисковые индексы, а также выполнять поиск по ним;
- просматривать информацию о правилах модерации моделей, а также создавать, применять, изменять и удалять такие правила;
- получать список всех подписок в облаке и просматривать информацию о них;
- покупать, изменять и удалять подписки, в том числе подписки других пользователей;
- сбрасывать окна потребления по любой подписке в облаке;
- использовать свою подписку;
- просматривать информацию о профилях рабочих мест пользователей;
- просматривать информацию о назначенных правах доступа к профилям рабочих мест пользователей и изменять такие права доступа;
- создавать, использовать, изменять и удалять профили рабочих мест пользователей;
- просматривать информацию о рабочих местах пользователей;
- просматривать информацию о назначенных правах доступа к рабочим местам пользователей и изменять такие права доступа;
- создавать и удалять рабочие места;
- использовать свое рабочее место;
- просматривать информацию о датасетах, а также создавать, использовать, изменять и удалять их;
- использовать функциональности распознавания речи, синтеза речи, перевода текста и распознавания текста на изображениях в сервисе Yandex AI Studio;
- просматривать информацию о квотах сервиса Yandex AI Studio;
- просматривать информацию об облаке и каталоге.
Включает разрешения, предоставляемые ролями ai.editor, ai.agentChannels.admin, ai.canvasAgents.admin, ai.assistants.admin, ai.datasets.admin, ai.models.admin, ai.guardrails.admin, ai.subscriptions.admin, ai.workRuntimes.admin и ai.workProfiles.admin.
ИИ-агенты
ai.assistants.auditor
Роль ai.assistants.auditor позволяет просматривать информацию о конфигурациях Responses API, загруженных файлах и поисковых индексах, о квотах сервиса Yandex AI Studio, а также об облаке и каталоге.
ai.assistants.viewer
Роль ai.assistants.viewer позволяет просматривать информацию о конфигурациях Responses API, файлах и поисковых индексах, а также выполнять поиск по таким индексам.
Пользователи с этой ролью могут:
- просматривать информацию о конфигурациях Responses API;
- просматривать информацию о загруженных файлах и содержимое таких файлов;
- просматривать информацию о поисковых индексах, а также выполнять поиск по таким индексам;
- просматривать информацию о квотах сервиса Yandex AI Studio;
- просматривать информацию об облаке;
- просматривать информацию о каталоге.
Включает разрешения, предоставляемые ролью ai.assistants.auditor.
ai.assistants.editor
Роль ai.assistants.editor позволяет управлять конфигурациями Responses API, файлами и поисковыми индексами.
Пользователи с этой ролью могут:
- просматривать информацию о конфигурациях Responses API, а также создавать, использовать, изменять и удалять их;
- просматривать информацию о загруженных файлах, а также загружать, изменять, просматривать и удалять такие файлы;
- просматривать информацию о поисковых индексах, создавать, изменять и удалять поисковые индексы, а также выполнять поиск по ним;
- просматривать информацию о квотах сервиса Yandex AI Studio;
- просматривать информацию об облаке;
- просматривать информацию о каталоге.
Включает разрешения, предоставляемые ролью ai.assistants.viewer.
ai.assistants.admin
Роль ai.assistants.admin позволяет управлять конфигурациями Responses API, файлами и поисковыми индексами.
Пользователи с этой ролью могут:
- просматривать информацию о конфигурациях Responses API, а также создавать, использовать, изменять и удалять их;
- просматривать информацию о загруженных файлах, а также загружать, изменять, просматривать и удалять такие файлы;
- просматривать информацию о поисковых индексах, создавать, изменять и удалять поисковые индексы, а также выполнять поиск по ним;
- просматривать информацию о квотах сервиса Yandex AI Studio;
- просматривать информацию об облаке;
- просматривать информацию о каталоге.
Включает разрешения, предоставляемые ролью ai.assistants.editor.
Текстовые агенты
ai.canvasAgents.auditor
Роль ai.canvasAgents.auditor позволяет просматривать метаданные текстовых агентов.
Пользователи с этой ролью могут:
- просматривать список текстовых агентов в каталоге, информацию о них и их версиях;
- просматривать информацию о назначенных правах доступа к текстовым агентам;
- просматривать список асинхронных операций с текстовыми агентами;
- просматривать информацию о каталоге.
ai.canvasAgents.viewer
Роль ai.canvasAgents.viewer позволяет просматривать текстовых агентов.
Пользователи с этой ролью могут:
- просматривать список текстовых агентов в каталоге, информацию о них и их версиях;
- просматривать информацию о назначенных правах доступа к текстовым агентам;
- просматривать список асинхронных операций с текстовыми агентами;
- просматривать информацию о каталоге.
Включает разрешения, предоставляемые ролью ai.canvasAgents.auditor.
ai.canvasAgents.editor
Роль ai.canvasAgents.editor позволяет управлять текстовыми агентами и тестировать их в интерфейсе тестирования.
Пользователи с этой ролью могут:
- просматривать список текстовых агентов в каталоге, информацию о них, их версиях и операциях с ними;
- создавать, изменять и удалять текстовых агентов;
- создавать версии текстовых агентов;
- тестировать в интерфейсе тестирования любую версию текстового агента, в том числе не опубликованную в канале: отправлять агенту сообщения и просматривать события выполнения;
- просматривать информацию о назначенных правах доступа к текстовым агентам;
- просматривать информацию о каталоге.
Включает разрешения, предоставляемые ролью ai.canvasAgents.viewer.
ai.canvasAgents.admin
Роль ai.canvasAgents.admin позволяет управлять текстовыми агентами и правами доступа к ним.
Пользователи с этой ролью могут:
- просматривать список текстовых агентов в каталоге, информацию о них, их версиях и операциях с ними;
- создавать, изменять и удалять текстовых агентов;
- создавать версии текстовых агентов;
- тестировать в интерфейсе тестирования любую версию текстового агента, в том числе не опубликованную в канале: отправлять агенту сообщения и просматривать события выполнения;
- просматривать информацию о назначенных правах доступа к текстовым агентам и изменять такие права доступа;
- просматривать информацию о каталоге.
Включает разрешения, предоставляемые ролью ai.canvasAgents.editor.
Каналы публикации текстовых агентов
ai.agentChannels.auditor
Роль ai.agentChannels.auditor позволяет просматривать метаданные каналов публикации текстовых агентов.
Пользователи с этой ролью могут:
- просматривать информацию о каналах публикации текстовых агентов, а также список каналов в каталоге;
- просматривать информацию о назначенных правах доступа к каналам публикации текстовых агентов;
- просматривать информацию о каталоге.
ai.agentChannels.viewer
Роль ai.agentChannels.viewer позволяет просматривать каналы публикации текстовых агентов.
Пользователи с этой ролью могут:
- просматривать информацию о каналах публикации текстовых агентов, а также список каналов в каталоге;
- просматривать информацию о назначенных правах доступа к каналам публикации текстовых агентов;
- просматривать информацию о каталоге.
Включает разрешения, предоставляемые ролью ai.agentChannels.auditor.
ai.agentChannels.editor
Роль ai.agentChannels.editor позволяет управлять каналами публикации текстовых агентов и публиковать в них версии агентов.
Пользователи с этой ролью могут:
- просматривать информацию о каналах публикации текстовых агентов и назначенных правах доступа к ним;
- создавать, изменять и удалять каналы публикации текстовых агентов, приостанавливать и возобновлять их работу;
- публиковать версии текстовых агентов в каналах;
- просматривать информацию о каталоге.
Включает разрешения, предоставляемые ролью ai.agentChannels.viewer.
ai.agentChannels.admin
Роль ai.agentChannels.admin позволяет управлять каналами публикации текстовых агентов и правами доступа к ним.
Пользователи с этой ролью могут:
- просматривать информацию о каналах публикации текстовых агентов, а также создавать, изменять и удалять каналы публикации текстовых агентов, приостанавливать и возобновлять их работу;
- просматривать информацию о назначенных правах доступа к каналам публикации текстовых агентов и изменять такие права доступа;
- публиковать версии текстовых агентов в каналах;
- просматривать информацию о каталоге.
Включает разрешения, предоставляемые ролью ai.agentChannels.editor.
Датасеты
ai.datasets.auditor
Роль ai.datasets.auditor позволяет просматривать метаданные датасетов.
ai.datasets.viewer
Роль ai.datasets.viewer позволяет просматривать информацию о датасетах.
Включает разрешения, предоставляемые ролью ai.datasets.auditor.
ai.datasets.user
Роль ai.datasets.user позволяет просматривать информацию о датасетах и использовать их.
Включает разрешения, предоставляемые ролью ai.datasets.viewer.
ai.datasets.editor
Роль ai.datasets.editor позволяет просматривать информацию о датасетах, а также создавать, использовать, изменять и удалять их.
Включает разрешения, предоставляемые ролью ai.datasets.user.
ai.datasets.admin
Роль ai.datasets.admin позволяет просматривать информацию о датасетах, а также создавать, использовать, изменять и удалять их.
Включает разрешения, предоставляемые ролью ai.datasets.editor.
Модели генерации текста и изображений
ai.languageModels.user
Роль ai.languageModels.user позволяет использовать модели генерации текста, модели векторного представления текста и классификаторов в сервисе Yandex AI Studio, а также просматривать информацию об облаке, каталоге и квотах сервиса.
ai.imageGeneration.user
Роль ai.imageGeneration.user позволяет использовать модели генерации изображений в сервисе Yandex AI Studio, а также просматривать информацию об облаке, каталоге и квотах сервиса.
ai.models.auditor
Роль ai.models.auditor позволяет просматривать метаданные моделей генерации текста Yandex AI Studio.
ai.models.viewer
Роль ai.models.viewer позволяет просматривать информацию о моделях генерации текста Yandex AI Studio.
Включает разрешения, предоставляемые ролью ai.models.auditor.
ai.models.user
Роль ai.models.user позволяет использовать конфигурации Responses API, обращаться к моделям генерации текста и изображений, векторного представления текста и классификаторов, а также использовать функциональности распознавания и синтеза речи, распознавания текста на изображениях и перевода текста в Yandex AI Studio.
Пользователи с этой ролью могут:
- просматривать информацию о моделях генерации текста Yandex AI Studio;
- использовать конфигурации Responses API, а также модели генерации текста и изображений, модели векторного представления текста и классификаторов в Yandex AI Studio;
- использовать функциональность перевода текста в Yandex AI Studio;
- использовать функциональность распознавания текста на изображениях в Yandex AI Studio;
- использовать функциональность распознавания и синтеза речи в Yandex AI Studio.
Включает разрешения, предоставляемые ролью ai.models.viewer.
ai.models.editor
Роль ai.models.editor позволяет использовать конфигурации Responses API, обращаться к моделям генерации текста и изображений, векторного представления текста и классификаторов, а также использовать функциональности распознавания и синтеза речи, распознавания текста на изображениях и перевода текста в Yandex AI Studio.
Пользователи с этой ролью могут:
- просматривать информацию о моделях генерации текста Yandex AI Studio;
- использовать конфигурации Responses API, а также модели генерации текста и изображений, модели векторного представления текста и классификаторов в Yandex AI Studio;
- использовать функциональность перевода текста в Yandex AI Studio;
- использовать функциональность распознавания текста на изображениях в Yandex AI Studio;
- использовать функциональность распознавания и синтеза речи в Yandex AI Studio.
Включает разрешения, предоставляемые ролью ai.models.user.
ai.models.admin
Роль ai.models.admin позволяет использовать конфигурации Responses API, обращаться к моделям генерации текста и изображений, векторного представления текста и классификаторов, а также использовать функциональности распознавания и синтеза речи, распознавания текста на изображениях и перевода текста в Yandex AI Studio.
Пользователи с этой ролью могут:
- просматривать информацию о моделях генерации текста Yandex AI Studio;
- использовать конфигурации Responses API, а также модели генерации текста и изображений, модели векторного представления текста и классификаторов в Yandex AI Studio;
- использовать функциональность перевода текста в Yandex AI Studio;
- использовать функциональность распознавания текста на изображениях в Yandex AI Studio;
- использовать функциональность распознавания и синтеза речи в Yandex AI Studio.
Включает разрешения, предоставляемые ролью ai.models.editor.
ai.playground.user
Роль ai.playground.user позволяет создавать запросы в Playground, получать список всех доступных моделей и использовать их в Playground Yandex AI Studio.
Пользователи с этой ролью могут:
- просматривать информацию о конфигурациях Responses API, а также создавать, использовать, изменять и удалять такие конфигурации;
- просматривать информацию о загруженных файлах и содержимое таких файлов;
- просматривать информацию о поисковых индексах, а также выполнять поиск по таким индексам;
- просматривать информацию о моделях генерации текста Yandex AI Studio и использовать такие модели;
- просматривать информацию о моделях генерации изображений Yandex AI Studio и использовать такие модели;
- просматривать информацию о моделях векторного представления текста Yandex AI Studio и использовать такие модели;
- просматривать информацию о моделях классификаторов Yandex AI Studio и использовать такие модели;
- использовать функциональность перевода текста в Yandex AI Studio;
- использовать функциональность распознавания текста на изображениях в Yandex AI Studio;
- использовать функциональность распознавания и синтеза речи в Yandex AI Studio;
- просматривать информацию о квотах сервиса Yandex AI Studio;
- просматривать информацию об облаке;
- просматривать информацию о каталоге.
Включает разрешения, предоставляемые ролями ai.assistants.viewer, ai.models.user, ai.imageGeneration.user, ai.languageModels.user, ai.speechkit-stt.user, ai.speechkit-tts.user, ai.translate.user и ai.vision.user.
Чтобы управлять поисковыми индексами в Playground, дополнительно необходима роль ai.assistants.editor.
Модерация ответов моделей
ai.guardrails.auditor
Роль ai.guardrails.auditor позволяет просматривать метаданные правил модерации моделей.
ai.guardrails.viewer
Роль ai.guardrails.viewer позволяет просматривать информацию о правилах модерации моделей.
Включает разрешения, предоставляемые ролью ai.guardrails.auditor.
ai.guardrails.user
Роль ai.guardrails.user позволяет применять правила модерации моделей и просматривать метаданные таких правил.
ai.guardrails.editor
Роль ai.guardrails.editor позволяет просматривать информацию о правилах модерации моделей, а также создавать, применять, изменять и удалять такие правила.
Включает разрешения, предоставляемые ролями ai.guardrails.viewer и ai.guardrails.user.
ai.guardrails.admin
Роль ai.guardrails.admin позволяет просматривать информацию о правилах модерации моделей, а также создавать, применять, изменять и удалять такие правила.
Включает разрешения, предоставляемые ролью ai.guardrails.editor.
Синтез и распознавание речи
ai.speechkit-stt.user
Роль ai.speechkit-stt.user позволяет использовать функциональность распознавания речи в сервисе Yandex AI Studio, а также просматривать информацию об облаке, каталоге и квотах сервиса.
ai.speechkit-tts.user
Роль ai.speechkit-tts.user позволяет использовать функциональность синтеза речи в сервисе Yandex AI Studio, а также просматривать информацию об облаке, каталоге и квотах сервиса.
Поисковые запросы
search-api.webSearch.user
Роль search-api.webSearch.user позволяет выполнять поисковые запросы с помощью Yandex Search API, а также просматривать информацию об облаке, каталоге и квотах Yandex Search API.
search-api.executor
Роль search-api.executor использовалась для работы с устаревшим Yandex Search API v1 и позволяет выполнять поисковые запросы с помощью актуальной версии Yandex Search API.
Роль search-api.executor устарела и не должна использоваться.
search-api.auditor
Роль search-api.auditor использовалась для работы с устаревшим Yandex Search API v1.
Роль search-api.auditor устарела и не должна использоваться.
search-api.viewer
Роль search-api.viewer использовалась для работы с устаревшим Yandex Search API v1.
Роль search-api.viewer устарела и не должна использоваться.
search-api.editor
Роль search-api.editor использовалась для работы с устаревшим Yandex Search API v1 и позволяет выполнять поисковые запросы с помощью актуальной версии Yandex Search API.
Роль search-api.editor устарела и не должна использоваться.
search-api.admin
Роль search-api.admin использовалась для работы с устаревшим Yandex Search API v1 и позволяет выполнять поисковые запросы с помощью актуальной версии Yandex Search API.
Роль search-api.admin устарела и не должна использоваться.
Распознавание текста на изображениях и в PDF
ai.vision.user
Роль ai.vision.user позволяет использовать функциональность распознавания текста на изображениях в сервисе Yandex AI Studio, а также просматривать информацию об облаке, каталоге и квотах сервиса.
Перевод текста
ai.translate.user
Роль ai.translate.user позволяет использовать функциональность перевода текста в сервисе Yandex AI Studio, а также просматривать информацию об облаке, каталоге и квотах сервиса.
MCP-серверы
serverless.mcpGateways.auditor
Роль serverless.mcpGateways.auditor позволяет просматривать информацию об MCP-серверах и назначенных правах доступа к ним, а также о квотах на использование MCP-серверов.
serverless.mcpGateways.viewer
Роль serverless.mcpGateways.viewer позволяет просматривать информацию об MCP-серверах и назначенных правах доступа к ним, а также о квотах на использование MCP-серверов.
Включает разрешения, предоставляемые ролью serverless.mcpGateways.auditor.
serverless.mcpGateways.invoker
Роль serverless.mcpGateways.invoker позволяет обращаться к MCP-серверам, в том числе через MCP Hub.
serverless.mcpGateways.anonymousInvoker
Роль serverless.mcpGateways.anonymousInvoker позволяет обращаться к MCP-серверам, в том числе через MCP Hub.
serverless.mcpGateways.editor
Роль serverless.mcpGateways.editor позволяет создавать, изменять и удалять MCP-серверы, просматривать информацию о них и назначенных правах доступа к ним, а также о квотах на использование MCP-серверов.
Включает разрешения, предоставляемые ролью serverless.mcpGateways.viewer.
serverless.mcpGateways.admin
Роль serverless.mcpGateways.admin позволяет управлять MCP-серверами и доступом к ним.
Пользователи с этой ролью могут:
- просматривать информацию об MCP-серверах, а также создавать, изменять и удалять их;
- просматривать информацию о назначенных правах доступа к MCP-серверам, а также изменять такие права доступа;
- просматривать информацию о квотах на использование MCP-серверов;
- обращаться через MCP Hub к MCP-серверам, в том числе внешним.
Включает разрешения, предоставляемые ролями serverless.mcpGateways.editor, serverless.mcpGateways.invoker и serverless.mcpGateways.anonymousInvoker.
Рабочие процессы
С помощью сервисных ролей Workflows вы можете управлять доступом пользователей к рабочим процессам Workflows.
Примечание
Возможность запускать рабочие процессы и управлять ими из определенных облачных сетей или с определенных IP-адресов, а также привязывать к рабочим процессам определенные облачные сети может быть ограничена политиками авторизации на уровне каталога, облака или организации.
serverless.workflows.auditor
Роль serverless.workflows.auditor позволяет просматривать информацию о рабочих процессах и назначенных правах доступа к ним, просматривать историю запусков рабочих процессов, а также информацию о квотах Yandex Workflows.
serverless.workflows.viewer
Роль serverless.workflows.viewer позволяет просматривать информацию о рабочих процессах и назначенных правах доступа к ним, просматривать историю запусков рабочих процессов, а также информацию о квотах Yandex Workflows.
Включает разрешения, предоставляемые ролью serverless.workflows.auditor.
serverless.workflows.executor
Роль serverless.workflows.executor позволяет запускать, приостанавливать, возобновлять и останавливать рабочие процессы Yandex Workflows.
serverless.workflows.editor
Роль serverless.workflows.editor позволяет управлять рабочими процессами.
Пользователи с этой ролью могут:
- просматривать информацию о рабочих процессах и назначенных правах доступа к ним;
- создавать, изменять и удалять рабочие процессы;
- запускать, приостанавливать, возобновлять и останавливать рабочие процессы;
- просматривать историю запусков рабочих процессов;
- просматривать информацию о квотах Yandex Workflows.
Включает разрешения, предоставляемые ролями serverless.workflows.viewer и serverless.workflows.executor.
serverless.workflows.admin
Роль serverless.workflows.admin позволяет управлять рабочими процессами.
Пользователи с этой ролью могут:
- просматривать информацию о рабочих процессах, а также создавать, изменять и удалять их;
- просматривать информацию о назначенных правах доступа к рабочим процессам, а также изменять такие права доступа;
- запускать, приостанавливать, возобновлять и останавливать рабочие процессы;
- просматривать историю запусков рабочих процессов;
- просматривать информацию о квотах Yandex Workflows.
Включает разрешения, предоставляемые ролью serverless.workflows.editor.
Подписки
ai.subscriptions.auditor
Роль ai.subscriptions.auditor позволяет пользователю просматривать метаданные своей подписки.
ai.subscriptions.viewer
Роль ai.subscriptions.viewer позволяет пользователю просматривать информацию о своей подписке.
Включает разрешения, предоставляемые ролью ai.subscriptions.auditor.
ai.subscriptions.user
Роль ai.subscriptions.user позволяет пользователю просматривать информацию о своей подписке и использовать ее.
Включает разрешения, предоставляемые ролью ai.subscriptions.viewer.
ai.subscriptions.consumer
Роль ai.subscriptions.consumer позволяет пользователю просматривать информацию о своей подписке, использовать ее, а также сбрасывать окна потребления по ней.
Включает разрешения, предоставляемые ролью ai.subscriptions.user.
ai.subscriptions.editor
Роль ai.subscriptions.editor позволяет пользователю управлять своей подпиской.
Пользователи с этой ролью могут:
- получать список всех подписок в облаке;
- просматривать информацию о своей подписке;
- покупать, использовать, изменять и удалять свою подписку;
- сбрасывать окна потребления по любой подписке в облаке.
Включает разрешения, предоставляемые ролью ai.subscriptions.user.
ai.subscriptions.admin
Роль ai.subscriptions.admin позволяет управлять подписками пользователей в облаке.
Пользователи с этой ролью могут:
- получать список всех подписок в облаке и просматривать информацию о них;
- покупать, изменять и удалять подписки, в том числе подписки других пользователей;
- сбрасывать окна потребления по любой подписке в облаке;
- использовать свою подписку.
Включает разрешения, предоставляемые ролью ai.subscriptions.editor.
Рабочие места пользователей
ai.workRuntimes.auditor
Роль ai.workRuntimes.auditor позволяет просматривать метаданные рабочих мест пользователей и информацию о назначенных правах доступа к рабочим местам.
ai.workRuntimes.viewer
Роль ai.workRuntimes.viewer позволяет просматривать информацию о рабочих местах пользователей и назначенных правах доступа к рабочим местам.
Включает разрешения, предоставляемые ролью ai.workRuntimes.auditor.
ai.workRuntimes.user
Роль ai.workRuntimes.user позволяет пользователю использовать свое рабочее место.
Пользователи с этой ролью могут:
- просматривать информацию о рабочих местах пользователей;
- просматривать информацию о назначенных правах доступа к рабочим местам пользователей;
- использовать свое рабочее место.
Включает разрешения, предоставляемые ролью ai.workRuntimes.viewer.
ai.workRuntimes.editor
Роль ai.workRuntimes.editor позволяет пользователю создавать рабочие места и использовать свое рабочее место.
Пользователи с этой ролью могут:
- просматривать информацию о рабочих местах пользователей;
- просматривать информацию о назначенных правах доступа к рабочим местам пользователей;
- создавать рабочие места;
- использовать свое рабочее место.
Включает разрешения, предоставляемые ролью ai.workRuntimes.user.
ai.workRuntimes.admin
Роль ai.workRuntimes.admin позволяет управлять рабочими местами пользователей и доступом к ним.
Пользователи с этой ролью могут:
- просматривать информацию о рабочих местах пользователей;
- просматривать информацию о назначенных правах доступа к рабочим местам пользователей и изменять такие права доступа;
- создавать и удалять рабочие места;
- использовать свое рабочее место.
Включает разрешения, предоставляемые ролью ai.workRuntimes.editor.
Профили рабочих мест пользователей
ai.workProfiles.auditor
Роль ai.workProfiles.auditor позволяет просматривать метаданные профилей рабочих мест пользователей и информацию о назначенных правах доступа к таким профилям.
ai.workProfiles.viewer
Роль ai.workProfiles.viewer позволяет просматривать информацию о профилях рабочих мест пользователей и назначенных правах доступа к таким профилям.
Включает разрешения, предоставляемые ролью ai.workProfiles.auditor.
ai.workProfiles.user
Роль ai.workProfiles.user позволяет использовать профили рабочих мест пользователей.
Пользователи с этой ролью могут:
- просматривать информацию о профилях рабочих мест пользователей;
- просматривать информацию о назначенных правах доступа к профилям рабочих мест пользователей;
- использовать профили рабочих мест пользователей.
Включает разрешения, предоставляемые ролью ai.workProfiles.viewer.
ai.workProfiles.editor
Роль ai.workProfiles.editor позволяет использовать и изменять профили рабочих мест пользователей.
Пользователи с этой ролью могут:
- просматривать информацию о профилях рабочих мест пользователей;
- просматривать информацию о назначенных правах доступа к профилям рабочих мест пользователей;
- использовать и изменять профили рабочих мест пользователей.
Включает разрешения, предоставляемые ролью ai.workProfiles.user.
ai.workProfiles.admin
Роль ai.workProfiles.admin позволяет управлять профилями рабочих мест пользователей и доступом к ним.
Пользователи с этой ролью могут:
- просматривать информацию о профилях рабочих мест пользователей;
- просматривать информацию о назначенных правах доступа к профилям рабочих мест пользователей и изменять такие права доступа;
- создавать, использовать, изменять и удалять профили рабочих мест пользователей.
Включает разрешения, предоставляемые ролью ai.workProfiles.editor.
Примитивные роли
Примитивные роли позволяют пользователям совершать действия во всех сервисах Yandex Cloud.
auditor
Роль auditor предоставляет разрешения на чтение конфигурации и метаданных любых ресурсов Yandex Cloud без возможности доступа к данным.
Например, пользователи с этой ролью могут:
- просматривать информацию о ресурсе;
- просматривать метаданные ресурса;
- просматривать список операций с ресурсом.
Роль auditor — наиболее безопасная роль, исключающая доступ к данным сервисов. Роль подходит для пользователей, которым необходим минимальный уровень доступа к ресурсам Yandex Cloud.
viewer
Роль viewer предоставляет разрешения на чтение информации о любых ресурсах Yandex Cloud.
Включает разрешения, предоставляемые ролью auditor.
В отличие от роли auditor, роль viewer предоставляет доступ к данным сервисов в режиме чтения.
editor
Роль editor предоставляет разрешения на управление любыми ресурсами Yandex Cloud, кроме назначения ролей другим пользователям, передачи прав владения организацией и ее удаления, а также удаления ключей шифрования Key Management Service.
Например, пользователи с этой ролью могут создавать, изменять и удалять ресурсы.
Включает разрешения, предоставляемые ролью viewer.
admin
Роль admin позволяет назначать любые роли, кроме resource-manager.clouds.owner и organization-manager.organizations.owner, а также предоставляет разрешения на управление любыми ресурсами Yandex Cloud, кроме передачи прав владения организацией и ее удаления.
Прежде чем назначить роль admin на организацию, облако или платежный аккаунт, ознакомьтесь с информацией о защите привилегированных аккаунтов.
Включает разрешения, предоставляемые ролью editor.
Вместо примитивных ролей мы рекомендуем использовать роли сервисов. Такой подход позволит более гранулярно управлять доступом и обеспечить соблюдение принципа минимальных привилегий.
Какие роли мне необходимы
В таблице сопоставлены действия и минимальные необходимые для их выполнения роли. Вы всегда можете назначить роль, которая дает более широкие разрешения, чем указанная. Например, назначить ai.editor вместо ai.viewer.
| Действие | Необходимые роли |
|---|---|
| Просмотр информации | |
| Просмотр метаданных всех ресурсов Yandex AI Studio, а также информации о квотах сервисов Yandex Translate, Yandex Vision OCR, Yandex SpeechKit и Yandex AI Studio, об облаке и каталоге | ai.auditor |
| Просмотр информации обо всех ресурсах Yandex AI Studio, чтение загруженных файлов и поиск по поисковым индексам Vector Store | ai.viewer |
| Просмотр информации о загруженных файлах и поисковых индексах Vector Store | ai.assistants.auditor |
| Просмотр содержимого загруженных файлов и выполнение поиска по поисковым индексам Vector Store | ai.assistants.viewer |
| Просмотр метаданных текстовых агентов | ai.canvasAgents.auditor |
| Просмотр информации о текстовых агентах | ai.canvasAgents.viewer |
| Просмотр метаданных каналов публикации текстовых агентов | ai.agentChannels.auditor |
| Просмотр информации о каналах публикации текстовых агентов | ai.agentChannels.viewer |
| Просмотр метаданных датасетов | ai.datasets.auditor |
| Просмотр информации о датасетах | ai.datasets.viewer |
| Просмотр метаданных моделей генерации текста | ai.models.auditor |
| Просмотр информации о моделях генерации текста | ai.models.viewer |
| Просмотр трейсов моделей и агентов в каталоге | ai.models.viewer |
| Просмотр метаданных правил модерации ответов моделей | ai.guardrails.auditor |
| Просмотр информации о правилах модерации ответов моделей | ai.guardrails.viewer |
| Просмотр информации об MCP-серверах и назначенных правах доступа к ним | serverless.mcpGateways.auditor |
| Просмотр информации о рабочих процессах, назначенных правах доступа к ним, истории запусков и квотах Yandex Workflows | serverless.workflows.auditor |
| Использование моделей и сервисов | |
| Использование моделей генерации текста, векторного представления текста и классификаторов | ai.languageModels.user |
| Использование моделей генерации изображений | ai.imageGeneration.user |
| Использование ИИ-агентов, а также моделей генерации текста и изображений, векторного представления текста и классификаторов | ai.models.user |
| Создание экспериментов и использование доступных моделей в AI Playground в интерфейсе AI Studio | ai.playground.user |
| Выполнение поисковых запросов в Yandex Search API | search-api.webSearch.user |
| Перевод текста с помощью Yandex Translate | ai.translate.user |
| Распознавание текста на изображениях с помощью Yandex Vision OCR | ai.vision.user |
| Распознавание речи с помощью Yandex SpeechKit | ai.speechkit-stt.user |
| Синтез речи с помощью Yandex SpeechKit | ai.speechkit-tts.user |
| Применение правил модерации ответов моделей | ai.guardrails.user |
| Использование датасетов | ai.datasets.user |
| Обращение к MCP-серверам, в том числе через MCP Hub | serverless.mcpGateways.invoker |
| Обращение к внешним MCP-серверам | serverless.mcpGateways.anonymousInvoker |
| Запуск, приостановка, возобновление и остановка рабочих процессов | serverless.workflows.executor |
| Управление ресурсами | |
| Использование сервисов Yandex Translate, Yandex Vision OCR, Yandex SpeechKit и Yandex AI Studio, а также управление файлами, поисковыми индексами Vector Store, датасетами, дообученными моделями и правилами модерации | ai.editor |
| Загрузка, изменение и удаление файлов, создание, изменение и удаление поисковых индексов Vector Store | ai.assistants.editor |
| Работа с файлами, поисковыми индексами и ИИ-агентами в интерфейсе AI Studio | ai.playground.user и ai.assistants.editor |
| Удаление ИИ-агентов и поисковых индексов в интерфейсе AI Studio | ai.playground.user |
| Создание, изменение, удаление и тестирование текстовых агентов | ai.canvasAgents.editor |
| Создание каналов публикации текстовых агентов, управление ими и публикация версий агентов | ai.agentChannels.editor |
| Создание, изменение и удаление датасетов | ai.datasets.editor |
| Создание и удаление датасетов в интерфейсе AI Studio | ai.playground.user и ai.datasets.editor |
| Подключение трейсинга моделей и агентов | ai.models.editor |
| Создание, применение, изменение и удаление правил модерации ответов моделей | ai.guardrails.editor |
| Создание и подключение MCP-серверов | serverless.mcpGateways.editor и iam.serviceAccounts.user |
| Изменение и удаление MCP-серверов | serverless.mcpGateways.editor |
| Создание, изменение и удаление рабочих процессов | serverless.workflows.editor |
| Создание API-ключа в интерфейсе AI Studio | resource-manager.admin |
| Управление доступом к ресурсам | |
| Назначение роли, отзыв роли и просмотр назначенных ролей на каталог | admin |
| Управление доступом к текстовым агентам | ai.canvasAgents.admin |
| Управление доступом к каналам публикации текстовых агентов | ai.agentChannels.admin |
| Управление доступом к MCP-серверам | serverless.mcpGateways.admin |
| Управление доступом к рабочим процессам | serverless.workflows.admin |
Примечание
Роли search-api.executor, search-api.auditor, search-api.viewer, search-api.editor и search-api.admin ранее использовались для работы с API сервиса Yandex Search API. Эти роли устарели и не должны использоваться: для поисковых запросов назначайте роль search-api.webSearch.user.