github/dootask
1
0
Fork 0
mirror of https://github.com/kuaifan/dootask.git synced 2026-08-26 06:39:03 +00:00
Code Issues Packages Projects Releases Wiki Activity
dootask/resources/ai-kb/zh/faq/ai-assistant/tool-failed.md

2.0 KiB
Raw 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 秒超时，长操作（大列表/复杂搜索）会断
  • 页面不在线：页面工具（execute_action）需要前端 socket 在线，关浏览器后立刻调用会失败
  • 模型不支持 tool call：选了纯文本模型，根本不会调

解决

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

相关