构建失败需先确认阶段：Building→Failed为构建阶段，Deploying→Failed为部署阶段；再查日志中validator error、connector not found、LLM output malformed三类关键错误；最后回溯指令绑定与连接器权限。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在 AgentSpace 中构建 Agent 失败时，界面常只显示“部署失败”或“校验不通过”，但不指明哪一步出错、为什么失败、是否可修复。这导致业务人员反复提交、工程师盲目查日志、问题卡在 UI 层无法下钻。
确认失败是否发生在构建阶段
打开 AgentSpace 控制台 → 进入目标 Agent 的「版本管理」页 → 找到最新一次构建记录 → 点击右侧「详情」链接。如果状态是 【Building】→【Failed】，且失败时间在 5 分钟内，说明是构建阶段失败；若状态为 【Deploying】→【Failed】，则属于部署阶段，需跳转至下一节。
注意：构建失败通常伴随红色感叹号图标和简短提示（如“指令语法错误”“连接器未授权”），但该提示不可靠——它可能只是最后一步的表象，真正问题藏在上游。
检查构建日志中的关键断点
在构建详情页中，点击「查看日志」按钮，日志按时间倒序排列。不要从头往下扫，直接定位以下三类行：
① 含 validator error 的行：这是平台内置校验器抛出的硬性拦截，比如工具参数类型不符、必填字段为空、JSON Schema 校验失败。这类错误必须修正后才能继续构建。
② 含 connector not found 或 permission denied for connector 的行：说明所选连接器未启用，或当前用户无权调用该连接器。此时需回到「连接器管理」页确认状态，并检查 IAM 权限是否包含 aidevops:UseConnector。
③ 含 LLM output malformed 的行：表示模型生成的结构化输出（如 JSON 工具调用）格式非法。常见于自定义系统提示词中约束过松，或未开启「强制 JSON 输出」开关。此错误不会报具体哪一行错，但一定出现在「指令设计」模块保存之后。
回溯指令与数据源绑定关系
方法一：在「Agent 设计画布」中，逐个点击已添加的节点 → 查看右侧面板「输入映射」区域。若某字段映射表达式为 {{inputs.xxx}}，但左侧「输入参数定义」里没有 xxx 字段，则构建会静默失败——平台不报错，但在日志末尾出现 input binding unresolved。
方法二：检查所有「数据源查询」节点是否配置了有效索引。例如连接 ElasticSearch 时，若填写的 【Index name】 不存在或拼写错误，构建过程不会中断，但后续任何依赖该节点的逻辑都会因空结果而触发下游校验失败。
这一步操作起来很简单，直接把鼠标悬停在节点右上角的「i」图标上，就能看到实时解析状态。灰色叹号表示未就绪，绿色对勾才代表绑定成功。
验证连接器权限与运行时上下文
步骤一：进入「连接器管理」→ 找到构建日志中报错的连接器 → 点击「测试连接」。若测试失败，说明凭证过期、网络策略阻断或服务端拒绝，需联系平台管理员更新密钥或放行出口 IP。
步骤二：在构建详情页底部，展开「运行时上下文」折叠区 → 查看 user_identity 字段值。如果显示为 【anonymous】，说明当前构建未绑定真实身份上下文，所有需鉴权的连接器调用都会被拒绝——即使你在 UI 上点了「授权」，也必须在「Agent 设置」→「执行身份」中显式选择服务角色。
步骤三：确认该连接器是否支持当前 Agent 的执行模式。例如某些数据库连接器仅允许在「后台任务」模式下调用，若 Agent 设置为「即时响应」模式，则构建会通过，但首次运行即失败，且错误不体现在构建日志中。
