智能体错误与解决方法
AI 智能体可能从 Shotomatic 收到的错误代码和停止原因、它们的含义,以及你可以怎么处理。
更新日期 2026年11月16日
当 Shotomatic 的工具无法完成智能体的请求时,会返回一个错误,包含 code、消息、重试是否可能有效,以及常常附带的一步需要你做的操作。好的智能体会把这一步转告给你。本页列出所有代码,方便你在智能体报告错误时知道该做什么。
错误代码
| 代码 | 含义 | 你可以做什么 |
|---|---|---|
approval_required | 智能体还没有获得批准。批准之前,它只能读取状态。 | 打开 Shotomatic,在批准卡片上选择允许。 |
permission_required | macOS 没有授予屏幕录制,或按键所需的辅助功能权限。 | 在系统设置 > 隐私与安全性中开启 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 | 一分钟内没有人回答确认卡片。 | 等你在电脑前时再请求一次。 |
unavailable | Shotomatic 主窗口没有打开,或应用无法启动任务。 | 打开 Shotomatic,保持主窗口打开,然后再请求一次。 |
failed | 出现了其他问题。 | 查看消息后重试;如果反复出现,请联系支持。 |
截图为什么暂停
智能体发起的自动截图不会在错误的位置按键,而是暂停:
- **其他窗口在前面:**被截取的窗口不在最前面时,Shotomatic 不会按任何键。把窗口调回最前面,再告诉智能体继续。截图期间不要操作电脑。
- **屏幕已锁定:**解锁后告诉智能体继续。
截图为什么结束
任务结束时,智能体会收到原因。以下属于正常结束:
- **内容不再变化:**设置了按键时,页面不再变化 Shotomatic 就会停止,例如到了书的最后一页。
- **达到停止条件:**达到了你要求的截图数、时长或结束时间。
- 由你或智能体停止:你选择了完成截图,或智能体停止了任务。已经截取的截图会保留。
以下需要你留意:
- **达到免费上限:**免费版的上限结束了这次截图。之前保存的截图在截图历史中。在免费版中,Action Capture 满 5 个步骤就会结束。
- **窗口已关闭:**截图过程中,被截取的窗口被关闭了。
- **窗口无法保持在最前面:**Shotomatic 无法把窗口调到最前面。让窗口保持可见,不要操作电脑,然后请智能体重新开始。
- **会话在别处结束:**截图过程中,截图会话在 Shotomatic 中被关闭了。