必须查看构建日志定位agent问题，其入口需满足cms 2.0、mse、sls均“已就绪”且地域为cn-hangzhou/shanghai/hongkong；可通过agents列表⚙️图标或deployment页view logs进入；日志以[build start]开头，重点查error、yaml行错、权限拒绝及工具未调用等线索。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在 Agent Space 中排查 Agent 构建失败、部署卡顿或 YAML 解析异常时，必须直接查看构建日志，仅靠界面提示无法定位到具体哪一行语法错误或权限拒绝原因。
确认构建日志入口是否可用
构建日志功能仅在 AgentSpace 已完成 CMS 2.0、MSE、SLS 三项资源绑定且状态均为「已就绪」后才激活。若空间详情页【基础信息与资源绑定】中任一栏显示「创建中」或「失败」，则日志面板将完全不可见，点击无响应。
【所在地域必须为 cn-hangzhou、cn-shanghai 或 cn-hongkong，其他地域不提供构建日志服务】
进入构建日志页面的两种路径
方法一：从 Agents 列表页快速直达
进入 Workspace → 点击左侧导航栏「Agents」→ 找到目标 Agent 行末的「⚙️」图标 → 鼠标悬停显示“查看构建日志”，单击即跳转至该 Agent 的实时构建日志流页面。
方法二：通过 Agent 详情页访问
点击 Agent 名称进入详情页 → 顶部标签栏切换至「Deployment」→ 在「Build Status」区域右侧，点击「View Logs」按钮 → 页面加载后自动滚动至最新日志行。
识别关键日志段落并定位问题
第一步：查找日志起始标记
每轮构建日志以 [BUILD START] agent-name@v1.2.0 开头，后接时间戳和 Git commit ID。若未看到该标记，说明构建流程尚未触发，需检查 AGENTS.md 是否已保存或 YAML 文件是否被误删。
第二步：定位错误源头
向下滚动，重点搜索含 ERROR、Failed to parse、permission denied 或 403 的行。例如：ERROR: failed to load tools config — yaml: line 12: did not find expected key
这表示第 12 行 YAML 缩进错误或冒号后缺少空格，必须修正后重新保存文件。
第三步：验证工具调用链完整性
若日志中出现 tool "pdf-search" registered 但后续无任何 calling pdf-search with... 记录，说明该工具虽注册成功，却未被 Prompt 或 workflow 触发——此时应检查 Agent 的 role 描述是否遗漏了“需调用 pdf-search 工具”等明确指令。
