用途:根据用户提供的 ID 或从导出数据、日志中解析出的 ID,生成指向 Arize UI 的深层链接,覆盖 trace、span、session、dataset、标注队列、evaluator 和 annotation config,便于从数据或日志跳回界面查看。
主要能力:提供各类资源的 URL 模板,基址为 https://app.arize.com(本地部署可覆盖)。trace/span 链接可加 &selectedSpanId={span_id} 高亮具体 span;session 链接使用 selectedSessionId;dataset 链接可指定 selectedTab=examples 或 experiments;队列支持列表与指定 queue_id;evaluator 可省略 version 取最新,指定时 version 需 URL 编码;annotation configs 有独立路径。
必要输入:org_id(base64)、space_id(base64)为通用必填;trace/span 需 project_id + trace_id(可选 span_id);session 需 project_id + session_id;dataset 需 dataset_id;队列需 queue_id(省略则为列表);evaluator 需 evaluator_id(可选 version)。所有路径 ID 必须 base64 编码,原始数字 ID 会生成看似有效但 404 的 URL;若拿到内部 ID(如 Organization:1:abC1),需先 base64 编码。org_id 无法通过 ax CLI 获取,需用户从浏览器 URL 复制。
时间范围:trace/span/session 链接必须提供 startA 和 endA(epoch 毫秒),否则默认最近 7 天,可能显示无数据。优先级:用户提供的 URL 中直接提取;span 的 start_time 前后各留 1 天(或 1 小时);兜底为最近 90 天。建议使用较窄窗口,90 天窗口加载较慢。
使用方式:收集 ID,确认路径 ID 均为 base64,确定 startA/endA,代入对应模板,以可点击的 Markdown 链接呈现。
限制与排错:出现无数据时扩大时间窗口;404 时检查 ID 是否正确及是否 base64;span 未高亮可能属于其他 trace;org_id 未知需用户从浏览器 URL 复制。相关技能 arize-trace 可导出 span 以获取 trace_id、span_id 和 start_time。具体示例见 references/EXAMPLES.md。