文件是独立管理的资源，可被多个会话挂载，生命周期与会话解耦。在控制台文件菜单上传与管理。
配额与限制
-
单个文件最大 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"file = client.files.upload("sales_2025.csv")
print(file.id)AgentStudioFile file = client.files().upload(Paths.get("sales_2025.csv"), "text/csv");
System.out.println(file.getId());会话隔离
将文件挂载到会话时，服务端会做一份内部拷贝挂入会话沙箱，原始文件不受会话内修改影响。可在会话详情查看挂载文件的实际副本。
挂载到会话
创建会话时挂载
在新建会话抽屉的挂载资源区点击添加文件，选择已上传的文件，填写挂载路径，例如 /uploads/workspace/data.csv。路径必须以 /uploads/ 开头。
路径前缀
填写的挂载路径会被加上 /mnt/session 前缀。路径必须以 /uploads/ 开头。例如：
|
填写路径 |
实际路径（智能体看到的） |
|
|
|
→ |
|
|
|
→ |
|
智能体在工具调用中应使用实际路径访问。在系统提示词中可直接告知完整路径，例如：数据文件位于 /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"}
]
}'session = client.sessions.create(
agent="agent_xxx",
environment_id="env_xxx",
resources=[
{"type": "file", "file_id": "file_xxx", "mount_path": "/uploads/workspace/data.csv"},
],
)Session session = client.sessions().create(SessionCreateParam.builder()
.agentId("agent_xxx")
.environmentId("env_xxx")
.resources(List.of(SessionResource.builder()
.type("file")
.fileId("file_xxx")
.mountPath("/uploads/workspace/data.csv")
.build()))
.build());删除
文件只支持删除，不支持归档。在文件页面点击对应文件行的删除，文件将被硬删除，不可恢复。已挂载到会话的副本不受影响。
通过 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"client.files.delete("file_xxx")client.files().delete("file_xxx");