Artifacts trong Antigravity: duyệt việc của AI bằng bằng chứng

Artifacts trong Antigravity là gì? Artifact là sản phẩm có cấu trúc mà tác tử của Google Antigravity tạo ra để làm việc và báo cho bạn biết nó đang nghĩ gì, đã làm gì: kế hoạch triển khai (implementation plan), bản khác biệt mã (diff), sơ đồ kiến trúc, ảnh chụp, bản ghi trình duyệt và bản tóm tắt cuối việc (walkthrough). Theo tài liệu chính thức (đọc ngày 03/11/2026), artifact cho phép cộng tác bất đồng bộ: bạn không cần dõi từng lệnh gọi công cụ, chỉ cần duyệt sản phẩm ở các mốc quan trọng. Bài này không hứa artifact giúp AI hết sai: artifact là bằng chứng để người duyệt kiểm tra, còn kiểm tra thế nào vẫn là việc của người. Bài đi qua từng loại artifact, cách bình luận, chính sách duyệt, khung Review và /diff. Phần giới thiệu chung xem ở Antigravity là gì?.

Vòng duyệt bằng artifact: kế hoạch, bằng chứng, bình luận, sửa, rồi mới giữ thay đổi. Sơ đồ: OPCAIOS.

Antigravity tạo những loại artifact nào?

Artifacts trong Antigravity gồm năm nhóm chính, theo các trang tài liệu artifacts, implementation-plan, walkthrough, screenshots và browser-recordings (đọc 03/11/2026). Phần lớn artifact được tạo trong chế độ Planning của tác tử.

Artifact	Khi nào xuất hiện	Dùng để duyệt gì
Implementation plan	Trước khi sửa mã, hoặc khi gọi /plan	Hướng làm, phạm vi, bước kiểm chứng
Diff mã	Khi tác tử ghi file	Từng dòng thay đổi
Ảnh chụp (screenshot)	Khi tác tử con browser cần bạn xem trạng thái trang	Giao diện có đúng không
Bản ghi trình duyệt	Mỗi lần tác tử con browser thao tác	Tác tử đã bấm gì, gõ gì
Walkthrough	Khi xong việc	Tóm tắt đã thay đổi gì

Về danh sách việc (task list): tài liệu hiện tại không có trang riêng (đọc 03/11/2026). Trang artifact-review chỉ ghi chế độ Planning chia việc thành "task groups", và nhật ký thay đổi có nhắc "task list" như một loại artifact.

Implementation plan là gì và duyệt nó thế nào?

Implementation plan là artifact kế hoạch mà tác tử Antigravity dùng để thiết kế các thay đổi trong mã trước khi làm, gồm chi tiết kỹ thuật cần sửa và được viết để bạn đọc duyệt. Theo trang Implementation plan (đọc 03/11/2026), trừ khi chính sách duyệt đặt là Always proceed, tác tử thường dừng lại xin bạn duyệt kế hoạch trước khi sửa file. Bạn có ba lựa chọn:

1. Proceed: bấm trong cuộc hội thoại hoặc trên đầu artifact để tác tử làm theo kế hoạch.
2. Bình luận rồi vẫn Proceed: ghi chú cho tác tử nhưng cho làm tiếp.
3. Review: bấm Review trên đầu artifact để xem lại mọi bình luận và gửi chúng thành một tin nhắn góp ý thay vì cho làm ngay.

Sau khi bạn Proceed hoặc gửi Review, tác tử hoặc sửa kế hoạch rồi xin duyệt lại, hoặc bắt đầu triển khai. Lệnh /plan buộc tác tử khảo sát mã mà không ghi file, hỏi lại khi yêu cầu mơ hồ, rồi mới viết kế hoạch. Trang /plan khuyên dùng cho tái cấu trúc lớn, yêu cầu chưa rõ hay di trú cơ sở dữ liệu. Cách này giống Plan mode trong Claude Code.

Bình luận lên artifact để AI sửa hoạt động ra sao?

Bình luận lên artifact là cách chỉ đúng chỗ sai cho tác tử Antigravity, thay vì viết một tin nhắn dài mô tả lại từ đầu. Theo trang Mentions and quoting (đọc 03/11/2026), khi bạn chọn một đoạn chữ trong artifact như implementation plan, một cửa sổ nhỏ hiện hai nút: Comment để để lại bình luận duyệt, Quote (Cmd+L trên macOS, Ctrl+L trên Windows và Linux) để đưa đoạn đó vào tin nhắn kế tiếp. Ảnh chụp cũng được lưu thành artifact hình ảnh và bình luận được. Bốn mẹo:

1. Mỗi bình luận nói một việc: "bỏ bước này", "dùng thư viện có sẵn", không gộp nhiều ý.
2. Ghi lý do ngắn để tác tử không lặp lỗi ở bước khác.
3. Nêu tiêu chí chấp nhận: "trang phải tải được khi không đăng nhập".
4. Đọc lại kế hoạch đã sửa, đừng giả định tác tử đã làm đúng.

Ví dụ giả định, không phải dự án thật: kế hoạch thêm trang đặt lịch hẹn đề xuất cài một thư viện lịch mới. Người duyệt bình luận vào đúng bước đó: "dùng ô chọn ngày sẵn có của trình duyệt, không thêm thư viện", rồi bấm Review.

Chính sách duyệt artifact nên đặt thế nào?

Chính sách duyệt artifact quyết định tác tử Antigravity có dừng lại chờ bạn trước khi làm theo kế hoạch hay không. Theo trang Artifact review (đọc 03/11/2026), khi mở cuộc hội thoại mới bạn chọn giữa hai chế độ: Planning (lên kế hoạch kỹ, tạo artifact) và Fast (làm thẳng, hợp việc nhỏ như đổi tên biến hay chạy một lệnh). Trong chế độ Planning, chính sách duyệt chỉnh ở thẻ Agent của Settings, có hai lựa chọn:

1. Request review (được khuyên dùng): tác tử luôn dừng và chờ bạn duyệt khi tạo kế hoạch hoặc diff.
2. Always proceed: tác tử không bao giờ dừng chờ duyệt, tự làm tiếp.

Chính sách duyệt khác với chế độ quyền chạy lệnh. Trang /goal ghi rõ chế độ goal chỉ đổi cách tác tử dừng, không đổi quyền công cụ hay chính sách duyệt artifact. Người mới nên để Request review; Always proceed chỉ hợp dự án thử có Git và bản sao lưu. Chi tiết về các mức quyền như Default, Auto hay Turbo nằm ở bài chế độ an toàn trong Antigravity.

Walkthrough, ảnh chụp và bản ghi trình duyệt chứng minh được gì?

Walkthrough, ảnh chụp và bản ghi trình duyệt là ba loại artifact chứng minh tác tử Antigravity đã làm gì, khác với lời tác tử tự kể. Theo tài liệu đọc ngày 03/11/2026, walkthrough được tạo khi tác tử xong việc, tóm tắt các thay đổi để bạn nắm lại trạng thái mã dù không theo dõi từng bước. Với việc trên trình duyệt, walkthrough thường kèm ảnh chụp và bản ghi màn hình. Ảnh chụp do tác tử con browser chụp trang hoặc một phần trang khi cần bạn xem. Bản ghi trình duyệt ghi lại thao tác của tác tử con browser, xem lại được dạng vòng lặp; trang tính năng ghi định dạng là video WebM. Ba giới hạn cần nhớ:

1. Walkthrough là bản tóm tắt do tác tử viết, nên vẫn phải đối chiếu với diff thật.
2. Ảnh chụp chỉ cho thấy một thời điểm, không chứng minh trang chạy đúng ở mọi trường hợp.
3. Bản ghi cho thấy tác tử đã thao tác, chưa chứng minh kết quả đúng nghiệp vụ.

Hãy coi artifact là bằng chứng để đặt câu hỏi, không phải lời xác nhận cuối. Cách tác tử con browser hoạt động xem ở browser agent của Antigravity.

Review changes trên ứng dụng và /diff trên CLI dùng thế nào?

Review changes là khung xem diff của Antigravity để kiểm tra từng file tác tử đã sửa trước khi giữ lại, gửi bình luận theo dòng và commit vào Git. Theo trang Review changes (đọc 03/11/2026), trên ứng dụng bạn mở khung Review từ bảng Overview hoặc từ thẻ "N files changed" dưới một lượt trả lời. Khung có ba cách xem:

Chế độ xem	Hiển thị
Uncommitted	Thay đổi đã stage và chưa stage (mặc định)
Branch	Mọi thay đổi trên nhánh hiện tại so với nhánh gốc
Agent Edits	File tác tử đã sửa trong cuộc hội thoại

Bình luận theo dòng được gắn vào tin nhắn kế tiếp, tác tử nhận kèm tên file và số dòng. Lưu ý quan trọng: nút Discard unstaged changes có hiệu lực ngay không hỏi lại và xoá luôn file chưa theo dõi khỏi ổ đĩa. Trên CLI, lệnh /diff mở trình xem diff toàn màn hình với ba chế độ All Changes, Per Turn và Commit Tree; nhấn C để bình luận, thoát ra sẽ được hỏi gửi bình luận chưa gửi hay không.

Quy trình duyệt việc của AI bằng bằng chứng gồm những bước nào?

Quy trình duyệt bằng bằng chứng là thói quen chỉ chấp nhận thay đổi của tác tử khi đã thấy kế hoạch, diff và kết quả kiểm chứng, thay vì tin lời tóm tắt. Gợi ý của OPCAIOS, ghép từ các tính năng trong tài liệu Antigravity:

1. Việc có rủi ro: dùng /plan hoặc Planning, chính sách Request review.
2. Bình luận vào đúng bước cần đổi trong kế hoạch, bấm Review.
3. Ghi tiêu chí xong kiểm chứng được: lệnh kiểm thử phải qua, trang phải hiện gì.
4. Xong việc: mở khung Review ở Agent Edits, đọc từng file.
5. Giao diện: xem ảnh chụp, bản ghi, rồi tự mở trang kiểm tra.
6. Đọc walkthrough sau cùng, đối chiếu với diff, rồi mới commit.

Với người không viết mã, sáu bước này là lớp an toàn tối thiểu; xem thêm quy trình an toàn cho người không biết code.

Kinh nghiệm của OPCAIOS

Trong hệ thống của OPCAIOS, Antigravity là tác tử điều phối trên máy Mac, cài ứng dụng Antigravity bản 2.28.x, Antigravity IDE bản 2.5.x và CLI agy bản 1.4.12, dùng song song với Claude Code và Codex. Antigravity từng làm một số tính năng quản trị website và sửa menu. Những điều chúng tôi thấy được trên máy, kiểm tra ngày 03/11/2026:

1. Tác tử dùng hồ sơ Chrome riêng, tách khỏi trình duyệt cá nhân.
2. Thư mục bản ghi trình duyệt hiện trống, nên chúng tôi không có bản ghi nào để minh hoạ và không khẳng định mức dùng tác tử con browser.
3. Mã website chỉ được sửa và triển khai từ một máy duy nhất. Lý do: từng có lần hơn 1.500 file hiện khác nhau chỉ vì kiểu xuống dòng khi triển khai từ máy Windows. Diff hàng nghìn file không duyệt bằng mắt được, nên phải dọn nguyên nhân gốc trước. Chúng tôi chưa kiểm chứng tuỳ chọn ẩn khoảng trắng của khung Review có ẩn được khác biệt kiểu xuống dòng hay không.

Chúng tôi chưa đo thời gian duyệt hay tỉ lệ lỗi bắt được nhờ artifact, nên không có số liệu để chia sẻ.

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

Artifact trong Antigravity được lưu ở đâu?

Theo trang Agent settings (đọc 03/11/2026), thư mục dữ liệu cục bộ của ứng dụng chứa artifact, mục knowledge và các dữ liệu khác, và mặc định tác tử chỉ được truy cập thư mục dự án cùng thư mục dữ liệu này. Trên ứng dụng, bạn xem artifact ở thanh bên và khung duyệt; trên CLI, mở danh sách artifact bằng Ctrl+R. Đừng chép thư mục này lên kho Git công khai vì có thể chứa nội dung riêng tư.

Có tắt được việc tác tử dừng chờ duyệt kế hoạch không?

Có. Trong thẻ Agent của Settings, đổi chính sách duyệt artifact từ Request review sang Always proceed, tác tử sẽ không dừng chờ duyệt nữa. Chế độ Fast cho việc nhỏ cũng bỏ qua bước lập kế hoạch. Tài liệu khuyên dùng Request review. Chỉ nên tắt bước duyệt cho dự án thử nghiệm có Git và có bản sao lưu.

Bình luận lên artifact khác gì gõ tin nhắn bình thường?

Bình luận gắn vào đúng đoạn chữ hoặc đúng dòng mã, nên tác tử biết chính xác chỗ cần sửa. Với diff trong khung Review, tác tử nhận cả tên file và số dòng. Với kế hoạch, bạn có thể gom nhiều bình luận rồi bấm Review để gửi một lần. Tin nhắn hợp cho đổi hướng lớn, bình luận hợp cho sửa chi tiết.

Walkthrough có đủ để tin tác tử đã làm đúng không?

Không đủ. Walkthrough là bản tóm tắt do chính tác tử viết sau khi xong việc. Nó có thể bỏ sót hoặc mô tả lạc quan. Hãy đối chiếu với diff thật ở chế độ Agent Edits, chạy lại kiểm thử và tự mở trang để xem. Ảnh chụp và bản ghi trình duyệt là bằng chứng bổ sung, không thay cho việc tự kiểm tra.

Người mới nên bắt đầu dùng artifact thế nào?

Bắt đầu với chế độ Planning và chính sách Request review cho mọi việc chạm vào mã thật. Mỗi lần tác tử đưa kế hoạch, đọc hết và để lại ít nhất một bình luận nếu thấy chỗ chưa rõ. Khi xong, mở khung Review và đọc từng file trước khi commit. Nếu muốn chạy nhiều tác tử, đọc thêm Agent Manager trong Antigravity. Muốn học quy trình này có người hướng dẫn, xem khoá đào tạo ứng dụng AI của OPCAIOS.

Nguồn: tài liệu Google Antigravity tại antigravity.google/docs: artifacts, artifact-review, implementation-plan, walkthrough, screenshots, ide/browser-recordings, review-changes, ide/review-changes-editor, cli/artifacts, plan, commands/goal, at-mentions, features, agent-settings, changelog (đọc ngày 03/11/2026). Chưa kiểm chứng: chi tiết artifact task list (không có trang riêng), việc ẩn khoảng trắng có ẩn khác biệt kiểu xuống dòng không. Kinh nghiệm là của OPCAIOS.