调用 Muse Wonder 工具失败时须按 error.code 分三类处理:超时则异步轮询,参数错误则仅修正指定字段,执行失败则终止并进人工队列;连续两次同类失败触发 Active Focus 澄清机制,强制二次授权,记忆不等于授权。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

调用 Muse Wonder 工具失败时,不能依赖模型自动重试或越权补救,必须由开发者在服务端设置明确的失败响应路径和人工干预闸门。
确认失败是否来自工具权限缺失
检查返回 error.code 是否为 【permission_denied】 或 error.message 包含 “tool not authorized” 字样。这类失败不是网络或参数问题,而是服务端未向该会话授予对应工具的调用白名单。
直接跳过重试逻辑,进入权限审核流程——模型的记忆再强,也不能把“用户曾经授权过”反演为“本次仍可执行”。
区分三类失败并路由到不同处理分支
方法一:error.code === "tool_timeout" → 触发单次异步轮询(间隔 3s,最多 2 次),不修改参数重发请求;
方法二:error.code === "invalid_parameters" → 提取 error.suggestion 中的字段名,用固定 schema 校验后仅重传修正字段,其余保持原 payload 不变;
方法三:error.code === "execution_failed" → 立即终止当前工具链,记录 error.trace_id,将完整上下文 + 工具输入/输出快照推入人工审核队列。
启用 Active Focus 的阻塞澄清机制
第一步:检测连续两次同一工具返回 execution_failed 或 invalid_parameters;
第二步:暂停所有自动工具调用,向用户发起结构化澄清请求,包含三项必填字段:失败工具名、最后一次输入摘要、你希望它现在做什么;
第三步:收到用户回复后,不直接喂给模型重试,而是先比对历史 memory 中该用户对同类操作的授权记录——若无近 72 小时内显式确认,则强制弹出二次授权弹窗。
这一步不可跳过。Active Focus 的“持续推进”前提是每次推进都有独立授权证据,【记忆不等于授权】。

















