Buff Development
Buff CodeРабота в Buff Code

Сессия: поле ввода, режимы, вопросы

Разговор с агентом: поле ввода, режимы разрешений, запросы разрешения с предпросмотром правки, вопросы агента, вложения, фоновая работа, расход.

Сессия — один разговор с агентом в папке проекта. Вы пишете задачу, агент читает код, правит файлы и запускает команды, а под каждым ответом видно, что он сделал.

Агент добавил функцию и тест, тест сразу поймал ошибку — агент её поправил. Под ответом — сводка изменений хода.

Лента

  • «Использовано 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 вопросов», «Далее», «Назад», «Отправить».

Агент заметил, что в каталоге нет чая дороже 1000 ₽, и спросил, как понимать задачу, вместо того чтобы угадывать.

Фоновая работа

Долгую команду агент может запустить в фоне и продолжать работу. Пока такая работа идёт, в строке под полем ввода видно «1 фоновая задача выполняется»; щелчок открывает список.

Фоновая команда агента: сколько уже идёт, её вывод и остановка.
  • У каждой задачи — время работы, «Вывод» (весь вывод, дописывается, пока команда идёт) и «Стоп».
  • «Стоп» не будит агента. В ленту ложится отметка «Оболочка: отменено»; агент увидит её в следующем ходе.
  • Своя команда (!) или команда агента, пока выполняется, переводится в фон кнопкой «Перевести в фон» или Ctrl+B (на macOS — тоже Ctrl+B).

Остаток и расход

Остаток средств организации — в конце строки под полем ввода. Щелчок открывает «Баланс и расход»: на сколько дней хватит при расходе организации за 30 дней, тариф и цены за миллион токенов, оценка этой сессии в рублях, ваш расход за 30 дней — столбиками и по дням, «Открыть кабинет» и «Обновить». Нужен коннектор компании v0.18.0 или новее; с более старым окно скажет «коннектор компании не знает этот запрос — обновите его».

Баланс и расход: остаток, запас по дням, тариф, оценка этой сессии и ваш расход.
  • Когда средств мало, остаток жёлтый, когда они закончились — красный, а над полем ввода появляется полоса «Открыть кабинет / Подробнее / Скрыть».
  • Отказ хода из-за средств объясняется словами, с кнопкой «Баланс и кабинет».
  • Стоимость сессии — оценка по тарифу, а не счёт. Списания видны в кабинете, см. Модели и расход.

Сжатие сессии

Когда разговор становится длинным, его можно сжать: /compact. Свежая часть разговора сохраняется дословно, а более раннее агент пересказывает сводкой для себя. В ленте сжатие видно разделителем «Сессия сжата» с числом токенов; сводку можно открыть кнопкой «Сводка для модели».

В консоли

Консоль: та же сессия, что и в окне, — с делами, режимом и стоимостью в строке состояния.
ЧтоКак
режим разрешений/mode; текущий виден под полем ввода
планshift+tab — смена агента (Build ↔ Plan)
команда оболочки! в начале строки
фоновая работастрока под полем ввода, вкладки фоновой работы, ctrl+d — стоп
остатокстрока состояния главного экрана; /balance — подробно
большая вставка«[Вставленный текст · N строк]»

On this page