Shortcuts AI 故障排查
解决设置密钥、共享表单、权限、工具、账单和 Agent 会话中的常见问题。
请先在“快捷指令”App 中直接运行一次 Agent。直接运行可以帮助判断问题来自 Agent 本身，还是 Siri、共享表单、操作按钮或小组件。
设置时没有打开快捷指令
在 iPhone 上返回 Shortcuts AI 设置页面，再次轻点 继续设置。该按钮会先复制设置密钥，再打开 Apple 快捷指令。
如果仍然无法自动跳转：
- 在设置页面使用 复制密钥。
- 选择页面显示的手动安装选项。
- Apple 快捷指令要求填写密钥时，粘贴刚才复制的内容。
- 轻点 添加快捷指令。
不要粘贴被缩短或部分隐藏的密钥。
设置密钥或身份验证失败
设置密钥用于把共享的 Agent 快捷指令连接到你的账户。如果 Agent 报告身份验证问题，请返回设置页面，选择 修复配对，再使用页面当前显示的密钥重复安装步骤。
如果你曾经通过信息或备忘录转存密钥，请改为直接从设置页面复制。不要向他人透露密钥。
共享表单中找不到 Agent
先确认正在共享的是支持的输入，例如文本、链接、Safari 网页、图片、音频、PDF 或其他文件。
然后在“快捷指令”App 中打开 Agent，进入快捷指令详情，并确认 在共享表单中显示 已启用。当所选内容与快捷指令接受的输入类型不匹配时，App 可能不会显示该快捷指令。
如果某个 App 无法提供合适的共享输入，仍可以打开“快捷指令”App，直接运行 Agent。
Siri、操作按钮或小组件无法启动 Agent
请先在“快捷指令”App 中直接运行 Agent。如果直接运行正常，再检查对应入口：
- Siri： 说出快捷指令的完整名称。如果 Siri 经常选择其他内容，可以改成一个简短、独特的名称。
- 操作按钮： 确认按钮已指定为运行 Agent 快捷指令。
- 小组件： 编辑“快捷指令”小组件并选择 Agent，或选择包含 Agent 的文件夹。
具体入口取决于 iPhone 型号和操作系统版本。
App 请求权限或操作失败
本地权限由 Apple 快捷指令和执行操作的 App 控制。请检查授权提示，只允许你愿意授予的访问权限。
如果之前拒绝过权限，请在 iPhone 设置中检查相关 App、“快捷指令”或隐私权限，然后再次运行请求。Shortcuts AI 无法绕过设备权限。
没有安装所需 App 或设备不支持对应功能时，操作也可能失败。请在工具与设备操作中查看工具所需的 App 与设备条件。
Agent 无法使用某项工具
打开 设置 → 工具，确认该工具已经启用。启用工具只代表 Agent 可以选择它，请求本身仍需明确说明希望执行的操作。
例如，“告诉 Jamie 会议安排”没有说明要使用信息、邮件、Gmail 还是 Outlook。选择很重要时，请写明 App 或操作。
文件或音频请求失败
Agent 上传文件或转录音频时，请保持 iPhone 联网。确认共享的是正确内容，并且 Agent 已把它作为快捷指令输入接收。
请求失败时，请从共享表单重新运行 Agent，并且只选择当前需要的文件。上传或转录尚未完成时，不要关闭快捷指令。
音频转录属于在线付费工具。详情请查看按量计费。
Agent 提示需要积分
打开 设置 → 账单 查看余额。如果希望继续，可以在那里添加积分。可用余额未达到服务要求时，无法开始新的付费会话。
模型与在线工具的计费方式请查看按量计费。
会话停止或一直等待
请重新运行 Agent，把请求作为新会话再试一次。当在线工作流不再运行、前一步操作没有返回预期结果，或提供商与网络暂时出错时，会话可能停止。
如果 Agent 提议准备支持邮件，请保留草稿中的会话 ID。支持团队可以用它查找失败的会话。
联系支持
发送邮件至 support@getshortcuts.ai，并附上：
- 你要求 Agent 完成的任务；
- 启动位置，例如“快捷指令”App 或共享表单；
- 涉及的 App 或工具；
- 显示的错误信息和会话 ID；
- iPhone 型号和操作系统版本。
不要在支持邮件或截图中包含设置密钥。