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

1. Pengantar

Di lab ini, Anda akan mempelajari cara membuat Keahlian Agen untuk memberi agen AI akses ke pengetahuan dan alur kerja khusus. Anda akan membuatnya sebagai skill lokal yang dapat diakses dari Antigravity CLI.

Yang akan Anda lakukan

• Buat Keterampilan Agen Anda sendiri untuk hal-hal favorit Anda.
• Gunakan Antigravity CLI untuk mengkueri 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 keahlian lokal dengan Antigravity CLI.

2. Penyiapan Project

1. Jika Anda 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.
2. Login ke Konsol Google Cloud.
3. 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.
4. Buat project baru atau pilih untuk menggunakan kembali project yang sudah 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

1. Klik link ini untuk langsung membuka Cloud Shell Editor
2. Jika diminta untuk memberikan otorisasi kapan saja hari ini, klik Authorize untuk melanjutkan.
3. Jika terminal tidak muncul di bagian bawah layar, buka terminal:
   • Klik Lihat.
   • Klik Terminal
4. 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 ID project Anda dengan:

       gcloud projects list | awk '/PROJECT_ID/{print $2}'
       

     
5. 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 kembali perintah gcloud config set project.

4. Membuat keahlian 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 Antigravity CLI tentang hal-hal favorit Anda.

1. Buat direktori untuk lab ini dan buka direktori tersebut:

   mkdir ~/agent-skills-lab && cd ~/agent-skills-lab
   

2. Buat direktori untuk skill project Anda:

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

3. 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.
4. 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 Antigravity CLI.

5. Menggunakan skill Anda dari Antigravity CLI

Setelah berhasil membuat skill, skill tersebut sudah dapat ditemukan oleh Antigravity CLI karena berada di direktori .agents/skills.

1. Mulai Antigravity CLI:

   agy
   

Catatan: Antigravity CLI sudah terinstal di Cloud Shell.

1. Lakukan autentikasi dengan Antigravity CLI: Selama startup awal, autentikasi diperlukan. Pilih OAuth (dengan menekan Enter).
2. Klik link (jika tidak dapat diklik, tandai URL di Cloud Shell untuk menyalinnya, lalu tempelkan ke browser Anda)
3. Login ke Akun Google Anda
4. Salin kodenya
5. Tempel kode ke terminal Cloud Shell Editor
6. Tekan Enter.
7. Tekan Enter untuk menerima beberapa setelan default.
8. Meminta Antigravity CLI mencantumkan keterampilan yang tersedia untuknya dalam konteksnya

   /skills
   

   Anda akan melihat my-favorite-things dalam daftar kemampuan yang tersedia.
9. Tekan ESC untuk keluar dari tampilan keterampilan
10. Tanyakan warna favorit Anda kepada Antigravity CLI:

    What is my favorite color?
    

    Antigravity CLI harus menggunakan keterampilan my-favorite-things untuk menjawab pertanyaan Anda. Jika diminta, izinkan Antigravity CLI menggunakan skill.

Output akan menunjukkan bahwa Antigravity 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 Antigravity CLI.

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

6. (Opsional) Bangun dan deploy aplikasi ke Firebase Hosting

Selain membuat keahlian Anda sendiri, Anda dapat menginstal keahlian yang dibuat oleh orang lain. Hal ini menunjukkan penggunaan keterampilan portabel—modul pengetahuan, petunjuk, dan alur kerja mandiri 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

1. Jika Anda masih berada di Antigravity CLI, ketik /exit untuk keluar.
2. Buat direktori baru untuk project Anda, lalu buka direktori tersebut:

   mkdir ~/todo-app && cd ~/todo-app
   

3. Login ke Firebase menggunakan Akun Google Anda. Gunakan flag --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 (jika tidak dapat diklik, tandai URL di Cloud Shell untuk menyalinnya, lalu tempelkan ke browser Anda) 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 .

Tips: Saat menempelkan kode otorisasi ke Cloud Shell, perhatikan dialog Chrome yang meminta izin akses papan klip dan pastikan izin tersebut diaktifkan. Anda dapat menggunakan Ctrl+Shift+V (Windows) atau CMD+Shift+V (Mac) untuk menempelkan kode ke terminal.

Menginstal Keahlian Agen untuk Firebase

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

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

npx skills add firebase/agent-skills

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

• firebase-auth-basics
• firebase-basics
• firebase-firestore
• firebase-hosting-basics
• firebase-security-rules-auditor

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

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

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

Membuat dan men-deploy aplikasi web dasar

1. Aktifkan API yang diperlukan untuk project Anda:

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

2. Aktifkan Firebase di project Google Cloud Anda saat ini:

   firebase projects:addfirebase ${GOOGLE_CLOUD_PROJECT}
   

3. Mulai Antigravity CLI:

   agy
   

4. Minta Antigravity CLI untuk 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.
   

   Antigravity CLI akan meminta izin saat membuat dan men-deploy aplikasi. Tekan Enter untuk mengizinkannya melakukannya. Anda mungkin perlu mengetik "approve" dan menekan Enter.Antigravity CLI akan menggunakan Agent Skills for Firebase untuk membuat dan men-deploy situs Anda. Pandu agen beserta persetujuan sesuai kebutuhan.

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

Menambahkan Firebase Authentication

1. Mulai Antigravity CLI jika belum dimulai:

   agy
   

   Antigravity CLI dapat mengajukan pertanyaan seperti "Apakah Anda memercayai folder ini?" Tekan Enter untuk menerima setelan default.
2. Sekarang, minta Antigravity CLI untuk 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 me.
   

   Antigravity CLI dapat meminta untuk membuat atau memperbarui file seperti index.html, style.css, dan script.js. Izinkan Antigravity CLI melakukannya. Antigravity CLI dapat meminta Anda melakukan beberapa tindakan di Firebase console. CLI dapat melakukan sebagian besar langkah ini jika Anda memintanya untuk mencoba, tetapi penyelesaian langkah-langkah secara manual (seperti mengaktifkan Google OAuth) mungkin diperlukan jika instance Cloud Shell Anda menginstal Firebase CLI versi lama.

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

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

Menambahkan Cloud Firestore

1. Mulai Antigravity CLI jika belum dimulai:

   agy
   

   Antigravity CLI dapat mengajukan pertanyaan seperti "Apakah Anda memercayai folder ini?" Tekan Enter untuk menerima setelan default.
2. Minta Antigravity CLI untuk menambahkan Firestore guna 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 to me.
   

   Antigravity CLI akan memperbarui file. Izinkan aplikasi melakukannya.

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

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

Jika aplikasi Anda tidak berfungsi seperti yang diharapkan, terus gunakan Antigravity 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 keterampilan dan mempelajari cara menginstal keterampilan tambahan untuk Antigravity 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.

1. Hapus direktori lab (tindakan ini akan menghapus keahlian dan aplikasi):

   rm -rf ~/agent-skills-lab
   

2. 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.