agent space前端文件上传单文件硬限15mb，超限将静默失败；可通过本地分卷压缩上传、挂载s3兼容存储桶或调用openapi直传三种方式突破限制。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在Agent Space中上传或处理超过15MB的合同PDF、设计稿ZIP包、原始日志CSV等大文件时，系统会直接拒绝上传或触发静默失败，必须拆分、压缩或切换存储路径才能完成操作。
识别当前文件大小限制与报错特征
进入Workspace → 点击「Data Sources」→「+ Add Source」→ 选择「File Storage」→ 点击「Upload Files」。此时若拖入一个23MB的PDF，界面不会弹出错误提示，但上传进度条卡在99%后自动消失，且文件列表中无任何新增项——这是典型的超限静默拦截。
【所有通过前端「Upload Files」入口提交的单文件，硬性上限为15MB】，该限制无法在UI中修改或绕过。
方法一：本地预处理——压缩+分卷上传
第一步：用7-Zip或macOS终端执行zip -s 10m large_contract_bundle.zip，将原文件切分为多个≤10MB的分卷（如large_contract_bundle.z01、large_contract_bundle.z02）。
第二步：逐个上传分卷文件。注意：必须保持原始文件名前缀一致，且全部分卷需上传至同一数据源目录下，否则Agent解析器无法自动重组。
第三步：在Agent配置中启用解压工具链。编辑agent.json，在"tools"数组里加入{"name": "unzip-bundle", "description": "reconstruct and extract split ZIP archives"}，否则Agent运行时会把.z01文件当作普通二进制对象跳过处理。
方法二：绕过前端——挂载S3兼容存储桶
点击顶部导航栏「Settings」→「Infrastructure」→「External Storage」→「Add S3-Compatible Bucket」。
填入Endpoint、Access Key、Secret Key及Bucket名称；勾选「Enable Direct Read for All Agents」。
这一步完成后，无需上传任何文件到Agent Space本地存储——Agent可直接通过tools: ["s3-reader"]从远端桶拉取GB级日志包或视频帧序列，且不占用Workspace配额。
【注意：必须确保Bucket策略允许GET+LIST操作，否则Agent会返回“AccessDenied”而非“File not found”】。
方法三：用OpenAPI直传大文件到后台存储卷
调用POST /v1/spaces/{space_id}/files/upload接口，使用multipart/form-data方式提交：
• file字段传原始大文件流（无15MB限制）；
• path字段指定目标路径，如"/ingest/raw/202609_q3_financials.xlsx"；
• metadata字段可附加{"source": "erp-export", "processed_by": "finance-agent"}用于后续检索。
请求成功后返回file_id（如fil_8a3f9c2d），该ID可直接注入workflow.yaml的input节点，跳过UI上传环节。
