用途:为 LLM 应用首次添加 Arize AX 追踪,流程为检测技术栈→获取唯一匹配的集成文档→接入自动埋点→验证 trace 成功上报。
主要能力:通过 references/integration-routing.md 将检测到的技术栈映射到单一文档页并只抓取该页;若应用使用智能体框架,则按框架而非其包装的供应商 SDK 路由;未列出的技术栈改用手动埋点。
使用方式:分两阶段。阶段一为只读分析,从清单与导入检测语言、包管理器、LLM 供应商、框架、已有追踪与 Arize 端点/区域配置,并确认范围(monorepo 或多服务需先询问)。阶段二在确认目标后按匹配文档安装与接线,凭证仅引用 ARIZE_API_KEY/ARIZE_SPACE_ID 环境变量,不要求用户粘贴密钥,不假设美国区域。
关键规则:先检查再修改;追踪为附加,不改业务逻辑;集中初始化于创建 LLM 客户端之前;优先自动埋点,仅在无埋点覆盖处添加手动 span;项目名必填(缺失会返回 HTTP 500);退出前需 flush;多轮对话可加 session.id。
验证:应用可构建/类型检查、启动追踪、发出至少一次真实请求,并在 Arize 中确认 trace;无 trace 时检查凭证、初始化顺序、端点区域与导出日志。
限制:Go 无集成文档页,需参考 references/go.md;具体包版本与安装命令以匹配文档为准,资料未提供完整命令细节。