文件上传与挂载 - Agent Studio

配额与限制

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

上传

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

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"

会话隔离

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

挂载到会话

创建会话时挂载

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

运行时挂载

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

路径前缀

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

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

智能体在工具调用中应使用实际路径访问。在系统提示词中可直接告知完整路径，例如：数据文件位于 /mnt/session/uploads/workspace/data.csv。

卸载

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

# 创建会话时挂载
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": "/workspace/data.csv"}
    ]
  }'

# 运行时追加挂载
curl -X POST "https://{workspace_id}.cn-beijing.maas.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": "/workspace/late.csv"}'

删除

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

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

下一步

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

​配额与限制

​上传

​会话隔离

​挂载到会话

​创建会话时挂载

​运行时挂载

​路径前缀

​卸载

​删除

​下一步