Skip to main content

运行时挂载资源

在会话运行期间动态挂载一个文件。服务端会将文件复制一份内部副本,并把挂载路径加上 /mnt/session/uploads/ 前缀。此操作不产生会话事件。

前提

已完成 Endpoint 与鉴权配置,详见API 总览与认证。

接口

POST /sessions/{session_id}/resources

路径参数

参数必填类型说明
session_id是string会话 ID,格式 sesn_<ULID>

请求体

字段必填类型说明
type是string资源类型,固定为 file
file_id是string已上传的文件 ID
mount_path是string挂载路径,以 /uploads 开头

请求示例

curl -X POST "$AGENTSTUDIO_URL/sessions/sesn_xxx/resources" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "file",
    "file_id": "file_xxx",
    "mount_path": "/uploads/workspace/late.csv"
  }'

响应

{
  "id": "sesrsc_xxx",
  "type": "file",
  "file_id": "file_xxx",
  "mount_path": "/mnt/session/uploads/workspace/late.csv",
  "created_at": "2026-05-28T08:25:00Z",
  "updated_at": "2026-05-28T08:25:00Z",
  "request_id": "xxx"
}

响应字段

字段类型说明
idstring资源 ID,格式 sesrsc_<ULID>
typestring资源类型,固定为 file
file_idstring内部副本的文件 ID,与请求中的 file_id 不同
mount_pathstring会话内的完整挂载路径
created_atstring创建时间,ISO 8601
updated_atstring最近更新时间,ISO 8601
request_idstring本次请求的唯一标识

错误码

状态码错误码说明
400InvalidParameterRequired parameter missing or invalid.
401InvalidApiKeyInvalid API-key provided.
Flow Agent API
Sandbox API
RAG API
长期记忆
ParseX API
Security API
框架集成
Assistant API(下线中)