在 Agent 运营分析创建业务空间、接入 Agent 之后，可获取到对应的 Token、SPC ID（业务空间 ID）、Agent ID，您需要基于这些参数完成数据上报，接入观测。

了解 Agent 运营分析基本概念，请参见基本概念。

在具体的 Agent 配置页面，选择数据配置页签，并单击观测配置。

在配置观测接入对话框，获取 Token、SPC ID、Agent ID。

数据上报地址 #

• 方式一：使用 psm （vpc.minibasellm.cozeloop）接入

  变量名	变量含义	变量示例
  MINIBASE_LLM_BASE_PSM	MiniBaseLLMBase服务PSM	vpc.minibasellm.cozeloop

• 方式二：使用 svc 接入

  变量名	变量含义	变量示例
  MINIBASE_LLM_BASE_URL	MiniBaseLLMBase服务URL	http://vpc-coze-loop.minibase-llm.svc:8888

API 上报 #

上报自定义的 Trace Span 数据。

• 请求

  请求方式	POST
  接口地址	/v1/loop/traces/ingest

• Header

  Header参数Key	Header参数说明	Header参数值
  Authorization	token

• 输入参数

  属性	类型	是否必填	默认值	备注
  spans	[]InputSpan	是	-	[{ "started_at_micros": "integer (Unix 纪元微秒)", "log_id": "string (可选, 日志ID)", "span_id": "string", "parent_id": "string", "trace_id": "string", "duration": "integer (毫秒)", "service_name": "string (可选, 服务名)", "workspace_id": "string", "span_name": "string", "span_type": "string (SpanType 枚举)", "method": "string", "status_code": "integer", "input": "string", "output": "string", "tags_string": {"agent_id":"1","thread_id":"t1","user_id":"u1","key": "value" }, "tags_long": { "key": 123 }, "tags_double": { "key": 1.23 } }]

• 返回参数

  属性	类型	默认值	备注
  BaseResp	BaseResp	-	响应结果 { "StatusMessage": "", "StatusCode": 200, "Extra": {"key":"value"} }
  code	int	-	是否上报成功
  msg	String	-	响应消息

• Input 示例

  {
      "spans": [
          {
              "started_at_micros": 1678886400000000,
              "span_id": "span-001",
              "parent_id": "0",
              "trace_id": "trace-abc",
              "duration": 500,
              "workspace_id": "your_workspace_id",
              "span_name": "MyAwesomeFunction",
              "span_type": "function",
              "method": "POST",
              "status_code": 0,
              "input": "{\"question\": \"Hello, World!\"}",
              "output": "{\"answer\": \"Hi there!\"}",
              "tags_string": {
                  "user_id": "user-123",
                  "thread_id": "t1",
                  "agent_id": "a1",
                  "env": "production"
              }
          }
      ]
  }
  

OpenTelemetry trace上报 #

兼容 OpenTelemetry 格式的 Trace 数据上报。

• 请求

  请求方式	POST
  接口地址	v1/loop/opentelemetry/v1/traces

• Header

  Header参数Key	Header参数说明	Header参数值
  Authorization	token

• 输入参数

  属性	类型	是否必填	默认值	备注
  workspace_id	String	是	-	工作空间 ID
  content_type	String	是	-	支持 application/json、application/x-protobuf 两种格式
  content_encoding	String	是	-	编码方式，支持 gzip 压缩
  body	[]byte	是	-	参数体

• 返回参数

  属性	类型	默认值	备注
  BaseResp	BaseResp	-	响应结果 { "StatusMessage": "", "StatusCode": 200, "Extra": {"key":"value"} }
  content_type	String	-	可视化分析记录 ID
  body	[]byte	-	参数体

• 映射逻辑：详情请参见 OpenTelemetry Attribute & Event 映射。

SDK 上报 #