Управление доступом в 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. После диаграммы дано описание всех ролей:
- Общие роли сервиса
- ИИ-агенты
- Текстовые агенты
- Каналы публикации текстовых агентов
- Датасеты
- Модели генерации текста и изображений
- Эксперименты
- Модерация ответов моделей
- Синтез и распознавание речи
- Распознавание текста
- Перевод текста
- Поисковые запросы
- MCP-серверы
- Рабочие процессы
Сервисные роли
Общие роли сервиса Yandex AI Studio
ai.auditor
Роль ai.auditor позволяет просматривать информацию о квотах сервисов Yandex Translate, Yandex Vision OCR, Yandex SpeechKit и Yandex AI Studio, о загруженных файлах, поисковых индексах Vector Store, датасетах и моделях генерации текста Yandex AI Studio, просматривать метаданные правил модерации ответов моделей, а также информацию об облаке и каталоге.
Включает разрешения, предоставляемые ролями ai.assistants.auditor, ai.datasets.auditor, ai.models.auditor и ai.guardrails.auditor.
ai.viewer
Роль ai.viewer позволяет просматривать информацию о квотах сервисов Yandex Translate, Yandex Vision OCR, Yandex SpeechKit и Yandex AI Studio, о моделях генерации текста, о правилах модерации ответов моделей, о датасетах, загруженных файлах и поисковых индексах Vector Store в Yandex AI Studio, выполнять чтение таких файлов и поиск по таким индексам, а также просматривать информацию об облаке и каталоге.
Включает разрешения, предоставляемые ролями ai.auditor, ai.assistants.viewer, ai.datasets.viewer, ai.models.viewer и ai.guardrails.viewer.
ai.editor
Роль ai.editor позволяет использовать сервисы Yandex Translate, Yandex Vision OCR, Yandex SpeechKit и Yandex AI Studio.
Пользователи с этой ролью могут:
- использовать сервис Yandex Translate для перевода текста;
- использовать сервис Yandex Vision OCR для анализа изображений;
- использовать сервис Yandex SpeechKit для распознавания и синтеза речи;
- просматривать информацию о моделях генерации текста Yandex AI Studio;
- просматривать информацию о правилах модерации ответов моделей, а также создавать, применять, изменять и удалять такие правила;
- использовать AI-агентов, а также модели генерации текста и изображений, модели векторного представления текста и классификаторов в сервисе Yandex AI Studio;
- просматривать информацию о загруженных файлах, а также загружать, изменять, просматривать и удалять такие файлы;
- просматривать информацию о поисковых индексах Vector Store, создавать, изменять и удалять поисковые индексы, а также выполнять поиск по ним;
- дообучать модели Yandex AI Studio, а также создавать, изменять и удалять дообученные модели;
- просматривать информацию о датасетах, использовать их для дообучения моделей, а также создавать, изменять и удалять датасеты;
- просматривать информацию об облаке и каталоге;
- просматривать информацию о квотах сервисов Yandex Translate, Yandex Vision OCR, Yandex SpeechKit и Yandex AI Studio.
Включает разрешения, предоставляемые ролями ai.viewer, ai.translate.user, ai.vision.user, ai.speechkit-stt.user, ai.speechkit-tts.user, ai.languageModels.user, ai.imageGeneration.user, ai.assistants.editor, ai.datasets.editor, ai.models.editor и ai.guardrails.editor.
ai.admin
Роль ai.admin позволяет использовать сервисы Yandex Translate, Yandex Vision OCR, Yandex SpeechKit и Yandex AI Studio.
Пользователи с этой ролью могут:
- использовать сервис Yandex Translate для перевода текста;
- использовать сервис Yandex Vision OCR для анализа изображений;
- использовать сервис Yandex SpeechKit для распознавания и синтеза речи;
- просматривать информацию о моделях генерации текста Yandex AI Studio;
- просматривать информацию о правилах модерации ответов моделей, а также создавать, применять, изменять и удалять такие правила;
- использовать AI-агентов, а также модели генерации текста и изображений, модели векторного представления текста и классификаторов в сервисе Yandex AI Studio;
- просматривать информацию о загруженных файлах, а также загружать, изменять, просматривать и удалять такие файлы;
- просматривать информацию о поисковых индексах Vector Store, создавать, изменять и удалять поисковые индексы, а также выполнять поиск по ним;
- дообучать модели Yandex AI Studio, а также создавать, изменять и удалять дообученные модели;
- просматривать информацию о датасетах, использовать их для дообучения моделей, а также создавать, изменять и удалять датасеты;
- просматривать информацию об облаке и каталоге;
- просматривать информацию о квотах сервисов Yandex Translate, Yandex Vision OCR, Yandex SpeechKit и Yandex AI Studio.
Включает разрешения, предоставляемые ролями ai.editor, ai.assistants.admin, ai.datasets.admin, ai.models.admin и ai.guardrails.admin.
ИИ-агенты
ai.assistants.auditor
Роль ai.assistants.auditor позволяет просматривать информацию о загруженных файлах и поисковых индексах Vector Store, а также о квотах сервиса Yandex AI Studio, об облаке и каталоге.
ai.assistants.viewer
Роль ai.assistants.viewer позволяет просматривать информацию о файлах и поисковых индексах Vector Store, а также выполнять поиск по таким индексам.
Пользователи с этой ролью могут:
- просматривать информацию о загруженных файлах и содержимое таких файлов;
- просматривать информацию о поисковых индексах Vector Store, а также выполнять поиск по таким индексам;
- просматривать информацию о квотах сервиса Yandex AI Studio;
- просматривать информацию об облаке;
- просматривать информацию о каталоге.
Включает разрешения, предоставляемые ролью ai.assistants.auditor.
ai.assistants.editor
Роль ai.assistants.editor позволяет использовать AI-агентов, а также управлять файлами и поисковыми индексами Vector Store.
Пользователи с этой ролью могут:
- использовать AI-агентов;
- просматривать информацию о загруженных файлах, а также загружать, изменять, просматривать и удалять такие файлы;
- просматривать информацию о поисковых индексах Vector Store, создавать, изменять и удалять поисковые индексы, а также выполнять поиск по ним;
- просматривать информацию о квотах сервиса Yandex AI Studio;
- просматривать информацию об облаке;
- просматривать информацию о каталоге.
Включает разрешения, предоставляемые ролью ai.assistants.viewer.
ai.assistants.admin
Роль ai.assistants.admin позволяет использовать AI-агентов, а также управлять файлами и поисковыми индексами Vector Store.
Пользователи с этой ролью могут:
- использовать AI-агентов;
- просматривать информацию о загруженных файлах, а также загружать, изменять, просматривать и удалять такие файлы;
- просматривать информацию о поисковых индексах Vector Store, создавать, изменять и удалять поисковые индексы, а также выполнять поиск по ним;
- просматривать информацию о квотах сервиса 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 Studio.
Включает разрешения, предоставляемые ролью ai.datasets.viewer.
ai.datasets.editor
Роль ai.datasets.editor позволяет просматривать информацию о датасетах, создавать, изменять и удалять датасеты, а также использовать их для дообучения моделей в AI Studio.
Включает разрешения, предоставляемые ролью ai.datasets.user.
ai.datasets.admin
Роль ai.datasets.admin позволяет просматривать информацию о датасетах, создавать, изменять и удалять датасеты, а также использовать их для дообучения моделей в AI Studio.
Включает разрешения, предоставляемые ролью ai.datasets.editor.
Модели генерации текста и изображений
ai.languageModels.user
Роль ai.languageModels.user позволяет использовать модели генерации текста, векторного представления текста и классификаторов в сервисе Yandex AI Studio, а также просматривать информацию об облаке, каталоге и квотах сервиса.
ai.imageGeneration.user
Роль ai.imageGeneration.user позволяет использовать модели генерации изображений YandexART в сервисе 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 позволяет использовать AI-агентов и модели генерации текста и изображений, векторного представления текста и классификаторов в Yandex AI Studio, а также использовать сервисы Yandex Translate, Yandex Vision OCR и Yandex SpeechKit.
Пользователи с этой ролью могут:
- просматривать информацию о моделях генерации текста Yandex AI Studio;
- использовать AI-агентов, а также модели генерации текста и изображений, модели векторного представления текста и классификаторов в сервисе Yandex AI Studio;
- использовать сервис Yandex Translate для перевода текста;
- использовать сервис Yandex Vision OCR для анализа изображений;
- использовать сервис Yandex SpeechKit для распознавания и синтеза речи.
Включает разрешения, предоставляемые ролью ai.models.viewer.
ai.models.editor
Роль ai.models.editor позволяет управлять дообучением моделей Yandex AI Studio, а также использовать сервисы Yandex Translate, Yandex Vision OCR, Yandex SpeechKit и Yandex AI Studio.
Пользователи с этой ролью могут:
- просматривать информацию о моделях генерации текста Yandex AI Studio;
- дообучать модели Yandex AI Studio, а также создавать, изменять и удалять дообученные модели;
- использовать AI-агентов, а также модели генерации текста и изображений, модели векторного представления текста и классификаторов в сервисе Yandex AI Studio;
- использовать сервис Yandex Translate для перевода текста;
- использовать сервис Yandex Vision OCR для анализа изображений;
- использовать сервис Yandex SpeechKit для распознавания и синтеза речи.
Включает разрешения, предоставляемые ролью ai.models.user.
ai.models.admin
Роль ai.models.admin позволяет управлять дообучением моделей Yandex AI Studio, а также использовать сервисы Yandex Translate, Yandex Vision OCR, Yandex SpeechKit и Yandex AI Studio.
Пользователи с этой ролью могут:
- просматривать информацию о моделях генерации текста Yandex AI Studio;
- дообучать модели Yandex AI Studio, а также создавать, изменять и удалять дообученные модели;
- использовать AI-агентов, а также модели генерации текста и изображений, модели векторного представления текста и классификаторов в сервисе Yandex AI Studio;
- использовать сервис Yandex Translate для перевода текста;
- использовать сервис Yandex Vision OCR для анализа изображений;
- использовать сервис Yandex SpeechKit для распознавания и синтеза речи.
Включает разрешения, предоставляемые ролью ai.models.editor.
ai.playground.user
Роль ai.playground.user позволяет создавать эксперименты, получать список всех доступных моделей и использовать их в AI Playground в консоли управления Yandex Cloud. Для работы с поисковыми индексами в консоли управления дополнительно необходима роль 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 SpeechKit для распознавания речи, а также просматривать информацию об облаке, каталоге и квотах сервиса.
ai.speechkit-tts.user
Роль ai.speechkit-tts.user позволяет использовать сервис Yandex SpeechKit для синтеза речи, а также просматривать информацию об облаке, каталоге и квотах сервиса.
Поисковые запросы
search-api.webSearch.user
Роль search-api.webSearch.user позволяет выполнять поисковые запросы в сервисе Yandex Search API, а также просматривать информацию об облаке, каталоге и квотах сервиса Yandex Search API.
search-api.executor
Роль search-api.executor использовалась для работы с устаревшим API сервиса.
Роль search-api.executor устарела и больше не используется.
search-api.auditor
Роль search-api.auditor использовалась для работы с устаревшим API сервиса и позволяет просматривать информацию о квотах сервиса Yandex Search API, а также об облаке и каталоге.
Роль search-api.auditor устарела и не должна использоваться.
search-api.viewer
Роль search-api.viewer использовалась для работы с устаревшим API сервиса и позволяет просматривать информацию о квотах сервиса Yandex Search API, а также об облаке и каталоге.
Роль search-api.viewer устарела и не должна использоваться.
search-api.editor
Роль search-api.editor использовалась для работы с устаревшим API сервиса и позволяет просматривать информацию о квотах сервиса Yandex Search API, а также об облаке и каталоге.
Роль search-api.editor устарела и не должна использоваться.
search-api.admin
Роль search-api.admin использовалась для работы с устаревшим API сервиса и позволяет просматривать информацию о квотах сервиса Yandex Search API, а также об облаке и каталоге.
Роль search-api.admin устарела и не должна использоваться.
Распознавание текста на изображениях и в PDF
ai.vision.user
Роль ai.vision.user позволяет использовать сервис Yandex Vision OCR для анализа изображений, а также просматривать информацию об облаке, каталоге и квотах сервиса.
Перевод текста
ai.translate.user
Роль ai.translate.user позволяет использовать сервис Yandex Translate для перевода текста, а также просматривать информацию об облаке, каталоге и квотах сервиса.
MCP-серверы
serverless.mcpGateways.auditor
Роль serverless.mcpGateways.auditor позволяет просматривать информацию об MCP-серверах и назначенных правах доступа к ним.
serverless.mcpGateways.viewer
Роль serverless.mcpGateways.viewer позволяет просматривать информацию об 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-серверы, просматривать информацию о них и назначенных правах доступа к ним.
Включает разрешения, предоставляемые ролью serverless.mcpGateways.viewer.
serverless.mcpGateways.admin
Роль serverless.mcpGateways.admin позволяет управлять 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.
Примитивные роли
Примитивные роли позволяют пользователям совершать действия во всех сервисах 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 Studio | ai.playground.user и ai.datasets.editor |
| Дообучение моделей, создание, изменение и удаление дообученных моделей | ai.models.editor |
| Дообучение моделей и классификаторов в интерфейсе AI Studio | ai.playground.user, ai.datasets.user и ai.models.editor |
| Создание, изменение, удаление, запуск и остановка инстансов Yandex AI Studio | ai.models.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.