# Следы агента

Следы агентов из Claude Code, Codex, Pi, Hermes Agent и Factory Droid поддерживаются нативно на Hugging Face Hub. Загрузите исходные сессии в формате JSONL в [Dataset](https://huggingface.co/datasets?format=format%3Aagent-traces) или [Storage Bucket](./storage-buckets), чтобы открыть их в специализированном просмотрщике следов. В Dataset следы отображаются в Data Studio, а в Storage Bucket можно открывать отдельные файлы `.jsonl` напрямую.

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

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

| Агент         | Локальный каталог сессии      |
| ------------- | ---------------------------- |
| Claude Code   | `~/.claude/projects`         |
| Codex         | `~/.codex/sessions`          |
| Архив Codex | `~/.codex/archived_sessions` |
| Factory/Droid | `~/.factory/sessions`        |
| Pi            | `~/.pi/agent/sessions`       |

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

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

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

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

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

Для сессий Pi Agent инструмент [`pi-share-hf`](https://github.com/badlogic/pi-share-hf) помогает собирать сессии проекта, удалять известные секреты, запускать TruffleHog и LLM-проверку, а также загружать только те сессии, которые прошли проверки.

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

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

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

После создания набора данных или хранилища установите CLI `hf` с помощью [рекомендуемого автономного установщика](/docs/huggingface_hub/guides/cli#getting-started) и войдите в систему. Установщик также настраивает [Hugging Face CLI Skill](./agents-cli), чтобы ваш агент для написания кода мог выполнять команды `hf` от вашего имени.

```bash
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`](https://huggingface.co/datasets/TeichAI/DeepSeek-v4-Pro-Agent). Вы также можете просматривать другие наборы данных с меткой [`traces`](https://huggingface.co/datasets?format=format%3Aagent-traces).