上传失败主因是文件名缺“合同”二字、Agent无Read权限、RAM子账号缺AliyunPAIFullAccess权限，或PDF超15MB/单次超50个。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在Agent Space中上传文件时遇到“上传失败”提示，页面卡在进度条99%、弹出红色报错框或根本无响应，常见于PDF合同归档、知识库初始化、多Agent协作链路搭建等关键环节——这往往不是网络抖动，而是系统在权限、格式、路径三处设了硬性拦截点。
检查文件名是否含中文“合同”二字
进入「Data Sources」→「File Storage」→「Upload Files」后，若上传的PDF始终失败且无具体错误码，先暂停所有操作。打开本地文件管理器，右键重命名该PDF，确保文件名中【必须包含中文“合同”二字】（例如“2026年采购合同_v2.pdf”可过，“procurement-agreement-2026.pdf”会被解析器直接跳过）。Agent Space的PDF解析模块仅识别含“合同”字样的文件名，这是硬编码规则，不支持通过配置关闭。
验证当前Workspace是否已绑定数据源权限
点击左侧菜单「Agents」→ 找到正在使用的Agent（如“合同查询员”）→ 点击右侧「Edit」→ 滚动至「Permissions」区域。确认该Agent对目标数据源的权限状态为「Read」且开关已开启。若此处为空白或显示“Not authorized”，说明上传行为本身成功，但Agent无法读取——后续所有检索、提取操作都会静默失败，不会报错。
注意：权限绑定必须在上传完成后手动勾选，系统不会自动关联新上传的文件。
从经过验证的商家搜索、比较并购买产品。返回包含决策包（优缺点、适用场景、过敏原、验证价格）的结构化产品数据，而非原始网页抓取结果。无需验证码或身份验证。覆盖约980种产品和10家商家。适用于用户想要查找、比较或购买产品的场景。
排查RAM子账号权限缺失
方法一：用主账号登录PAI控制台 → 进入目标Workspace → 点击左上角「成员管理」→ 查看当前用户角色。若角色为“只读成员”，则文件上传入口被隐藏，所有上传按钮均不可见，此时看到的“失败”其实是界面未加载出上传控件。
方法二：若使用RAM子账号，必须提前在RAM控制台为其授予【AliyunPAIFullAccess】权限。未授予时，即使能看到上传按钮，点击后也会返回403错误且无提示。该权限需主账号手动附加，无法由Workspace管理员代授。
确认单个PDF不超过15MB且一次不传超50个
第一步：用系统自带文件属性查看功能，核对PDF实际大小。某些扫描版PDF表面显示12MB，但解压后元数据膨胀至18MB，会触发后台校验拦截。
第二步：若需批量上传，严格遵守【一次最多50个文件】限制。超过后系统将拒绝整个批次，但仅提示“upload failed”，不说明超量。建议分批上传，每批命名加序号（如“合同_01”“合同_02”），便于后续定位问题文件。
