文件上传与挂载 - 千问AI平台

配额与限制

单个文件最大 10 MB。
单个业务空间下文件总容量上限 100 GB。
文件保存时效 30 天，超期可能被自动清理。需要长期保留请定期重新上传。

上传

在文件页面点击上传文件，从本地选择文件后上传。上传后文件进入安全审核（checking），审核通过变为 available 后才可挂载到会话。审核未通过则标记为 rejected 或 type_rejected。通过 API 上传文件，以 multipart/form-data 方式提交。完整参数与响应字段详见 File API。

curl -X POST "https://dashscope.aliyuncs.com/api/v1/agentstudio/files" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -F "file=@./sales_2025.csv"

会话隔离

将文件挂载到会话时，服务端会做一份内部拷贝挂入会话沙箱，原始文件不受会话内修改影响。可在会话详情查看挂载文件的实际副本。

挂载到会话

创建会话时挂载

在新建会话抽屉的挂载资源区，从已上传的文件中选择一个挂载到当前会话，并填写挂载路径。/uploads/ 前缀由控制台固定写死，只需填写后面的部分，例如填 CLAUDE.md，挂载路径即为 /uploads/CLAUDE.md。

运行时挂载

会话已创建后，在会话页面右侧资源面板点击挂载文件追加。挂载实时生效，无需重启会话。

路径前缀

挂载路径以 /uploads/ 开头（控制台已写死该前缀，通过 API 挂载时需自行写全）。服务端再补上 /mnt/session 前缀，即智能体在沙箱中看到的运行侧路径：

挂载路径（控制台填写 / API `mount_path`）		运行侧路径（智能体看到的）
`/uploads/CLAUDE.md`	→	`/mnt/session/uploads/CLAUDE.md`
`/uploads/workspace/data.csv`	→	`/mnt/session/uploads/workspace/data.csv`

智能体在工具调用中应使用运行侧路径访问。在系统提示词中可直接告知完整路径，例如：数据文件位于 /mnt/session/uploads/workspace/data.csv。查询会话资源时，接口返回的 mount_path 也是运行侧路径。

卸载

在资源面板对应文件行点击卸载。卸载后会话内的副本被清理，原始文件不变。通过 API 挂载文件：创建会话时通过 resources 字段挂载；会话运行中通过 POST /sessions/{session_id}/resources 追加。完整参数与响应字段详见 Session API。

# 创建会话时挂载
curl -X POST "https://dashscope.aliyuncs.com/api/v1/agentstudio/sessions" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent": "agent_xxx",
    "environment_id": "env_xxx",
    "resources": [
      {"type": "file", "file_id": "file_xxx", "mount_path": "/uploads/workspace/data.csv"}
    ]
  }'

# 运行时追加挂载
curl -X POST "https://dashscope.aliyuncs.com/api/v1/agentstudio/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"}'

删除

文件只支持删除，不支持归档。在文件页面点击对应文件行的删除，文件将被硬删除，不可恢复。已挂载到会话的副本不受影响。

curl -X DELETE "https://dashscope.aliyuncs.com/api/v1/agentstudio/files/file_xxx" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY"

下一步

发起会话：在会话中观察工具如何使用挂载的文件。
运行环境：配置工具调用的执行沙箱。

​配额与限制

​上传

​会话隔离

​挂载到会话

​创建会话时挂载

​运行时挂载

​路径前缀

​卸载

​删除

​下一步