查询会话详情 - ShowOpsSession

功能介绍

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

调用方法

授权信息

账号根用户具备所有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位。取值范围：不涉及。默认取值：不涉及。

请求参数

无

响应参数

状态码：200

表2 响应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

响应示例

状态码：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表示成功，其他值表示失败，具体参见错误码文档。