问题排查
34-AI 助手 · 2026-10-12 · 2.0 KB
助手的问题九成是三类：① 模型/Key 没配好 ② 上下文太长带不动工具 ③ 被权限门拦住。
本专题手工维护（2026-10-12 建）；⚠ 报错文案以应用当前版本为准（应用给的提示通常已经写明原因 ✓）
一、先按这个顺序查（30 秒定位）
① 模型通道 —— 是否配了可用的文本模型（Key / 积分通道）？模型是否支持工具调用？
② 上下文 —— 会话是不是太长 ⇒ "工具通道不可用"？
③ 权限门 —— 是不是写操作被"规则门禁 / 授权门禁 / 人机协同硬门"拦了？
二、现象 → 原因 → 处置
| 现象 | 常见原因 | 处置 |
|---|---|---|
| 它不回话 / 报未配置模型 | ⚠ 这是前置条件未满足（不是故障）：没配可用的大模型 | 按提示：设置 → API 服务商配 Key；或配 WorkBuddy 云服务后用「积分通道」的模型（免 Key，⚠ 配完要重启应用✓） |
| 换服务商后报「未配置 X 的 API Key 或地址」 | 该服务商没配全 | 去「设置 → API 服务商」补该服务商的 Key/地址 ✓ |
| 报 WorkspaceId 占位符未配置 | API 地址里用了占位符但没填值 | 按提示到「设置 → API Key 管理 → 该服务商」填 WorkspaceId ✓ |
| ★ 提示「这一轮的工具通道不可用（多半是会话上下文过长，带上工具定义就超了服务商上限），模型只好把调用写成了文本。那些调用没有执行 —— 节点、任务或产物都不会真的出现」 | 会话太长，带工具定义超了模型上限 | ⇒ 开一个新会话，再让它做同一件事 ✓（也可先「上下文瘦身」把 prompt 降下来 ✓） |
| ★ 正文里出现"工具调用 / 返回"，但界面提示那是模型自述 | 模型把调用写成了文字，没有真执行 | 回它一句「真的调用工具重试」✓ |
| 正文里的调用提示「（已由应用解析并执行）」 | 这次是真执行（应用解析了它写在正文里的调用） | 看产物卡核对即可 ✓ |
| 写操作被拒：该画布规则还没读 | 第①道门（规则门禁）：写之前必须先读过该画布规则 | 让它先读画布规则再写 ✓ |
| 写操作被拒：这是用户画布、且未开启「AI 编辑授权」 | 第②道门（授权门禁） | 开启「AI 编辑授权」；或让它在自建的沙箱画布里先做 ✓ |
| 报错：海报设计 / 视频剪辑类节点不许在沙箱做 | 人机协同硬门：这类活必须在你看得见、点得到的画布上做 | 到界面上手动施工（这不是故障，是设计 ✓） |
| 点了中止后没有回复 | 正常行为 | 中止即停（模型调用与工具循环都停了，这一轮没有产出回复）⚠ 已提交的生成任务不受影响 ✓ |
| 轨迹里某次工具调用带 ✕ | 该次调用失败（参数/权限/环境） | 看失败原因逐条改；失败记录可删掉（只清会话记录，任务/产物不动 ✓） |
| 产物打不开 / 另存为失败 | 多为远端链接已失效，或产物没本地化到本机 | 让它重新本地化 / 重新生成 ✓ |
| 它说"已完成"但没有产物 | 那是"将要执行"被说成了"已执行" | 看产物卡与产出库（核对为准）；也可要求它"给出产物路径" ✓ |
| 它给的模板 id / 工具名不存在 | 模型凭记忆编了 | 让它先查（模板面/工具面都能现查 ✓）；必要时纠正它 ✓ |
三、排错三条纪律
- 先看应用的提示条 —— "没有执行 / 已执行"这类提示说得非常明确 ⇒ 照它做 ✓
- 一次只改一处：改完就让它单步执行验证（别整段重做 ✓）
- 长会话先开新会话：很多"变笨"的表现其实是上下文太长，不是模型坏了 ✓
四、要报障时，把这四样一起给
| # | 信息 | 从哪拿 |
|---|---|---|
| 1 | 它最后一条回复 + 应用提示条原文（照抄，别转述） | 面板里直接复制 ✓ |
| 2 | 工具调用轨迹（哪一步失败、失败原因） | 展开「工具调用 N 次」✓ |
| 3 | 用的模型 / 通道（本机模型 or 积分通道） | 顶部模型下拉 ✓ |
| 4 | 画布名 + 你要它做的事 | 你刚说的那句话 ✓ |
来源：E:/workbuddyProj/unlimitCanvas/ai_manual/ai_helper/04-问题排查.md