Режимы и права¶
Режим сессии определяет, что агенту разрешено в целом, а гранулярные права — что можно делать конкретным инструментам и с какими файлами. Оба механизма работают вместе.
Режимы сессии¶
Режим — глобальное состояние сессии, а не отдельный агент: при переключении меняется набор доступных инструментов, но роль и инструкции агента остаются прежними.
| Режим | Поведение | Кто переключает |
|---|---|---|
| Plan | Только чтение: любые записи, изменения и удаления запрещены. Агент исследует, задаёт вопросы и работает с планом проекта | Вы или агент |
| Act | Полный доступ: инструменты агента плюс глобальные права | Вы или агент |
| YOLO | Все подтверждения «ask» автоматически становятся «allow». Запреты «deny» остаются в силе | Только вы |
Режим по умолчанию может быть автоматическим: в нём агент сам решает, когда войти в план — для сложных задач и архитектурных решений, а простые изменения делает сразу.
Переключение¶
- Из интерфейса — переключателем режима в шапке сессии.
- Агентом — он может сам войти в план и выйти из него, когда это уместно (для этого у агента есть инструменты входа в план и выхода из него).
- Через API —
PATCH /api/v2/sessions/:idс телом{ "mode": "plan" }(такжеactилиyolo).
Read-only агенты
Если у агента нет инструментов записи, shell и веба, режим для него неприменим — переключатель в интерфейсе неактивен.
План и todo¶
Состояние планирования тоже часть сессии:
- План живёт в проекте (колонки, пункты, зависимости). Агент читает и записывает его инструментами плана.
- Todo живёт в сессии. Агент ведёт его отдельными инструментами.
- Панель «Сессия» показывает план и todo; она обновляется по событиям утверждения плана и изменения списка задач.
Строгость цикла «план → реализация»¶
Настраивается глобально или на уровне проекта — насколько обязателен план перед изменениями:
| Режим | Поведение |
|---|---|
| auto | Агент сам решает, нужен ли план: для простых задач действует сразу, для сложных — предлагает план |
| strict | План обязателен. Без утверждённого плана любые записи, правки и удаления запрещены; читать можно всегда |
| off | Планирование отключено, агент всегда работает в режиме действий |
Как выбрать
strict — для командной работы и сложных проектов; auto — баланс скорости
и контроля; off — для одноразовых задач и прототипов.
Гранулярные права¶
Права задаются для каждого инструмента с тремя вариантами действия:
| Действие | Поведение |
|---|---|
allow |
Выполняется без спроса |
deny |
Блокируется с пояснением причины |
ask |
Показывается вам на подтверждение |
Помимо отдельных инструментов можно задавать паттерны — например, для файлов и внешних каталогов. Пример правил:
permission:
"*": "allow" # всё разрешено по умолчанию
read:
"*": "allow"
"*.env": "ask" # секреты — спрашивать
"**/credentials.*": "deny" # файлы учётных данных — никогда
edit:
"*": "deny" # в режиме плана ничего не меняем
- Паттерны работают для чтения, записи, команд и внешних каталогов.
- Правило для конкретного пути/команды переопределяет общее.
- Права можно настраивать на лету: ответ на запрос подтверждения может разрешить действие один раз или на всю сессию.
Подтверждения и отказы¶
- При ответе «разрешить в сессии» действует разрешение на всю сессию: такие же вызовы больше не спрашивают, а разовое разрешение действует только на один вызов. Для обычных инструментов разрешение сохраняется по инструменту и путям, для команд-оболочки — каталогом (см. ниже); если постоянное правило выдать нельзя, вопрос повторится.
- При отказе обработка останавливается: файл не создаётся, а промежуточные результаты сохраняются в истории, чтобы вы могли продолжить с того же места.
Что показывает полоса подтверждения¶
Полоса подтверждения объясняет вопрос человеческим языком:
- Что вызвало вопрос. Вместо технического текста для модели видно, какой участок команды или пути вызвал вопрос; этот участок подсвечен.
- Команда и параметры. Команда показана отдельным блоком, остальные параметры — списком. Прежний технический текст спрятан в свёрнутые «Технические детали».
- Индикатор в дереве. Сессия, ждущая ответа, помечена в дереве сессий — цветом и подписью, а не только цветом.
Разрешение на сессию: каталогом¶
Когда вопрос вызван динамикой (путь собран из переменных или подстановок), ответ «Разрешить в сессии» даёт агенту доступ к каталогу-виновнику — тем каталогам, из-за которых возник вопрос, — на всю сессию, а не разовое разрешение на один вызов.
Шаблон «на всю команду» при этом не выдаётся: он шире того, что вы одобрили. Поэтому для изменения или удаления данных, для защищённого пути и для смены рабочего каталога постоянное правило не сохраняется вовсе — вопрос повторится при следующей попытке.
Разрешение не отменяет запреты
«Разрешить в сессии» снимает только динамический вопрос. Правила deny,
защищённые пути и опасные операции (удаление, изменение прав, выход за
периметр) остаются в силе. Если каталог-виновник определить не удалось,
постоянное правило не выдаётся: текущий вызов одобрен один раз, а
следующий спросит снова. Каждый выданный грант попадает в аудит.
Перезапуск инстанса¶
Ожидание подтверждения хранится на диске, поэтому перезапуск инстанса его не теряет:
- Полоса подтверждения восстанавливается с пометкой «Инстанс был перезапущен…».
- Ответ «разрешить» применяется как разрешение в сессии.
- Ответ «отклонить» снимает ожидание.
Что именно разрешит такой ответ, решается по той же схеме, что и в обычном ходе (см. выше): для динамики в пути — доступ к каталогу-виновнику на сессию, а для изменения или удаления данных, защищённого пути и смены рабочего каталога постоянное правило не выдаётся, и вопрос повторится при следующей попытке.
Подробнее — Обслуживание.
Наследование саб-агентами¶
Саб-агенты не получают больше прав, чем родительская сессия:
- Им передаются права родителя плюс собственные ограничения — включая запрет записи, если родитель в режиме плана.
- По умолчанию саб-агентам закрыты переспрашивание пользователя, вход/выход из плана и запуск других саб-агентов.
- Если саб-агенту нужно подтверждение, запрос приходит в родительскую сессию, а ответ применяется к дочерней.
MCP-инструменты и режимы¶
Доступность инструментов MCP можно ограничить по режимам: для каждого сервера и инструмента задаётся, доступен ли он в Plan и в Act. Недоступный в текущем режиме инструмент отклоняется.