Сессии разработки
Запись работы разработчика с моделью в Buff Code: кому она нужна, из чего состоит, что записывается и что нет, кто видит и где что искать.
Работа Buff Code записывается на стороне Buff целиком. Запись ведёт сам Buff Code: каждое сообщение сессии, рассуждение, вызов инструмента и его результат он пишет в свою базу и тут же — в Buff; сервер, через который идёт каждый запрос к модели, добавляет к ходу модель, токены и списание. Разработчику ничего для этого не нужно настраивать.
Раздел кабинета «Сессии разработки» показывает эти записи: список сессий с итогами за период, каждую сессию по шагам — с полосой хода, лентой и инспектором действия — и вкладку «Вопросы», где по записям можно спрашивать модель.
Кому это нужно
| Кто | Зачем открывает раздел | С чего начать |
|---|---|---|
| Руководитель | Кто из команды работает с моделью, сколько ходов и токенов ушло, во что это обошлось — по периоду, проекту и разработчику, без расспросов. Что модель делала в конкретной сессии: какие команды запускала, какие файлы правила, где ошибалась. | Найти сессию, затем Спросить по сессиям |
| Разработчик | Вспомнить, что делала модель вчера и почему; показать коллеге сессию с решением, а не пересказывать; задать вопрос по записи — «что осталось незакрытым». | Прочитать сессию, Что именно делал агент |
| Информационная безопасность | Что именно ушло к модели — дословно, вызов за вызовом; кто смотрел чужие сессии и кто их выгружал — по журналу аудита. | Что именно делал агент, Журнал аудита и Buff Code |
Словарь раздела
Термины ниже — те же, что в интерфейсе; страницы раздела пользуются ими без пояснений.
| Термин | Что это |
|---|---|
| Сессия | Одна сессия Buff Code у разработчика — одна запись в кабинете. Называется по первой строке первого сообщения разработчика; если текста в сессии нет — «Вызовы без сохранённого текста». |
| Ход | Один запрос Buff Code к модели и её ответ. У хода есть модель, статус, длительность, токены по видам и списанная сумма. Ответ на одно сообщение разработчика часто занимает несколько ходов: модель вызвала инструмент, получила результат, спросила снова. |
| Действие | Вызов инструмента вместе с результатом, который на него пришёл: «Запустил make test», «Изменил src/api.py», «Искал в справочнике». В ленте — одна строка под ответом модели; в инспекторе — целиком. |
| Шаг | Одна метка на полосе хода: сообщение разработчика или одно действие. Подпись «шаг 12 из 40» считает именно их. |
| Служебный вызов | Ход, который Buff Code сделал не по работе, а для себя: придумать название сессии, сжать контекст. Записывается, как и остальные, но в ленте по умолчанию скрыт. |
| Полоса хода | Полоса под шапкой сессии: метка на каждый шаг, цвет по виду действия, ошибки красным. Клик или стрелки ведут к шагу. |
| Инспектор | Правая колонка (на телефоне — нижняя шторка) с выбранным действием целиком и вкладкой «Файлы». |
Что записывается
Сессия хранится целиком, в том виде, в каком её ведёт Buff Code:
- слова разработчика и приложенные к ним файлы;
- что пришло от модели: текст ответа, рассуждение, вызовы инструментов с аргументами и результат каждого вызова — содержимое прочитанных файлов, вывод команд, ответы подключений;
- кто и где: разработчик, устройство, организация, проект;
- сколько — у каждого хода: модель, статус ответа, длительность, токены — вход, выход, рассуждение, кэш (чтение и запись) — и сколько списано.
Неудачный ход (отказ модели, обрыв, отказ из-за баланса) тоже сохраняется и не списывается. Служебные вызовы — название сессии, сжатие контекста — считаются и списываются наравне с рабочими; сжатие видно в ленте как служебное сообщение.
Что не записывается и что не показывается
Не записывается то, что не уходит к модели: файлы на диске, которые Buff Code ей не передавал; команды терминала и их вывод, если их не отдали модели; правки, которые разработчик внёс руками. Пароли и токены подключений в записи не бывает — они не покидают коннектор.
Не записывается и не показывается: системный промпт и описания инструментов, которые Buff Code добавляет к каждому запросу, и параметры самого запроса к модели. Их нет ни в инспекторе, ни в выгрузке: запись хранит работу разработчика с моделью — что он просил, что модель ответила и сделала, — а не внутреннее устройство Buff Code.
Где хранится и кто видит
Записи хранятся в Buff, в данных вашей организации, на тех же условиях, что остальные материалы организации (см. Безопасность). Они не удаляются: при уходе сотрудника его сессии остаются у организации.
| Кто | Что видит |
|---|---|
| Разработчик | свои сессии |
| Владелец организации | сессии всех разработчиков организации |
Участник, который откроет чужую сессию, получит отказ: «Чужие сессии разработки видит только владелец организации». Владелец, открыв чужую сессию, видит предупреждение «Чужая сессия»: просмотр и выгрузка записываются в журнал аудита.
Карта раздела
| Страница | О чём |
|---|---|
| Найти сессию | Фильтры по периоду, разработчику и проекту; «Итого за выбранное»; как читается строка списка; «Спросить по выборке» |
| Прочитать сессию | Шапка и метрики; полоса хода; лента сообщений и действий; служебные вызовы; «Следить» и «Идёт»; раскладка на телефоне |
| Что именно делал агент | Инспектор: виды действий и что показывает каждый; статусы; «Вызов и результат как есть»; вкладка «Файлы» |
| Спросить по сессиям | Три способа задать вопрос; что получает модель; как читать ответ; кто видит; расход и журнал |
| Выгрузка | Markdown и JSON: что в файле, пример, что не входит |
| Журнал аудита и Buff Code | Какие события вокруг Buff Code попадают в журнал аудита, с какой важностью, и какие — нет |
Репозитории проекта
Модель в Buff Code ищет и читает код проекта в Buff без клона на машине: поиск файлов, поиск по содержимому и чтение по любой ветке, только на чтение.
Найти сессию
Список сессий разработки: фильтры по периоду, разработчику и проекту, «Итого за выбранное», как читается строка, пустые состояния, «Спросить по выборке».