Skip to main content
CozeloopExporter 将 span 数据以 OTLP(HTTP)协议上报至Cozeloop平台。接入后,可通过Cozeloop的 Trace 功能观测调用链路,或通过其评测功能对智能体进行评测。数据按工作空间隔离。

何时使用

  • 需要在Cozeloop上观测智能体的调用链路;
  • 需要借助Cozeloop的评测能力分析对话质量与工具使用效果;
  • 已有Cozeloop工作空间与访问密钥。

使用示例

也可以通过 CozeloopExporterConfig 显式传入连接参数:

参数

构造参数

CozeloopExporter 的连接参数由 config 字段承载,类型为 CozeloopExporterConfig;不传时各字段自动从对应环境变量读取。

Cozeloop 连接配置

config 为 CozeloopExporterConfig,各字段默认从 CozeloopConfig 读取,环境变量如下:
space_id 取自环境变量 OBSERVABILITY_OPENTELEMETRY_COZELOOP_SERVICE_NAME;未设置时,导出器会以 token 为凭证自动创建一个默认工作空间。登录Cozeloop后,URL 中 space 之后的片段即为工作空间 ID。

环境变量配置

也可以让 Agent 依据环境变量自动挂载 Cozeloop 导出器,无需显式构造:
设置 ENABLE_COZELOOP=true 后,即便智能体未显式提供 tracers,Agent 也会自动创建 OpentelemetryTracer 并挂载 CozeloopExporter。
最后修改于 2026年9月19日