awesome-copilot 的 arize-link 技能：Arize UI 深链接 URL 构造完整指南

awesome-copilot 的 arize-link 技能Arize UI 深链接 URL 构造完整指南【免费下载链接】awesome-copilotCommunity-contributed instructions, agents, skills, and configurations to help you make the most of GitHub Copilot.项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-copilot本文以 skills/arize-link/references/EXAMPLES.md 为主体骨架结合 skills/arize-link/SKILL.md 的模板、参数与故障排除说明系统讲解如何为 Arize 平台的 trace追踪、span跨度、session会话、dataset数据集、labeling queue标注队列、evaluator评估器与 annotation config标注配置生成可点击分享的 UI 深链接。读完本文你将掌握 Arize 前端 URL 的路径结构与查询参数含义、base64 编码硬性要求、时间窗口startA/endA选择策略以及如何基于导出的 trace 数据一键反查 Arize UI。一、arize-link 技能在仓库中的定位arize-link是 awesome-copilot 仓库中由 Arize 官方贡献metadata.author: arize版本 1.0的 Copilot 技能位于 skills/arize-link/目录结构如下skills/arize-link/ ├── SKILL.md # 技能定义使用场景、必填输入、URL 模板、时间范围、故障排除 └── references/ └── EXAMPLES.md # 每种链接类型的完整具体 URL 示例本文主体该技能用于在用户想「打开 / 查看 / 分享」某个 Arize 资源trace、span、session、dataset、标注队列、evaluator、annotation config时根据资源 ID 生成可直接点击的深链接。它与同一插件家族的其他技能形成完整闭环arize-trace负责导出 trace/span 拿到 IDarize-link再把 ID 拼回 UI 链接方便团队协作分享。整个技能族可通过 plugins/arize-ax/README.md 说明的方式以插件形式安装copilot plugin install arize-axawesome-copilot二、占位符约定理解 URL 中的{xxx}参数EXAMPLES.md 开篇明确了全文使用的占位符这也是构造任何 Arize 深链接前必须收集的最小信息集占位符含义说明{org_id}组织 ID必须为base64 编码字符集A-Za-z0-9/{space_id}空间 ID必须为base64 编码{project_id}项目 ID必须为base64 编码{start_ms}/{end_ms}时间范围epoch 毫秒例如1741305600000/1741392000000{trace_id}/{span_id}/{session_id}资源标识来自导出的 trace 数据或日志{dataset_id}/{queue_id}/{evaluator_id}资源标识来自 UI 或导出数据从 skills/arize-link/SKILL.md 的「Required Inputs」可知输入分为两类恒必填按资源类型附加org_idbase64trace/spanproject_idtrace_id可选span_idspace_idbase64sessionproject_idsession_iddatasetdataset_id标注队列queue_id查看列表时可省略evaluatorevaluator_id可选version2.1 base64 编码是硬性要求这是构造链接最容易踩的坑。SKILL.md 明确警告所有路径 ID 必须 base64 编码使用原始数字 ID 生成的 URL 看起来合法但打开后会 404。如果用户提供的是数字应让用户直接从浏览器地址栏https://app.arize.com/organizations/{org_id}/spaces/{space_id}/…复制完整 ID如果手头是原始内部 ID例如Organization:1:abC1这种格式需要先做 base64 编码再拼入 URL。三、URL 模板与参数解析所有链接的基础 URL 是https://app.arize.com自建部署环境可覆盖base_url。整体路径模式为{base_url}/organizations/{org_id}/spaces/{space_id}/{资源类型路径}?{查询参数}下面逐一展开 EXAMPLES.md 中给出的 9 类链接。每条均完整继承原文模板并补充参数含义解析。3.1 Trace追踪https://app.arize.com/organizations/{org_id}/spaces/{space_id}/projects/{project_id}?selectedTraceId{trace_id}queryFilterAselectedTabllmTracingtimeZoneAAmerica%2FLos_AngelesstartA{start_ms}endA{end_ms}envAtracingmodelTypegenerative_llm参数作用selectedTraceId定位到指定 traceselectedTabllmTracing打开 LLM Tracing 视图页签timeZoneAAmerica%2FLos_Angeles界面时区%2F是/的 URL 编码startA/endA时间范围epoch 毫秒必填详见第四节envAtracing环境筛选为 tracingmodelTypegenerative_llm模型类型筛选为生成式 LLMqueryFilterA查询过滤器默认留空3.2 Span在 trace 中高亮指定 spanhttps://app.arize.com/organizations/{org_id}/spaces/{space_id}/projects/{project_id}?selectedTraceId{trace_id}selectedSpanId{span_id}queryFilterAselectedTabllmTracingtimeZoneAAmerica%2FLos_AngelesstartA{start_ms}endA{end_ms}envAtracingmodelTypegenerative_llm与 Trace 链接的唯一差异是追加了selectedSpanId{span_id}用于在 trace 视图中高亮某个具体 span。SKILL.md 提醒span 高亮失败时先确认span_id确实属于该trace_id可能来自另一条 trace。3.3 Session会话https://app.arize.com/organizations/{org_id}/spaces/{space_id}/projects/{project_id}?selectedSessionId{session_id}queryFilterAselectedTabllmTracingtimeZoneAAmerica%2FLos_AngelesstartA{start_ms}endA{end_ms}envAtracingmodelTypegenerative_llm将selectedTraceId替换为selectedSessionId其余参数一致。session 对应一组共享attributes.session.id的 trace例如多轮对话。3.4 Dataset —— Examples 页签https://app.arize.com/organizations/{org_id}/spaces/{space_id}/datasets/{dataset_id}?selectedTabexamples注意路径从/projects/{project_id}变为/datasets/{dataset_id}通过selectedTabexamples打开数据集的样例列表页。无需startA/endA。3.5 Dataset —— Experiments 页签https://app.arize.com/organizations/{org_id}/spaces/{space_id}/datasets/{dataset_id}?selectedTabexperiments与上一条共用{dataset_id}仅将selectedTab改为experiments直达该数据集关联的实验记录页。3.6 Labeling Queue 列表https://app.arize.com/organizations/{org_id}/spaces/{space_id}/queues路径段为/queues不携带队列 ID展示空间下全部标注队列。配合 skills/arize-annotation/SKILL.md 中ax annotation-queues list --space SPACE使用可先定位队列再分享链接。3.7 Labeling Queue指定队列https://app.arize.com/organizations/{org_id}/spaces/{space_id}/queues/{queue_id}在/queues后追加{queue_id}直达具体队列queue_id同样需要 base64 编码。3.8 Evaluator最新版本https://app.arize.com/organizations/{org_id}/spaces/{space_id}/evaluators/{evaluator_id}路径段为/evaluators/{evaluator_id}不加version参数时默认打开该 evaluator 的最新版本。3.9 Evaluator指定版本https://app.arize.com/organizations/{org_id}/spaces/{space_id}/evaluators/{evaluator_id}?version{version_url_encoded}追加?version参数定位历史版本。SKILL.md 特别强调version 值必须 URL 编码例如结尾的要写成%3D否则链接解析异常。3.10 Annotation Configs标注配置列表https://app.arize.com/organizations/{org_id}/spaces/{space_id}/annotation-configs路径段为/annotation-configs展示空间下全部标注配置label schema。标注配置是人工反馈标签的 schema 定义详见 skills/arize-annotation/SKILL.md 中的ax annotation-configs命令族。四、时间范围startA/endA的选择策略这是 trace/span/session 链接能否正常显示的关键。SKILL.md 将其标记为CRITICALstartA和endAepoch 毫秒对于 trace/span/session 链接是必填的 —— 省略时界面默认回溯最近 7 天若目标 trace 落在这个窗口之外页面会显示「no recent data」。选择优先级从高到低用户提供的 URL若用户是从浏览器复制的链接直接提取其中startA/endA原样复用Span 的start_time以导出 span 的start_time为基准前后各留 ±1 天需要更紧凑窗口可缩到 ±1 小时兜底策略最近 90 天now - 90d至now。同时建议优先使用紧凑窗口90 天窗口加载缓慢会影响分享体验。在真实工作流中start_time、trace_id、span_id、session_id这些输入都来自 skills/arize-trace/SKILL.md 描述的导出命令例如ax spans export PROJECT --trace-id TRACE_ID --output-dir .arize-tmp-traces导出得到的spans.json中包含context.trace_id、context.span_id、start_time等字段正是填充{trace_id}、{span_id}与推算startA/endA的直接来源。五、完整生成步骤Instructions综合 SKILL.md 与 EXAMPLES.md生成一条深链接的标准流程为收集 ID从用户、导出数据或已解析的 URL 中获取org_id、space_id及资源专属 ID校验编码确认所有路径 ID 均为 base64 编码字符集A-Za-z0-9/非编码 ID 一律先编码确定时间窗口按第四节优先级确定startA/endA仅 trace/span/session 链接需要套用模板选择第二节/第三节中对应资源类型的模板替换占位符输出以可点击的 Markdown 链接形式呈现给用户方便直接粘贴到 IM、文档或工单中分享。六、常见问题排查SKILL.md 给出了针对深链接的排查表整理如下现象解决方案「No data」/ 空视图trace 落在时间窗口外 —— 放宽startA/endA按 ±1h → ±1d → 90d 逐步扩大404ID 错误或未做 base64 编码 —— 从浏览器地址栏核对org_id、space_id、project_idspan 未高亮span_id可能属于另一条 trace —— 对照导出的 span 数据核验org_id未知axCLI 不暴露 org ID —— 请用户从https://app.arize.com/organizations/{org_id}/spaces/{space_id}/…地址栏复制七、与其他技能的协同arize-link不是孤立的它处于 Arize 观测闭环的「出口」位置skills/arize-trace/SKILL.md用ax spans export/ax traces export导出 trace、span、session 及start_time为链接提供 ID 与时间基准skill 的 Related Skills 中明确指向 arize-link「把导出数据中的 trace ID 变成可点击的 Arize UI URL」skills/arize-annotation/SKILL.md创建标注配置与标注队列通过queues、annotation-configs链接直达人工标注界面skills/arize-dataset、skills/arize-evaluator、skills/arize-experiment数据集与评估相关的资源同样可用本节链接直达。典型工作流示例先用arize-trace导出某条错误 trace → 从spans.json拿到trace_id、span_id、start_time→ 用arize-link生成带时间窗口的 Trace/Span 深链接 → 分享给团队成员在 Arize UI 中协作定位问题。八、结语掌握 Arize UI 深链接的构造规则本质上是理解「路径段决定资源类型、查询参数决定视图状态、base64 编码决定链接有效性、时间窗口决定数据可见性」这四层要素。EXAMPLES.md 提供的 9 类模板覆盖了日常分享所需的全部资源类型配合 SKILL.md 的输入校验与时间选择策略即可在任意场景下稳定生成可用的分享链接。更多实现细节可继续阅读 skills/arize-link/SKILL.md 与 skills/arize-link/references/EXAMPLES.md。【免费下载链接】awesome-copilotCommunity-contributed instructions, agents, skills, and configurations to help you make the most of GitHub Copilot.项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-copilot创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考