启动session - StartCodeInterpreterSession

code_interpreter_name

是

String

参数解释：

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

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

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

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

约束限制：

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

取值范围：

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

默认取值：

不涉及。

Authorization

是

String

参数解释：

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

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

约束限制：

不涉及。

取值范围：

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

默认取值：

不涉及。

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

否

String

参数解释：

可选的代码解释器会话唯一标识符，用于恢复已有会话。若不传则会创建新会话。

约束限制：

必须为已存在的活动会话ID，若传入无效或已过期的会话ID将返回404错误。

取值范围：

由字母、数字、中划线、下划线组成，长度1-128字符。

默认取值：

不涉及。

name

是

String

参数解释：

代码解释器会话的名称。此名称有助于您识别和管理会话。名称无需唯一。

约束限制：

不允许为空字符串。

取值范围：

符合正则条件^[a-zA-Z0-9_-]+$，仅允许字母、数字、中划线、下划线，长度1-128个字符。

默认取值：

不涉及。

session_timeout

否

Integer

参数解释：

此设置表示会话在无任何活动后自动终止的时间，单位：秒。

约束限制：

输入值必须在60~86400范围内，超出范围将返回400错误。

取值范围：

60~86400。

默认取值：

900（即15分钟）。

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接口返回获得。

取值范围：

由字母、数字、中划线、下划线组成的唯一字符串，长度1-64字符。

session_timeout

Integer

参数解释：

代码解释器会话的超时时间，单位：秒。

取值范围：

60~86400。

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]+$。

200

OK

400

请求参数错误。

401

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

409

操作冲突。

429

请求频率超限。

500

服务内部错误。