mcpField
A
arize-link

arize-link

github.com/github开发40.6k1.1k 次安装1 天前更新
代码仓库

关于 arize-link

用于生成指向 Arize UI 的深层链接的技能，支持 traces、spans、sessions、数据集、标注队列、evaluators 和标注配置。它会依据资源 ID 构造链接，并要求 trace 类链接包含时间范围。

主要功能

  1. 01生成多种 Arize 资源的 UI 链接
  2. 02按资源类型填入对应 ID
  3. 03检查路径 ID 是否为 Base64
  4. 04为 trace、span 和 session 链接设置时间范围

适用场景

  1. 01从导出的 trace 数据跳转到对应 UI 页面
  2. 02为数据集或标注队列生成可点击链接
  3. 03排查链接无数据或 404 的原因

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/github/awesome-copilot --skill arize-link

安装后在 Claude Code 中输入/arize-link确认已加载。

附带文件references/EXAMPLES.md

详细介绍

Arize 链接

为 trace、span、session、数据集、标注队列、评估器和标注配置生成指向 Arize UI 的深度链接。

何时使用

  • 用户想要一个指向 trace、span、session、数据集、标注队列、评估器或标注配置的链接
  • 你从导出数据或日志中获得了 ID，需要链接回 UI
  • 用户要求在 Arize 中"打开"或"查看"上述任一内容

必需输入

从用户或上下文（导出的 trace 数据、解析后的 URL）中收集：

始终必需资源特定
org_id（base64）project_id + trace_id [+ span_id] — trace/span
space_id（base64）project_id + session_id — session
dataset_id — 数据集
queue_id — 特定队列（省略则显示列表）
evaluator_id [+ version] — 评估器

所有路径 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（本地部署可覆盖）

Trace（添加 &selectedSpanId={span_id} 以高亮特定 span）：

{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

Session：

{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

队列列表 / 特定队列：

{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

时间范围

关键：trace/span/session 链接必须包含 startA 和 endA（epoch 毫秒）——省略它们会默认使用最近 7 天，如果 trace 落在此窗口之外，将显示"无最近数据"。

优先级顺序：

  1. 用户提供的 URL — 直接提取并复用 startA/endA。
  2. Span 的 start_time — 前后各扩展 ±1 天（或 ±1 小时以获得更紧的窗口）。
  3. 兜底方案 — 最近 90 天（now - 90d 至 now）。

优先使用紧窗口；90 天窗口加载缓慢。

操作步骤

  1. 从用户、导出数据或 URL 上下文中收集 ID。
  2. 验证所有路径 ID 均已 base64 编码。
  3. 按照上述优先级顺序确定 startA/endA。
  4. 代入相应模板，并以可点击的 markdown 链接形式呈现。

故障排查

问题解决方案
"无数据" / 视图为空Trace 超出时间窗口 — 扩大 startA/endA（±1h → ±1d → 90d）。
404ID 错误或未经过 base64 编码。从浏览器 URL 重新检查 org_id、space_id、project_id。
Span 未高亮span_id 可能属于不同的 trace。对照导出的 span 数据进行验证。
org_id 未知ax CLI 不会暴露它。请用户从 https://app.arize.com/organizations/{org_id}/spaces/{space_id}/… 复制。

相关技能

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

示例

每种链接类型的完整具体 URL 集合见 references/EXAMPLES.md。

评论

支持 Markdown