用途：在客户侧智能体仓库中做最小增量改动，接入 OpenTelemetry 追踪并把 span 导出到 Coval，随后用真实 Coval 连接路径验证 trace。仅使用客户仓库、公开 Coval 文档、公开 SDK 示例、Coval CLI/API 与公开 OpenAPI 规范，不假设可访问 Coval 内部仓库。
主要能力：先做只读分析（语言与包管理器、启动命令、框架栈如 Pipecat/LiveKit/Vapi/Twilio/WebSocket、现有遥测系统、短生命周期进程的 flush 路径）；再选择关联路径，每次导出只用一个目标头：模拟用 X-Simulation-Id，对话监控用 X-Conversation-Id。路由按类型：SIP 入站从 SIP 头或参与者属性取 ID；PSTN 入站不依赖 SIP 头，改用 pre_call_webhook_url 或注册端点；外呼在触发载荷中携带 simulation_output_id；WebSocket 在初始化载荷中携带；对话监控先缓冲 span，通话结束后提交再导出。
使用方式：先检查认证 coval whoami、coval agents list --format json，必要时用 COVAL_API_KEY 直连 API，切勿打印密钥；写 API 集成前先取 curl -fsS https://api.coval.dev/v1/openapi。实现要求：端点 https://api.coval.dev/v1/traces，认证头 x-api-key 或 X-API-Key 取自环境变量，超时 30 秒，设置 service.name 等资源属性，优先复用已有 TracerProvider，用 BatchSpanProcessor，批次低于 3-4 MB，短生命周期进程退出前 flush。使用规范 span 名（llm、tts、stt、vad、llm_tool_call、turn、conversation、pipeline、transport），并加入可成指标的数值属性。
验证：先跑本地检查（如 python -m compileall .、npm test、npm run typecheck、go test ./...），再通过 CLI/API 发起一次真实测试并轮询，确认导出返回 200 且 Trace Search 中出现预期 span。
限制：避免逐块或逐帧的 transport span，改为在父 span 上用计数属性聚合；Coval 存储为追加式、不去重，只重试失败批次；删除配置、降级认证、覆盖非空字段或改动共享资源前必须征得同意。资料未提供具体价格与平台支持细节。