kuaifan da095a1a80 feat(ai-assistant): 页面操作搬到主程序 /ws + doo task notify + 删 OCR
页面操作传输层从 MCP 独立 WebSocket 迁到主程序常驻 /ws:
- 后端 AssistantController 加 operation__dispatch/result(fd 归属校验 +
  PushTask 精推 + Cache 轮询取结果),WebSocketService onMessage 加
  operationResult 回包分支
- 前端 actions.js 加 case "operation" 经 emitter 桥接到浮窗执行后回包;
  float-button.vue 接 aiOperationRequest;operation-module.js 解耦、
  executor 惰性化;删除 operation-client.js(不再单连 MCP WS)

ai-kb 同步:tool-binding.yaml 去掉 4 个工具(3 页面 + OCR),相关 chunk
reconcile(措辞去 MCP 化、OCR 改多模态识图),工具数 33→29

i18n:后端新增文案登记 original-api.txt

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-12 01:31:21 +00:00

2.0 KiB
Raw Permalink Blame History

id, title, type, feature, scope, locale, aliases, related_tools, related_pages, prerequisites, negative, last_verified
id title type feature scope locale aliases related_tools related_pages prerequisites negative last_verified
ai-assistant.tool-failed.faq AI 工具调用失败怎么办 faq ai-assistant end-user zh
AI 调工具报错
tool_call failed
AI 操作失败
AI 工具不响应
AI 卡在执行中
AI 调用超时
工具失败不会自动二次重试,需用户重新触发
失败不会回滚已成功的工具(如已建任务再发消息失败,任务保留)
隐藏错误细节属正常,敏感字段不会暴露给用户
v1.7.90

AI 工具调用失败怎么办

问题

浮窗里 AI 调工具的气泡显示「失败」「执行超时」「无权限」「找不到资源」等,回复也提示"没能完成"。

常见原因

  • 后端短时不可用mcp_server 容器重启 / 网络抖动
  • 权限不足:操作了你没权限访问的资源(如别人的任务、非成员的项目)
  • 参数错误AI 推断的 ID 不存在(如任务已被删)
  • 超时:单次工具调用默认 30 秒超时,长操作(大列表/复杂搜索)会断
  • 页面不在线:页面操作(打开任务/跳页面/操作元素)需要前端 socket 在线,关浏览器后立刻让 AI 操作会失败
  • 模型不支持 tool call:选了纯文本模型,根本不会调

解决

  1. 重试:浮窗里点工具气泡上的「重试」按钮,或回复"再试一次"
  2. 换措辞:原句太模糊就给更具体的 ID / 关键词
  3. 检查权限:项目级问负责人加成员;任务级问任务负责人加可见用户
  4. 换模型:选标注「支持工具」的模型,浮窗顶部切换
  5. 刷新页面:页面动作失败时刷新一次后再让 AI 重试
  6. 联系管理员:连续失败请通知管理员看 mcp_server 插件日志

相关