Следы агента

Следы агентов из Claude Code, Codex, Pi, Hermes Agent и Factory Droid поддерживаются нативно на Hugging Face Hub. Загрузите исходные сессии в формате JSONL в Dataset или Storage Bucket, чтобы открыть их в специализированном просмотрщике следов. В Dataset следы отображаются в Data Studio, а в Storage Bucket можно открывать отдельные файлы .jsonl напрямую.

Найдите свои трассировки

Большинство поддерживаемых агентов записывают сессии в формате JSONL в локальные каталоги:

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

Hermes Agent хранит текущие сессии в своей базе данных сессий. Перед загрузкой экспортируйте сессии, которые вы хотите поделиться, в формате JSONL:

hermes sessions export session.jsonl --session-id <session_id>

Вы разрабатываете собственный harness? Если вашего агента нет в списке выше, вы можете обеспечить отображение его сессий в trace viewer, генерируя данные в формате Session Traces Format.

Файлы трассировки могут содержать промпты, входные данные инструментов, вывод команд, локальные пути, скриншоты, секреты, закрытый код и персональные данные. Перед публикацией проверьте и удалите из трассировок конфиденциальную информацию, либо сохраните датасет или бакет в режиме приватного доступа, если вы не уверены в содержимом.

Для сессий Pi Agent инструмент pi-share-hf помогает собирать сессии проекта, удалять известные секреты, запускать TruffleHog и LLM-проверку, а также загружать только те сессии, которые прошли проверки.

Самый простой способ загрузить данные — попросить об этом самого агента: укажите ему каталог или экспортированный файл JSONL, описанный выше, и попросите загрузить файлы .jsonl в набор данных или бакет на Hub.

Buckets особенно полезны, если вы хотите продолжать синхронизацию трасс по мере поступления новых сессий.

Загрузите свои трассировки

После создания набора данных или хранилища установите CLI hf с помощью рекомендуемого автономного установщика и войдите в систему. Установщик также настраивает Hugging Face CLI Skill, чтобы ваш агент для написания кода мог выполнять команды hf от вашего имени.

curl -LsSf https://hf.co/cli/install.sh | bash
hf auth login

hf upload <username>/<dataset-name> ~/.codex/sessions . --repo-type dataset
hf buckets sync ~/.codex/sessions hf://buckets/<username>/<bucket-name>/codex

Замените ~/.codex/sessions на соответствующий каталог сессий вашего агента или на каталог, содержащий файлы JSONL, экспортированные из Hermes Agent. Используйте hf upload для датасетов и hf buckets sync для бакетов, которые вы хотите обновлять по мере записи новых трассировок. Более короткая команда hf sync является псевдонимом для hf buckets sync.

Просмотр трассировок

После того как вы добавите трассировки в набор данных, откройте Data Studio и щёлкните по строке. Для трассировок в Storage Bucket перейдите к файлу .jsonl, который вы хотите просмотреть, и откройте его. Просмотрщик трассировок отображает временную шкалу сессии, промпты, сообщения ассистента, вызовы инструментов, вывод оболочки, блоки рассуждений и результаты.

В качестве публичного примера откройте TeichAI/DeepSeek-v4-Pro-Agent. Вы также можете просматривать другие наборы данных с меткой traces.