文档首页/ 智能体开发平台 AgentArts/ API参考/ API/ 观测/ 会话管理/ 查询会话详情 - ShowOpsSession
更新时间:2026-05-21 GMT+08:00
分享

查询会话详情 - ShowOpsSession

功能介绍

该接口用于查询会话详情。

调用方法

请参见如何调用API

授权信息

账号根用户具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备如下身份策略权限,更多的权限说明请参见权限和授权项

授权项

访问级别

资源类型(*为必须)

条件键

别名

依赖的授权项

agentarts::showOpsSession

Read

-

-

-

  • apm:apm2TraceEvents:get
  • apm:apm2Service:get

URI

GET /v1/ops/observation/sessions/{session_id}

表1 路径参数

参数

是否必选

参数类型

描述

session_id

String

参数解释

会话ID,唯一标识一个会话,可通过ListOpsSession接口获取。

约束限制

长度限制1-64位。

取值范围

不涉及。

默认取值

不涉及。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

String

参数解释:

消息体编码格式。用于告知服务端请求体(Body)所采用的主体数据类型,以便服务端正确解析。

约束限制:

不涉及。

取值范围:

application/json。

默认取值:

application/json。

Authorization

String

参数解释:

签名认证信息,当使用AK/SK方式认证时,使用SDK对请求进行签名的过程中会自动填充该字段。

约束限制:

SDK自动填充,格式为SDK-HMAC-SHA256。

取值范围:

符合签名规范的字符串。

默认取值:

不涉及。

X-Sdk-Date

String

参数解释:

请求发送的时间,当使用AK/SK方式认证时,使用SDK对请求进行签名的过程中会自动填充该字段。

约束限制:

符合ISO 8601格式。

取值范围:

格式为YYYYMMDDTHHMMSSZ,如20240416T095341Z。

默认取值:

不涉及。

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

session_id

String

参数解释

会话ID。

取值范围

不涉及。

latency

Number

参数解释

耗时,会话的总执行时长。

取值范围

大于等于0的数值,单位为ms。

tokens

Number

参数解释

Tokens消耗,会话消耗的总Token数量。

取值范围

大于等于0的数值,单位为个。

input_tokens

Number

参数解释

Input Tokens消耗,会话输入部分消耗的Token数量。

取值范围

大于等于0的数值,单位为个。

output_tokens

Number

参数解释

Output Tokens消耗,会话输出部分消耗的Token数量。

取值范围

大于等于0的数值,单位为个。

trace_num

Number

参数解释

调用链数量。

取值范围

不涉及。

user_id

String

参数解释

用户ID。

取值范围

不涉及。

call_type

String

参数解释

调用类型。

取值范围

不涉及。

start_time

Long

参数解释

开始时间,会话开始的时间戳。

取值范围

Unix时间戳,单位为ms。

domain_id

String

参数解释

租户DomainID。

取值范围

不涉及。

resource_id

String

参数解释

资源ID。

取值范围

不涉及。

resource_name

String

参数解释

资源名称。

取值范围

不涉及。

resource_type

String

参数解释

资源类型。

取值范围

  • agent:单智能体。

  • multiagents:多智能体。

  • workflow:工作流。

请求示例

GET https://*.com/v1/ops/observation/sessions/test111

Content-Type:application/json
X-Sdk-Date:20240416T095341Z
Authorization:SDK-HMAC-SHA256 Access=****************, SignedHeaders=content-type;host;x-sdk-date, Signature=****************

响应示例

状态码:200

参数解释

响应码,用于标识接口调用结果。

取值范围

200表示成功,其他值表示失败,具体参见错误码文档。

{
  "session_id" : "test111",
  "latency" : 5,
  "tokens" : 0,
  "input_tokens" : 0,
  "output_tokens" : 0,
  "trace_num" : 1,
  "user_id" : "319c74a30677464db04f25ffd55ae3c8",
  "call_type" : "debug",
  "start_time" : 1775271188055,
  "domain_id" : null,
  "resource_id" : "b0fd244b-c5c8-4ef7-97b6-645a1b03edc6",
  "resource_name" : null,
  "resource_type" : null
}

状态码

状态码

描述

200

参数解释

响应码,用于标识接口调用结果。

取值范围

200表示成功,其他值表示失败,具体参见错误码文档。

错误码

请参见错误码

相关文档