Cách tạo Agent Skills cho Gemini CLI

1. Giới thiệu

Trong lớp học này, bạn sẽ tìm hiểu cách tạo Kỹ năng của trợ lý ảo để cung cấp cho LLM quyền truy cập vào kiến thức và quy trình làm việc riêng. Bạn sẽ tạo nó 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 cho Đặc vụ của riêng bạn cho những việc bạn yêu thích.
Sử dụng Gemini CLI để truy vấn kỹ năng của bạn.
Cài đặt các Kỹ năng của trợ lý 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ộ với Gemini 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 và trường học cấp có thể có những hạn chế khiến bạn không bật được các 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 Cloud Console.
- Việc hoàn thành bài thực hành này sẽ tốn ít hơn 1 USD cho các tài nguyên trên đám mâ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í trị giá 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 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 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 sử dụ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 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 "những điều yêu thích"

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 để dạy Gemini CLI về những điều bạn yêu thích.

Tạo một thư mục để lưu trữ kỹ năng của bạn:
```
mkdir -p ~/.gemini/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 ~/.gemini/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: Information about my favorite things. Use this skill to answer questions about my favorite color, food, or programming language.
---

My favorite color is blue.
My favorite food is pizza.
My favorite programming language is 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 Gemini CLI.

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

Giờ đây, bạn có thể dùng kỹ năng đã tạo thành công với Gemini CLI. Gemini CLI sẽ tự động phát hiện các kỹ năng được đặt trong ~/.gemini/skills.

Khởi động Gemini CLI trong Cloud Shell
```
gemini
```
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ê những kỹ năng mà Gemini có thể sử dụng trong bối cảnh của bạn
```
/skills
```
Bạn sẽ thấy my-favorite-things trong danh sách các kỹ năng hiện có.
Hỏi Gemini về màu sắc yêu thích của bạn:
```
What is my favorite color?
```
Gemini 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 Gemini CLI sử dụng kỹ năng này.

Đầu ra phải cho thấy Gemini CLI đã sử dụng kỹ năng của bạn và trả lời bằng "Xanh dương".

Bạn đã hoàn thành! Bạn đã tạo thành công một kỹ năng và thử nghiệm 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 Gemini CLI.

6. Cài đặt Agent Skills cho Firebase

Ngoài việc tạo các 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. Agent Skills for Firebase (GitHub) là các mô-đun độc lập, có thể di chuyển được chứa kiến thức, hướng dẫn và quy trình làm việc dành riêng cho Firebase. Các chỉ dẫn này được thiết kế để giúp trợ lý AI hiểu rõ 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.

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

npx skills add firebase/agent-skills

Lệnh này sẽ tải xuống và cài đặt các kỹ năng, bao gồm firebase-basics, firebase-auth-basics, firebase-firestore-basics và firebase-app-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ề Các kỹ năng của trợ lý ảo cho Firebase, hãy xem phần Các kỹ năng hiện có.

7. Khám phá Các kỹ năng của tác nhân cho Firebase

Các Kỹ năng của tác nhân cho Firebase hiện đã được cài đặt và sẵn sàng sử dụng trong Gemini CLI. Bạn có thể xem các mẫu này bằng cách chạy Gemini CLI và nhập /skills firebase:

gemini

Sau đó, trong Gemini CLI:

/skills firebase

Bạn sẽ thấy danh sách các kỹ năng đã cài đặt của Firebase, chẳng hạn như firebase-basics, firebase-auth-basics, firebase-firestore-basics và firebase-app-hosting-basics.

8. (Không bắt buộc) Sử dụng Agent Skills cho Firebase để tạo và triển khai một ứng dụng

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

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. Nếu bạn đang ở trong Cloud Shell hoặc một môi trường khác không có trình duyệt, hãy sử dụng cờ --no-localhost.
```
firebase login --no-localhost
```
Làm theo hướng dẫn để uỷ quyền cho Giao diện dòng lệnh (CLI) của Firebase.
Bắt đầu Gemini CLI:
```
gemini
```

Bây giờ, hãy yêu cầu Gemini tạo mã ứng dụng:

Generate HTML, CSS, and Javascript for a single page  application. It should use Google Sign-in with Firebase Authentication, and 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.

Gemini có thể yêu cầu tạo các tệp như index.html, style.css và script.js. Cho phép ứng dụng làm như vậy.

Cuối cùng, hãy triển khai ứng dụng lên Firebase App Hosting:
```
/firebase-app-hosting-basics deploy my web app to Firebase App Hosting.
```
Làm theo mọi lời nhắc để định cấu hình Dịch vụ lưu trữ ứng dụng và hoàn tất quá trình triển khai. Sau khi triển khai, bạn sẽ nhận được một URL cho ứng dụng trực tiếp của mình!

9. 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 Cloud để tránh phát sinh thêm chi phí.

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

gcloud projects delete $GOOGLE_CLOUD_PROJECT

Bạn cũng có thể muốn xoá các tài nguyên không cần thiết khỏi đĩa cloudshell. Bạn có thể:

Xoá thư mục kỹ năng:

rm -rf ~/.gemini/skills/my-favorite-things

Cảnh báo! Bạn không thể huỷ thao tác tiếp theo này! Nếu muốn xoá mọi thứ trên Cloud Shell để giải phóng dung lượng, bạn có thể xoá toàn bộ thư mục gốc. Hãy cẩn thận để đảm bảo mọi thứ bạn muốn giữ lại đều được lưu ở nơi khác.
```
sudo rm -rf $HOME
```