截至 2026 年 11 月 11 日,Google Antigravity 的 swarm 模式(即 /swarm 命令)是一项预览功能,能够将一条提示词转化为由 Google Gemini 4 Carbon 领衔的协同 Agent 团队。Google 的 Gemini 4 Carbon 已于 2026 年 11 月 10 日正式全面开放(GA),在 /swarm 模式中,它负责任务规划、统筹协调与代码审查,同时让速度更快、更轻量的模型在并行的隔离工作区中干活,并由对抗式验证 Agent(adversarial verifier agents)对每一处修改进行测试。
下文将依次介绍:这套团队如何分工、Google 用它做出了哪些演示案例、谁可以使用它、目前还有哪些未知细节,以及如何配合 Apifox CLI 为 swarm 团队提供可执行的 API 契约测试。
AI Coding 交流群
如果你也在用 AI 写代码,或者正在研究 Cursor、Claude Code 这些工具,欢迎加入以下交流群。群里平时会聊一些 AI 编程的实际用法、开发工作流,还有各种新工具和新玩法。
什么是 Google Antigravity /swarm?
/swarm 是 Google 面向 Agent 优先(agent-first)的开发平台 Google Antigravity 中的一项预览命令。你只需输入一条提示词,Antigravity 就会拉起一支你可以实时追踪进度的 Agent 团队:Gemini 4 Carbon 承担最需要深度推理的角色,轻量模型负责并行编码构建,而验证 Agent 则在每次修改合入前进行检验。
Google 在宣布 Gemini 4 Carbon 正式上线的同一篇公告中介绍了该功能。由于目前仍处于预览阶段,其具体行为表现和访问权限规则后续可能会调整。
如果你还不熟悉 Antigravity 平台本身,可以先阅读我们的 Google Antigravity 初探以及 Antigravity 2.0 平台更新介绍。想了解驱动 swarm 的核心模型,可阅读 Gemini 4 Carbon 是什么。
关于本文的方法说明:撰写本文所用的机器尚未开通 Antigravity 的 /swarm 预览权限,因此下文内容全部整理自 Google 官方公告,不包含本机实操运行记录,也没有对 /swarm 之外的未公开命令语法做任何假设。
Antigravity Agent Swarm 是如何分工的?
Antigravity 的 Agent 集群将一项开发任务拆解给三类角色协同完成:
- 主控领队(Gemini 4 Carbon): Google 表示,开发者可以将 Carbon 指派给“最需要深度推理的角色,例如架构设计、统筹协调”以及审查。它负责将用户的提示词拆解为子任务,并对最终结果做出评判。
- 并行执行者(更轻量的模型): 速度更快、成本更低的模型运行在“并行的隔离工作区(parallel isolated workspaces)”中,避免两个执行者在任务中途互相覆盖对方的文件。
- 验证者(对抗式 Agent): 独立的验证 Agent 会“测试每一处改动”。它们的职责是挑出代码里的问题,而不是顺着编写代码的执行者说好话。

这是一种大家很熟悉的协作模式(高阶模型做规划、轻量模型并行执行、独立角色做验收),只不过现在通过一条命令就能自动串联起来。
隔离工作区之所以关键,是因为多个并行 Agent 如果共用同一个工作树(working tree),很容易发生冲突——比如一个 Agent 刚重命名了函数,另一个 Agent 还在按旧名字调用。而对抗式验证者之所以重要,是因为写代码的 Agent 往往只会测试自己已经想到的正常路径。
Google 用 /swarm 构建了哪些演示项目?
Google 的发布公告展示了三个演示案例。请注意,这些是 Google 官方的展示项目,而非外部独立评测:
| 演示项目 | Google 表示由 Carbon 产出的成果 | Google 点名使用的工具 |
|---|---|---|
| 山景城园区游戏(Mountain View campus game) | 一款开放世界 3D 游戏,玩家可以“化身骑着 GBike 的鹈鹕”探索 Google 山景城园区 | Antigravity /swarm |
| Google 周边商店(Google Merchandise Store) | “仅用两条提示词重构了在线商店,并提出了五套视觉艺术指导方案” | Carbon(Google 公告) |
| 科纳音乐厅古钢琴(Koerner Hall fortepiano) | 将一架可弹奏的约 1780 年代 Stein-Schule 古钢琴放进多伦多科纳音乐厅的 3D 模型中,“具备随座位变化的空间声学效果” | “Google Antigravity 中的多 Agent 循环(multi-agent loop)” |
三个案例中,只有园区游戏明确归功于 /swarm 命令;古钢琴演示则归功于 Antigravity 中的多 Agent 循环——两者概念相近,但表述并不完全等同。引用这些案例时建议保留这一区分。
谁可以使用 Antigravity Swarm 模式?
以下是 Google 官方公布的访问权限与定价信息(每行均注明来源):
| 项目 | 详情说明 | 来源 |
|---|---|---|
| Carbon 正式版(GA)发布日期 | 2026 年 11 月 10 日 | |
| 模型 ID | gemini-4-carbon |
|
/swarm 状态 |
Google Antigravity 中的预览功能 | |
| 个人订户访问权限 | 正面向所有 Google AI Ultra 订户逐步开放(覆盖 Antigravity、Gemini 应用及搜索 AI 模式) | |
| 开发者访问权限 | 在 Google AI Studio 的 Gemini API 及 Gemini 企业版中面向付费开发者和企业开放 | |
| 首发 API 价格 | 每百万输入 token $2 / 输出 token $10 | |
| 2026 年 11 月 30 日后价格 | 每百万输入 token $4 / 输出 token $20 | Google(脚注) |
| 默认模型建议 | “Argon 依然是绝大多数软件工程与知识工作的理想选择” |
Google 尚未说明的细节
发布公告留下了几个尚未解答的问题。在 Google 官方文档正式补充之前,如果看到任何博客或视频给出了笃定的数字,建议保持审慎:
- Agent 数量上限: 官方未说明单次 swarm 运行最多可拉起多少个 Agent。
- 具体套餐门槛: Google 表示 Carbon 正在向 Antigravity 中的 AI Ultra 订户开放,但并未明确说明具体哪些套餐档位包含
/swarm预览权限。 - 执行者使用的具体模型: Google 仅称之为“速度更快、更轻量的模型”,未公布具体模型名称。
- 用量配额: 未公布专门针对 swarm 模式的配额或速率限制。
- 正式上线(GA)时间: 未公布
/swarm结束预览的具体日期。
运行一次 Gemini 4 Carbon Swarm 要花多少钱?
Google 在一点上说得很坦白:Carbon 消耗的 token 更多。公告指出,Carbon“会比 Argon 使用更多 token 来进行充分探索、深度推理并运行长链路验证循环”。而 swarm 模式会进一步放大这一消耗,因为主控模型不仅要负责前期规划,还要逐一审查每个执行者的产出、阅读每个验证者的报告。
有三个实际要点需要注意:
- 在 2026 年 11 月 30 日前,单 token 费率与 Argon 相同。 Carbon 的首发价为每百万输入 token $2、输出 token $10,与 Argon 完全一致;从 12 月 1 日起则涨至 $4 和 $20。我们的 Gemini 4 Carbon 定价解析详细拆解了这次价格跳升。
- 费率相同不代表账单相同。 由于 Carbon 在单个任务中消耗的 token 更多,即便单 token 价格一样,由 Carbon 领衔的任务总账单也会高于 Argon。
- 订阅配额对比 API 计费。 官方尚未公布 swarm 模式的消耗如何折算进 Google AI Ultra 订阅配额,因此在预览期间请留意你账户内的用量页面。
把绝大部分具体代码修改分派给轻量执行者,只把 Carbon 的 token 留给架构规划与结果审查,刚好契合 Google 的官方建议:日常工作用 Argon,硬骨头交给 Carbon。我们的 Gemini 4 Carbon 与 Argon 对比梳理了两者的分界线,而 Gemini 4 Carbon 对比 Claude Fable 5.2 则将其与 Anthropic 的模型进行了横向比较。
如果你想直接调用 Carbon 而不是通过 Antigravity,可参考 Gemini 4 Carbon API 指南跑通第一个请求;更便宜的默认选项则可参考 Gemini 4 Argon API 指南。
给你的 Swarm 一份明确契约:OpenAPI 规范加 Apifox CLI 测试
验证 Agent 的水平,取决于它们用来评判“代码是否正确”的标准有多严格。如果 swarm 团队正在构建或修改一个 API,你能交给它的最硬核标准就是一份 OpenAPI 规范外加一套可执行的自动化测试。这样一来,“验证通过”就意味着接口真实跑通了请求断言,而不是仅仅让另一个大模型读了一遍代码 diff 说“看起来没问题”。

一旦测试失败,验证者可以把报错的具体请求和实际响应原封不动地打回给执行 Agent 重修。
让你的 Antigravity Agent 用 Apifox CLI 运行测试
借助 Apifox CLI,编码 Agent 可以直接在终端里导入你的接口规范、编写测试用例并执行运行,同时拿到可供机器读取的 JSON 报告。你只需要做一次初始化配置,后续工作全部交给 Agent。
安装并登录:
npm install -g apifox-cli@latest
apifox auth login --with-token <YOUR_APIFOX_TOKEN>
apifox test-case category --project <PROJECT_ID>
然后给你的 Agent 发送一条提示词:
Import ./openapi.yaml into Apifox project <PROJECT_ID> on a new AI branch.
For every endpoint in the spec, create a test case that asserts the status code
and the response schema. Run all cases against environment <ENV_ID> and report
each failure with the request, the expected schema and the actual response.
Agent 会在写入前先读取并校验每个 payload schema,然后依次运行以下命令(参数均对照 Apifox CLI 2.2.12):
apifox branch create --project <PROJECT_ID> --type ai --name "ai/20261111-from-main-swarm-contract" --from main
apifox import --project <PROJECT_ID> --format openapi --file ./openapi.yaml --branch "ai/20261111-from-main-swarm-contract"
apifox cli-schema get test-case-create
apifox cli-schema validate test-case-create --file case.json
apifox test-case create --project <PROJECT_ID> --file case.json --branch "ai/20261111-from-main-swarm-contract"
apifox test-case run <CASE_ID> --project <PROJECT_ID> --branch "ai/20261111-from-main-swarm-contract" -e <ENV_ID> -r cli,json
AI 分支(AI branch)可以把 Agent 生成的改动隔离在主分支之外,等你审查确认后再合并——这非常适合一次性触碰多个端点的 swarm 团队。
配合 swarm 模式时,养成以下两个习惯效果最好:
- 让验证者看测试运行结果,而不是只看代码。 在提示词中明确要求验证 Agent:只要
apifox test-case run未通过,无论代码 diff 看起来多漂亮,都一律判定为未通过。 - 保持报告机器可读。
-r json会为 Agent 提供结构化的失败详情,方便它精准分派给对应的执行者修复;加上--upload-report则方便你事后在 Apifox 客户端中复盘运行记录。
同一条命令加上 -r junit 即可直接放进 CI 流水线中,确保 swarm 团队在开发阶段遵循的契约与持续集成流水线强制执行的契约完全一致。
什么时候该用 /swarm,什么时候该用单 Agent?
面对跨度广的任务时使用 /swarm:例如需要同时修改后端 API、前端界面和数据库迁移脚本的功能,或者一旦漏掉隐蔽 Bug 代价极高的构建任务。而对于五分钟就能审完的小修小补,继续使用单个 Agent(通常搭配 Argon 即可)更加高效省钱。
常见问题
Google Antigravity /swarm 是免费的吗?
Google 尚未宣布 /swarm 的免费层级。Google 表示 Gemini 4 Carbon 正在向 Antigravity 中的 Google AI Ultra 订户开放,并通过 Gemini API 面向付费开发者提供。具体哪些套餐包含 /swarm 预览权限尚未明确说明。
Antigravity Swarm 中的 Agent 由什么模型驱动?
Google 的 Gemini 4 Carbon 担任主控角色,负责架构设计、统筹协调与审查。Google 表示并行执行者由“速度更快、更轻量的模型”驱动,但未点名具体型号。
一次 Swarm 可以运行多少个 Agent?
Google 尚未公布数量上限。官方公告仅将其描述为“协同工作的 Agent 团队”,未给出具体数字。
/swarm 支持接入我自己的 API 测试吗?
Google 尚未描述内置的 API 测试集成功能。不过你完全可以为 Agent 团队提供一份外部契约:用 OpenAPI 规范配合由 Agent 调用 Apifox CLI 运行的测试用例,让“验证通过”真正建立在接口返回结果符合规范承诺的基础上。
Gemini 4 Carbon 是 Antigravity 的默认模型吗?
不是。Google 将 Argon(而非 Carbon)定位为绝大多数软件工程和知识工作的理想默认选择;Carbon 则面向高难度任务,会消耗更多 token 进行探索与验证。如果你正在横向对比面向 Agent 任务的旗舰模型,也可以参考我们的 Claude Fable 5.2 API 指南。