更新时间:2026-09-14 GMT+08:00
分享

查询session - ShowCodeInterpreterSession

功能介绍

该API用于查询一个代码解释器的Session详情。

调用方法

请参见如何调用API。

授权信息

当前API调用无需身份策略权限。

URI

GET /v1/code-interpreters/{code_interpreter_name}/sessions-get

表1 路径参数

参数

是否必选

参数类型

描述

code_interpreter_name

是

String

参数解释:

与会话关联的代码解释器的唯一标识符。

代码解释器名称获取方式:

1.进入AgentArts平台,在左侧导航栏选择"组件库 > 沙箱工具 "。

2.在代码解释器列表中"代码解释器名称/ID"处获取代码解释器名称。

约束限制:

必须为已创建的代码解释器名称,若不存在则返回404错误。

取值范围:

符合正则^[a-z][a-z0-9-]{0,38}[a-z0-9]$,即必须以小写字母开头,小写字母或数字结尾,中间可包含数字、小写字母、中划线,字符长度必须在2-40个字符之间。

默认取值:

不涉及。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-HW-AgentArts-Code-Interpreter-Session-Id

是

String

参数解释:

使用的代码解释器会话的唯一标识符。从StartCodeInterpreterSession接口返回获得。

约束限制:

session_id不可为空,格式不合法返回400错误,会话不存在或已过期返回404错误。

取值范围:

由StartCodeInterpreterSession接口返回的session_id,由字母、数字、中划线、下划线组成,长度1-128字符。

默认取值:

不涉及。

Authorization

是

String

参数解释:

本次智能体工具调用对应的身份认证凭据。需要根据实际的智能体工具的入站身份认证方式获取对应的身份认证凭据。

API Key认证、IAM认证及OAuth 2.0认证具体请参见认证鉴权。

约束限制:

不涉及。

取值范围:

1-4096个字符,由字母、数字及特殊字符组成。

默认取值:

不涉及。

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

code_interpreter_name

String

参数解释:

代码解释器的名称。

取值范围:

与请求路径中的code_interpreter_name一致。

created_at

String

参数解释:

代码解释器会话创建的时间。使用ISO 8601格式,示例:2026-04-28T10:00:00Z,时区为UTC。

取值范围:

ISO 8601格式日期时间字符串,长度1-64字符。

name

String

参数解释:

代码解释器会话的名称。

取值范围:

符合正则条件^[a-zA-Z0-9_-]+$,长度1-128字符。

session_id

String

参数解释:

代码解释器会话的唯一标识符,由系统自动生成。该ID需用于后续停止会话、执行代码等操作的请求Header(X-HW-AgentArts-Code-Interpreter-Session-Id)中。从StartCodeInterpreterSession接口返回获得。

取值范围:

由字母、数字、中划线、下划线组成的唯一字符串,符合正则^[a-zA-Z0-9_-]+$,长度1-128字符。

session_timeout

Integer

参数解释:

代码解释器会话的超时时间,单位:秒。

取值范围:

60~86400。

状态码:401

表4 响应Body参数

参数

参数类型

描述

code

Integer

参数解释:

异常错误码。

取值范围:

可选值:401。

message

String

参数解释:

错误详细信息。

取值范围:

长度为 1 - 512 个字符。

error_code

String

参数解释:

错误码。

取值范围:

满足正则规则^AgentArts.0401\d{4}$

error_msg

String

参数解释:

错误详细信息。

取值范围:

符合正则:^[a-zA-Z0-9\s\u4e00-\u9fff.,!?;:()'"-\u3002\uff0c\uff01\uff1f\uff1b\uff1a\uff08\uff09]+$。

请求示例

GET /v1/code-interpreters/{code_interpreter_name}/sessions-get

响应示例

状态码:200

OK

{
  "code_interpreter_name" : "string",
  "session_id" : "string",
  "name" : "string",
  "created_at" : "2026-04-28T10:00:00Z",
  "session_timeout" : 900
}

状态码:400

请求参数错误。

{
  "error_code" : "AgentArts.04010001",
  "error_msg" : "session_id length must be between 1 and 128 characters"
}

状态码:401

未授权(认证令牌缺失、无效或已过期)。

{
  "code" : 401,
  "message" : "Authentication failed"
}

状态码:404

资源不存在。

{
  "error_code" : "AgentArts.04010004",
  "error_msg" : "Session session-001 not found"
}

状态码:500

服务内部错误。

{
  "error_code" : "AgentArts.04010000",
  "error_msg" : "Failed to retrieve session"
}

状态码

状态码

描述

200

OK

400

请求参数错误。

401

未授权(认证令牌缺失、无效或已过期)。

404

资源不存在。

500

服务内部错误。

错误码

请参见错误码。

相关文档