Google sử dụng công nghệ AI để dịch nội dung sang ngôn ngữ bạn ưu tiên. Bản dịch bằng AI có thể có lỗi.

Cách sử dụng Các kỹ năng của AI Agent (với Antigravity CLI và Các kỹ năng của Agent cho Firebase)

1. Giới thiệu

Ảnh bìa của phòng thí nghiệm Kỹ năng của tác nhân

Trong phòng thí nghiệm này, bạn sẽ tìm hiểu cách tạo Kỹ năng của tác nhân để cung cấp cho các tác nhân AI quyền truy cập vào kiến thức và quy trình công việc riêng biệt. Bạn sẽ tạo nó dưới dạng một kỹ năng cục bộ có thể truy cập từ Antigravity CLI.

Bạn sẽ thực hiện

Tạo Kỹ năng cho tác nhân của riêng bạn cho những việc bạn yêu thích.
Sử dụng Antigravity CLI để truy vấn kỹ năng của bạn.
Cài đặt Kỹ năng của tác nhân chính thức cho Firebase và sử dụng các kỹ năng này để tạo và triển khai một ứng dụng.

Kiến thức bạn sẽ học được

Cách cấu trúc một kỹ năng.
Cách viết tệp SKILL.md.
Cách sử dụng các kỹ năng cục bộ bằng Antigravity CLI.

2. Thiết lập dự án

Nếu chưa có Tài khoản Google, bạn phải tạo một Tài khoản Google.
- Sử dụng tài khoản cá nhân thay vì tài khoản do nơi làm việc hoặc trường học cấp. Tài khoản do nơi làm việc hoặc trường học cấp có thể có các hạn chế khiến bạn không bật được những API cần thiết cho lớp học này.
Đăng nhập vào Google Cloud Console.
Bật tính năng thanh toán trong Bảng điều khiển Cloud.
- Bạn sẽ tốn chưa đến 1 USD cho các tài nguyên trên Cloud để hoàn thành bài tập thực hành này.
- Bạn có thể làm theo các bước ở cuối bài thực hành này để xoá tài nguyên nhằm tránh bị tính thêm phí.
- Người dùng mới đủ điều kiện dùng thử miễn phí 300 USD.
Tạo dự án mới hoặc chọn sử dụng lại một dự án hiện có.
- Nếu bạn thấy lỗi về hạn mức dự án, hãy sử dụng lại một dự án hiện có hoặc xoá một dự án hiện có để tạo dự án mới.

3. Mở Trình chỉnh sửa Cloud Shell

Nhấp vào đường liên kết này để chuyển trực tiếp đến Cloud Shell Editor
Nếu được nhắc uỷ quyền vào bất kỳ thời điểm nào trong hôm nay, hãy nhấp vào Uỷ quyền để tiếp tục.
Nếu cửa sổ dòng lệnh không xuất hiện ở cuối màn hình, hãy mở cửa sổ đó:
- Nhấp vào Xem
- Nhấp vào Terminal (Thiết bị đầu cuối)
Trong thiết bị đầu cuối, hãy thiết lập dự án bằng lệnh sau:
- Định dạng:
```
gcloud config set project [PROJECT_ID]
```
- Ví dụ:
```
gcloud config set project lab-project-id-example
```
- Nếu bạn không nhớ mã dự án của mình, hãy làm như sau:
  - Bạn có thể liệt kê tất cả mã dự án bằng cách:
```
gcloud projects list | awk '/PROJECT_ID/{print $2}'
```
Bạn sẽ thấy thông báo sau:
```
Updated property [core/project].
```
Nếu thấy biểu tượng WARNING và được yêu cầu Do you want to continue (Y/n)?, thì có thể bạn đã nhập sai mã dự án. Nhấn n, nhấn Enter rồi thử chạy lại lệnh gcloud config set project.

4. Tạo kỹ năng tuỳ chỉnh

Agent Skills là các thư mục chứa ít nhất một tệp SKILL.md cung cấp hướng dẫn và kiến thức cho một tác nhân AI. Trong phần này, bạn sẽ tạo một kỹ năng giúp Antigravity CLI tìm hiểu về những điều bạn yêu thích.

Tạo một thư mục cho phòng thí nghiệm này rồi chuyển đến thư mục đó:
```
mkdir ~/agent-skills-lab && cd ~/agent-skills-lab
```

Tạo một thư mục cho kỹ năng của dự án:

mkdir -p ~/agent-skills-lab/.agents/skills/my-favorite-things

Tạo và mở một tệp SKILL.md mới cho kỹ năng của bạn:
```
cloudshell edit ~/agent-skills-lab/.agents/skills/my-favorite-things/SKILL.md
```
Lệnh cloudshell edit sẽ mở tệp SKILL.md trong trình chỉnh sửa phía trên cửa sổ dòng lệnh.

Thêm nội dung sau vào tệp SKILL.md:

---
name: my-favorite-things
description: Provides personal information about my favorite color, food, and programming language. Use this skill when the user asks questions about my personal preferences or favorite things.
---

# Knowledge

- **Favorite Color:** Blue
- **Favorite Food:** Pizza
- **Favorite Programming Language:** Python

If asked about one of my favorite things, please respond with the information provided above.

Chỉ với một tệp SKILL.md, bạn đã tạo được kỹ năng đầu tiên! Đã đến lúc sử dụng kỹ năng này trong Antigravity CLI.

5. Sử dụng kỹ năng của bạn từ Antigravity CLI

Giờ đây, bạn đã tạo thành công một kỹ năng và kỹ năng đó đã được Antigravity CLI phát hiện vì nằm trong thư mục .agents/skills.

Khởi động Antigravity CLI:
```
agy
```

Xác thực bằng Antigravity CLI: Bạn cần xác thực trong lần khởi động ban đầu. Chọn OAuth (nhấn Enter).
Nhấp vào đường liên kết (nếu không nhấp được, hãy đánh dấu URL trong Cloud Shell để sao chép, sau đó dán vào trình duyệt)
Đăng nhập vào Tài khoản Google của bạn
Sao chép mã
Dán mã vào cửa sổ dòng lệnh của Trình chỉnh sửa Cloud Shell
Nhấn Enter.
Nhấn Enter để chấp nhận một số chế độ cài đặt mặc định.
Yêu cầu Antigravity CLI liệt kê những kỹ năng mà công cụ này có thể sử dụng trong ngữ cảnh của nó
```
/skills
```
Bạn sẽ thấy my-favorite-things trong danh sách các kỹ năng có sẵn.
Nhấn ESC để thoát khỏi chế độ xem kỹ năng
Hỏi Antigravity CLI về màu sắc yêu thích của bạn:
```
What is my favorite color?
```
Antigravity CLI nên sử dụng kỹ năng my-favorite-things để trả lời câu hỏi của bạn. Nếu được nhắc, hãy cho phép Antigravity CLI sử dụng kỹ năng này.

Đầu ra sẽ cho thấy Antigravity CLI đã sử dụng kỹ năng của bạn và trả lời bằng nội dung như "Xanh dương" hoặc "Màu tôi yêu thích là xanh dương".

Bạn đã làm được! Bạn đã tạo thành công một kỹ năng và kiểm thử kỹ năng đó bằng Antigravity CLI.

Khi bạn đã sẵn sàng kết thúc phiên, hãy nhập /exit rồi nhấn Enter để thoát Antigravity CLI.

6. (Không bắt buộc) Tạo và triển khai một ứng dụng lên Firebase Hosting

Ngoài việc tạo kỹ năng của riêng mình, bạn có thể cài đặt các kỹ năng do người khác tạo. Điều này minh hoạ việc sử dụng kỹ năng linh hoạt – các mô-đun kiến thức, hướng dẫn và quy trình làm việc độc lập có thể dễ dàng chia sẻ và sử dụng lại.

Kỹ năng của tác nhân cho Firebase là một ví dụ điển hình về các mô-đun di động này. Các chỉ dẫn này được thiết kế để giúp trợ lý AI nắm được các phương pháp hay nhất của Firebase và thực hiện các tác vụ phức tạp với độ chính xác cao hơn và chi phí mã thông báo thấp hơn.

Giờ đây, hãy sử dụng Agent Skills cho Firebase để tạo một ứng dụng web "Việc cần làm", có tính năng xác thực người dùng và cơ sở dữ liệu, rồi triển khai ứng dụng đó lên Lưu trữ Firebase.

Thiết lập dự án

Nếu bạn vẫn đang ở trong Antigravity CLI, hãy nhập /exit để thoát.
Tạo một thư mục mới cho dự án của bạn rồi chuyển đến thư mục đó:
```
mkdir ~/todo-app && cd ~/todo-app
```
Đăng nhập vào Firebase bằng Tài khoản Google của bạn. Sử dụng cờ --no-localhost vì bạn đang ở trong Cloud Shell:
```
firebase login --no-localhost
```
1. Tương tác với lời nhắc trên giao diện dòng lệnh:
  - Khi được hỏi Enable Gemini in Firebase features?, hãy nhập Y (để chọn Có) rồi nhấn Enter.
  - Khi được hỏi Allow Firebase to collect CLI and Emulator Suite usage and error reporting information?, hãy nhập Y (để chọn Có) rồi nhấn Enter.
2. Uỷ quyền trong trình duyệt:
  - Bạn sẽ thấy một URL trong thiết bị đầu cuối. Nhấp vào đường liên kết (nếu không nhấp được, hãy đánh dấu URL trong Cloud Shell để sao chép, sau đó dán vào trình duyệt) để mở trang đăng nhập trong một thẻ trình duyệt mới.
  - Bước 1/3 (Xác nhận lệnh): Nhấp vào Có, tôi vừa chạy lệnh này.
  - Bước 2/3 (Xác nhận mã phiên): Đảm bảo Mã phiên khớp với mã phiên xuất hiện trong thiết bị đầu cuối của bạn, sau đó nhấp vào Có, đây là mã phiên của tôi.
  - Bước 3/3 (Sao chép mã): Nhấp vào Sao chép để sao chép mã uỷ quyền vào bảng nhớ tạm.
3. Hoàn tất quá trình đăng nhập:
  - Quay lại cửa sổ dòng lệnh Cloud Shell rồi dán mã uỷ quyền tại dấu nhắc ? Enter authorization code:.
  - Nhấn Enter.
Bạn sẽ thấy thông báo thành công: ✔ Success! Logged in as .

Cài đặt Kỹ năng của tác nhân cho Firebase

Giờ đây, khi đã tạo thư mục dự án, bạn nên cài đặt Agent Skills cho Firebase trong thư mục đó.

Bạn có thể cài đặt Agent Skills cho Firebase bằng skills CLI trong thiết bị đầu cuối:

npx skills add firebase/agent-skills

Trong quá trình cài đặt, bạn sẽ được nhắc chọn những kỹ năng cần cài đặt. Dùng các phím mũi tên để di chuyển trong danh sách và dùng phím cách để chọn những kỹ năng này.

firebase-auth-basics
firebase-basics
firebase-firestore
firebase-hosting-basics
firebase-security-rules-auditor

Chọn 5 kỹ năng Firebase

Đối với các lời nhắc tiếp theo, bạn có thể chấp nhận các giá trị mặc định một cách an toàn bằng cách nhấn Enter.

Lệnh này sẽ tải xuống và cài đặt các kỹ năng, bao gồm cả firebase-basics và firebase-hosting-basics, giúp bạn có thể sử dụng các kỹ năng này trong Antigravity CLI cùng với kỹ năng my-favorite-things.

Để tìm hiểu thêm về Kỹ năng của tác nhân cho Firebase, hãy xem các kỹ năng hiện có.

Tạo và triển khai một ứng dụng web cơ bản

Bật các API bắt buộc cho dự án của bạn:

gcloud services enable \
  cloudresourcemanager.googleapis.com \
  firebase.googleapis.com

Bật Firebase trên dự án hiện tại của bạn trên Google Cloud:
```
firebase projects:addfirebase ${GOOGLE_CLOUD_PROJECT}
```
Khởi động Antigravity CLI:
```
agy
```
Yêu cầu Antigravity CLI tạo một index.html cơ bản:
```
Generate an index.html file with the content "Hello Firebase Hosting" and
deploy the application to Firebase Hosting using the current Google Cloud
Project.
```
Antigravity CLI sẽ yêu cầu quyền khi tạo và triển khai ứng dụng. Nhấn Enter để cho phép. Bạn có thể cần nhập "approve" (phê duyệt) rồi nhấn Enter.Antigravity CLI sẽ sử dụng Agent Skills cho Firebase để tạo và triển khai trang web của bạn. Hướng dẫn tác nhân cùng với các quy trình phê duyệt nếu cần.

Sau khi triển khai xong, ứng dụng này sẽ cung cấp một URL cho ứng dụng web của bạn. Hãy dùng ctrl+click (Windows/Linux) hoặc cmd+click (Mac) để mở các đường liên kết trong thiết bị đầu cuối Cloud Shell Editor. Truy cập vào URL của ứng dụng bạn đã triển khai!

Thêm Xác thực Firebase

Khởi động Antigravity CLI nếu chưa khởi động:
```
agy
```
Antigravity CLI có thể hỏi những câu hỏi như "Bạn có tin tưởng thư mục này không?" Nhấn Enter để chấp nhận các giá trị mặc định.
Bây giờ, hãy yêu cầu Antigravity CLI thêm tính năng Đăng nhập bằng Google:
```
Generate HTML, CSS, and Javascript for a single page application.
It should use Google Sign-in with Firebase Authentication.
A user should be able to sign in with their Google Account.
Deploy when you are done and give the URL to me.
```
Antigravity CLI có thể yêu cầu tạo hoặc cập nhật các tệp như index.html, style.css và script.js. Cho phép Antigravity CLI làm như vậy. Antigravity CLI có thể yêu cầu bạn thực hiện một số thao tác trong bảng điều khiển của Firebase. CLI có thể thực hiện hầu hết các thao tác này nếu bạn yêu cầu, nhưng bạn có thể phải hoàn tất các bước theo cách thủ công (chẳng hạn như bật Google OAuth) nếu phiên bản Cloud Shell của bạn đã cài đặt phiên bản Firebase CLI cũ hơn.

Để xem các thay đổi mới nhất, bạn có thể cần thực hiện thao tác "Làm mới hoàn toàn" bằng cách nhấn ctrl+shift+R (Windows/Linux) hoặc cmd+shift+R (Mac).

Thêm Cloud Firestore

Khởi động Antigravity CLI nếu chưa khởi động:
```
agy
```
Antigravity CLI có thể hỏi những câu hỏi như "Bạn có tin tưởng thư mục này không?" Nhấn Enter để chấp nhận các giá trị mặc định.

Yêu cầu Antigravity CLI thêm Firestore để lưu các việc cần làm:

Update the application to save tasks in Cloud Firestore for the signed-in user.
A user should be able to add new tasks and see a list of their tasks.
Deploy when you are done and give the URL to to me.

Antigravity CLI sẽ cập nhật các tệp. Cho phép ứng dụng làm như vậy.

Để xem các thay đổi mới nhất, bạn có thể cần thực hiện thao tác "Làm mới hoàn toàn" bằng cách nhấn ctrl+shift+R (Windows/Linux) hoặc cmd+shift+R (Mac).

Nếu ứng dụng của bạn không hoạt động như mong đợi, hãy tiếp tục làm việc với Antigravity CLI để có được chức năng mà bạn mong muốn. Ví dụ: shell Hide the task form when the user is logged out. Update the security rules so the user can see their TODOs.

Hãy tiếp tục thử nghiệm với phòng thử nghiệm để thêm các tính năng bạn muốn thấy trong ứng dụng Firebase mới.

7. Kết luận

Xin chúc mừng! Bạn đã tạo thành công một kỹ năng và tìm hiểu cách cài đặt các kỹ năng bổ sung cho Antigravity CLI.

(Không bắt buộc) Dọn dẹp

Nếu muốn dọn dẹp, bạn có thể xoá dự án trên đám mây để tránh bị tính thêm phí.

Nếu bạn muốn, hãy xoá dự án:

gcloud projects delete $GOOGLE_CLOUD_PROJECT

Bạn cũng có thể xoá các tài nguyên không cần thiết khỏi ổ đĩa Cloud Shell để giải phóng dung lượng.

Xoá thư mục phòng thí nghiệm (thao tác này sẽ xoá cả kỹ năng và ứng dụng):
```
rm -rf ~/agent-skills-lab
```
Xoá thư mục ứng dụng "Việc cần làm" (nếu bạn đã tạo thư mục này bên ngoài):
```
rm -rf ~/todo-app
```

Nếu cần đặt lại Cloud Shell về trạng thái mặc định, bạn có thể tham khảo tài liệu chính thức để biết hướng dẫn về cách thực hiện một cách an toàn.