Skip to main content

查看 Run Dataset

pChronicle 使用同一套接口读取本地、对象存储或dataset pin 指向的 Agent 运行记录。本页中的 浏览、find、analysis 和 query 命令都是只读的。

1. 不准备数据，直接体验​

pchronicle onboard

Walkthrough 会创建临时示例 Dataset，并依次介绍主要命令。也可以直接跳到查询：

pchronicle onboard query

两条命令都不要求源码 checkout，也不要求已有 Dataset。

2. 浏览已有的 Dataset​

onboarding 创建的 Dataset 是临时数据，Walkthrough 结束后会被清理。要进行持久查询，请把下面的命令替换为你已有的 Dataset 路径；如果还没有数据，完成 onboarding 查询后继续阅读发现并查询自己的 Dataset即可。

Dataset 可以是本地路径、对象存储 URI 前缀，或 @prod 这样的dataset pin：

pchronicle list ./trajectory-data
pchronicle stats overview ./trajectory-data

list（ls）显示 pChronicle 可以使用的 Run 数据；stats overview 无需编写 SQL，即可给出稳定汇总。

需要定位具体内容时，使用统一的 find --match 语法：

pchronicle find ./trajectory-data --match "timeout" --format json
pchronicle find ./trajectory-data --match '#system("retry")'

3. 提出一个具体问题​

pchronicle query ./trajectory-data \
  --sql 'SELECT source, COUNT(*) AS steps
         FROM dataset.steps
         GROUP BY source
         ORDER BY source'

查询只读，并受明确的资源上限约束。pChronicle 会在语义对齐时，把支持的运行数据格式规范化为公共的 runs、 steps 和 tool_calls 表。

你刚刚完成了什么​

你打开了一个 Dataset，运行了内建汇总，查询了规范化表，并可以用 FTS/JSONB 定位具体轨迹。整个过程没有修改 Dataset。

按任务继续：