Cara menggunakan Keahlian Agen AI (dengan Gemini CLI dan Keahlian Agen untuk Firebase)

1. Pengantar

Foto sampul lab Agent Skills

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 Keahlian 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 kustom Anda

Keterampilan Agen adalah direktori yang berisi minimal 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 lab ini dan buka direktori tersebut:
```
mkdir ~/agent-skills-lab && cd ~/agent-skills-lab
```

Buat direktori untuk skill project Anda:

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

Buat dan buka file SKILL.md baru untuk skill Anda:
```
cloudshell edit ~/agent-skills-lab/.agents/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: 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.

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 Anda berhasil membuat skill, skill tersebut sudah dapat ditemukan oleh Gemini CLI karena berada di direktori .agents/skills.

Mulai Gemini CLI:
```
gemini
```
Anda akan melihat Gemini CLI mengenali skill baru. 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 kemampuan Anda dan membalas dengan sesuatu seperti "Biru" atau "Warna favorit saya adalah 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. (Opsional) Bangun dan deploy aplikasi ke Firebase Hosting

Selain membuat skill Anda sendiri, Anda dapat menginstal skill yang dibuat oleh orang lain. Hal ini menunjukkan penggunaan keterampilan portabel—modul pengetahuan, petunjuk, dan alur kerja yang berdiri sendiri yang dapat dengan mudah dibagikan dan digunakan kembali.

Keahlian Agen untuk Firebase adalah contoh yang bagus dari modul portabel ini. Modul ini dirancang untuk membantu asisten AI memahami praktik terbaik Firebase dan menjalankan tugas kompleks dengan akurasi yang lebih tinggi dan biaya token yang lebih rendah.

Sekarang, gunakan Keahlian Agen untuk Firebase guna membuat aplikasi web "To Do", dengan autentikasi pengguna dan database, lalu deploy ke Firebase Hosting.

Menyiapkan project

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. Gunakan tanda --no-localhost karena Anda berada di Cloud Shell:
```
firebase login --no-localhost
```
1. Berinteraksi dengan perintah CLI:
  - Saat ditanya Enable Gemini in Firebase features?, ketik Y (untuk Ya), lalu tekan Enter.
  - Saat ditanya Allow Firebase to collect CLI and Emulator Suite usage and error reporting information?, ketik Y (untuk Ya), lalu tekan Enter.
2. Memberikan otorisasi di browser:
  - Anda akan melihat URL di terminal. Klik link untuk membuka halaman login di tab browser baru.
  - Langkah 1 dari 3 (Konfirmasi perintah): Klik Yes, I just ran this command.
  - Langkah 2 dari 3 (Konfirmasi ID sesi): Pastikan ID Sesi cocok dengan yang ditampilkan di terminal Anda, lalu klik Ya, ini adalah ID sesi saya.
  - Langkah 3 dari 3 (Salin kode): Klik Salin untuk menyalin kode otorisasi ke papan klip Anda.
3. Selesaikan login:
  - Kembali ke terminal Cloud Shell dan tempel kode otorisasi di prompt ? Enter authorization code:.
  - Tekan Enter.
Anda akan melihat pesan berhasil: ✔ Success! Logged in as .

Menginstal Keahlian Agen untuk Firebase

Setelah membuat direktori project, Anda harus menginstal Keahlian Agen untuk Firebase di dalamnya.

Anda dapat menginstal Agent Skills for Firebase dengan skills CLI di terminal:

npx skills add firebase/agent-skills

Selama penginstalan, Anda akan diminta untuk memilih keterampilan yang akan diinstal. Gunakan tombol panah untuk menavigasi daftar dan tombol spasi untuk memilih keterampilan ini.

firebase-basics
firebase-hosting-basics
firebase-auth-basics
firebase-firestore-enterprise-native-mode

Memilih empat keahlian Firebase

Untuk perintah berikutnya, Anda dapat menerima setelan default dengan aman dengan menekan Enter.

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

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

Membuat dan men-deploy aplikasi web dasar

Aktifkan API yang diperlukan untuk project Anda:

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

Aktifkan Firebase di project Google Cloud Anda saat ini:

firebase projects:addfirebase ${GOOGLE_CLOUD_PROJECT}

Mulai Gemini CLI:
```
gemini
```
Minta Gemini membuat index.html dasar:
```
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 akan meminta untuk membuat index.html dan menjalankan firebase. Tekan Enter untuk mengizinkannya melakukannya.Gemini CLI harus menggunakan Agent Skills for Firebase untuk membuat dan men-deploy situs Anda. Pandu agen bersama dengan persetujuan sesuai kebutuhan.

Setelah selesai di-deploy, aplikasi web Anda akan menyediakan URL. Gunakan ctrl+click (Windows) atau cmc+click (Mac) untuk membuka link di terminal Cloud Shell Editor. Buka URL untuk aplikasi yang di-deploy.

Tambahkan Firebase Authentication

Mulai Gemini CLI jika belum dimulai:
```
gemini
```
Gemini dapat mengajukan pertanyaan seperti "Apakah Anda memercayai folder ini?" Tekan Enter untuk menerima setelan default.
Sekarang, minta Gemini menambahkan Login dengan 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 dapat meminta untuk membuat atau memperbarui file seperti index.html, style.css, dan script.js. Izinkan Gemini melakukannya. Gemini dapat meminta Anda melakukan beberapa tindakan di Firebase console. CLI dapat melakukan sebagian besar langkah ini jika Anda memintanya untuk mencoba, tetapi menyelesaikan langkah-langkah secara manual (seperti mengaktifkan Google OAuth) mungkin diperlukan jika instance Cloud Shell Anda menginstal Firebase CLI versi lama.

Untuk melihat perubahan terbaru Anda, Anda mungkin perlu melakukan "Pemuatan Ulang Paksa" dengan ctrl+shift+R (Windows) atau cmd+shift+R (Mac).

Menambahkan Cloud Firestore

Mulai Gemini CLI jika belum dimulai:
```
gemini
```
Gemini dapat mengajukan pertanyaan seperti "Apakah Anda memercayai folder ini?" Tekan Enter untuk menerima setelan default.

Minta Gemini menambahkan Firestore untuk menyimpan tugas:

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 akan memperbarui file. Izinkan aplikasi melakukannya.

Untuk melihat perubahan terbaru Anda, Anda mungkin perlu melakukan "Pemuatan Ulang Paksa" dengan ctrl+shift+R (Windows) atau cmd+shift+R (Mac).

Jika aplikasi Anda tidak berfungsi seperti yang diharapkan, terus gunakan Gemini CLI untuk mendapatkan fungsi yang Anda harapkan. Contoh: shell Hide the task form when the user is logged out. Update the security rules so the user can see their TODOs.

Terus bereksperimen dengan lab untuk menambahkan fitur yang ingin Anda lihat di aplikasi Firebase baru Anda.

7. 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 Cloud Shell untuk mengosongkan ruang.

Hapus direktori lab (tindakan ini akan menghapus keahlian dan aplikasi):
```
rm -rf ~/agent-skills-lab
```
Hapus direktori aplikasi "To Do" (jika Anda membuatnya di luar):
```
rm -rf ~/todo-app
```

Jika Anda perlu mereset Cloud Shell ke status defaultnya, Anda dapat mengikuti dokumentasi resmi untuk mengetahui petunjuk cara melakukannya dengan aman.