Authorizations
DashScope API Key
Body
application/json绑定的智能体引用对象。可仅引用智能体,也可锁定版本并按需建立会话级覆盖(system / tools / mcp_servers / skills),覆盖仅作用于本会话,不改动智能体本身
绑定的运行环境 ID。环境配置预装包时创建后可能需要预热,准备中的环境不可被会话绑定(返回 invalid_parameter),需等待预热完成
会话标题,便于在列表中辨识
创建时挂载的资源列表。文件挂载后以副本形式进入会话沙箱;记忆库挂载后由服务端生成挂载路径,智能体通过文件工具读写。同一记忆库不能重复挂载
文件挂载
- Option 1
- Option 2
Vault ID 列表。将指定 Vault 中的 Credential 注入会话运行环境,使智能体可访问对应密钥。同一会话绑定多个 Vault 时,不同 Vault 之间的 secret_name 不能重复,也不要使用前缀相同的名称(例如 API_KEY 与 API_KEY_V2),否则创建会话返回 400 invalid_parameter(Invalid request)
业务自定义键值,不影响模型行为
会话运行时注入的环境变量,字符串键值对,沙箱代码中可直接按名读取
会话级 MCP 请求头,独立于 agent 字段。对指定 MCP Server 的全部出网请求注入自定义 Header;省略时为空数组。传入不存在的 MCP Server 名称不报错,运行时该配置不生效。接入方法与示例见自定义 MCP 与 Skills
Response
会话 ID,格式 sesn_<ULID>
固定为 session
会话状态:idle / running / terminated。新建会话为 idle
智能体配置完整快照,含 id/version/name/model/system/tools 等;会话级覆盖已并入快照。本响应不含 mcp_configs,可通过获取 Session 接口查询
绑定的运行环境 ID
会话标题
挂载的资源列表。文件为副本挂载;记忆库由服务端生成 mount_path
文件挂载
- Option 1
- Option 2
业务自定义键值
归档时间,未归档时为 null
创建时间,ISO 8601
最近更新时间,ISO 8601
本次请求的唯一标识
会话运行时注入的环境变量