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

1. Giới thiệu

Ảnh bìa của phòng thực hành Kỹ năng của nhân viên hỗ trợ

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 mô hình ngôn ngữ lớn (LLM) 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 kỹ năng này dưới dạng một kỹ năng cục bộ có thể truy cập từ Gemini CLI.

Bạn sẽ thực hiện

Tạo Kỹ năng của tác nhân cho riêng bạn đối với những điều bạn yêu thích.
Sử dụng Gemini 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 để xây dựng 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ộ với Gemini CLI.

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

Nếu chưa có, 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 sẽ đủ điều kiện nhận khoản tín dụng dùng thử miễn phí trị giá 300 USD.
Tạo một 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 một 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 uỷ quyền vào bất kỳ thời điểm nào trong ngày hôm nay, hãy nhấp vào Uỷ quyền để 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ị đầu cuối:
- 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 sau:
```
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 một tác nhân AI. Trong phần này, bạn sẽ tạo một kỹ năng dạy Gemini CLI 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 dự án của bạ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 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 một 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 Gemini CLI.

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

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

Bắt đầu Gemini CLI:
```
gemini
```
Bạn sẽ thấy Gemini CLI nhận ra kỹ năng mới. Bạn có thể cần nhấn Enter để chấp nhận một số chế độ cài đặt mặc định.

Yêu cầu Gemini liệt kê các kỹ năng mà Gemini 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 có sẵn.
Hỏi Gemini về màu bạn yêu thích:
```
What is my favorite color?
```
Gemini 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 Gemini CLI sử dụng kỹ năng này.

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

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

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

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

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 di động – các mô-đun kiến thức, hướng dẫn và quy trình công 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 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 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 Kỹ năng của tác nhân 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, đồ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 Gemini CLI, hãy nhập /quit để 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 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. 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 để mở trang đăng nhập trong một 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ập mã uỷ quyền?).
  - 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-basics
firebase-hosting-basics
firebase-auth-basics
firebase-firestore-enterprise-native-mode

Chọn 4 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 Gemini 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 có sẵn.

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 trên đám mây của Google hiện tại:
```
firebase projects:addfirebase ${GOOGLE_CLOUD_PROJECT}
```
Bắt đầu Gemini CLI:
```
gemini
```
Yêu cầu Gemini 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.
```
Gemini sẽ yêu cầu tạo index.html và thực thi firebase. Nhấn Enter để cho phép Gemini thực hiện việc này.Gemini 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 phê duyệt nếu cần.

Khi triển khai xong, tác nhân sẽ cung cấp một URL cho ứng dụng web của bạn. Sử dụng ctrl+click (Windows) hoặc cmc+click (Mac) để mở các đường liên kết trong thiết bị đầu cuối 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

Bắt đầu Gemini CLI nếu chưa bắt đầu:
```
gemini
```
Gemini 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.
Giờ đây, hãy yêu cầu Gemini 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 the user.
```
Gemini 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 Gemini thực hiện việc này. Gemini 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 CLI 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.

Để thấy các thay đổi mới nhất xuất hiện, 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) hoặc cmd+shift+R (Mac).

Thêm Cloud Firestore

Bắt đầu Gemini CLI nếu chưa bắt đầu:
```
gemini
```
Gemini 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 Gemini thêm Firestore để lưu các tác vụ:

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 the user.

Gemini sẽ cập nhật các tệp. Cho phép Gemini thực hiện việc này.

Nếu ứng dụng của bạn không hoạt động như dự kiến, hãy tiếp tục làm việc với Gemini 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 tác vụ khi người dùng đăng xuất. Cập nhật 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 Gemini 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 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ể 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.