Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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ực hành 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 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. Bạn sẽ tạo kỹ năng này dưới dạng 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 của tác nhân riêng cho những thứ 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 đó để xây dựng và triển khai ứng dụng.

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

Cách xây dựng kỹ năng.
Cách viết tệp SKILL.md.
Cách sử dụng kỹ năng cục bộ với Antigravity CLI.

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

Nếu bạn 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 công việc hoặc trường học. Tài khoản công việc và trường học có thể có các hạn chế khiến bạn không thể bật các API cần thiết cho phòng thí nghiệm này.
Đăng nhập vào Google Cloud Console.
Bật tính năng thanh toán trong Cloud Console.
- Việc hoàn thành phòng thí nghiệm này sẽ tốn ít hơn 1 USD tài nguyên Cloud.
- Bạn có thể làm theo các bước ở cuối phòng thí nghiệm 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í trị giá 300 USD.
Tạo dự án mới hoặc chọn sử dụng lại 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 dự án hiện có hoặc xoá 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 Trình chỉnh sửa Cloud Shell
Nếu bạn được nhắc cho phép vào bất kỳ thời điểm nào trong ngày hôm nay, hãy nhấp vào Cho phép để tiếp tục.
Nếu thiết bị đầu cuối không xuất hiện ở cuối màn hình, hãy mở thiết bị đó:
- Nhấp vào Xem
- Nhấp vào Thiết bị đầu cuối
Trong thiết bị đầu cuối, hãy đặt dự án bằng lệnh này:
- Đị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:
  - Bạn có thể liệt kê tất cả mã dự án bằng:
```
gcloud projects list | awk '/PROJECT_ID/{print $2}'
```
Bạn sẽ thấy thông báo này:
```
Updated property [core/project].
```
Nếu bạn thấy WARNING và được hỏi Do you want to continue (Y/n)? (Bạn có muốn tiếp tục không (Có/Không)?), 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

Kỹ năng của tác nhân 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 tác nhân AI. Trong phần này, bạn sẽ tạo một kỹ năng dạy Antigravity CLI về những thứ bạn yêu thích.

Tạo 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 thư mục cho kỹ năng dự án của bạn:

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

Tạo và mở 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 thiết bị đầu cuối.

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 tệp SKILL.md, bạn đã tạo 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, khi bạn đã tạo thành công một kỹ năng, Antigravity CLI sẽ tự động phát hiện kỹ năng đó vì kỹ năng này nằm trong thư mục .agents/skills.

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

Xác thực bằng Antigravity CLI: Bạn phải xác thực trong lần khởi động đầu tiên. 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 thiết bị đầu cuối 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ê các kỹ năng mà kỹ năng này có trong ngữ cảnh của mình
```
/skills
```
Bạn sẽ thấy my-favorite-things trong danh sách các kỹ năng hiện có.
Nhấn ESC để thoát khỏi chế độ xem kỹ năng
Hỏi Antigravity CLI về màu sắc bạn yêu thích:
```
What is my favorite color?
```
Antigravity CLI sẽ 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.

Kết quả 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 sắc 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 khỏi Antigravity CLI.

6. (Không bắt buộc) Xây dựng và triển khai ứng dụng lên Firebase Hosting

Ngoài việc tạo kỹ năng riêng, 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 di động – các mô-đun kiến thức, hướng dẫn và quy trình công việc khép kín 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 kỹ năng này được thiết kế để giúp trợ lý AI hiểu các phương pháp hay nhất của Firebase và thực thi 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 Kỹ năng của tác nhân cho Firebase để tạo ứ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, đồng thờ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 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 CLI:
  - Khi được hỏi Enable Gemini in Firebase features? (Bật Gemini trong các tính năng của Firebase?), hãy nhập Y (cho Có) rồi nhấn Enter.
  - Khi được hỏi Allow Firebase to collect CLI and Emulator Suite usage and error reporting information? (Cho phép Firebase thu thập thông tin về việc sử dụng CLI và Bộ mô phỏng cũng như thông tin báo cáo lỗi?), hãy nhập Y (cho Có) rồi nhấn Enter.
2. Cho phép 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 thẻ trình duyệt mới.
  - Bước 1 trong 3 (Xác nhận lệnh): Nhấp vào Yes, I just ran this command (Có, tôi vừa chạy lệnh này).
  - Bước 2 trong 3 (Xác nhận mã phiên): Đảm bảo Session ID (Mã phiên) khớp với mã hiển thị trong thiết bị đầu cuối của bạn, sau đó nhấp vào Yes, this is my session ID (Có, đây là mã phiên của tôi).
  - Bước 3 trong 3 (Sao chép mã): Nhấp vào Copy (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 thiết bị đầu cuối Cloud Shell rồi dán mã uỷ quyền vào lời 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 (Thành công! Đã đăng nhập với tư cách là `).

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 Kỹ năng của tác nhân cho Firebase trong thư mục đó.

Bạn có thể cài đặt Kỹ năng của tác nhân cho Firebase bằng CLI kỹ năng 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 các kỹ năng cần cài đặt. Sử dụng các phím mũi tên để di chuyển trong danh sách và phím cách để chọn các 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 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 ứ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 Google Cloud hiện tại của bạn:
```
firebase projects:addfirebase ${GOOGLE_CLOUD_PROJECT}
```
Khởi động Antigravity CLI:
```
agy
```
Yêu cầu Antigravity CLI tạo 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 thực hiện việc này. Bạn có thể cần nhập "approve" (phê duyệt) rồi nhấn Enter.Antigravity CLI sẽ sử dụng Kỹ năng của tác nhân 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.

Khi quá trình triển khai hoàn tất, hệ thống sẽ cung cấp URL cho ứng dụng web của bạn. Sử dụng ctrl+click (Windows/Linux) hoặc cmd+click (Mac) để mở đường liên kết trong thiết bị đầu cuối của Trình chỉnh sửa Cloud Shell. Truy cập vào URL của ứng dụng đã triển khai!

Thêm tính năng Xác thực Firebase

Khởi động Antigravity CLI nếu chưa khởi động:
```
agy
```
Antigravity CLI có thể hỏi các 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.
Giờ đây, 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 thực hiện việc nà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 thử, nhưng bạn có thể phải hoàn tất các bước theo cách thủ công (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 các 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 thực hiện việc nà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. (ẩn biểu mẫu việc cần làm khi người dùng đăng xuất. Cập nhật các quy tắc bảo mật để người dùng có thể xem các việc cần làm của họ).

Hãy tiếp tục thử nghiệm với phòng thí nghiệm để thêm các tính năng mà 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 bạn cần đặt lại Cloud Shell về trạng thái mặc định, bạn có thể làm theo tài liệu chính thức để biết hướng dẫn về cách thực hiện việc này một cách an toàn.