AgentsView может объединить журналы сессий агентов программирования из разных инструментов в один локальный архив с поиском. Это руководство для руководителя инженерной команды, которому нужно найти известную задачу, проверить поля использования, действительно записанные агентом, и определить источник каждого показателя стоимости.

Эта пошаговая инструкция основана на документации выпуска AgentsView v0.45.0 от 9 октября 2026 года и текущих руководствах по быстрому запуску и использованию токенов, проверенных 17 октября. BIG CHANGE не устанавливала AgentsView, не импортировала транскрипт и не проверяла эти шаги на практике. Уточните установленную версию: документация и списки выпусков могут меняться.

Перед началом

Нужна завершенная сессия агента программирования, которую вам разрешено читать, характерная фраза или ID сессии из этой задачи и разрешение на чтение ее локального каталога журналов. В Quick Start перечислены настольные загрузки для macOS, Windows и Linux, а также wheel-пакеты CLI для Linux x86_64 и aarch64, macOS x86_64 и arm64, Windows x86_64 и arm64. Настольное приложение уже упаковано; сборка из исходников имеет отдельные требования к Go, Node и CGO. Согласно быстрому запуску, для базового локального архивирования не нужны учетная запись размещенного сервиса или ключ API.

Журналы сессий могут содержать запросы, исходный код, входные данные инструментов и секреты. Выбирайте лишь каталоги, которые ваша команда разрешает проверять. Определите, какие провайдеры и корневые каталоги архив может считывать, до первого запуска: обычная команда agentsview serve сразу обнаруживает и синхронизирует поддерживаемые источники по умолчанию. Для этой проверки оставьте веб-интерфейс на документированном адресе обратной петли. Не включайте размещенную синхронизацию сырых данных, отправку в PostgreSQL или ClickHouse, публикацию в Gist, генерируемую аналитику или размещенную точку доступа эмбеддингов только ради этого вопроса. Семантический поиск необязателен; обычный полнотекстовый поиск работает с локальным индексом.

1. Установите и определите исполняемый файл

Выберите один способ из руководства по установке. Для самостоятельного CLI документированная постоянная установка через Python выглядит так:

Terminal
pip install agentsview
agentsview --version

Руководство также предлагает uvx agentsview для запуска без постоянной установки, установщики для отдельных платформ и настольные пакеты. В macOS пакет Homebrew cask связывает CLI, встроенный в приложение; для приложения, установленного из DMG, может потребоваться добавить каталог CLI в PATH. Прежде чем доверять версии, уточните, какой исполняемый файл находит оболочка. GitHub обозначает v0.45.0 как выпуск от 9 октября, но при разборе экранов и схемы отчета используйте собственный результат --version.

2. Ограничьте источники до первой синхронизации

Для установки CLI или настольного приложения на хосте подготовьте новый каталог данных и его config.toml до запуска AgentsView. Руководство по настройке описывает disabled_agents для исключения локальных провайдеров файловой системы и [agents.<id>].dirs для замены корневых каталогов одного провайдера по умолчанию. Перечислите ID всех остальных провайдеров из таблицы Session Discovery этого руководства в disabled_agents, а параметр dirs единственного разрешенного провайдера задайте равным одобренному корневому каталогу. Например, [agents.codex] вместе с dirs = ["/approved/codex/sessions"] заменяет стандартные каталоги Codex; измените путь под свою систему. Если полного списка исключений нет, пока не запускайте демон на хосте. Переопределение только CODEX_SESSIONS_DIR или CLAUDE_PROJECTS_DIR меняет корневой каталог этого провайдера, но не отключает стандартное обнаружение остальных.

Используйте новый AGENTSVIEW_DATA_DIR для этой проверки, если существующий архив уже может содержать несвязанные сессии. Руководство по настройке говорит, что ранее архивированные сессии отключенных провайдеров остаются доступны, поэтому изменение настройки не очищает старый архив. Также disabled_agents охватывает локальное обнаружение и наблюдение, но не удаленные импорты или экспорты; для этой локальной задачи оставьте удаленные хосты и места экспорта ненастроенными.

Изолированный контейнер — альтернатива, если вести список исключений всех остальных провайдеров непрактично. Пример Docker в Quick Start публикует интерфейс только на 127.0.0.1, монтирует один источник агента только для чтения и использует отдельный том данных. Монтируйте только разрешенный корневой каталог источника и задайте соответствующую переменную каталога внутри нового контейнера; не включайте остальные монтирования из примера Compose проекта. Контейнер видит лишь явно смонтированные каталоги сессий хоста. Опубликованные образы Docker охватывают Linux amd64 и arm64; для этого пути нужна работающая установка Docker.

3. Создайте локальный архив

Для CLI хоста с ограниченными источниками запустите документированный сервер на переднем плане:

Terminal
agentsview serve

После применения и проверки области источников на шаге 2 это инициализирует ~/.agentsview/sessions.db или выбранный каталог данных, обнаруживает журналы включенных агентов, синхронизирует их, отслеживает изменения и открывает http://127.0.0.1:8080. Оставьте этот терминал открытым. Если нужен фоновый процесс, используйте agentsview daemon start и agentsview daemon status; настольное приложение управляет собственным бэкендом. Совместимый сервер, который уже работает, может просто сообщить свой URL; поэтому проверьте, запущен ли демон, прежде чем считать, что новая конфигурация управляла сбором данных.

Если выбран изолированный контейнер, проверьте его единственное монтирование источника только для чтения и новый том данных, затем запустите документированной командой Docker. Используйте его интерфейс обратной петли и выполняйте последующие отчеты CLI agentsview внутри этого контейнера, чтобы они читали тот же архив. Не запускайте параллельно на хосте serve без ограничения источников.

Убедитесь, что источник известной задачи появился, а нежелательные провайдеры не появились. Если сессия отсутствует, проверьте одобренный путь, настройку провайдера и состояние синхронизации, прежде чем заключать, что сессии нет. Выполните agentsview sync, когда перед отчетом нужно включить недавно измененные файлы; сервер также отслеживает изменения. Перед каждой полной повторной синхронизацией снова проверяйте настроенную область.

4. Найдите задачу и проверьте транскрипт

В веб-интерфейсе используйте Ctrl/Cmd+K для буквального поиска характерной фразы из известной задачи. Ограничьте список проектом, агентом или датой, откройте подходящий результат и проверьте сообщения и вызовы инструментов. Если полный ID сессии или UUID уже известен, Ctrl/Cmd+G открывает ее напрямую. Эти элементы управления описаны в Quick Start. Запишите агента, ID сессии и дату, чтобы связать результат использования с правильным разговором.

Если буквальный поиск не находит задачу, попробуйте более короткую фразу и убедитесь, что исходный агент записал локальный транскрипт в каталог, доступный AgentsView. Задачу, существующую лишь в удаленном сервисе, неподдерживаемом формате или каталоге вне настроенных корневых каталогов, не вернуть более упорным поиском. Не включайте семантическую индексацию или загрузку транскрипта как обычное исправление отсутствующего локального источника.

5. Проверьте поля использования сессии

Откройте представление использования найденной сессии и определите присутствующие записанные поля модели, ввода, вывода, создания кэша и чтения из кэша. Руководство по использованию токенов называет отчетность о стоимости экспериментальной и еще развивающейся. AgentsView считывает метаданные модели и токенов из исходных журналов и сохраняет сырые данные использования токенов в строках сообщений. Если источник явно сообщает стоимость, используется она; иначе стоимость вычисляется из доступных токенов и тарифов модели. В JSON сведения о происхождении называют эти случаи reported, computed или mixed.

Если нужен сохраненный машиночитаемый отчет для этой одной сессии, пример CLI проекта использует agentsview session usage SESSION_ID --format json. Замените SESSION_ID на ID, проверенный в транскрипте, и сохраните JSON вместе с заметкой о задаче. Прежде чем цитировать итоговую сумму, проверьте в этом выводе указанную модель, категории токенов и источник стоимости.

Считайте пустое поле или отсутствующую модель неизвестными. AgentsView не может восстановить использование, которое агент никогда не записывал. В примечаниях к выпуску сказано, что импорт Junie CLI исключает разговоры и вызовы инструментов, существующие только в IDE, а резервный импорт обычного текста Antigravity содержит транскрипт без использования токенов или стоимости. Это конкретные примеры того, почему доступная для поиска сессия не обязательно имеет полную сумму расходов. Сообщенная источником сумма также может относиться ко всей сессии, тогда как распределение по моделям остается оценочным.

6. Ограничьте дневной отчет

Используйте фильтры даты, проекта и агента на странице Usage, чтобы посмотреть день сессии. Страница также предлагает таблицу Top Sessions by Cost со ссылками на отдельные транскрипты. Для проверяемого отчета в терминале подставьте местную дату сессии и имя агента в:

Terminal
agentsview usage daily --since YYYY-MM-DD --until YYYY-MM-DD --agent codex --breakdown

Дневная таблица разделяет некэшированный ввод, вывод, создание кэша и чтение из кэша; строки по моделям появляются, когда задан --breakdown. Дата группируется по системному часовому поясу, если не указан --timezone. В дневной итог могут входить другие сессии того же агента; это проверка охвата и масштаба, а не стоимость одной задачи. Сохраните ID сессии рядом с дневным отчетом и проверьте, какие строки действительно относятся к ней.

Для отчета без получения каталога цен добавьте --offline. По словам AgentsView, это читает существующий архив без синхронизации источников или запуска демона и использует встроенные резервные цены. Если важны недавние изменения сессии, сначала обновите архив; офлайн-отчет не может обнаружить новые журналы. Обычные команды использования могут запрашивать цены LiteLLM и OpenRouter, а встроенный каталог устаревает вместе с установленным выпуском.

7. Интерпретируйте сумму и остановите службу

Помечайте каждую сумму согласно ее происхождению. Computed означает, что AgentsView умножил записанные токены на выбранные тарифы. Reported означает, что источник явно сообщил стоимость. Mixed означает, что отчет объединяет разные виды. Даже сумма, сообщенная источником, не доказывает, что счет провайдера за всю учетную запись сверен. Независимо сравните собственные платежные документы или данные тарифного плана соответствующего провайдера, особенно когда важны уровни обслуживания, скидки или включенные в подписку объемы. Документация AgentsView говорит, что не может определить цены Batch, Flex, Priority, региональные цены или цены часового кэширования, если сохраненные данные использования не указывают этот уровень. Некоторые токены на стороне инструментов отсутствуют в локальных транскриптах.

Проверка успеха — найденный транскрипт, в котором агент, ID и дата совпадают с выбранным представлением использования, с записанными доступными полями модели и токенов и неизвестными значениями для недоступных. Результат — локальный архив с поиском и заметка об использовании задачи или дня с ограниченным охватом, а не счет. Остановите работающий на переднем плане agentsview serve с помощью Ctrl+C или остановите фоновый сервер командой agentsview daemon stop. В Quick Start сказано, что остановка демона останавливает и веб-интерфейс, и наблюдение за сессиями.

Большая перемена

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

Источники и дополнительное чтение

  • Примечания к выпуску AgentsView v0.45.0: датированные изменения охвата агентов, карточек Usage, синхронизации и поведения цен. Примечание к выпуску — запись поставщика, а не тест BIG CHANGE.
  • AgentsView Quick Start: поддерживаемые способы установки, команды сервера и демона, настройка источников и управление локальным поиском.
  • Настройка AgentsView: обнаружение источников, исключение провайдеров, расположение архива и ограничения этих настроек.
  • Использование токенов и стоимость в AgentsView: охват источников, отчеты об использовании, происхождение цен, офлайн-режим и известные ограничения отчетности.
  • Репозиторий AgentsView: исходный код и лицензия MIT; репозиторий описывает стандартный архив как локальный.