Документация/Агент
Режимы агента
«Авто», «Полный», «План» и «Без ограничений»: что агент в каждом режиме делает сам, о чём спрашивает и как переключить режим.
Режим задаёт, как часто агент спрашивает разрешения. В режиме «Авто» он спрашивает перед рискованным, в «Полном» — только перед самым опасным. В «Плане» агент только планирует и ничего в проекте не меняет. Режим «Без ограничений» вы включаете для одного чата, когда доверяете агенту работу без присмотра.
Примечание
Режим «Авто» и модель «Авто» — разные вещи. Режим определяет, о чём агент вас спрашивает. Модель «Авто» сама подбирает модель под каждый шаг, её выбирают в переключателе модели. Подробнее — на странице Модели.
Как переключить
- Нажмите на переключатель режима справа под полем ввода — у него подсказка «Режим агента».
- В меню «Режим агента» выберите режим. У каждого пункта написано, о чём агент спросит.
- Для «Полного» и «Без ограничений» подтвердите выбор в окне предупреждения. В новом чате пункта «Без ограничений» нет, пока не отправите первое сообщение.
Переключатель меняет режим только этого чата. Если уйти в другой раздел и вернуться, режим сохранится. Последняя строка меню, «Что на какой ступени →», открывает «Настройки → Безопасность агента».
Режимы
| Режим | Что делает агент | О чём спрашивает |
|---|---|---|
| «Авто» | Сам принимает решения. | Спросит перед рискованным и необратимым. |
| «Полный» | Работает сам. | Спросит про удаление, prod, базы, деньги, ключи и навыки. |
| «План» | Уточняет детали, пишет спеку и план. Файлы проекта не меняет. | Спрашивает так же, как в «Авто». |
| «Без ограничений» | Работает без присмотра, только в этом чате. | Спросит лишь о секретах, навыках, удалении корня диска и стирании дисков. |
Действия на ступени «Запрещено» агент не сделает ни в одном режиме. Ступень каждого действия видна в «Настройки → Безопасность агента → Действия», а как ступени связаны с режимами — в разделе ниже.
«Авто»
Режим по умолчанию. Агент сам правит и собирает проект, запускает тесты и работает с git на вашем компьютере. Перед
рискованными, но обычными в работе действиями он спросит разрешения: например, перед sudo, push в защищённую ветку,
удалением файлов вне проекта или запуском команды вне песочницы. Спросит он и перед необратимым.
Какие ветки считать защищёнными, задаёт список «Защищённые ветки» в «Настройки → Безопасность агента → Действия»;
если список не задан, защищены main, master и release/*. Песочница — средство операционной системы: она не даёт
команде агента писать вне разрешённых папок и ходить в сеть мимо списка. По умолчанию песочница выключена. Подробнее о
ней — на странице Ограничения агента.
«Полный»
Агент сам делает то, о чём в «Авто» спросил бы: sudo, push в защищённые ветки, изменения на stage и в облаках.
Спрашивает только о самом опасном. По умолчанию это удаление, prod, базы данных, деньги, ключи и файлы .env, права
доступа в облаках, публикация пакетов, данные других программ и выключение компьютера. Перед установкой и удалением
навыка агент спрашивает всегда.
Относится ли кластер к stage или prod, решает его метка окружения. Пока вы не выбрали метку, приложение угадывает её по адресу и имени кластера. Подробнее о метках — на странице Доступ к базам и кластерам.
Когда вы включаете режим, появляется окно «Включить режим «Полный»?». С галочкой «Больше не спрашивать» окно пропадёт, и дальше режим будет включаться сразу. Чтобы вернуть предупреждение, откройте «Настройки → Безопасность агента → Исключения» и в блоке «Предупреждения режимов» нажмите «Спрашивать снова».
Включайте «Полный» для работы, которую готовы доверить агенту без присмотра.
«План»
Агент задаёт уточняющие вопросы, пишет план и показывает карточку «План готов». Файлы проекта он не меняет, а команды запускает только после вашего ответа. Когда вы нажмёте «Начать выполнение», чат сам перейдёт в режим «Авто». Подробнее — на странице Режим «План».
«Без ограничений»
Важно
В этом режиме агент почти не спрашивает разрешений. Команды запускаются без песочницы, сеть открыта. Писать в базы данных и менять рабочие кластеры агент может без карточки.
- Режим действует в одном чате, и включить его можно только в уже начатом. Другие чаты работают как раньше.
- Сначала появится предупреждение «Работать без ограничений в этом чате?» — нажмите в нём «Работать без ограничений».
- Пока режим включён, над лентой видна полоса «Агент работает без ограничений в этом чате» с кнопкой «Выключить».
- Режим выключится, если нажать «Выключить», выбрать в меню другой режим или закрыть приложение. Режимом по умолчанию его сделать нельзя.
Даже здесь ключи, пароли и файлы .env закрыты: открыть .env, вывести переменные окружения или ключи агент может
только с вашего разрешения. Спросит он и перед тем, как удалить корень диска или домашнюю папку, стереть диск,
установить или удалить навык. Ограничения организации действуют и в этом режиме.
Режим новых чатов
Новые чаты открываются в режиме «Авто». Чтобы они сразу начинались в «Полном», откройте «Настройки → Безопасность агента», перейдите на вкладку «Действия» и в строке «Режим новых чатов» выберите «Полный». Переключатель в чате по-прежнему меняет только этот чат.
Ступени: что решает режим
Каждое действие агента стоит на одной из четырёх ступеней. От режима зависит, с какой ступени агент вас спрашивает.
| Ступень | «Авто» и «План» | «Полный» | «Без ограничений» |
|---|---|---|---|
| «Запрещено» | не делает | не делает | не делает |
| «Спрашивать всегда» | спросит | спросит | сделает сам, кроме самого опасного |
| «Спрашивать в Авто» | спросит | сделает сам | сделает сам |
| «Без вопросов» | сделает сам | сделает сам | сделает сам |
Ступень каждого действия видна в «Настройки → Безопасность агента → Действия», там её и меняют. Туда же можно вставить команду и проверить, что с ней сделает каждый режим. Подробнее — на странице Ограничения агента.
Субагенты работают с правами своего чата: в «Полном» чате субагент тоже делает сам то, что «Полный» разрешает.
Ограничения
- Организация может запретить режимы «Полный» и «Без ограничений». Запрещённый «Без ограничений» в меню серый, с подписью «Запрещено организацией» или с пояснением организации. Если запрещён «Полный», новые чаты открываются в «Авто». Подробнее — на странице Организации.
- Если на компьютере нет системной связки ключей, выбор в «Режиме новых чатов» действует до закрытия приложения.
Что дальше
- Режим «План» — вопросы, план и карточка «План готов».
- Разрешения и вопросы — как отвечать на карточки агента.
- Ограничения агента — песочница, сеть, файлы.
- Модели — модель «Авто» и выбор модели.
Обновлено · Нашли неточность? Напишите на support@devmachine.ai или в Telegram.