Agent execution terminated due to error（智能体因错误而终止）

简短回答：「Agent execution terminated due to error.」表示智能体这次运行因一个未被命名的错误而结束。先用一条简短提示重试一次；再次失败就开始新对话、切换模型、关闭 MCP 服务器。如果提示里还有别的文字（high traffic、cancelled、cleared a prefix 等），请看下方对照表。其他问题请访问我们的主故障排除中心。

你看到的是哪条报错？

人们常把 Antigravity 的好几种报错统称为“智能体终止”。请对照屏幕上的原文。标注“社区报告”的原因来自 Google AI Developers Forum 的回复或用户反馈，并非官方的根因说明。我没有找到可以验证的 Antigravity 官方中文译文，所以报错原文保持英文。

"Agent execution terminated due to error."

直接回答：这是一条兜底提示。Antigravity 结束了本次运行，却没有说明原因。前面可能带有 "Unknown:" 或 "Error:"。一位 Google CLI 的 GitHub 贡献者表示，旧版 CLI 会把网络和认证失败掩盖在这句话后面，新版本会在可能时显示真正的原因。

有一个有文档记录的原因：Antigravity CLI 更新日志（v1.2.15，2026年10月5日）写道，当套餐配额用完、AI 积分余额也不够支付请求时，CLI 过去会在 Working... 上重试约两分半钟，然后显示这条通用提示；现在会立刻提示 "Your AI credits balance is too low to continue."。如果是在长时间 “Working...” 之后才报错，请先检查配额和积分。

1. 发一条简短的后续提示（例如 "continue"）重试。在应用里，错误卡片上的 Retry 按钮现在会直接恢复任务，不再添加多余的 "Continue" 消息（更新日志 v2.9.1，2026年8月20日）。
2. 再次失败就点击 + 开始新对话。
3. 切换模型。如果 Gemini 正常而 Claude 失败，怀疑 MCP 工具冲突；如果所有模型都失败，怀疑登录、账户、配额或容量。一位 GitHub issue 提交者说切换到 Flash 模型可行而 High 版本失败（社区报告）。
4. 关闭所有 MCP 服务器（见下方第四步），重启后再逐个启用。论坛上有一份 bug 报告：启用 Firebase MCP 的第 15 个工具（functions_get_logs）时，Claude 模型会立刻失败，而 Gemini 仍然正常。
5. 更新。CLI 运行 agy upgrade；IDE 使用 Help > Check for Updates。
6. CLI 用户：运行 /logout 再重新登录。两位 GitHub 评论者说这样解决了问题（社区报告）。在 Windows 上，有用户把一个案例追溯到失败的 PreInvocation hook 命令，运行会因此以这条通用提示结束（社区报告）。
7. 仍然出现：在命令面板运行 "Download Diagnostics"，并按 Google 论坛工作人员的要求，通过应用内的 Report Issue 提交诊断包。如果显示了 Error ID，请一并附上。

"You can prompt the model to try again or start a new conversation if the error persists. See our troubleshooting guide for more help."

直接回答：这句话是终止提示附带的建议文字，不是单独的错误。按它说的顺序做，再用上面的步骤：

1. 输入一条简短提示，例如 "continue"，让模型重试。
2. 如果错误再次出现，开始新对话，并用两三行话粘贴你做到哪里了。
3. 仍然失败：切换模型、关闭 MCP 服务器、更新应用，并在命令面板运行 Antigravity: Reset Onboarding（Google 论坛工作人员对卡住的智能体建议过这个命令和 Developer: Reload Window）。
4. 完全退出，并在任务管理器或活动监视器中结束残留的 language_server 进程，再重新打开。

"User cancelled agent execution."

直接回答：提示说是你取消的，但很多用户报告自己根本没点 Stop。Google 论坛工作人员在一个帖子里无法复现，转而列出了可能原因：网络中断或内部超时、终端命令卡住或崩溃、API 速率限制或配额、安全或策略拦截。在另一个帖子里，工作人员提到本地安全软件或 VPN 切断持久连接也可能触发这种中止。该帖的一位用户说，即使配额还有，发 1 到 3 次请求后又会出现。

1. 完全退出 Antigravity，并在任务管理器或活动监视器中结束残留的 language_server 或辅助进程。
2. 删除 %APPDATA%\Antigravity\（Windows）、~/Library/Application Support/Antigravity/（macOS）或 ~/.config/Antigravity/（Linux）下的 GPUCache 和 Session Storage 文件夹。它们是缓存，不是你的项目文件。
3. 暂时关闭 VPN、代理或安全软件，再测试。
4. 检查是否有卡住的终端命令：打开命令面板，结束正在运行的终端进程。
5. 在模型设置页查看配额和重置时间。
6. CLI 用户：工作人员建议在 Settings > Agent Settings 中把 Terminal Command Auto Execution 设为 Proceed in Sandbox，并对复杂任务使用 /plan，以避免单轮超时。
7. 仍然出现：点击 Help，选择 "Provide feedback"，勾选 "Attach Antigravity server log" 并提交。

"Our servers are experiencing high traffic right now, please try again in a minute."

直接回答：服务器端容量提示。论坛用户反映，免费、Pro、Ultra 套餐在繁忙时段都会遇到，所有模型都可能受影响，有时持续数小时。"We're currently experiencing high traffic. Please try again later." 属于同一类。Google 工作人员曾说明正在增加额外的容量时段（该帖发布时是太平洋时间下午晚些时候），这只是时间上的线索，不是修复方法。

1. 等一分钟，只重试一次。反复点击 Retry 可能消耗配额；有论坛用户说配额就是被重试耗光的（社区报告）。
2. 查看第三方状态追踪站，并在模型设置里查看你的用量。
3. 切换到其他模型或档位。论坛回复提到，繁忙时段所有模型可能同时失败。
4. 错峰再试。
5. 如果详情里出现 503 或 MODEL_CAPACITY_EXHAUSTED，请看 503 high traffic 与速率限制指南。

"Service temporarily restricted ... temporary global restrictions have been applied"

直接回答：我没有找到针对这句话的 Antigravity 官方解释，所以原因未经证实。文字本身指向高流量和临时限制，看起来是用量或容量限制，而不是本机故障。"Service Temporarily Restricted" 这几个词也出现在一个 GitHub Copilot 每周限额的帖子里，工作人员称那是内置的用量上限，所以不要假定两个产品含义相同。

1. 不要重装。本机上没有任何东西会造成服务器端的限制。
2. 打开模型用量页面，查看是否有重置时间。如果看到每周或多日的锁定，请阅读每周配额冷却说明。
3. 换一个模型，稍后再试。
4. 如果是付费套餐，限制一直不解除或用量页面与限制相矛盾，请附上服务器日志提交反馈。

"The server cleared a prefix of the conversation as it grew too large."

直接回答：对话达到大小上限，服务器丢弃了最早的一部分。Google 论坛的回复把它描述为最早的轮次被裁剪，以便模型处理你最新的提示，而不是删除你的项目。其他用户报告，它后面可能跟着带 Error ID 的 "Agent execution terminated due to error"，或者智能体陷入循环；一份 bug 报告把触发点估计在约 15,000 个 trajectory step（用户给出的数字，不是官方上限）。

1. 如果智能体在循环，先停止它。
2. 不要继续在这个对话里输入。bug 报告说，在清除状态期间排队的提示可能丢失，所以重要内容请自己留一份。
3. 开始新对话，粘贴一段简短总结：做了什么、下一步是什么。这是 Google 工作人员直接给出的建议。
4. 如果觉得工作内容不见了，查看编辑器里该文件的 Timeline 面板，或在命令面板运行 Local History: Find Entry to Restore（Google 论坛工作人员的建议）。
5. 以后一个任务用一个对话，换任务前让智能体写一份总结笔记。

"Antigravity server crashed unexpectedly. Please restart to fully restore AI features."

直接回答：这是本地 language server 进程出了故障，不是模型或配额错误。先重启 Antigravity。如果反复崩溃，原因见我们的专题文章：Antigravity server crashed 修复。如果聊天面板是空白的，请看空白聊天修复。

一直 Working...（卡在 working，没有报错）

直接回答：智能体在等一个迟迟不返回的东西。Google 论坛回复提到的原因包括：高流量时段、过长的链式终端命令、残留的 MCP 条目、~/.gemini/ 里扫描大文件夹的全局规则，以及一个 bug：配额降到 0% 且未开启 AI 积分时智能体一直转圈（工作人员说新版本已修复）。CLI 更新日志（v1.3.6，2026年10月15日）说明，模型连接 5 分钟没有数据时现在会自动取消并重试，所以请先更新。

1. 点击红色的 Stop 按钮，等几秒，再点击 + 新建对话。
2. 从 High 档切换到较低档位或其他提供商的模型。
3. 更新 Antigravity（Help > Check for Updates，CLI 用 agy upgrade）。
4. 检查 ~/.gemini/ 里是否有残留的 mcp_config.json 条目，或扫描巨大文件夹的全局规则。
5. 仍然卡住：运行 Antigravity: Reset Onboarding，然后 Developer: Reload Window。还不行就完全退出并结束 language_server 进程。
6. 打开 Developer: Toggle Developer Tools，查看 Console 里的红色错误，提交反馈时附上。

2026年早期原因（3月，v1.20.5）

下面四项是2026年3月围绕 v1.20.5 发布时报告的情况，作为历史记录保留，供你在旧版本上或症状吻合时排查。我无法用当前更新日志重新核实，所以请视为社区报告。如果你用的是新版本，请先按上面针对具体报错的步骤处理。

2026年3月的新原因

早期版本称，自 v1.20.5 发布以来，已发现数个导致「Agent terminated due to error」消息的新根本原因。如果您在2026年3月开始看到此错误，下面的情况之一很可能是原因，即使之前的故障排除步骤曾经有效。早期版本还称其中两项延续到了 Antigravity 2.x 系列（2.0 IDE 与 agy CLI 共用同一个 agent 运行时），到 2026 年 7 月仍然存在。

更新（2026年10月30日）：这些都是社区报告（2026年3月），我们没有找到 Google 的官方声明或更新日志来证实，包括它们在 Antigravity 2.x 上仍然存在的说法。早期版本还称跨模型锁定在 2.x 上会波及全部托管模型，并给出了命令面板里名为「Antigravity: Restart Agent Service」的命令来解除锁定。我们无法在当前文档中确认这个命令名称；如果找不到，请完全退出并重新打开 Antigravity。

第一步：卸载 Antigravity 并清除数据

最后的手段。请先试上面针对具体报错的步骤。完全重装无法修复服务器端的提示，例如高流量、临时限制或配额限制。

要修复持续的终止错误，您必须执行彻底卸载。这不仅需要移除应用程序本身，更重要的是删除可能包含损坏会话数据的配置文件夹。

1.1 卸载应用程序

macOS：打开 Finder，前往应用程序文件夹，将 Antigravity 拖到废纸篓。清空废纸篓以完成移除。

1.2 删除配置文件夹

损坏的缓存或身份验证令牌是代理故障最常见的原因。请根据您的操作系统删除相应的文件夹：

🍎 macOS

手动路径：打开 Finder，按 Cmd + Shift + G，然后输入 ~/Library/Application Support/。找到并删除 Antigravity 文件夹。

终端：

macOS 终端

rm -rf ~/Library/Application\ Support/Antigravity

🪟 Windows

手动路径：按 Win + R，输入 %APPDATA%，然后删除 Antigravity 文件夹。

命令提示符：

命令提示符

rd /s /q "%APPDATA%\Antigravity"

🐧 Linux

手动路径：打开文件管理器，显示隐藏文件（Ctrl + H），前往 ~/.config/，然后删除 Antigravity 文件夹。

终端：

Bash 终端

rm -rf ~/.config/Antigravity

系统清理完毕后，您已准备好重新开始。请按照以下步骤重新安装并验证您的环境。

第二步：重新安装 Antigravity

既然您的系统已清除损坏数据，现在可以进行最新版本的全新安装了。

2.1 下载安装程序

请前往官方下载页面获取最新稳定版本：

2.2 安装过程（Mac）

下载 .dmg 文件后，打开它并将 Antigravity 图标拖动到应用程序文件夹。

等待复制过程完成。这将确保所有必需的应用程序资源被正确放置到本地存储中。

2.3 初次启动

从应用程序文件夹打开 Antigravity。您将看到欢迎界面。点击「Next」将引导您完成初始设置，在此过程中您将登录并重新初始化工作区。

第三步：重新登录并验证

应用安装完成后，您需要使用 Google 账户重新进行身份验证。这将刷新您的会话令牌，并确保代理拥有访问 LLM 提供商所需的正确权限。

登录后，请按照引导提示操作，以恢复您之前的工作区或创建一个新的工作区。

第四步：禁用 MCP 服务器（如果错误仍然存在）

如果您已重新安装并重新登录，但「HI」验证仍失败，症结可能在于配置错误或处于挂起状态的 **Model Context Protocol (MCP)** 服务器。MCP 服务器负责将代理连接到外部工具，如果其中一个未能成功初始化，则可能导致整个代理进程终止。您可以在我们的Antigravity 错误索引中找到更具体的错误代码。

4.1 访问 MCP 设置

点击 Antigravity 侧边栏右上角的三点图标 ...，然后选择MCP 服务器。

4.2 关闭所有服务器

暂时禁用所有活动的 MCP 服务器。如果代理恢复正常工作，您可以逐一重新启用它们，以找出导致终止的具体服务器。

第五步：切换 AI 模型（绕过提供商过载）

有时，「Agent terminated」错误是由特定模型提供商（例如 Google 或 Anthropic）服务器临时过载造成的。如果代理在某个模型上无响应，切换到另一个模型通常可以绕过瓶颈。

5.1 打开模型选择器

查看您的 Antigravity IDE 底部栏。点击当前模型名称以打开选择菜单。

5.2 尝试不同的级别

模型名称变化很快，请打开模型选择器，看你的版本里列出了什么。如果 High 档模型出现故障，请尝试 Flash 或更低档位的模型，或来自其他提供商的模型。低级别模型或来自不同提供商的模型通常具有不同的速率限制，即使高级模型负载较重时也可能可用。如果切换模型本身就触发了错误，请看上方2026年早期原因里的跨模型锁定说明，并完全重启应用。

最后一步：验证修复

检查一切是否正常运行的最佳方法是在聊天中发送一条简单的「HI」消息。如果代理响应迅速且准确，您的终止问题就解决了！