Antigravity Swarm: Cách dùng Gemini 4 Neon với /swarm

Bạn muốn chạy Antigravity swarm với Gemini 4 Neon? Hãy tìm hiểu cách khởi chạy /swarm, kết hợp worker Neon và Hydrogen, cũng như kiểm tra kết quả bằng Apidog CLI.

Ashley Goolam

Ashley Goolam

19 tháng 11 2026

Antigravity Swarm: Cách dùng Gemini 4 Neon với /swarm

Apidog cho doanh nghiệp

Triển khai tại chỗ

SSO & RBAC

Tuân thủ SOC 2

Khám phá Apidog Enterprise

Chế độ swarm (đàn trung) của Antigravity với Gemini 4 Neon hoạt động như sau: chọn Gemini 4 Neon trong bộ chọn mô hình, gõ /swarm kèm theo một nhiệm vụ và cách xác minh nó, và cuộc trò chuyện của bạn trở thành điều phối viên. Neon chia công việc cho các worker được đặt tên, thêm một @verifier, và báo cáo lại khi các bài kiểm tra thành công. Yêu cầu worker Gemini 4 Hydrogen trong prompt để tiết kiệm hạn ngạch.

Chế độ swarm của Antigravity với Gemini 4 Neon là gì?

/swarm là một lệnh xem trước (preview) trong Google Antigravity cho phép chạy một nhóm các agent được đặt tên trên cùng một nhiệm vụ. Cuộc trò chuyện hiện tại của bạn trở thành điều phối viên: nó chia công việc, giao nhiệm vụ cho từng worker, thêm một verifier đọc diff và chạy các bài kiểm tra, rồi báo cáo kết quả cho bạn. Khi Gemini 4 Neon được chọn, Neon chính là điều phối viên.

Google ra mắt Neon vào ngày 18 tháng 11 năm 2026 và mô tả nó "hoạt động như một Orchestrator nhanh và có khả năng đánh giá cao, điều phối các subagent Hydrogen chạy song song trong Google Antigravity." Hai bản demo ra mắt — một bàn thí nghiệm 3D được xây dựng qua Blender MCP và một bản tái hiện 3D phòng nghiên cứu năm 1936 của Alan Turing — đều được xây dựng bằng /swarm.

Để tìm hiểu các kiến thức cơ bản về mô hình này, hãy đọc bài Gemini 4 Neon là gì; để xem tính năng này khi ra mắt cùng Carbon, xem bài giải thích Google Antigravity /swarm của chúng tôi. Các bước dưới đây lấy từ tài liệu của Google, và swarm đang ở giai đoạn preview nên các menu có thể thay đổi.

Ai có thể dùng /swarm với Gemini 4 Neon?

Bạn cần gói Google AI Pro hoặc Google AI Ultra. Dưới đây là những gì mỗi gói nhận được trong Antigravity, theo tài liệu Choose a model:

Tính năng Free và Google AI Plus Google AI Pro Google AI Ultra
Lệnh /swarm Không Có Có
Gemini 4 Neon Không Có (gói trả phí, hoặc dùng thử trên thiết bị cao cấp đủ điều kiện) Có
Gemini 4 Hydrogen Không Có (chỉ các gói đăng ký không dùng thử) Có
Orchestrator (Neon) Không Có (gói trả phí, hoặc dùng thử trên thiết bị cao cấp đủ điều kiện) Có
Làm mới hạn ngạch Hàng tuần Mỗi 5 giờ, có giới hạn hàng tuần Mỗi 5 giờ, giới hạn hàng tuần cao nhất

Ba chi tiết dễ gây nhầm lẫn:

/swarm chạy trên hạn ngạch đăng ký của bạn, không phải khóa API. Để biết giá API của Neon, xem hướng dẫn giá Gemini 4 Neon của chúng tôi.

Cách chạy /swarm với Gemini 4 Neon: từng bước

Các bước trong ứng dụng Antigravity:

  1. Mở dự án của bạn và bắt đầu một cuộc trò chuyện mới.
  2. Chọn Gemini 4 Neon trong bộ chọn mô hình bên dưới ô nhập prompt. Chọn Gemini 4 Neon thuần, không phải Orchestrator (Neon). Lý do sẽ được giải thích bên dưới.
  3. Chọn mức thinking. Neon cung cấp Low, Medium, High (mặc định) và Extra. High là lựa chọn khởi đầu phù hợp cho một điều phối viên.
  4. Gõ /swarm rồi nhấn Tab (hoặc Enter) để chèn lệnh.
  5. Mô tả nhiệm vụ và cách xác minh nó. Ví dụ: /swarm Add input validation to the handlers in src/routes/users.ts and src/routes/orders.ts, add tests next to each, and have a verifier run npm test.
  6. Mở khung Swarm từ liên kết "Open the Swarm UI" ở cuối câu trả lời của điều phối viên.
  7. Tiếp tục trò chuyện với điều phối viên trong khi swarm đang chạy. Hỏi trạng thái hoặc thay đổi phạm vi bất kỳ lúc nào.

Các tab Board, Members và Graph của khung này hiển thị các bài đăng trực tiếp, trạng thái và mô hình của từng worker, cũng như ai nhắc đến ai.

Diagram of an Antigravity swarm led by Gemini 4 Neon: your /swarm prompt goes to the Neon coordinator, which posts to a shared message board; three Gemini 4 Hydrogen workers, a Neon verifier and a sleeping monitor all read and post to the board

Trong Antigravity CLI

Luồng trong terminal gần như giống hệt. Khởi động CLI với Neon đã chọn:

agy --model gemini-4-neon
# or, for the deepest reasoning on the coordinator:
agy --model gemini-4-neon-xhigh

Gõ /swarm, nhấn Tab, rồi mô tả nhiệm vụ. Mở bảng trực tiếp bằng /swarm board hoặc Alt+S (trên macOS, chỉ khi terminal của bạn gửi phím Option dưới dạng Meta), liệt kê các worker bằng /agents, và nhắn tin trực tiếp cho một worker bằng @verifier also run the integration tests.

Điều phối viên Neon, worker Hydrogen: cách kết hợp mô hình

Theo mặc định, mọi worker chạy trên cùng mô hình với cuộc trò chuyện của bạn. Chọn Neon và bạn có một swarm toàn Neon: mạnh, nhưng tốn hạn ngạch.

Bài đăng ra mắt Neon mô tả một cấu trúc khác: Neon đánh giá công việc trong khi các agent Gemini 4 Hydrogen nhanh hơn thực hiện nó. Antigravity cho phép bạn yêu cầu điều đó bằng ngôn ngữ tự nhiên. Tài liệu ghi: "Để dùng mô hình khác cho một worker hoặc tất cả, hãy nêu trong prompt của bạn." Mô hình phải là một trong những mô hình bạn có thể chọn trong bộ chọn mô hình.

Một prompt thiết lập sự phân chia này:

/swarm Build the /users and /orders endpoints described in openapi.yaml.
Give each resource its own worker and run every worker on Gemini 4 Hydrogen.
Keep the verifier on Gemini 4 Neon. The verifier must run the API tests
and send each failure back to the worker that owns the endpoint.

Tại sao không dùng Orchestrator (Neon)?

Orchestrator (Neon) là một tùy chọn trong bộ chọn mô hình, ghép Neon làm planner với Hydrogen làm executor trong một agent duy nhất. Tài liệu nói thẳng: "Orchestrator giữ một agent duy nhất trong cuộc trò chuyện của bạn." Nó chạy với cấu hình cố định, nên bạn không thể đặt mức thinking, và tài liệu swarm của Google không nói gì về cách swarm hoạt động khi Orchestrator là mô hình của cuộc trò chuyện.

Vì vậy, hãy chọn theo hình thức công việc:

Bạn muốn Chọn
Một agent, Neon lập kế hoạch và Hydrogen viết code, tiết kiệm hạn ngạch hơn Orchestrator (Neon)
Nhiều agent chạy song song trên các file riêng biệt, kèm một verifier Gemini 4 Neon + /swarm
Khả năng đánh giá của Neon ở mọi bước, mức thinking điều chỉnh được Gemini 4 Neon, không dùng swarm

Hướng dẫn Gemini 4 Hydrogen Orchestrator của chúng tôi giải thích chi tiết vòng giao tác giữa planner và executor trong một agent.

Điều phối viên nên dùng mức thinking nào của Neon?

Hãy bắt đầu với High. Google cho biết Neon ở mức High có chi phí trên mỗi nhiệm vụ thấp hơn 32% so với Carbon trong khi vẫn đạt điểm cao trên Artificial Analysis Intelligence Index. Điểm cao nhất của nó (61, xếp hạng #3) đạt được ở mức Extra High.

Chuyển lên Extra (xhigh) khi điều phối viên liên tục chia việc kém, chẳng hạn như hai worker cùng chỉnh sửa một file. Hãy hạ worker xuống Hydrogen trước khi hạ điều phối viên xuống Medium: nhiệm vụ của nó là đánh giá, không phải viết code. Để xem phân tích chi tiết về sự đánh đổi, xem hướng dẫn các mức thinking của Gemini 4 Neon của chúng tôi.

Viết prompt /swarm chia việc rõ ràng

Tài liệu swarm của Antigravity đưa ra một quy tắc quan trọng hơn cả: nêu rõ bạn muốn gì và cách xác minh nó, rồi để điều phối viên tự quyết định cách chia việc. Bốn thói quen sau giúp ích:

  1. Nêu rõ ranh giới. Liệt kê các file hoặc tài nguyên để mỗi worker độc quyền một phần.
  2. Nêu rõ bước kiểm tra. npm test, go test -race ./... hoặc một lần chạy kiểm thử API. Nếu không có, verifier chỉ đọc diff.
  3. Nêu rõ những gì không được thay đổi. "Không xóa các assertion" ngăn worker làm yếu đi các bài kiểm tra.
  4. Yêu cầu bản sao làm việc khi các chỉnh sửa chồng lấn. Theo mặc định, các worker dùng chung không gian làm việc của bạn.

Dùng /swarm cho công việc rộng có thể chia rõ ràng. Với một bug khó đơn lẻ, Google khuyên dùng /boost. Với các dự án kéo dài hàng giờ hoặc nhiều ngày, đó là /teamwork.

Các worker đang chờ không tiêu tốn token cho đến khi có người nhắc đến họ. Một thành viên hết hạn ngạch sẽ tạm dừng và không tự khởi động lại khi hạn ngạch làm mới: hãy đăng lên bảng, đổi mô hình của nó hoặc nhắn tin cho nó.

Cung cấp cho verifier của swarm các bài kiểm tra API thực sự với Apidog CLI

Khi swarm xây dựng một API, một verifier chỉ đọc diff thực chất chỉ đang phỏng đoán. Hãy đưa cho nó một đặc tả OpenAPI và các bài kiểm tra thực thi được, và "đã xác minh" có nghĩa là các request thực sự đã vượt qua theo hợp đồng.

Diagram of the swarm verification loop: openapi.yaml feeds Gemini 4 Hydrogen workers that build endpoints; the verifier runs apidog run with cli and json reporters; a pass goes to the coordinator, a failure goes back to the workers with the request, expected schema and actual response

Apidog CLI cho phép agent import đặc tả, viết test case và chạy chúng từ terminal với đầu ra JSON mà nó có thể đọc. Cài đặt một lần trong dự án:

npm install -g apidog-cli@latest
apidog auth login --with-token <YOUR_TOKEN>
npx -y skills add https://apidog.com   # pick your agent when prompted

Hoặc bảo agent của bạn: "Đọc https://apidog.com/apidog-cli-installation-guide.md và cài đặt Apidog CLI." Hướng dẫn đó được viết cho agent. Để biết cách cài đặt riêng cho Antigravity, xem cách dùng Apidog CLI trong Antigravity.

Sau đó thêm bước kiểm tra vào prompt swarm của bạn:

/swarm Build the /users and /orders endpoints in openapi.yaml, one Gemini 4
Hydrogen worker per resource. Before building, import openapi.yaml into Apidog
project <projectId> on a new AI branch and create one test case per endpoint
that asserts the status code and response schema. The verifier stays on
Gemini 4 Neon, runs every case against environment <envId>, and treats any
failed run as a failed change, whatever the diff looks like.

Verifier đọc schema của từng payload trước khi viết bất cứ thứ gì, rồi chạy các lệnh như sau:

apidog branch create --project <projectId> --type ai --name "ai/20261119-from-main-neon-swarm" --from main
apidog import --project <projectId> --format openapi --file ./openapi.yaml --branch "ai/20261119-from-main-neon-swarm"
apidog cli-schema get test-case-create
apidog cli-schema validate test-case-create --file case.json
apidog test-case create --project <projectId> --file case.json --branch "ai/20261119-from-main-neon-swarm"
apidog run --test-case <caseId> --project <projectId> --branch "ai/20261119-from-main-neon-swarm" -e <envId> -r cli,json

Mọi flag ở trên lấy từ apidog <cmd> --help trên Apidog CLI 2.2.12. Nhánh AI giữ các thay đổi do agent viết ra khỏi nhánh chính của bạn cho đến khi bạn xem xét — điều này quan trọng khi nhiều worker cùng chỉnh sửa các endpoint.

Báo cáo JSON nêu rõ request lỗi, nên verifier có thể gửi nó tới @users-api hoặc @orders-api thay vì @all. Thêm --upload-report để xem lại lần chạy trong Apidog sau đó.

Lệnh apidog run ... -r junit tương tự có thể dùng ngay trong CI, nên hợp đồng mà swarm đã kiểm tra chính là hợp đồng mà pipeline của bạn thực thi. Xem Apidog CLI trong pipeline CI/CD. Gói Free của Apidog hỗ trợ tối đa 4 người dùng.

Câu hỏi thường gặp

Antigravity /swarm có miễn phí không?

Không. Tài liệu của Google liệt kê /swarm chỉ dành cho các gói Google AI Pro và Google AI Ultra, và Gemini 4 Neon không có sẵn trên các gói Free hoặc Plus trong Antigravity.

Swarm worker dùng mô hình nào?

Cùng mô hình với cuộc trò chuyện của bạn, trừ khi prompt của bạn nói khác. Hãy yêu cầu worker Gemini 4 Hydrogen và verifier Neon bằng ngôn ngữ tự nhiên, sử dụng các mô hình có sẵn trong bộ chọn mô hình của bạn.

Một swarm Neon có thể chạy bao nhiêu agent?

Google không công bố giới hạn. Điều phối viên quyết định số worker cần thêm và thường thêm một @verifier cho mỗi hai đến bốn worker, kèm một @monitor.

Neon có ngữ cảnh 1 triệu token trong Antigravity không?

Không, theo tài liệu Antigravity của Google, vốn liệt kê Neon ở mức tối đa 512K token tại đó. Cửa sổ 1 triệu token áp dụng cho Gemini API.

/swarm có giống Orchestrator (Neon) không?

Không. Orchestrator (Neon) là một agent duy nhất chuyển đổi giữa Neon lập kế hoạch và Hydrogen thực thi. /swarm chạy nhiều agent được đặt tên song song trên một bảng chia sẻ, với một verifier chuyên trách.

Thực hành thiết kế API trong Apidog

Khám phá cách dễ dàng hơn để xây dựng và sử dụng API