Сессия: поле ввода, режимы, вопросы
Разговор с агентом: поле ввода, режимы разрешений, запросы разрешения с предпросмотром правки, вопросы агента, вложения, фоновая работа, расход.
Сессия — один разговор с агентом в папке проекта. Вы пишете задачу, агент читает код, правит файлы и запускает команды, а под каждым ответом видно, что он сделал.
Лента
- «Использовано N — …» — какие инструменты агент вызвал между репликами: «Чтение», «Редактировать», «Оболочка», «Список дел», «База знаний: запись» и другие. Щелчок раскрывает вызовы с их результатом.
- Ответ агента — обычным текстом с разметкой. Пути файлов в нём — ссылки.
- Сводка изменений хода — под ответом, если ход менял файлы: «Изменено 2 файла +23 −1» и «Откатить ход». Подробно — Изменения и откат.
- Служебные отметки — свёрнутой строкой: смена агента, сжатие сессии, отметки цели.
Поле ввода
Под полем — строка управления:
| Элемент | Что делает |
|---|---|
| + | меню: «Изображения и файлы» (Ctrl+U), «Команды» (/), «Контекст» (@), «Команда оболочки» (!) |
| Режим («Править сам») | сколько агенту можно без вопросов — см. ниже |
| План | агент только составляет план и ничего не меняет, пока вы его не утвердите — см. План и цель |
| Модель | модель организации, которой ответит агент. Список — Модели и расход |
| ◆ организация › проект | рабочий контекст: чьи знания, репозитории и подключения видит агент. Сменить — Вход и рабочий контекст |
| ⎇ ветка ±N | ветка Git и число изменённых файлов; щелчок открывает окно Git |
| остаток, ₽ | средства организации; щелчок открывает «Баланс и расход» — см. ниже |
/— команды: встроенные (/goal,/side,/compact,/undo…), свои команды проекта и навыки. Команда без аргументов выполняется по Enter; у команды с необязательным текстом (/side,/goal) первый Enter вставляет её в поле — допишите текст или нажмите Enter ещё раз.@— файл или папка проекта как часть сообщения; агент получит их содержимое.!— команда оболочки от вас, без агента:!bun test. Она выполняется в папке проекта, а вывод сразу виден в ленте и попадает в контекст агента.
Карта запросов
У длинной сессии слева от ленты — риски карты запросов, по одной на каждое ваше сообщение. Наведение показывает запрос и начало ответа, щелчок переносит к нему.
Вложения и цитаты
- Картинки и файлы — кнопкой, перетаскиванием или вставкой из буфера. У каждой — миниатюра; щелчок открывает просмотр. Если модель не читает картинки сама, вложение уходит файлом, и подсказка у плашки это объясняет: «Модель не читает картинки сама — откроет файл инструментами». Ограничения на число вложений нет.
- Большая вставка — от трёх строк или больше 150 символов — ложится чипом «Вставленный текст · N строк». Щелчок показывает текст целиком; его можно «Развернуть в текст» или удалить. Модель получает вставку целиком.
- Цитата из ответа — выделите фрагмент в ответе агента, рядом появится кнопка «Добавить в сообщение». В поле ляжет чип «Из ответа · N строк», агент получит фрагмент цитатой.
Режимы разрешений
Режим — правила текущей сессии: что агент делает без вопросов, а о чём спрашивает. Выбираете
режим вы — в поле ввода или командой /mode; агент его не меняет. Организация режим не
закрепляет: это настройка разработчика. Новая сессия начинается с режима, выбранного последним.
| Режим | Что агент делает сам | О чём спрашивает |
|---|---|---|
| Спрашивать | читает и ищет | перед каждой правкой файла и каждой командой |
| Править сам | правит файлы проекта | перед командами оболочки |
| Полный доступ | правит и запускает команды в проекте | за пределами проекта и перед файлами .env |
Запрос разрешения
Когда агенту нужно разрешение, над полем ввода появляется запрос: команда целиком, а у правки файла — сама правка, как в диффе, — и три кнопки.
- Разрешить один раз — только это действие.
- Разрешить всегда — запомнить для проекта. Под командой написано, что именно запомнится:
«„Всегда“ запомнит для этого проекта: команды
cat *,echo *». - Запретить — с полем «Что сделать вместо этого». Текст уходит агенту, ход продолжается: агент сделает по-вашему, а не остановится.
Запрос от субагента помечен «от субагента».
Вопросы агента
Если в задаче не хватает решения, агент спрашивает — карточкой над полем ввода. У вопроса варианты ответа с пояснением, свой ответ можно написать в последней строке. Вопросов может быть несколько: «1 из 2 вопросов», «Далее», «Назад», «Отправить».
Фоновая работа
Долгую команду агент может запустить в фоне и продолжать работу. Пока такая работа идёт, в строке под полем ввода видно «1 фоновая задача выполняется»; щелчок открывает список.
- У каждой задачи — время работы, «Вывод» (весь вывод, дописывается, пока команда идёт) и «Стоп».
- «Стоп» не будит агента. В ленту ложится отметка «Оболочка: отменено»; агент увидит её в следующем ходе.
- Своя команда (
!) или команда агента, пока выполняется, переводится в фон кнопкой «Перевести в фон» или Ctrl+B (на macOS — тоже Ctrl+B).
Остаток и расход
Остаток средств организации — в конце строки под полем ввода. Щелчок открывает «Баланс и расход»: на сколько дней хватит при расходе организации за 30 дней, тариф и цены за миллион токенов, оценка этой сессии в рублях, ваш расход за 30 дней — столбиками и по дням, «Открыть кабинет» и «Обновить». Нужен коннектор компании v0.18.0 или новее; с более старым окно скажет «коннектор компании не знает этот запрос — обновите его».
- Когда средств мало, остаток жёлтый, когда они закончились — красный, а над полем ввода появляется полоса «Открыть кабинет / Подробнее / Скрыть».
- Отказ хода из-за средств объясняется словами, с кнопкой «Баланс и кабинет».
- Стоимость сессии — оценка по тарифу, а не счёт. Списания видны в кабинете, см. Модели и расход.
Сжатие сессии
Когда разговор становится длинным, его можно сжать: /compact. Свежая часть разговора
сохраняется дословно, а более раннее агент пересказывает сводкой для себя. В ленте сжатие видно
разделителем «Сессия сжата» с числом токенов; сводку можно открыть кнопкой «Сводка для модели».
В консоли
| Что | Как |
|---|---|
| режим разрешений | /mode; текущий виден под полем ввода |
| план | shift+tab — смена агента (Build ↔ Plan) |
| команда оболочки | ! в начале строки |
| фоновая работа | строка под полем ввода, вкладки фоновой работы, ctrl+d — стоп |
| остаток | строка состояния главного экрана; /balance — подробно |
| большая вставка | «[Вставленный текст · N строк]» |
Окно и список сессий
Как устроено окно Buff Code: главная, колонка сессий с закреплением, группами и архивом, состояние сессии словом, поиск по названию и по переписке.
Изменения и откат
Что агент изменил за ход и как это вернуть: сводка под ответом, дифф, безопасный откат с проверкой чужих правок, дерево и просмотр файлов.