arize-link

Arize 链接

生成指向 Arize UI 中项目、跟踪、跨度、会话、数据集、实验、标注队列、评估器和标注配置的深层链接。

适用场景

• 用户需要项目、跟踪、跨度、会话、数据集、标注队列、评估器或标注配置的链接
• 你有从导出数据或日志中获取的 ID，需要链接回 UI
• 用户要求在 Arize 中“打开”或“查看”上述任意内容

必需输入

从用户、上下文（导出的跟踪数据或解析后的 URL）或 ax CLI 收集：

始终必需	特定资源所需
org_id（base64）	project_id + trace_id [+ span_id] — 跟踪/跨度
space_id（base64）	project_id + session_id — 会话
	dataset_id — 数据集
	dataset_id + experiment_id（一个或多个）— 实验或比较
	experiment_id — 不含数据集的实验
	queue_id — 特定队列（列表视图省略）
	evaluator_id [+ version] — 评估器

查找组织和项目 ID

优先使用 CLI，不要向用户索取 CLI 可以提供的 ID：

ax organizations list --output json

使用 .organizations[].id 作为组织 ID。如果返回多个组织，请根据用户提供的组织名称进行匹配，或请用户选择。

要查找项目 ID，请列出相关空间中的项目：

ax projects list --space "{space_name_or_id}" --limit 100 --output json

使用匹配项目的 id；其 space_id 即为 URL 所需的空间 ID。该命令接受空间名称或 ID；如果空间未知，请运行 ax projects list --limit 100 --output json 并选择匹配的项目。

要查找实验 ID，请列出数据集上的实验；每个实验都有一个 id 和一个 dataset_id：

ax experiments list --dataset "{dataset_name_or_id}" --space "{space_name_or_id}" --output json

所有路径 ID 都必须使用 base64 编码（字符：A-Za-z0-9+/=）。原始数字 ID 会生成看似有效、但会返回 404 的 URL。如果用户提供的是数字，请让他们直接从 Arize 浏览器 URL 中复制 ID（https://app.arize.com/organizations/{org_id}/spaces/{space_id}/…）。如果你有原始内部 ID（例如 Organization:1:abC1），请先进行 base64 编码，再插入 URL。

URL 模板

基础 URL：https://app.arize.com（本地部署时可覆盖）

项目：

{base_url}/organizations/{org_id}/spaces/{space_id}/projects/{project_id}

跟踪（添加 &selectedSpanId={span_id} 以突出显示特定跨度）：

{base_url}/organizations/{org_id}/spaces/{space_id}/projects/{project_id}?selectedTraceId={trace_id}&queryFilterA=&selectedTab=llmTracing&timeZoneA=America%2FLos_Angeles&startA={start_ms}&endA={end_ms}&envA=tracing&modelType=generative_llm

会话：

{base_url}/organizations/{org_id}/spaces/{space_id}/projects/{project_id}?selectedSessionId={session_id}&queryFilterA=&selectedTab=llmTracing&timeZoneA=America%2FLos_Angeles&startA={start_ms}&endA={end_ms}&envA=tracing&modelType=generative_llm

数据集（selectedTab：examples 或 experiments）：

{base_url}/organizations/{org_id}/spaces/{space_id}/datasets/{dataset_id}?selectedTab=examples

实验（重复使用 experimentId，以并排比较实验）：

{base_url}/organizations/{org_id}/spaces/{space_id}/datasets/{dataset_id}/experiments/compare?experimentId={experiment_id}
{base_url}/organizations/{org_id}/spaces/{space_id}/datasets/{dataset_id}/experiments/compare?experimentId={experiment_id_a}&experimentId={experiment_id_b}

不含数据集的实验：

{base_url}/organizations/{org_id}/spaces/{space_id}/experiments/{experiment_id}

对实验 ID 进行 URL 编码（= → %3D、+ → %2B、/ → %2F）。

队列列表 / 特定队列：

{base_url}/organizations/{org_id}/spaces/{space_id}/queues
{base_url}/organizations/{org_id}/spaces/{space_id}/queues/{queue_id}

评估器（省略 ?version=… 以使用最新版本）：

{base_url}/organizations/{org_id}/spaces/{space_id}/evaluators/{evaluator_id}
{base_url}/organizations/{org_id}/spaces/{space_id}/evaluators/{evaluator_id}?version={version_url_encoded}

version 的值必须进行 URL 编码（例如，末尾的 = → %3D）。

标注配置：

{base_url}/organizations/{org_id}/spaces/{space_id}/annotation-configs

时间范围

重要：跟踪/跨度/会话链接必须包含 startA 和 endA（纪元毫秒）。省略它们会默认使用最近 7 天；如果跟踪不在此时间范围内，就会显示“没有近期数据”。

优先顺序：

1. 用户提供的 URL — 直接提取并复用 startA/endA。
2. 跨度 start_time — 前后各扩展 1 天（或各扩展 1 小时以使用更窄的时间范围）。
3. 回退方案 — 最近 90 天（从 now - 90d 到 now）。

优先使用较窄的时间范围；90 天的时间范围加载较慢。

说明

1. 从用户、导出数据、URL 上下文或 CLI 收集 ID。使用 ax organizations list --output json 获取 org_id；需要时使用 ax projects list 获取 project_id。
2. 确认所有路径 ID 均已使用 base64 编码。
3. 对于跟踪、跨度和会话链接，按照上述优先顺序确定 startA/endA。
4. 将相应模板中的占位值替换为实际值，并以可点击的 Markdown 链接形式提供。

故障排查

问题	解决方案
“无数据”／视图为空	跟踪记录不在时间范围内——扩大 startA/endA 范围（±1 小时 → ±1 天 → 90 天）。
404	ID 错误或不是 base64。使用 ax organizations list --output json 重新检查 org_id，使用 ax projects list 检查 project_id，并从浏览器 URL 中检查 space_id。
未突出显示 Span	span_id 可能属于其他跟踪记录。请对照导出的 Span 数据进行验证。
org_id 未知	运行 ax organizations list --output json 并使用 .organizations[].id。如果 CLI 无法访问该组织，请让用户从 Arize 浏览器 URL 中复制该 ID。

相关技能

• arize-trace：导出 Span 以获取 trace_id、span_id 和 start_time。

示例

请参阅 references/EXAMPLES.md，了解每种链接类型的完整具体 URL 示例。