SuperAPI AI 工具集

phoenix-tracing

数据与分析

查看项目

更新于 10-15 17:18

技能介绍

用途:Phoenix Tracing 是 Arize Phoenix 的追踪技能指南,帮助开发者为 LLM 应用实现 OpenInference 语义约定的埋点与可观测性,适用于实现 LLM 追踪、创建自定义 span 或部署到生产等场景。资料按用途分为七个优先级类别:Setup(安装与配置)、Instrumentation(自动与手动追踪)、Span Types(9 种 span 及其属性)、Organization(项目与会话)、Enrichment(自定义元数据)、Production(批处理、掩码)、Feedback(标注与评估)。

主要能力:提供 Python 与 TypeScript 两种语言的参考文件。Setup 覆盖安装 arize-phoenix-otel(Python)与 @arizeai/phoenix-otel(TypeScript)并配置端点;Instrumentation 支持自动埋点 OpenAI、LangChain 等框架,也支持用装饰器(Python)或包装器(TypeScript)手动创建 span,并可从 Claude Code、OpenHands、Codex 等导入 ATIF 智能体轨迹;Span Types 定义了 LLM 调用、chain、retriever、tool、agent、embedding、reranker、guardrail、evaluator,以及实验性的 decision 共 10 类 span 的属性结构;Organization 按应用分组 trace 并追踪会话;Enrichment 添加自定义属性;Production 涉及批处理与 PII 掩码;Feedback 为 span 添加反馈标注。基础文件说明 trace、span、属性概念、各类型必填字段、通用属性(user.id、session.id)与 JSON 扁平化规则。

使用方式:按语言先读 setup-{lang} 完成安装配置,再选 instrumentation-auto-{lang} 或 instrumentation-manual-{lang},需要具体操作时查阅 span-{type},属性规范见 fundamentals-。可按类别前缀(setup-、instrumentation-、span-、sessions-、production-、fundamentals-)或语言后缀(-python.md、*-typescript.md)导航。常见流程:快速上手为 setup-{lang} → instrumentation-auto-{lang} → 在 Phoenix 中查看;自定义 span 为 setup-{lang} → instrumentation-manual-{lang} → span-{type}。

限制:资料未提供具体价格、收费、平台支持范围、性能数据与限制条款;decision span 标注为实验性;其余细节暂未提供。