Agent 轨迹

来自 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来使其会话在跟踪查看器中渲染。

Trace 文件可能包含提示词、工具输入、命令输出、本地路径、截图、密钥、私有代码和个人数据。在公开发布之前，请审查并编辑 Trace 文件以移除敏感信息；如果不确定其中包含的内容，请保持数据集或存储桶为私有。

对于 Pi Agent 会话，pi-share-hf 可以帮助收集项目会话、编辑已知密钥、运行 TruffleHog 和 LLM 审查，并仅上传通过检查的会话。

最简单的上传方式是直接让智能体自行操作：将上述目录或导出的 JSONL 文件指向它，并告诉它将 .jsonl 文件上传到 Hub 数据集或存储桶。

如果您希望在新会话到达时持续同步跟踪数据，桶（Buckets）会特别有用。

上传您的跟踪

创建数据集或存储桶后，使用推荐的独立安装程序安装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 替换为与您的 agent 匹配的会话目录，或替换为包含从 Hermes Agent 导出的 JSONL 文件的目录。对于数据集，请使用 hf upload；对于需要在新 trace 写入时更新的 bucket，请使用 hf buckets sync。较短的 hf sync 命令是 hf buckets sync 的别名。

查看您的跟踪

当数据集中包含追踪记录后，打开 Data Studio 并点击某一行。对于存储在 Storage Bucket 中的追踪记录，请导航至要检查的 .jsonl 文件并打开它。追踪查看器会显示会话时间线、提示词、助手消息、工具调用、Shell 输出、推理块以及结果。

以公开示例为例，打开 TeichAI/DeepSeek-v4-Pro-Agent。您还可以浏览更多标记为 traces 的数据集。