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

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

- 类型: 公开网页
- 规范页面: [https://www.shotomatic.com/zh-cn/guide/ai-agents/errors](https://www.shotomatic.com/zh-cn/guide/ai-agents/errors)
- Markdown 页面: [https://www.shotomatic.com/zh-cn/guide/ai-agents/errors.md](https://www.shotomatic.com/zh-cn/guide/ai-agents/errors.md)

浏览用户指南

本页内容

1.  [错误代码](#错误代码)
2.  [截图为什么暂停](#截图为什么暂停)
3.  [截图为什么结束](#截图为什么结束)

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

## 错误代码

代码

含义

你可以做什么

`approval_required`

智能体还没有获得批准。批准之前，它只能读取状态。

打开 Shotomatic，在批准卡片上选择**允许**。

`permission_required`

macOS 没有授予**屏幕录制**，或按键所需的**辅助功能**权限。

在**系统设置 > 隐私与安全性**中开启 Shotomatic，然后重新打开它。请参阅 [macOS 权限](https://www.shotomatic.com/zh-cn/guide/get-started/macos-permissions)。

`license_limit`

达到了免费版的上限，例如每天的截图数或每批的网址数。

缩小任务、明天再试，或查看[价格](https://www.shotomatic.com/zh-cn/pricing)。已经保存的截图会保留。

`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`

出现了其他问题。

查看消息后重试；如果反复出现，请[联系支持](mailto:support@shotomatic.com)。

## 截图为什么暂停

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

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

## 截图为什么结束

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

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

以下需要你留意：

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

仍未解决？请参阅[问题排查](https://www.shotomatic.com/zh-cn/guide/troubleshooting/common-issues#ai-%E6%99%BA%E8%83%BD%E4%BD%93%E6%97%A0%E6%B3%95%E8%BF%9E%E6%8E%A5%E6%88%96%E6%97%A0%E6%B3%95%E4%BD%BF%E7%94%A8-shotomatic)或[客户端问题排查列表](https://www.shotomatic.com/zh-cn/guide/ai-agents/other-agents#%E9%97%AE%E9%A2%98%E6%8E%92%E6%9F%A5)。

## 本页内容

1.  [错误代码](#错误代码)
2.  [截图为什么暂停](#截图为什么暂停)
3.  [截图为什么结束](#截图为什么结束)

## 关于此版本

此 Markdown 页面根据 Shotomatic 服务端渲染的公开页面生成，不包含交互控件和网站导航。引用或分享时，请使用规范页面。
