用途:为 AI 应用接入原始 OpenTelemetry,使追踪数据进入 Confident AI。仅适用于含 LLM 调用、智能体循环与规划、检索/向量搜索、工具调用的 AI 组件;不要给 Web 服务、CRUD 后端、数据库、基础设施等非 AI span 添加 confident.* 属性。若目标不含上述 AI 组件,则不适用。
与其他技能区别:本技能为厂商中立的 OTLP 导出与原始 confident.* 属性,不使用 confident-trace 包;confident-tracing 负责 Python/TypeScript 的自动集成与自定义 SDK span;deepeval 负责评估套件、数据集、指标与测试运行。
前提:项目级 CONFIDENT_API_KEY;应用语言的 OpenTelemetry SDK(Python 需 opentelemetry-sdk 与 opentelemetry-exporter-otlp-proto-http)。直连 Confident AI Cloud 使用 OTLP/HTTP,绝不用 gRPC。
工作方式:将 OTLP/HTTP traces 导出器指向 Confident AI,并带 x-confident-api-key 请求头;Confident AI 从 span 读取 confident.* 属性。父子嵌套、trace ID、采样、状态、链接与上下文传播仍由原生 OpenTelemetry 处理。
流程:确认目标是 AI 应用并检查现有 TracerProvider、导出器、Collector 或 APM 管道;按 API key 区域前缀选择直连 Cloud 端点(见 references/endpoint-and-exporter.md);接入或改指带 x-confident-api-key 头的 OTLP/HTTP 导出器,Python 可从 templates/confident_otel_setup.py 起步;若进程还发出无关 span,需隔离导出使只有 AI span 到达 Confident AI;在 span 上设置 confident.span.,在整条 trace 上设置 confident.trace.(见 references/span-attributes.md、references/trace-attributes.md);对象与元数据用 JSON 编码,字符串列表用原生同质基本类型数组;若已有 gen_ai.* 语义约定属性,先读 references/gen-ai-fallbacks.md 再决定是否补充;工作完成后 flush 并在 Confident AI 中验证层级。
原则:只插桩并导出 AI 组件;优先改指现有导出器而非新增重复管道;confident.* 键与语言无关;直连 Cloud 始终用 OTLP/HTTP,Collector 面向应用侧可用其他协议;已知时显式设置 confident.span.type,仅在回退时用 gen_ai.* 推断;禁止硬编码 API key 或记录密钥与未批准的敏感内容;保留原生 trace ID、父子关系、采样、状态、资源、链接与传播。
限制:仅面向 AI 应用;具体端点、区域选择、认证与过滤细节需查阅上述参考文件,资料未提供其内容。