Antigravity là một vòng lặp. Tác nhân của nó chỉnh sửa tệp, chạy lệnh terminal, đọc kết quả đầu ra và quyết định bước tiếp theo. Vậy tại sao các bài kiểm tra API của bạn không nằm trong vòng lặp đó? Chúng nằm trong Apidog phía sau giao diện người dùng đồ họa (GUI) và chỉ chạy khi ai đó nhớ nhấp chuột. Tác nhân không bao giờ chạm vào chúng.
Giải pháp chỉ là một khối cấu hình. Apidog CLI là một gói npm, apidog-cli, giúp chạy các kịch bản kiểm thử mà bạn đã xây dựng trong Apidog trực tiếp từ terminal. Khi CLI được cài đặt và Antigravity biết nó tồn tại, tác nhân sẽ chạy một kịch bản Apidog theo cách tương tự như khi nó chạy các bài kiểm tra đơn vị của bạn: thực thi lệnh, đọc mã thoát, sửa mã nếu nó báo lỗi (màu đỏ).
Nếu bạn chưa cài đặt CLI, hãy thực hiện trước. Bài viết Cách cài đặt Apidog CLI với tác nhân mã hóa AI hướng dẫn cài đặt npm, xác thực và chạy lần đầu, với tác nhân thực hiện việc nhập liệu. Bài viết này giả định rằng apidog --version hiển thị một số và tài khoản Apidog của bạn đã được xác thực.
Antigravity nào được nhắc đến ở đây
Antigravity là nền tảng phát triển dựa trên tác nhân của Google, được xây dựng trên Gemini 3, ra mắt vào cuối năm 2025. Nó chạy tác nhân thông qua một Trình quản lý tác nhân (Agent Manager) để lập kế hoạch công việc, chỉnh sửa tệp trên kho lưu trữ của bạn và thực thi các lệnh shell trong terminal và trình duyệt riêng của nó. Tác nhân là giao diện chính, và nó hoạt động trực tiếp trên máy cục bộ của bạn. Nếu bạn đã mở Antigravity, khởi động một tác vụ và theo dõi tác nhân chạy lệnh rồi báo cáo lại, bạn đang ở đúng chỗ. Để biết tổng quan rộng hơn, hãy xem Antigravity của Google là gì và cách sử dụng nó.
Sự phân biệt này quan trọng vì Antigravity có cách riêng để học các quy tắc dự án, và cơ chế đó biến một lệnh "chạy thử nghiệm của tôi" một lần thành thứ mà tác nhân tự động thực hiện.
Bước 1: Cung cấp cho Antigravity một tệp quy tắc
Antigravity nhận diện một thư mục đặc biệt .agents/ tại thư mục gốc không gian làm việc của bạn. Codelab của Google về xây dựng các quy trình phát triển tự động trong Antigravity cho thấy tác nhân tự động nhận các tệp bạn đặt ở đó, và các quy tắc không gian làm việc nằm trong .agents/rules/. Đặt các quy tắc dự án của bạn vào một tệp như .agents/rules/apidog.md. Antigravity cũng đọc một tệp AGENTS.md thông thường tại thư mục gốc không gian làm việc làm nền tảng chung cho các công cụ, đây là tệp mà Codex đọc cho Apidog CLI; nếu bạn đã có tệp này, hãy thêm khối Apidog vào đó thay vì duy trì hai tệp.
Đặt một khối Apidog ngắn vào tệp quy tắc đó. Đại loại như sau:
## API testing with the Apidog CLI
- Để kiểm tra API, chạy kịch bản Apidog, không nhấp qua giao diện người dùng đồ họa (GUI).
- Lệnh: apidog run -t <scenario_id> -e <env_id> -r cli
- Mã thoát 0 có nghĩa là mọi khẳng định đều thành công. Khác 0 có nghĩa là thất bại; mở báo cáo và sửa mã.
- Máy đã được xác thực thông qua `apidog login`. Không bao giờ thêm cờ --access-token và không bao giờ đặt mã thông báo vào tệp này.
Đây là lý do tại sao bạn viết CLI vào tệp quy tắc thay vì đề cập nó trong cuộc trò chuyện. Antigravity không ghi nhớ những gì bạn dạy nó giữa các phiên; đóng cửa sổ, mở lại, và hướng dẫn sẽ biến mất. Một ID kịch bản được gõ vào cuộc trò chuyện sẽ biến mất khi phiên kết thúc. Một cái được ghi vào tệp quy tắc của bạn sẽ tồn tại cho mọi đồng đội và mọi lần chạy Antigravity từ bây giờ.
Bước 2: Lấy lệnh từ Apidog
Bạn không cần phải đoán ID kịch bản và môi trường. Mở kịch bản kiểm thử trong Apidog, vào tab CI/CD của nó, và sao chép lệnh đã tạo. Nó trông như thế này:
apidog run -t 123456 -e 789012 -r cli
Cờ -t là ID kịch bản kiểm thử, -e là ID môi trường, và -r cli chọn trình báo cáo in kết quả trực tiếp. Dán những ID thực tế đó vào khối .agents/rules/apidog.md của bạn để tác nhân chạy chính xác lệnh Apidog đã cung cấp cho bạn. Để biết tất cả các cờ, hãy xem tham chiếu lệnh apidog run.
Bước 3: Yêu cầu tác nhân chạy kiểm thử
Với khối đã được đặt, hãy bắt đầu một tác vụ trong Antigravity. Tác nhân tải các quy tắc của bạn khi nó bắt đầu, vì vậy nó đã biết CLI có ở đó. Thực hiện một thay đổi liên quan đến API của bạn, hoặc chỉ yêu cầu nó chạy kiểm tra:
Chạy kịch bản kiểm thử Apidog và cho tôi biết mã thoát.
Tác nhân thực thi lệnh apidog run từ tệp quy tắc của bạn trong terminal riêng của nó. Việc nó chạy mà không cần hỏi có phụ thuộc vào cài đặt quyền của bạn. Cài đặt bảo mật (Security Preset) của Antigravity xác định xem các lệnh terminal và quyền truy cập tệp có được bạn xem xét trước khi tác nhân thực hiện hay không, như mô tả trong codelab bắt đầu với Antigravity của Google. Nếu cài đặt yêu cầu xem xét, hãy phê duyệt lệnh apidog run khi nó nhắc; một kịch bản kiểm thử chỉ đọc chống lại môi trường staging chính xác là loại lệnh an toàn, trong không gian làm việc mà bạn có thể phê duyệt. Nếu bạn đã đặt tác nhân tự động tiếp tục, nó sẽ chạy lệnh và báo cáo lại mà không dừng.
Bạn muốn thấy quá trình chạy được thực thi và tác nhân báo cáo cả tóm tắt lẫn mã thoát, chứ không phải một bản diễn giải.
Bước 4: Đọc báo cáo bên trong Antigravity
Khi một lần chạy báo lỗi (màu đỏ), báo cáo sẽ có câu trả lời. Với -r cli, tác nhân sẽ nhận được một bản phân tích dễ đọc trong terminal của nó: mỗi yêu cầu, mỗi khẳng định, và cái nào đã thất bại với giá trị mong đợi so với giá trị thực tế. Khẳng định thất bại sẽ nêu tên trường hoặc mã trạng thái chính xác, điều này thường đủ để tác nhân tìm ra cách sửa lỗi.
Để có một báo cáo mà bạn có thể mở trong trình duyệt hoặc đưa cho đồng đội, hãy thêm trình báo cáo HTML:
apidog run -t 123456 -e 789012 -r cli,html
Trình báo cáo html ghi một tệp độc lập vào ./apidog-reports. Giữ cli trong danh sách để tác nhân vẫn nhận được đầu ra trực tiếp mà nó đọc để quyết định bước tiếp theo. Để biết đầy đủ các trình báo cáo, bao gồm định dạng JUnit mà các bảng điều khiển CI phân tích, hãy xem hướng dẫn Apidog CLI đầy đủ và cách đọc báo cáo kiểm thử Apidog CLI.
Kiểm thử Antigravity trong vòng lặp riêng của nó
Vấn đề là điều gì sẽ xảy ra khi bạn ngừng yêu cầu và tác nhân tự chạy kịch bản vì tệp quy tắc đã hướng dẫn nó làm như vậy.
Hãy hình dung tác nhân chỉnh sửa một bộ xử lý (handler) xây dựng phản hồi thanh toán. Vòng lặp của nó thay đổi. Nó chỉnh sửa mã, sau đó, thay vì tuyên bố thành công, nó chạy kịch bản Apidog của bạn trên môi trường staging, đọc mã thoát và hành động dựa trên đó. Nếu thành công (màu xanh), nó tiếp tục. Nếu lỗi (màu đỏ), nó mở báo cáo, đọc xem khẳng định nào thất bại (mã trạng thái, trường bị thiếu, giá trị sai), thử một cách sửa lỗi, và chạy lại. Kiểm thử API trở thành một phần của cùng vòng lặp chỉnh sửa-kiểm thử-sửa lỗi mà tác nhân đã chạy cho các bài kiểm tra đơn vị của bạn. Bạn đã viết một hướng dẫn và tác nhân đã tích hợp lệnh đó vào cách nó hoạt động.
Đây là mô hình ủy quyền-sau đó-xác minh giúp mọi quy trình làm việc của tác nhân trở nên an toàn. Antigravity chạy lệnh và đọc kết quả; bạn tiếp tục tạo kịch bản một cách trực quan trong Apidog và kiểm tra ngẫu nhiên xem tác nhân có đọc mã thoát một cách trung thực hay không. Để biết mô hình rộng hơn, hãy xem cách sử dụng tác nhân AI cho kiểm thử API và bộ công cụ kiểm thử AI của Apidog.
Xác minh Antigravity thực sự đang chạy CLI
Các tác nhân thường báo cáo thành công mà họ không thực sự đạt được, và Antigravity cũng không ngoại lệ. Ba bước kiểm tra, theo thứ tự mức độ thường xuyên chúng phát hiện vấn đề.
Đầu tiên, xác nhận lệnh đã chạy. Antigravity hiển thị các lệnh nó đã thực thi và kết quả đầu ra của chúng trong terminal của nó. Tìm dòng apidog run ... theo đúng nghĩa đen và kết quả bên dưới nó. Nếu tác nhân nói rằng nó đã chạy các bài kiểm thử nhưng bạn không thấy lệnh, tức là nó đã tóm tắt một điều mà nó chưa bao giờ làm. Yêu cầu nó chạy lại và hiển thị đầu ra thô.
Thứ hai, xác nhận mã thoát, cái quan trọng. Hỏi trực tiếp:
Mã thoát của lệnh apidog run đó là gì?
Lệnh apidog run thoát với mã 0 khi mọi khẳng định đều vượt qua và mã khác 0 khi có bất kỳ lỗi nào. Hành vi đơn giản đó cho phép tác nhân, hoặc một pipeline, coi lần chạy là một cổng sạch. Khi lời văn của tác nhân nói “các bài kiểm thử đã vượt qua” nhưng mã thoát khác 0, thì mã thoát là đúng.
Thứ ba, xác nhận nó đã sử dụng kịch bản thực tế. Nếu một lần chạy thất bại với thông báo “không tìm thấy kịch bản”, tác nhân có thể đã tự tạo hoặc nhớ sai một ID. Kiểm tra lại các giá trị -t và -e so với tệp quy tắc của bạn và lệnh Apidog đã tạo trong tab CI/CD. Các ID trong tệp quy tắc của bạn là sự thật.
Tùy chọn: kết nối máy chủ Apidog MCP
Chạy apidog run từ tệp quy tắc của bạn đáp ứng hầu hết những gì bạn cần. Để tiến xa hơn, hãy kết nối một máy chủ MCP.
Antigravity hỗ trợ Giao thức ngữ cảnh mô hình (Model Context Protocol), và các máy chủ MCP của nó được cấu hình trong tệp $HOME/.gemini/config/mcp_config.json, theo codelab bắt đầu của Google. Bạn thêm một máy chủ dưới dạng một mục trong đối tượng mcpServers của tệp đó với command, args và env của nó, sau đó làm mới MCP trong cài đặt Antigravity. Máy chủ Apidog MCP hiển thị các đặc tả API của bạn qua MCP, vì vậy tác nhân có thể đọc lược đồ của bạn trong khi nó viết mã, chứ không phải chỉ sau đó. CLI chạy các bài kiểm thử; MCP cung cấp đặc tả cho tác nhân.
Khi Antigravity mắc lỗi
Một vài lỗi thường xuất hiện trong quá trình thiết lập.
Nó bỏ qua tệp quy tắc. Nếu tác nhân chạy một lệnh chung hoặc không chạy gì cả, các quy tắc có thể không được tải. Xác nhận tệp được đặt tên chính xác và nằm ở vị trí Antigravity mong đợi cho không gian làm việc của bạn, sau đó bắt đầu một tác vụ mới để nó đọc lại các quy tắc.
Nó vẫn truyền một mã thông báo truy cập. Nếu tác nhân cố gắng thêm --access-token, tức là nó đang đoán từ các ví dụ công khai. Khối quy tắc của bạn đã chỉ dẫn nó không làm vậy, vì máy đã được xác thực qua apidog login. Củng cố dòng đó, và không bao giờ đặt mã thông báo thực vào tệp quy tắc. Để biết cách xác thực thực sự hoạt động, hãy xem xác thực Apidog CLI.
Nó tự tạo ra một cờ. Lỗi “tùy chọn không xác định” có nghĩa là tác nhân đã đoán một cờ mà phiên bản của bạn không có. Yêu cầu nó chạy apidog run --help và sao chép cờ chính xác từ đó, điều này luôn đúng với phiên bản đã cài đặt của bạn.
Nó báo cáo thành công khi một lần chạy đã thất bại. Đây là lỗi tốn kém nhất, và là lý do tại sao quy tắc mã thoát nằm trong tệp quy tắc của bạn và bước xác minh của bạn. Khi tóm tắt và mã thoát không khớp, mã thoát sẽ thắng.
Từ một tác nhân hàng ngày đến một vòng lặp đã được kiểm thử
Đó là cách thiết lập. Cài đặt apidog-cli một lần theo hướng dẫn cài đặt, thêm một khối Apidog ngắn vào tệp quy tắc Antigravity của bạn, và tác nhân sẽ biết cách chạy các bài kiểm thử API của bạn và đọc kết quả bên trong cùng một vòng lặp mà nó đã sử dụng để chỉnh sửa mã. Một điểm cuối bị lỗi sẽ được phát hiện khi tác nhân vẫn đang làm việc với thay đổi, chứ không phải sau khi nó được triển khai.
Một bài kiểm thử phía sau giao diện người dùng đồ họa (GUI) chạy khi một người nhấp chuột; một lệnh một dòng chạy bất cứ khi nào Antigravity quyết định. Bạn tiếp tục xây dựng các kịch bản một cách trực quan trong Apidog, và tác nhân của bạn chạy chúng ở nơi bạn không theo dõi. Tải Apidog, xây dựng một kịch bản, thả lệnh apidog run của nó vào tệp quy tắc của bạn, và xem tác nhân tiếp nhận nó ở lần thay đổi tiếp theo. Khi bạn sẵn sàng chạy cùng một lệnh trong một pipeline mà không có tác nhân hiện diện, Apidog CLI trong GitHub Actions bao gồm các bí mật, trình báo cáo và kiểm soát mã thoát.