cURL
鉴权
string
header
必填
DashScope API Key
请求体
application/jsonstring
必填
绑定的智能体 ID。会话锁定智能体当前最新版本的快照
string
必填
绑定的运行环境 ID
string
会话标题,便于在列表中辨识
object[]
创建时挂载的文件列表。每项含 type(固定为 file)、file_id(已上传的文件 ID)、mount_path(挂载路径,必须以 /uploads/ 开头,实际路径会加上 /mnt/session 前缀)
string[]
Vault ID 列表。将指定 Vault 中的 Credential 注入会话运行环境,使智能体可访问对应密钥
object
业务自定义键值,不影响模型行为
object
会话运行时注入的环境变量,字符串键值对,沙箱代码中可直接按名读取
响应
200-application/json
string
会话 ID,格式 sesn_<ULID>
string
固定为 session
enum<string>
会话状态:idle / running / terminated。新建会话为 idle
idle,running,terminated
object
智能体配置完整快照(创建时锁定),含 id/version/name/model/system/tools 等
string
绑定的运行环境 ID
string
会话标题
object[]
挂载的文件列表
object
业务自定义键值
string | null
归档时间,未归档时为 null
string
创建时间,ISO 8601
string
最近更新时间,ISO 8601
string
本次请求的唯一标识
object
会话运行时注入的环境变量