1. Giới thiệu
Trong lớp học lập trình này, bạn sẽ tìm hiểu về Google Antigravity, một nền tảng phát triển tác nhân được thiết kế để giúp bạn phát triển trong kỷ nguyên của các tác nhân. Antigravity 2.0 đóng vai trò là trung tâm điều khiển tập trung của các tác nhân AI, cung cấp một nền tảng hợp nhất để khởi chạy, giám sát và điều phối các hoạt động của các tác nhân này.
Với việc ra mắt phiên bản 2.0, Antigravity không chỉ còn là một Trình quản lý tác nhân được tích hợp với một IDE. Đây hiện là một hệ sinh thái hoàn chỉnh gồm các sản phẩm được thiết kế cho kỷ nguyên ưu tiên tác nhân:
- Antigravity: Ứng dụng độc lập hàng đầu dành cho macOS, Linux và Windows. Đây là trung tâm điều khiển để quản lý song song nhiều tác nhân cục bộ, chạy các tác vụ theo lịch và nhiều việc khác. Không giống như phiên bản tiền nhiệm là Agent Manager, Antigravity 2.0 là một ứng dụng độc lập hoạt động độc lập với một IDE.
- Antigravity IDE: IDE ban đầu, đầy đủ tính năng và có tác nhân vẫn được cung cấp (và được nhà phát triển nên dùng!). Công cụ này đi kèm với trình quản lý tác nhân, các cấu phần phần mềm và khả năng hiểu biết sâu sắc về toàn bộ mã nguồn của bạn.
- Antigravity CLI: Giao diện dòng lệnh để tương tác với tác nhân dựa trên thiết bị đầu cuối. Chúng tôi sẽ không đề cập đến vấn đề này trong hướng dẫn này.
- Antigravity SDK: Công cụ dành cho nhà phát triển để tích hợp Antigravity vào hệ thống của riêng họ theo cách có lập trình. Chúng tôi sẽ không đề cập đến vấn đề này trong hướng dẫn này.
Trong lớp học lập trình này, chúng ta sẽ tập trung vào Antigravity và đề cập ngắn gọn đến Antigravity IDE. Hai thành phần còn lại là Antigravity CLI và Antigravity SDK sẽ không được đề cập.
Nếu bạn quan tâm đến lớp học lập trình về Antigravity CLI (một ứng dụng dựa trên thiết bị đầu cuối), hãy tham khảo lớp học lập trình: Bắt đầu sử dụng Antigravity CLI.
Kiến thức bạn sẽ học được
- Cài đặt và định cấu hình Antigravity.
- Khám phá các khái niệm chính của Antigravity, chẳng hạn như cách làm việc với Agent, Workspace và nhiều khái niệm khác.
- Tuỳ chỉnh chế độ Antigravity thông qua nhiều chế độ cài đặt và theo lựa chọn ưu tiên của bạn.
Bạn cần có
Bạn cần cài đặt Antigravity trên hệ thống của mình. Sản phẩm này có trên máy Mac, Windows và một số bản phân phối Linux cụ thể. Ngoài máy tính của riêng mình, bạn sẽ cần những thứ sau:
- Trình duyệt web Chrome.
- Tài khoản Gmail (Tài khoản Gmail cá nhân).
Lớp học lập trình này dành cho người dùng và nhà phát triển ở mọi cấp độ.
Các vấn đề về báo cáo
Khi tham gia lớp học lập trình và sử dụng Antigravity, bạn có thể gặp phải vấn đề.
Đối với các vấn đề liên quan đến lớp học lập trình (lỗi chính tả, hướng dẫn sai), vui lòng mở một lỗi bằng nút Report a mistake ở góc dưới bên trái của lớp học lập trình này:
Đối với các lỗi hoặc yêu cầu về tính năng liên quan đến Antigravity, vui lòng báo cáo vấn đề trong Antigravity. Bạn có thể báo cáo ý kiến phản hồi về sản phẩm bằng cách nhấp vào biểu tượng Cài đặt ở góc dưới cùng bên trái của sản phẩm Antigravity. Sau đó, chọn biểu tượng Provide Feedback.
2. Cài đặt
Cài đặt Antigravity
Truy cập vào trang tải Google Antigravity xuống. Tải ứng dụng Antigravity xuống cho hệ điều hành của bạn (macOS, Linux hoặc Windows).
Chạy trình cài đặt. Màn hình sau sẽ xuất hiện:
Đăng nhập bằng Tài khoản Google của bạn. Hoàn tất quy trình xác thực và bạn sẽ thấy thông tin sau:
Nhấp vào Open Antigravity (Mở Antigravity). Chính sách này sẽ cho thấy Chính sách bảo mật và việc sử dụng dữ liệu. Nhấp vào Tiếp theo.
Chọn một giao diện bạn thích:
Antigravity đi kèm với một bộ trình bổ trợ hoạt động với nhiều Công cụ dành cho nhà phát triển của Google. Các trình bổ trợ này cài đặt một bộ kỹ năng giúp Antigravity hoạt động với nhiều công cụ dành cho nhà phát triển của Google. Dưới đây là danh sách các trình bổ trợ mà bạn có thể chọn cài đặt (không bắt buộc). Chúng ta sẽ không đề cập đến các trình bổ trợ này trong lớp học lập trình. Nhấp vào Hoàn tất.
Bạn sẽ thấy giao diện Antigravity như sau:
Cài đặt Antigravity IDE
Bạn có thể chọn cài đặt Antigravity IDE (không bắt buộc). Chuyển đến trang tải Google Antigravity xuống. Chuyển đến phần tải xuống Antigravity IDE.
Sau khi cài đặt thành công cả Antigravity và Antigravity IDE, bạn sẽ thấy 2 biểu tượng trong thanh công cụ: Antigravity (nền trắng) và Antigravity IDE (nền sau dạng lưới màu đen).
3. Giao diện Antigravity
Chúng tôi đã sẵn sàng bắt đầu! Trước tiên, hãy tập trung vào việc sử dụng Antigravity. Màn hình Antigravity ban đầu tương tự như màn hình này:
Chúng ta sẽ chuyển đến lựa chọn Cài đặt ở góc dưới cùng bên trái khi cần trong quá trình thực hiện hướng dẫn này.
Dự án
Trước tiên, hãy tìm hiểu khái niệm về Dự án trong Antigravity. Đây là điểm mấu chốt vì nếu bạn nhận thấy giao diện trong ngăn bên phải, thì giao diện này có ghi rõ Select Project (Chọn dự án) và Antigravity sử dụng phương pháp tiếp cận theo hướng dự án để đảm bảo các tác nhân có quyền truy cập vào đúng tệp, công cụ, quyền và nhiều nội dung khác.
Dự án là sự kết hợp của các thư mục xác định môi trường và phạm vi của tác nhân. Thay vì buộc một tác nhân hoạt động trong một thư mục duy nhất, một dự án có thể hoạt động với một hoặc nhiều thư mục (ví dụ: một kho lưu trữ giao diện người dùng và một kho lưu trữ phụ trợ), cung cấp cho các tác nhân của bạn tất cả ngữ cảnh cần thiết cho toàn bộ mã nguồn của bạn. Tất cả các dự án đều có chế độ cài đặt tác nhân riêng biệt, cho phép bạn tuỳ chỉnh chế độ cài đặt bảo mật của các dự án khác nhau một cách độc lập.
Hãy tạo dự án đầu tiên. Trong thư mục chính trên máy cục bộ, hãy tạo một thư mục có tên là $HOME/agy2-projects/my-first-project . Xin lưu ý rằng đây không nhất thiết phải là một thư mục trống.
Giờ đây, chúng ta sẽ tạo dự án đầu tiên trong Antigravity bằng cách xác định những thư mục cấu thành dự án. Trong trường hợp ban đầu, sẽ có một thư mục.
Nhấp vào Chọn dự án → Dự án mới như minh hoạ bên dưới:
Như dự kiến, bạn sẽ được yêu cầu Chọn(các) thư mục như minh hoạ dưới đây:
Nhấp vào Thêm thư mục rồi chuyển đến thư mục cụ thể mà bạn muốn chọn, tức là $HOME/agy2-projects/my-first-project
Bạn vẫn có thể thêm nhiều thư mục vào dự án (thông qua Add Folder (Thêm thư mục)), nhưng hiện tại, chúng ta có thể nhấp vào nút Next (Tiếp theo).
Thao tác này sẽ mở ra một hộp thoại như minh hoạ dưới đây. Tất cả dự án đều có chế độ cài đặt tác nhân riêng biệt, cho phép bạn tuỳ chỉnh độc lập các chế độ cài đặt bảo mật của từng dự án.
Mỗi dự án sẽ kế thừa các quyền liên quan đến việc xem xét cấu hình tạo tác, công cụ được phép, Máy chủ Giao thức ngữ cảnh mô hình (MCP) từ một cấu hình chung có sẵn thông qua phần Cài đặt trong giao diện chính. Tuy nhiên, bạn có thể đặt riêng các quyền này và nhiều quyền khác cho mỗi dự án, nhờ đó có được nhiều tính linh hoạt hơn và giữ cho ngữ cảnh cũng như các công cụ tinh gọn và hiệu quả cho dự án cụ thể của bạn.
Hiện tại, hãy chọn chế độ Mặc định.
Bạn cũng có thể đặt tên cho dự án trong hộp thoại tiếp theo rồi nhấp vào Create (Tạo):
Lúc này, bạn sẽ thấy màn hình sau. Dự án xuất hiện trong danh sách dự án và cả trong giao diện trò chuyện như minh hoạ. Xin lưu ý rằng bạn có thể chọn mô hình, truyền thêm bối cảnh thông qua dấu + hoặc @ hoặc hành động / và nhiều thao tác khác.
Sau khi bạn gửi lời chào đến tác nhân bằng một tin nhắn, tác nhân sẽ phản hồi cho phù hợp.
Chúng ta có một yêu cầu khác để lấy tin tức và yêu cầu này hoạt động hiệu quả.
Cuộc trò chuyện
Trong dự án của chúng tôi (my-first-project), chúng tôi đã bắt đầu một chuỗi hội thoại và hiện có một loạt tin nhắn (tin nhắn của người dùng và câu trả lời của trợ lý) trong chuỗi đó.
Bạn sẽ thấy chuỗi trò chuyện này ở bên trái được nhóm theo dự án.
Bây giờ, hãy làm điều gì đó thú vị và đặt tên cho chuỗi hội thoại này. Hãy gọi đó là conv-introduction.
Để làm điều đó, hãy nhấp vào biểu tượng ba dấu chấm dọc bên cạnh cuộc trò chuyện. Bạn sẽ thấy 3 lựa chọn. Chọn thao tác Đổi tên.
Đặt giá trị conv-introduction hoặc bất kỳ tên nào có ý nghĩa với bạn.
Giờ đây, nếu bạn muốn có một cuộc trò chuyện hoàn toàn mới trong dự án, hãy nhấp vào dấu + (Cuộc trò chuyện mới trong dự án) bên cạnh dự án như minh hoạ dưới đây.
Giờ đây, bạn đang tham gia một cuộc trò chuyện hoàn toàn mới.
Hãy hỏi một số tin tức thể thao trên khắp thế giới. Xin lưu ý rằng chúng ta vẫn đang ở trong my-first-project.
Điều này giúp tôi nắm bắt được một số tin tức về thế giới thể thao và bạn có thể nhận thấy rằng giờ đây chúng ta có 2 chuỗi trò chuyện trong cùng một dự án.
Hãy đổi tên cuộc trò chuyện này thành conv-sportsnews. Nếu muốn xem tất cả cuộc trò chuyện đã diễn ra cho đến nay, bạn có thể truy cập vào Nhật ký trò chuyện ở trên cùng bên trái như minh hoạ dưới đây:
Bất cứ lúc nào, bạn cũng có thể bắt đầu một cuộc trò chuyện mới trong dự án hiện tại hoặc một dự án mới thông qua lựa chọn Cuộc trò chuyện mới ở trên cùng.
Cài đặt dự án
Bây giờ, hãy quay lại phần Project Settings (Cài đặt dự án) mà chúng ta đã đề cập trước đó. Khi tạo một dự án trong Antigravity, dự án đó sẽ kế thừa các quyền mặc định. Bạn có thể ghi đè các quyền này một cách cụ thể nếu muốn.
Để chuyển đến phần cài đặt dự án cho một dự án cụ thể, hãy nhấp vào biểu tượng bánh răng cài đặt bên cạnh mỗi dự án trong thanh điều hướng bên trái.
Thao tác này sẽ đưa bạn đến chế độ cài đặt của Dự án cụ thể (tức là my-first-project) như minh hoạ bên dưới:
Lưu ý rằng ở bên trái, trong phần dự án, my-first-project được chọn. Nếu có nhiều dự án hơn, các dự án này sẽ xuất hiện trong danh sách này và bạn có thể dễ dàng chọn bất kỳ dự án nào rồi điều chỉnh chế độ cài đặt của dự án đó nếu cần.
Bây giờ, hãy tập trung vào phía bên phải, tức là phần cài đặt dự án cho my-first-project (dự án đầu tiên của tôi). Bạn sẽ thấy rằng thư mục này có một thư mục duy nhất mà chúng ta đã thêm vào dự án này. Bạn cũng có thể thêm các thư mục khác tại đây.
Bạn nên xem qua toàn bộ danh sách và xem xét tính linh hoạt hiện có để giúp bạn thay đổi nhiều chế độ cài đặt theo yêu cầu tuỳ chỉnh của dự án.
Trong đó có:
- Chế độ cài đặt sẵn về bảo mật: Xác định xem bạn có cần xem xét tất cả các lệnh của thiết bị đầu cuối và quyền truy cập vào tệp trước khi tác nhân có thể thực hiện các hành động hay không.
- Hành vi của tác nhân: Xác định xem tác nhân có thực hiện kế hoạch triển khai khi bạn xem xét hay không.
- Nhiều quyền cục bộ Đường dẫn tệp, URL, v.v. được phép hoặc bị chặn đối với tác nhân.
- Bạn thậm chí có thể định cấu hình những Công cụ MCP cụ thể được phép dùng cho dự án này. Điều này khá hữu ích để ngăn mọi máy chủ MCP được định cấu hình trên toàn cầu có sẵn cho tác nhân trong dự án này.
Lưu ý: Bất cứ lúc nào, bạn cũng có thể chuyển đến phần cài đặt của Antigravity hoặc thậm chí là phần cài đặt dự án thông qua lựa chọn cài đặt chính trong giao diện Antigravity.
4. Lệnh dấu gạch chéo
Có một số lệnh gạch chéo / thú vị trong Antigravity. Trong giao diện trò chuyện, nếu nhập / , bạn sẽ thấy các lệnh như minh hoạ dưới đây:
Hãy cân nhắc lệnh /browser. Đây là một lệnh rõ ràng để khởi chạy trình duyệt và yêu cầu trình duyệt làm một việc gì đó. Bạn cần có Google Chrome và quyền trong Google Chrome để bắt đầu một phiên gỡ lỗi.
Thao tác này sẽ tạo ra một tác nhân phụ của trình duyệt, cố gắng khởi chạy một phiên gỡ lỗi với Chrome và yêu cầu bạn cấp quyền trước:
Sau khi bạn cho phép, ứng dụng sẽ yêu cầu cấp quyền khi cần và nhận thông tin chi tiết.
Lệnh /schedule sẽ hữu ích nếu bạn muốn thiết lập các tác vụ định kỳ hoặc một lần để tác nhân thực thi theo khoảng thời gian cố định hoặc theo lịch (ví dụ: 9:00 sáng vào thứ Hai, thứ Tư).
Đồng thời, bạn cũng có thể thực hiện việc này thông qua giao diện người dùng và điều này được đề cập trong phần Lập lịch lệnh ở bước tiếp theo.
5. Lệnh lên lịch
Bạn có thể sử dụng lựa chọn Lịch biểu trong giao diện chính để tự động hoá các công việc định kỳ hoặc đặt lời nhắc một lần trong các dự án cụ thể.
Hãy tạo một việc cần làm hằng ngày để nhắc chúng ta về cuộc họp hằng ngày lúc 6 giờ chiều. Nhấp vào Mới rồi điền thông tin chi tiết như minh hoạ dưới đây:
Nhấp vào Thêm việc cần làm định kỳ, sau đó việc cần làm sẽ được thêm vào danh sách việc cần làm định kỳ như minh hoạ dưới đây:
Hãy thêm một lời nhắc khác để nhắc chúng ta nghỉ giải lao sau mỗi 20 phút:
Hiện tại, chúng ta có 2 tác vụ theo lịch, như minh hoạ dưới đây:
Bạn có thể tắt hoặc xoá bất kỳ việc cần làm nào. Hãy nhớ rằng chúng ta đã sử dụng các câu lệnh cơ bản, nhưng câu lệnh của bạn có thể chi tiết hơn, có thể gọi các công cụ (giao tiếp với các hệ thống bên ngoài) và thực hiện nhiều việc hơn ở chế độ nền theo định kỳ, dựa trên yêu cầu của bạn.
6. Máy chủ Giao thức ngữ cảnh mô hình (MCP)
Giao thức ngữ cảnh mô hình (MCP) đã trở thành tiêu chuẩn giúp kết nối các tác nhân với các hệ thống bên ngoài. Các công cụ này đóng vai trò quan trọng trong việc đảm bảo rằng tác nhân vẫn dựa trên dữ liệu và hoạt động tích hợp của bạn.
Antigravity hỗ trợ cả máy chủ MCP cục bộ và từ xa. Công cụ này cũng đi kèm với các chế độ tích hợp với một số máy chủ MCP hoạt động với các dịch vụ của Google Cloud và chỉ cần một lần nhấp để cài đặt với một số dữ liệu cấu hình.
Trước tiên, hãy xem danh sách các lựa chọn máy chủ MCP được định cấu hình sẵn. Chuyển đến phần Cài đặt → Tuỳ chỉnh rồi nhấp vào nút Thêm MCP+ để thêm một máy chủ mới. Thao tác này sẽ mở ra một hộp thoại, nơi bạn có thể xem danh sách đầy đủ các máy chủ:
Nhấp vào nút +Thêm để thêm bất kỳ Máy chủ MCP nào. Bạn sẽ cần cung cấp một số thông tin như mã dự án, thông tin chi tiết về cơ sở dữ liệu, tuỳ thuộc vào máy chủ MCP.
Thêm máy chủ MCP hiện có
Ở chế độ nền, các máy chủ MCP được định cấu hình trong tệp $HOME/.gemini/config/mcp_config.json. Nếu đã làm việc với các máy chủ MCP từ xa hiện có, bạn chỉ cần thêm thông tin chi tiết vào tệp này. Hãy xem phần định cấu hình Máy chủ MCP tuỳ chỉnh tại đây.
Sau khi thêm các máy chủ MCP từ xa và lưu tệp, bạn có thể chuyển đến phần máy chủ MCP trong Antigravity như sau:
- Trong giao diện chính của Antigravity, hãy nhấp vào Settings (Cài đặt).
- Chuyển đến phần Tuỳ chỉnh. Nhấp vào Làm mới nếu bạn vẫn không thấy các máy chủ MCP.
- Bạn có thể tắt bất kỳ máy chủ MCP nào nếu muốn thông qua nút Bật/tắt. Ngoài ra, bạn có thể nhấp vào bất kỳ máy chủ MCP nào và xem các công cụ do máy chủ này cung cấp.
Để sử dụng các máy chủ MCP đã định cấu hình, bạn có thể yêu cầu Antigravity làm điều gì đó cần đến máy chủ MCP. Ví dụ: bạn có thể bật máy chủ cloudrun-mcp và yêu cầu Antigravity thực hiện những việc sau: Build and deploy a Cloud Run service. Thao tác này sẽ nhắc Antigravity tìm và sử dụng máy chủ cloudrun-mcp để định cấu hình và triển khai một dịch vụ Cloud Run.
7. Tệp phần mềm
Antigravity tạo ra Artifacts (Hiện vật) khi lập kế hoạch và hoàn thành công việc. Đây là cách để Antigravity truyền đạt công việc của mình và nhận ý kiến phản hồi từ người dùng. Đây là các tệp markdown đa dạng thức, sơ đồ kiến trúc, hình ảnh, bản ghi trình duyệt, chênh lệch mã, v.v.
Các thành phần giải quyết khoảng trống về độ tin cậy. Khi một tác nhân tuyên bố đã sửa lỗi, trước đây, nhà phát triển phải đọc mã để xác minh. Trong Antigravity, tác nhân tạo ra một thành phần để chứng minh điều đó.
Sau đây là các cấu phần chính do Antigravity tạo ra:
Task Lists: Trước khi viết mã, tác nhân sẽ tạo một kế hoạch có cấu trúc. Bạn thường không cần chỉnh sửa kế hoạch này, nhưng có thể xem xét và trong một số trường hợp, bạn có thể thêm nhận xét để thay đổi kế hoạch nếu cần.Implementation Plan: Được dùng để thiết kế các thay đổi trong cơ sở mã nhằm hoàn thành một nhiệm vụ. Các kế hoạch này chứa thông tin chi tiết về kỹ thuật liên quan đến những bản sửa đổi cần thiết và người dùng phải xem xét, trừ phi bạn đặt chính sách đánh giá cấu phần phần mềm thành Luôn tiếp tục.Walkthrough: Thẻ này được tạo sau khi tác nhân hoàn tất việc triển khai tác vụ, dưới dạng bản tóm tắt về các thay đổi và cách kiểm thử các thay đổi đó.Code diffs: Mặc dù không phải là một cấu phần phần mềm, nhưng Antigravity cũng tạo ra các khác biệt về mã mà bạn có thể xem xét và nhận xét.Screenshots: Tác nhân này ghi lại trạng thái của giao diện người dùng trước và sau khi có thay đổi.
Để hiểu rõ hơn về các thành phần, hãy tạo một cuộc trò chuyện với một dự án mới hoặc hiện có bằng câu lệnh sau:
Write a node application that I can run from the command line to get me the latest news from Google.
Tác nhân bắt đầu hoạt động và quay lại với thành phần đầu tiên: Kế hoạch triển khai.
Bạn có thể xem bất kỳ cấu phần phần mềm nào do Antigravity tạo ra bằng cách bật/tắt Ngăn phụ xuất hiện ở góc trên cùng bên phải.
Nếu bật Auxiliary Pane (Ngăn phụ), bạn sẽ thấy đầu ra sau đây, trong đó đề cập đến việc có 1 Artifact (Hiện vật) được tạo (Kế hoạch triển khai).
Nhấp vào Kế hoạch triển khai để xem thông tin chi tiết, như minh hoạ bên dưới:
Hiện tại, chúng ta có thể chọn gói này và chỉ cần nhấp vào nút Tiếp tục để chuyển sang bước tiếp theo.
Giờ đây, khi hoạt động, nó sẽ tạo ra một cấu phần phần mềm khác, Kế hoạch công việc và các tệp khác. Bạn có thể thấy tất cả thông tin đó trong ngăn phụ như minh hoạ bên dưới:
Nếu nhấp vào cấu phần phần mềm Việc cần làm, bạn sẽ thấy danh sách việc cần làm từng bước để đạt được mục tiêu mà bạn đã xác định, cùng với những bước đã hoàn thành và những bước chưa hoàn thành.
Cuối cùng, khi mọi việc đã hoàn tất, được kiểm tra và xác minh bởi Nhân viên hỗ trợ, bạn sẽ nhận được thông báo cho biết rằng nhiệm vụ đã hoàn tất. Một cấu phần phần mềm khác có tên là Hướng dẫn hiện đã sẵn sàng. Bạn có thể xem danh sách cuối cùng như minh hoạ bên dưới:
Một số điều cần lưu ý, không chỉ có Artifacts (Task, Walkthrough và Implementation Plan) mà còn có Source Files (package.json , index.js).
Bạn có thể không cần một Trình chỉnh sửa / IDE đầy đủ tính năng để xem các tệp được tạo. Bạn có thể nhấp vào tệp package.json hoặc index.js và xem được nội dung cũng như nhận xét về nội dung đó.
8. Antigravity IDE
Bạn có thể chọn sử dụng IDE Antigravity mà chúng ta đã cài đặt trước đó trong lớp học lập trình này nếu muốn dùng IDE. Bạn sẽ nhận thấy rằng khi bạn chuyển đổi Bảng điều khiển phụ trong giao diện Antigravity chính, sẽ có một lựa chọn Mở IDE.
Nhấp vào đó để mở Antigravity IDE. Bạn có thể thấy một cảnh báo khi khởi chạy Antigravity IDE, cảnh báo này có dạng như sau:
Đây là điều bình thường. Hãy nhấp vào Có. Thao tác này sẽ mở Antigravity IDE. Những người từng sử dụng IDE sẽ thấy quen thuộc với IDE này. Nơi này có tất cả các thư mục/tệp đã tạo, một trình chỉnh sửa và một Bảng điều khiển tác nhân, nơi bạn có thể trò chuyện với Tác nhân về mã (giải thích, tạo, sửa, v.v.).
9. Kỹ năng
Mặc dù các mô hình cơ bản của Antigravity là những mô hình đa năng mạnh mẽ, nhưng chúng không biết ngữ cảnh dự án cụ thể hoặc các tiêu chuẩn của nhóm bạn. Việc tải mọi quy tắc hoặc công cụ vào cửa sổ ngữ cảnh của tác nhân sẽ dẫn đến tình trạng quá tải công cụ, chi phí cao hơn, độ trễ và sự nhầm lẫn.
Các kỹ năng giải quyết vấn đề này thông qua việc cung cấp thông tin theo trình tự lần lượt. Kỹ năng là một gói kiến thức chuyên biệt ở trạng thái không hoạt động cho đến khi cần. Thao tác này chỉ được tải vào ngữ cảnh của tác nhân khi yêu cầu cụ thể của bạn khớp với nội dung mô tả của kỹ năng .
Cấu trúc và phạm vi
Kỹ năng là các gói dựa trên thư mục. Bạn có thể xác định các biến này trong hai phạm vi, tuỳ thuộc vào nhu cầu của mình:
- Phạm vi toàn cầu (
~/.gemini/config/skills/): Có sẵn trên tất cả các sản phẩm và dự án của Antigravity (Antigravity, Antigravity IDE, Antigravity CLI). - Phạm vi dự án/không gian làm việc (
<project-root>/.agents/skills/): Lựa chọn này sẽ chỉ cho phép sử dụng kỹ năng trong một dự án cụ thể.
Phân tích cấu trúc của một kỹ năng
Một thư mục kỹ năng điển hình sẽ có dạng như sau :
my-skill/
├── SKILL.md #(Required) metadata & instructions.
├── scripts/ # (Optional) Python or Bash scripts for execution.
├── references/ # (Optional) text, documentation, or templates.
└── assets/ # (Optional) Images or logos.
Bây giờ, hãy thêm một số kỹ năng.
Kỹ năng xem xét mã
Đây là một kỹ năng chỉ có hướng dẫn, tức là chúng ta chỉ cần tạo tệp SKILL.md. Tệp này sẽ chứa siêu dữ liệu và hướng dẫn về kỹ năng. Hãy tạo một kỹ năng cung cấp thông tin chi tiết cho đặc vụ để xem xét các thay đổi về mã nhằm phát hiện lỗi, vấn đề về kiểu chữ và các phương pháp hay nhất.
Giả sử bạn đang ở trong một thư mục dự án cụ thể (ví dụ: $HOME/agy2-projects/my-skills-project), bước đầu tiên là tạo một thư mục trong thư mục dự án sẽ chứa kỹ năng.
mkdir -p .agents/skills/code-review
Tạo tệp SKILL.md trong thư mục dự án, chẳng hạn như .agents/skills/code-review mà chúng ta vừa tạo, với nội dung như minh hoạ dưới đây:
---
name: code-review
description: Reviews code changes for bugs, style issues, and best practices. Use when reviewing PRs or checking code quality.
---
# Code Review Skill
When reviewing code, follow these steps:
## Review checklist
1. **Correctness**: Does the code do what it's supposed to?
2. **Edge cases**: Are error conditions handled?
3. **Style**: Does it follow project conventions?
4. **Performance**: Are there obvious inefficiencies?
## How to provide feedback
- Be specific about what needs to change
- Explain why, not just what
- Suggest alternatives when possible
Lưu ý rằng tệp SKILL.md ở trên chứa siêu dữ liệu (tên và nội dung mô tả) ở trên cùng, sau đó là các chỉ dẫn. Khi tải, tác nhân sẽ chỉ đọc siêu dữ liệu của các kỹ năng và chỉ tải hướng dẫn đầy đủ về kỹ năng khi cần.
Hãy để chúng tôi xác thực kỹ năng Đánh giá mã. Mở một cuộc trò chuyện trong Antigravity trong một dự án cụ thể mà bạn chọn và đưa ra câu lệnh sau.
Thao tác này sẽ cho thấy kỹ năng code-review.
Dùng thử
Tạo một tệp mới có tên demo_bad_code.py trong $HOME/agy2-projects/my-skills-project với nội dung như bên dưới:
import time
def get_user_data(users, id):
# Find user by ID
for u in users:
if u['id'] == id:
return u
return None
def process_payments(items):
total = 0
for i in items:
# Calculate tax
tax = i['price'] * 0.1
total = total + i['price'] + tax
time.sleep(0.1) # Simulate slow network call
return total
def run_batch():
users = [{'id': 1, 'name': 'Alice'}, {'id': 2, 'name': 'Bob'}]
items = [{'price': 10}, {'price': 20}, {'price': 100}]
u = get_user_data(users, 3)
print("User found: " + u['name']) # Will crash if None
print("Total: " + str(process_payments(items)))
if __name__ == "__main__":
run_batch()
Mở một cuộc trò chuyện mới trong một dự án cụ thể trong Antigravity và đưa ra câu lệnh sau: review the @demo_bad_code.py file.
Trợ lý ảo phải xác định kỹ năng code-review, tải thông tin chi tiết rồi thực hiện hành động theo hướng dẫn trong tệp code-review/SKILL.md.
Dưới đây là một ví dụ về kết quả đầu ra:
10. Kết luận
Xin chúc mừng! Giờ đây, bạn đã cài đặt thành công Antigravity, định cấu hình môi trường và tìm hiểu cách kiểm soát các tác nhân.
Nhận huy hiệu Tác nhân AI trong 5 ngày trên Kaggle
Bạn đã hoàn thành phòng thí nghiệm này trong khoá học 5-Day AI Agents: Intensive Vibe Coding Course with Google của Kaggle chưa? Nhận huy hiệu hoàn thành: Nhận huy hiệu Tác nhân AI trong 5 ngày.
Các bước tiếp theo Để xem Antigravity hoạt động như thế nào trong quá trình tạo các ứng dụng thực tế, bạn có thể xem lớp học lập trình sau:
- Xây dựng và triển khai lên Google Cloud bằng Antigravity: Lớp học lập trình này hướng dẫn cách thiết kế, xây dựng và triển khai một ứng dụng không máy chủ lên Google Cloud.
Tài liệu tham khảo
- Trang web chính thức : https://antigravity.google/
- Tài liệu: https://antigravity.google/docs/home
- Các trường hợp sử dụng : https://antigravity.google/use-cases
- Tải xuống : https://antigravity.google/download
- Kênh YouTube của Google Antigravity : https://www.youtube.com/@googleantigravity