mirror of
https://github.com/kuaifan/dootask.git
synced 2026-07-31 18:35:56 +00:00
da095a1a80
页面操作传输层从 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>
50 lines
2.0 KiB
Markdown
50 lines
2.0 KiB
Markdown
---
|
||
id: ai-assistant.tool-failed.faq
|
||
title: AI 工具调用失败怎么办
|
||
type: faq
|
||
feature: ai-assistant
|
||
scope: end-user
|
||
locale: zh
|
||
aliases:
|
||
- AI 调工具报错
|
||
- tool_call failed
|
||
- AI 操作失败
|
||
- AI 工具不响应
|
||
- AI 卡在执行中
|
||
- AI 调用超时
|
||
related_tools: []
|
||
related_pages: []
|
||
prerequisites: []
|
||
negative:
|
||
- 工具失败不会自动二次重试，需用户重新触发
|
||
- 失败不会回滚已成功的工具（如已建任务再发消息失败，任务保留）
|
||
- 隐藏错误细节属正常，敏感字段不会暴露给用户
|
||
last_verified: v1.7.90
|
||
---
|
||
|
||
# AI 工具调用失败怎么办
|
||
|
||
## 问题
|
||
浮窗里 AI 调工具的气泡显示「失败」「执行超时」「无权限」「找不到资源」等，回复也提示"没能完成"。
|
||
|
||
## 常见原因
|
||
- **后端短时不可用**：`mcp_server` 容器重启 / 网络抖动
|
||
- **权限不足**：操作了你没权限访问的资源（如别人的任务、非成员的项目）
|
||
- **参数错误**：AI 推断的 ID 不存在（如任务已被删）
|
||
- **超时**：单次工具调用默认 30 秒超时，长操作（大列表/复杂搜索）会断
|
||
- **页面不在线**：页面操作（打开任务/跳页面/操作元素）需要前端 socket 在线，关浏览器后立刻让 AI 操作会失败
|
||
- **模型不支持 tool call**：选了纯文本模型，根本不会调
|
||
|
||
## 解决
|
||
1. **重试**：浮窗里点工具气泡上的「重试」按钮，或回复"再试一次"
|
||
2. **换措辞**：原句太模糊就给更具体的 ID / 关键词
|
||
3. **检查权限**：项目级问负责人加成员；任务级问任务负责人加可见用户
|
||
4. **换模型**：选标注「支持工具」的模型，浮窗顶部切换
|
||
5. **刷新页面**：页面动作失败时刷新一次后再让 AI 重试
|
||
6. **联系管理员**：连续失败请通知管理员看 `mcp_server` 插件日志
|
||
|
||
## 相关
|
||
- 工具机制：[[ai-assistant.tools.concept]]
|
||
- 权限不足：[[ai-assistant.tool-permission.faq]]
|
||
- MCP 不可用：[[ai-assistant.mcp-down.faq]]
|