エージェントのトレース

Claude Code、Codex、Pi、Hermes Agent、Factory Droid からの Agent のトレースは、Hugging Face Hub でネイティブにサポートされています。生の JSONL セッションを Dataset または Storage Bucket にアップロードすると、専用のトレースビューアで開くことができます。Dataset では Data Studio でトレースを表示でき、Bucket では個々の .jsonl ファイルを直接開くことができます。

トレースを検索

サポートされているほとんどのエージェントは、JSONLセッションをローカルディレクトリに書き込みます:

これらのトレースファイルは標準でサポートされているため、修正や変換を行うことなくアップロードできます。

Hermes Agentは現在のセッションをセッションデータベースに保存します。共有したいセッションは、アップロード前にJSONLとしてエクスポートしてください。

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

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

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

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

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

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

トレースをアップロード

データセットまたはバケットを作成した後、推奨されるスタンドアロンインストーラーを使用してhf CLIをインストールし、ログインしてください。このインストーラーは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 を、お使いのエージェントに対応するセッションディレクトリ、または Hermes Agent からエクスポートされた JSONL ファイルを含むディレクトリに置き換えてください。データセットには hf upload を、新しいトレースが書き込まれるたびに更新したいバケットには hf buckets sync を使用します。より短い hf sync コマンドは、hf buckets sync のエイリアスです。

トレースを表示

データセットにトレースが格納されたら、Data Studio を開いて行をクリックします。Storage Bucket 内のトレースについては、確認したい .jsonl ファイルに移動して開きます。トレースビューアには、セッションのタイムライン、プロンプト、アシスタントのメッセージ、ツール呼び出し、シェル出力、推論ブロック、および結果が表示されます。

公開の例として、TeichAI/DeepSeek-v4-Pro-Agentを開いてください。tracesタグが付けられた他のデータセットも閲覧できます。