Управление доступом в Yandex AI Studio

Об управлении доступом

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. После диаграммы дано описание всех ролей:

Сервисные роли

Общие роли сервиса Yandex AI Studio

ai.auditor

Роль ai.auditor позволяет просматривать информацию о моделях генерации текста и правилах модерации моделей, о текстовых агентах и каналах публикации текстовых агентов, а также о конфигурациях 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.

Пользователи с этой ролью могут:

Включает разрешения, предоставляемые ролями 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, файлах и поисковых индексах, а также выполнять поиск по таким индексам.

Пользователи с этой ролью могут:

Включает разрешения, предоставляемые ролью 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.

Пользователи с этой ролью могут:

Включает разрешения, предоставляемые ролью ai.models.viewer.

ai.models.editor

Роль ai.models.editor позволяет использовать конфигурации Responses API, обращаться к моделям генерации текста и изображений, векторного представления текста и классификаторов, а также использовать функциональности распознавания и синтеза речи, распознавания текста на изображениях и перевода текста в Yandex AI Studio.

Пользователи с этой ролью могут:

Включает разрешения, предоставляемые ролью ai.models.user.

ai.models.admin

Роль ai.models.admin позволяет использовать конфигурации Responses API, обращаться к моделям генерации текста и изображений, векторного представления текста и классификаторов, а также использовать функциональности распознавания и синтеза речи, распознавания текста на изображениях и перевода текста в Yandex AI Studio.

Пользователи с этой ролью могут:

Включает разрешения, предоставляемые ролью ai.models.editor.

ai.playground.user

Роль ai.playground.user позволяет создавать запросы в Playground, получать список всех доступных моделей и использовать их в Playground 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.

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

Следующая