agent space中合同pdf打不开的主因是文件名不含“合同”二字致解析器跳过，或agent未获数据源read权限；需重命名文件、勾选权限、执行resync并检查网络拦截。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Agent Space里上传的合同PDF、审批单Excel或会议纪要Word打不开，双击后提示“文件损坏”“无法加载”或直接无响应，根本不是文件本身问题，而是Agent对数据源的访问权限没配对、解析规则没生效，或者文件名触发了系统自动过滤机制。
检查文件是否被系统跳过解析
Agent Space的PDF解析器默认只处理文件名中含中文“合同”二字的PDF，其他名称如“2024_09_Sales_Agreement.pdf”或“协议V2.pdf”会被直接忽略——上传成功但不入库，后续任何Agent都查不到它。【文件名必须含中文“合同”二字，否则PDF解析器会跳过该文件】
打开Workspace →「Data Sources」→ 找到对应文件存储源 → 点击右侧「View Files」，确认目标文件是否显示在列表中。若未出现，立即重命名文件为“采购合同_20240901.pdf”并重新上传。
验证Agent是否拥有该数据源的读取权限
方法一：图形化授权路径
进入Workspace → 左侧菜单点「Agents」→ 选中目标Agent（如“合同查询员”）→ 点击右上角「Permissions」→ 在「Data Source Access」区域找到对应文件源 → 勾选「Read」权限 → 点「Save Changes」。
AI智能体安全与信任验证。扫描消息、智能体卡及A2A通信中的提示注入、越狱及恶意模式。适用于保护智能体免受攻击、验证外部智能体或扫描不受信任内容。
方法二：YAML配置校验
点击Agent设置页的「Edit YAML」→ 检查permissions字段是否包含如下结构：
permissions: {read: ["contract-archive-bucket"]}
若缺失或拼写错误（比如写成"contract-archieve-bucket"），保存后仍无法读取。
强制刷新Agent对文件的索引状态
第一步：进入「Data Sources」→ 找到对应文件源 → 点击「Resync」按钮。
第二步：等待右上角绿色提示“Resync completed”出现，期间不要关闭页面。
第三步：回到Agent测试面板，输入“请提取合同编号”，观察返回结果是否包含真实字段值——若仍为空，说明索引未重建成功，需检查文件是否被杀毒软件临时锁定或上传时网络中断导致文件体不完整。
排查本地环境兼容性问题
在Chrome或Edge最新版中打开Agent Space，禁用所有浏览器插件（尤其广告拦截类和PDF预览增强类），然后重新加载页面。
若使用企业内网，确认代理策略未拦截/api/v1/data/sources/[id]/preview接口——该接口负责向前端返回可渲染的文件内容流，拦截后表现为“打不开”但无报错提示。
