必须立刻定位是前端JS错误、API响应异常还是权限拦截导致，否则无法继续配置Agent或调试工作流；通过F12打开开发者工具，优先查看Console中Uncaught Error等红色报错，若无则切换Network筛选401/403/500请求，并检查URL是否为agentloop4service域名及embed参数是否合法。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当你在Agent Space控制台操作时页面突然白屏、按钮点击无反应或弹出“Something went wrong”，必须立刻定位是前端JS错误、API响应异常还是权限拦截导致，否则无法继续配置Agent或调试工作流。
打开浏览器开发者工具抓取实时错误
按 F12 或 Cmd+Option+I（Mac）唤出开发者工具 → 切换到「Console」标签页 → 刷新页面重现报错。重点捕获以 Uncaught Error、TypeError 或 SyntaxError 开头的红色堆栈信息。
若控制台空空如也，说明错误未触发JS异常，而是静默失败——此时必须切换到「Network」标签页，筛选 XHR/Fetch 请求，查找状态码为 401（登录态失效）、403（权限不足）或 500（后端崩溃）的请求项。
区分前端报错与后端API失败
方法一：检查报错是否带 agentloop 或 agentspace 域名前缀
若 Console 中报错路径含 https://agentloop4service.console.aliyun.com/...，属于 AgentLoop 内嵌页面自身 JS 错误，需确认是否使用了内嵌免登录链接且未正确传入 embed 参数；
方法二：在 Network 面板中点击失败请求 → 查看「Response」或「Preview」内容
若返回体是 JSON 且含 "code": "PermissionDenied" 或 "message": "workspace not found"，说明后端已明确拒绝，此时应跳转至权限或 Workspace 配置环节排查；
若响应为空白或显示 HTML 片段（如 Nginx 502 页面），说明网关层已中断，需检查 agentloop4service 域名是否被误配为普通控制台域名。
验证是否为内嵌集成导致的上下文丢失
第一步：确认当前访问地址是否为 agentloop4service.console.aliyun.com
严禁使用 https://pai.console.aliyun.com 或其他控制台域名打开 AgentSpace 页面，否则 iframe 内嵌会因跨域或登录态隔离直接白屏。
第二步：检查 URL 中是否包含合法 embed 参数
正常内嵌链接必须含 embed=... 且经 URL 编码，例如：embed=%7B%22sidebar%22%3A%22hidden%22%7D。若缺失或格式错误（如未编码、含非法字符），页面将无法初始化 React 上下文，直接卡在 loading 状态。
第三步：在 Console 中执行 window.parent?.location?.href
若返回 undefined 或报 Blocked a frame with origin ...，说明当前页面未运行在合法 iframe 中，或父页面未正确注入身份凭证 —— 此时需回退至第三方系统服务端，重新生成 destination 并调用 STS AssumeRole 获取临时 token。
