# エージェントのトレース

Claude Code、Codex、Pi、Hermes Agent、Factory Droid からの Agent のトレースは、Hugging Face Hub でネイティブにサポートされています。生の JSONL セッションを [Dataset](https://huggingface.co/datasets?format=format%3Aagent-traces) または [Storage Bucket](./storage-buckets) にアップロードすると、専用のトレースビューアで開くことができます。Dataset では Data Studio でトレースを表示でき、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>
```

独自のハーネスを構築していますか？上記にリストされていないエージェントの場合、[Session Traces Format](./session-traces-format)を出力することで、そのセッションをトレースビューアに表示できます。

トレースファイルには、プロンプト、ツールの入力、コマンドの出力、ローカルパス、スクリーンショット、シークレット、非公開コード、個人データが含まれる場合があります。公開する前にトレースを確認し、機密情報を削除してください。中身が不明な場合は、データセットまたはバケットを非公開にしてください。

Pi Agent セッションでは、[`pi-share-hf`](https://github.com/badlogic/pi-share-hf) を使用して、プロジェクトのセッションを収集し、既知のシークレットをマスクし、TruffleHog と LLM によるレビューを実行し、チェックに合格したセッションのみをアップロードできます。

アップロードする最も簡単な方法は、エージェント自身に指示することです。上記のディレクトリまたはエクスポートされたJSONLファイルを指定し、`.jsonl`ファイルをHubのデータセットまたはバケットにアップロードするように指示してください。

バケットは、新しいセッションが到着するたびにトレースの同期を継続的に維持したい場合に特に役立ちます。

## トレースをアップロード

データセットまたはバケットを作成した後、[推奨されるスタンドアロンインストーラー](/docs/huggingface_hub/guides/cli#getting-started)を使用して`hf` CLIをインストールし、ログインしてください。このインストーラーは[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` を、お使いのエージェントに対応するセッションディレクトリ、または Hermes Agent からエクスポートされた JSONL ファイルを含むディレクトリに置き換えてください。データセットには `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)タグが付けられた他のデータセットも閲覧できます。