导出失败需立即定位原因：权限不足（permission denied）、前端拦截（failed to fetch）或后端存储问题（storage full）；须依次检查agent读取权限、下载路径合规性及agent bucket状态。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Agent Space文件导出失败会导致项目进度中断、协作节点卡顿、本地备份缺失，必须立即区分是前端阻塞、权限拦截还是后端存储层拒绝写入。
确认导出失败的具体报错类型
点击导出按钮后，观察右下角弹窗或控制台（F12 → Console）中的错误信息：若显示“Permission denied”或“No read access to source”，说明当前Agent无该文件读取权限；若显示“Failed to fetch”或“Network Error”，大概率是前端请求未发出或被代理拦截；若显示“Export quota exceeded”或“Storage full”，则指向后端配额或空间耗尽问题。
【注意】不要直接重试——重复触发失败导出会加重后端队列压力，尤其在多Agent并行导出时可能引发连锁超时。
检查并修复Agent对目标文件的读取权限
进入对应Workspace → 左侧导航栏点击「Data Sources」→ 找到该文件所在的数据源（如“contract-archive-bucket”或“sales-reports”）→ 点击右侧「Permissions」→ 在列表中定位执行导出操作的Agent（例如“合同查询员”或“周报生成器”）→ 确保其状态为“Read: ✅”，若为“❌”或空白，立即勾选并保存。
这一步不可跳过：Agent Space默认不继承Workspace级权限，每个数据源需单独授权。未授权时导出请求会在网关层被静默拦截，前端仅显示“失败”而无详细原因。
验证导出目标路径是否符合平台规则
方法一：使用系统默认下载路径
确保浏览器未启用“禁止自动下载”策略（Chrome设置 → 隐私设置和安全性 → 网站设置 → 自动下载 → 允许）；导出时不要手动修改保存位置，先用默认路径测试是否成功。
方法二：指定自定义路径（仅限桌面端v26.415+）
点击导出按钮旁的齿轮图标→勾选“Custom save location”→选择本地非系统保护目录（如D:\agent-exports），【避开C:\Windows、C:\Program Files及任何带中文空格或特殊符号的路径】；部分杀毒软件会拦截写入系统关键目录，导致导出无声失败。
排查后端存储配额与Agent Bucket状态
第一步：确认当前Workspace绑定的Agent Bucket是否健康
进入「Settings」→「Storage」→ 查看“Active Bucket”状态是否为“Online”；若显示“Degraded”或“Offline”，立即切换至备用Bucket或联系管理员。
第二步：检查单Agent空间配额余量
在相同页面下拉，找到“Agent Space Quota”栏目→ 对照导出文件大小（如PDF合同平均3MB）与剩余可用空间（如“287 MB / 500 MB”）→ 若剩余不足，需清理旧文件或申请扩容。
第三步：验证Space级写入能力
打开终端，执行：curl -X POST https://your-agentspace-domain/api/v1/spaces/{space_id}/test-write -H "Authorization: Bearer YOUR_TOKEN" → 返回HTTP 200且body含"write_ok:true"即表示底层存储可写；若返回403或503，说明Agent Bucket的Space隔离层已拒绝该Agent的写操作。
