文件 - 阿里云百炼

配额与限制

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

上传

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

curl -X POST "https://{workspace_id}.cn-beijing.maas.aliyuncs.com/api/v1/agentstudio/files" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -F "file=@./sales_2025.csv"

会话隔离

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

挂载到会话

创建会话时挂载

在新建会话抽屉的挂载资源区点击添加文件，选择已上传的文件，填写挂载路径，例如 /uploads/workspace/data.csv。路径必须以 /uploads/ 开头。

路径前缀

填写的挂载路径会被加上 /mnt/session 前缀。路径必须以 /uploads/ 开头。例如：

填写路径		实际路径（智能体看到的）
`/uploads/workspace/data.csv`	→	`/mnt/session/uploads/workspace/data.csv`
`/uploads/data/sales.xlsx`	→	`/mnt/session/uploads/data/sales.xlsx`

智能体在工具调用中应使用实际路径访问。在系统提示词中可直接告知完整路径，例如：数据文件位于 /mnt/session/uploads/workspace/data.csv。通过 API 挂载文件：创建会话时通过 resources 字段挂载。完整参数与响应字段详见创建 Session。

curl -X POST "https://{workspace_id}.cn-beijing.maas.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"}
    ]
  }'

删除

文件只支持删除，不支持归档。在文件页面点击对应文件行的删除，文件将被硬删除，不可恢复。已挂载到会话的副本不受影响。通过 API 删除文件，不可恢复。完整参数与响应字段详见删除 File。

curl -X DELETE "https://{workspace_id}.cn-beijing.maas.aliyuncs.com/api/v1/agentstudio/files/file_xxx" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY"

​配额与限制

​上传

​会话隔离

​挂载到会话

​创建会话时挂载

​路径前缀

​删除

配额与限制

上传

会话隔离

挂载到会话

创建会话时挂载

路径前缀

删除