Перейти к содержанию

Режимы и права

Режим сессии определяет, что агенту разрешено в целом, а гранулярные права — что можно делать конкретным инструментам и с какими файлами. Оба механизма работают вместе.

Режимы сессии

Режим — глобальное состояние сессии, а не отдельный агент: при переключении меняется набор доступных инструментов, но роль и инструкции агента остаются прежними.

Режим Поведение Кто переключает
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. Недоступный в текущем режиме инструмент отклоняется.

Что дальше