Cara membuat Keterampilan Agen untuk Gemini CLI

1. Pengantar

Di lab ini, Anda akan mempelajari cara membuat Keterampilan Agen untuk memberi LLM akses ke pengetahuan dan alur kerja khusus. Anda akan membuatnya sebagai kemampuan lokal yang dapat diakses dari Gemini CLI.

Yang akan Anda lakukan

Buat Keterampilan Agen Anda sendiri untuk hal-hal favorit Anda.
Gunakan Gemini CLI untuk membuat kueri ke skill Anda.
Instal Keterampilan Agen resmi untuk Firebase dan gunakan untuk membangun serta men-deploy aplikasi.

Yang akan Anda pelajari

Cara menyusun skill.
Cara menulis file SKILL.md.
Cara menggunakan kemampuan lokal dengan Gemini CLI.

2. Penyiapan Project

Jika belum memiliki Akun Google, Anda harus membuat Akun Google.
- Gunakan akun pribadi, bukan akun kantor atau sekolah. Akun kantor dan sekolah mungkin memiliki batasan yang mencegah Anda mengaktifkan API yang diperlukan untuk lab ini.
Login ke Konsol Google Cloud.
Aktifkan penagihan di Konsol Cloud.
- Menyelesaikan lab ini akan dikenai biaya kurang dari $1 USD untuk resource Cloud.
- Anda dapat mengikuti langkah-langkah di akhir lab ini untuk menghapus resource agar tidak dikenai biaya lebih lanjut.
- Pengguna baru memenuhi syarat untuk mengikuti Uji Coba Gratis senilai$300 USD.
Buat project baru atau pilih untuk menggunakan kembali project yang ada.
- Jika Anda melihat error tentang kuota project, gunakan kembali project yang ada atau hapus project yang ada untuk membuat project baru.

3. Buka Cloud Shell Editor

Klik link ini untuk langsung membuka Cloud Shell Editor
Jika diminta untuk memberikan otorisasi kapan saja hari ini, klik Authorize untuk melanjutkan.
Jika terminal tidak muncul di bagian bawah layar, buka terminal:
- Klik Lihat
- Klik Terminal
Di terminal, tetapkan project Anda dengan perintah ini:
- Format:
```
gcloud config set project [PROJECT_ID]
```
- Contoh:
```
gcloud config set project lab-project-id-example
```
- Jika Anda tidak ingat project ID Anda:
  - Anda dapat mencantumkan semua project ID Anda dengan:
```
gcloud projects list | awk '/PROJECT_ID/{print $2}'
```
Anda akan melihat pesan ini:
```
Updated property [core/project].
```
Jika Anda melihat WARNING dan diminta Do you want to continue (Y/n)?, berarti Anda kemungkinan telah memasukkan ID project dengan salah. Tekan n, tekan Enter, lalu coba jalankan perintah gcloud config set project lagi.

4. Membuat skill "hal favorit" Anda

Keterampilan Agen adalah direktori yang setidaknya berisi file SKILL.md yang memberikan petunjuk dan pengetahuan kepada agen AI. Di bagian ini, Anda akan membuat skill yang mengajarkan Gemini CLI tentang hal-hal favorit Anda.

Buat direktori untuk menyimpan skill Anda:

mkdir -p ~/.gemini/skills/my-favorite-things

Buat dan buka file SKILL.md baru untuk skill Anda:
```
cloudshell edit ~/.gemini/skills/my-favorite-things/SKILL.md
```
Perintah cloudshell edit akan membuka file SKILL.md di editor di atas terminal.

Tambahkan konten berikut ke file 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.

Dengan hanya file SKILL.md, Anda telah membuat skill pertama Anda. Sekarang saatnya menggunakan keterampilan ini di Gemini CLI.

5. Menggunakan skill Anda dari Gemini CLI

Setelah berhasil membuat skill, Anda dapat menggunakannya dengan Gemini CLI. Keterampilan yang ditempatkan di ~/.gemini/skills akan otomatis ditemukan oleh Gemini CLI.

Mulai Gemini CLI di Cloud Shell
```
gemini
```
Anda mungkin perlu menekan Enter untuk menerima beberapa setelan default.
Meminta Gemini mencantumkan keterampilan yang tersedia untuknya sesuai konteksnya
```
/skills
```
Anda akan melihat my-favorite-things dalam daftar kemampuan yang tersedia.
Tanyakan warna favorit Anda kepada Gemini:
```
What is my favorite color?
```
Gemini CLI harus menggunakan kemampuan my-favorite-things untuk menjawab pertanyaan Anda. Jika diminta, izinkan Gemini CLI menggunakan skill tersebut.

Output akan menunjukkan bahwa Gemini CLI menggunakan skill Anda dan membalas dengan "Biru".

Anda berhasil! Anda telah berhasil membuat skill dan mengujinya menggunakan Gemini CLI.

Jika Anda siap mengakhiri sesi, ketik /quit, lalu tekan Enter untuk keluar dari Gemini CLI.

6. Menginstal Agent Skills untuk Firebase

Selain membuat skill Anda sendiri, Anda dapat menginstal skill yang dibuat oleh orang lain. Keterampilan Agen untuk Firebase (GitHub) adalah modul portabel dan mandiri yang berisi pengetahuan, petunjuk, dan alur kerja khusus Firebase. Alat ini dirancang untuk membantu asisten AI memahami praktik terbaik Firebase dan menjalankan tugas yang kompleks dengan akurasi yang lebih tinggi dan biaya token yang lebih rendah.

Anda dapat menginstal semua Keterampilan Agen untuk Firebase dengan skills CLI di terminal Anda:

npx skills add firebase/agent-skills

Perintah ini akan mendownload dan menginstal kemampuan, termasuk firebase-basics, firebase-auth-basics, firebase-firestore-basics, dan firebase-app-hosting-basics, sehingga kemampuan tersebut dapat digunakan di Gemini CLI bersama dengan kemampuan my-favorite-things Anda.

Untuk mempelajari lebih lanjut Keterampilan Agen untuk Firebase, lihat Keterampilan yang tersedia.

7. Mempelajari Keterampilan Agen untuk Firebase

Agent Skills for Firebase kini telah diinstal dan siap digunakan di Gemini CLI. Anda dapat melihatnya dengan menjalankan Gemini CLI dan mengetik /skills firebase:

gemini

Kemudian di Gemini CLI:

/skills firebase

Anda akan melihat daftar skill Firebase yang terinstal, seperti firebase-basics, firebase-auth-basics, firebase-firestore-basics, dan firebase-app-hosting-basics.

8. (Opsional) Menggunakan Agent Skills for Firebase untuk membuat dan men-deploy aplikasi

Sekarang, gunakan Agent Skills for Firebase yang telah diinstal untuk membuat aplikasi web "To Do", dengan autentikasi pengguna dan database, lalu deploy ke Firebase App Hosting.

Jika Anda masih berada di Gemini CLI, ketik /quit untuk keluar.
Buat direktori baru untuk project Anda dan buka direktori tersebut:
```
mkdir todo-app && cd todo-app
```
Login ke Firebase menggunakan akun Google Anda. Jika Anda berada di Cloud Shell atau lingkungan lain tanpa browser, gunakan tanda --no-localhost.
```
firebase login --no-localhost
```
Ikuti petunjuk untuk memberi otorisasi Firebase CLI.
Mulai Gemini CLI:
```
gemini
```

Sekarang, minta Gemini untuk membuat kode aplikasi:

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 dapat meminta untuk membuat file seperti index.html, style.css, dan script.js. Izinkan aplikasi melakukannya.

Terakhir, deploy aplikasi ke Firebase App Hosting:
```
/firebase-app-hosting-basics deploy my web app to Firebase App Hosting.
```
Ikuti perintah apa pun untuk mengonfigurasi App Hosting dan menyelesaikan deployment. Setelah di-deploy, Anda akan menerima URL untuk aplikasi live.

9. Kesimpulan

Selamat! Anda telah berhasil membuat skill dan mempelajari cara menginstal skill tambahan untuk Gemini CLI.

(Opsional) Membersihkan

Jika ingin membersihkan, Anda dapat menghapus project Cloud untuk menghindari biaya tambahan.

Jika Anda ingin, hapus project:

gcloud projects delete $GOOGLE_CLOUD_PROJECT

Anda juga dapat menghapus resource yang tidak diperlukan dari disk cloudshell. Anda dapat:

Hapus direktori skill:

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

Peringatan! Tindakan berikutnya ini tidak dapat diurungkan. Jika ingin menghapus semua yang ada di Cloud Shell untuk mengosongkan ruang penyimpanan, Anda dapat menghapus seluruh direktori beranda Anda. Berhati-hatilah agar semua yang ingin Anda simpan sudah disimpan di tempat lain.
```
sudo rm -rf $HOME
```