浏览用户指南

智能体错误与解决方法

AI 智能体可能从 Shotomatic 收到的错误代码和停止原因、它们的含义,以及你可以怎么处理。

更新日期 2026年11月16日

查看 Markdown
本页内容

当 Shotomatic 的工具无法完成智能体的请求时,会返回一个错误,包含 code、消息、重试是否可能有效,以及常常附带的一步需要你做的操作。好的智能体会把这一步转告给你。本页列出所有代码,方便你在智能体报告错误时知道该做什么。

错误代码

代码含义你可以做什么
approval_required智能体还没有获得批准。批准之前,它只能读取状态。打开 Shotomatic,在批准卡片上选择允许。
permission_requiredmacOS 没有授予屏幕录制,或按键所需的辅助功能权限。在系统设置 > 隐私与安全性中开启 Shotomatic,然后重新打开它。请参阅 macOS 权限。
license_limit达到了免费版的上限,例如每天的截图数或每批的网址数。缩小任务、明天再试,或查看价格。已经保存的截图会保留。
pro_feature请求用到了需要 Pro 的功能,对智能体和对你都一样。去掉这个功能再请求,或升级到 Pro。
busy另一个截图任务正在运行,或 Shotomatic 正在向你确认别的事。等另一个任务结束或停止它,回答已打开的卡片,然后再请求一次。
source_unavailable窗口或屏幕已经不在了,或者无法截取。重新打开窗口,或请智能体选择其他来源。
not_found会话、文档、工作流或任务的 ID 已不存在。请智能体重新列出项目。
revision_conflict智能体读取文档后,文档发生了变化,通常是因为你编辑了它。智能体需要重新读取文档,再应用一次修改。
browser_not_installed网页截图需要 Shotomatic 的浏览器,但它还没有安装。在 Shotomatic 中打开网页截图页面并安装浏览器。
invalid_request智能体发送了 Shotomatic 无法使用的值。通常智能体会自己修正。如果反复出现,换一种说法再请求。
confirmation_declined你在确认卡片上选择了取消。不需要做什么。没有删除或安排任何内容。
confirmation_timeout一分钟内没有人回答确认卡片。等你在电脑前时再请求一次。
unavailableShotomatic 主窗口没有打开,或应用无法启动任务。打开 Shotomatic,保持主窗口打开,然后再请求一次。
failed出现了其他问题。查看消息后重试;如果反复出现,请联系支持。

截图为什么暂停

智能体发起的自动截图不会在错误的位置按键,而是暂停:

  • **其他窗口在前面:**被截取的窗口不在最前面时,Shotomatic 不会按任何键。把窗口调回最前面,再告诉智能体继续。截图期间不要操作电脑。
  • **屏幕已锁定:**解锁后告诉智能体继续。

截图为什么结束

任务结束时,智能体会收到原因。以下属于正常结束:

  • **内容不再变化:**设置了按键时,页面不再变化 Shotomatic 就会停止,例如到了书的最后一页。
  • **达到停止条件:**达到了你要求的截图数、时长或结束时间。
  • 由你或智能体停止:你选择了完成截图,或智能体停止了任务。已经截取的截图会保留。

以下需要你留意:

  • **达到免费上限:**免费版的上限结束了这次截图。之前保存的截图在截图历史中。在免费版中,Action Capture 满 5 个步骤就会结束。
  • **窗口已关闭:**截图过程中,被截取的窗口被关闭了。
  • **窗口无法保持在最前面:**Shotomatic 无法把窗口调到最前面。让窗口保持可见,不要操作电脑,然后请智能体重新开始。
  • **会话在别处结束:**截图过程中,截图会话在 Shotomatic 中被关闭了。

仍未解决?请参阅问题排查或客户端问题排查列表。

智能体错误与解决方法 | 用户指南 | Shotomatic