Menyiapkan Gemini di Firebase dalam ruang kerja

Firebase Studio memfasilitasi alur kerja pengembangan Anda dengan fitur kode bantuan AI berikut:

• Saran penyelesaian kode saat Anda mengetik.

• Bantuan AI dengan chat, yang memiliki pemahaman tentang ruang kerja dan terintegrasi sepenuhnya dengan kode Anda. Model ini dapat menghasilkan, menerjemahkan, dan menjelaskan kode. Selain itu, dengan peninjauan dan persetujuan Anda, Gemini di Firebase dapat berinteraksi langsung dengan ruang kerja Anda untuk mengupdate file, menjalankan perintah terminal, menafsirkan output perintah, dan menentukan langkah berikutnya. Pelajari lebih lanjut di Coba chat dengan Gemini.

• Tindakan langsung yang dapat Anda lakukan pada bagian kode yang dipilih. Misalnya, Anda dapat meminta Gemini untuk membuat kode yang dipilih lebih mudah dibaca.

• Bantuan kode inline.

Anda dapat menyesuaikan cara Gemini di Firebase membantu Anda dengan menyesuaikan setelannya dan menambahkan file aturan AI:

• Menyesuaikan setelan penyelesaian kode.
• Menyesuaikan setelan pengindeksan codebase.
• Menyesuaikan petunjuk untuk Gemini dengan file aturan AI.
• Kecualikan file dari Gemini dengan file .aiexclude.
• Bawa kunci Anda sendiri: Menggunakan model Gemini lain dalam chat

Menggunakan Gemini di Firebase di ruang kerja Anda

Gunakan Gemini di Firebase untuk meningkatkan produktivitas coding Anda melalui bantuan panel chat atau kode inline.

1. Gunakan bantuan chat atau kode inline di workspace Anda:

   • Untuk menggunakan chat: Di ruang kerja yang terbuka, klik spark Gemini di bagian bawah ruang kerja.

   • Untuk menggunakan bantuan kode inline: Mulai ketik kode Anda, lalu tekan Tab untuk menerima saran.

2. Perhatikan bahwa dua opsi berikut diaktifkan secara default:

   • Saran saat Anda mengetik, yang memberikan penyelesaian kode inline.
   • Pengindeksan codebase, yang memberikan penyesuaian yang lebih baik dan respons yang lebih berguna.

   Untuk mengubah pilihan ini untuk setelan ruang kerja Anda di masa mendatang:

   • Untuk memperbarui setelan penyelesaian kode, lihat Menyesuaikan setelan penyelesaian kode.
   • Untuk memperbarui setelan pengindeksan kode, lihat artikel Menyesuaikan setelan pengindeksan kode.

   Anda juga dapat mengecualikan file dan direktori tertentu dari pengindeksan AI. Lihat Mengecualikan file dari Gemini dengan file .aiexclude.

Gemini di pintasan Firebase

Untuk membuka chat dengan Gemini dengan cepat: tekan Ctrl+Shift+Space (atau Cmd+Shift+Space di MacOS).

Untuk melihat perintah Gemini dari palet perintah:

1. Buka palet perintah dengan menekan Ctrl+Shift+P (atau Cmd+Shift+P di MacOS).

2. Telusuri Gemini.

   Daftar perintah Gemini akan muncul.

Menyesuaikan setelan penyelesaian kode

Untuk membantu Anda menulis kode, Firebase Studio menyediakan penyelesaian kode AI yang memprediksi dan mengisi otomatis kode dalam file terbuka segera setelah Anda mulai mengetik.

Perhatikan bahwa pelengkapan kode diaktifkan secara default.

Untuk mengaktifkan atau menonaktifkan penyelesaian kode, sesuaikan setelan penyelesaian kode menggunakan salah satu metode berikut:

• Jika Anda menggunakan file settings.json, tetapkan "IDX.aI.enableInlineCompletion" ke true atau false.

• Untuk memperbarui setelan di ruang kerja Firebase Studio:

  1. Klik Kelola (terletak di kiri bawah ruang kerja), lalu pilih Setelan, atau tekan Ctrl+, (Cmd+, di Mac).

     Jika Anda menggunakan App Prototyping agent di Prototyper view, click Switch to Code to open Code view.

  2. Pilih tab Workspace, lalu telusuri setelan Firebase Studio > AI > Enable Inline Completion.

  3. Untuk menonaktifkan pelengkapan kode, batalkan pilihan opsi Aktifkan pelengkapan kode inline saat Anda mengetik.

Menyesuaikan setelan pengindeksan codebase

Anda dapat mengontrol apakah Gemini mengindeks kode Anda atau tidak. Mengindeks kode Anda akan memberikan hasil yang lebih bermanfaat saat menggunakan chat atau bantuan AI inline.

Perhatikan bahwa pengindeksan codebase diaktifkan secara default.

Untuk mengaktifkan atau menonaktifkan pengindeksan kode, sesuaikan setelan pengindeksan codebase menggunakan salah satu metode berikut:

• Jika Anda menggunakan file settings.json, tetapkan "IDX.aI.enableCodebaseIndexing" ke true atau false.

• Untuk memperbarui setelan di ruang kerja Firebase Studio:

  1. Klik Kelola (terletak di kiri bawah ruang kerja), lalu pilih Setelan, atau tekan Ctrl+, (Cmd+, di Mac).

     Jika Anda menggunakan App Prototyping agent di Prototyper view, click Switch to Code to open Code view.

  2. Pilih tab Workspace, lalu telusuri setelan Firebase Studio > AI > Enable Inline Completion.

  3. Pilih Firebase Studio > AI: Enable Codebase Indexing.

  4. Untuk menonaktifkan pengindeksan kode, batalkan pilihan AI: Enable Codebase Indexing. Anda harus memperbarui setelan pengindeksan kode untuk setiap ruang kerja.

Menyesuaikan petunjuk untuk Gemini di Firebase dengan file aturan AI

Anda dapat menambahkan informasi konteks dan perintah sistem dengan membuat file aturan AI (.idx/airules.md). Gemini di Firebase menggunakan aturan Anda sebagai petunjuk dan konteks sistem, memastikan bahwa responsnya disesuaikan untuk kasus penggunaan Anda.

Gunakan file aturan AI untuk membagikan perintah kustom, praktik terbaik, dan bahkan konteks penting tentang project Anda dengan Gemini untuk mencapai sasaran seperti:

• Memengaruhi persona Gemini dan mengkhususkan keahliannya.
• Menerapkan standar lingkup project, seperti gaya coding, konvensi, dan preferensi teknologi.
• Mengurangi jumlah informasi yang perlu Anda bagikan secara eksplisit dalam kode atau chat dengan memberikan konteks penting tentang project Anda.

Aturan yang Anda konfigurasi digunakan oleh Gemini di chat.

Membuat dan menguji file aturan AI

Untuk membuat dan menguji file aturan AI:

1. Buat file baru di .idx/airules.md di ruang kerja Firebase Studio (di direktori yang sama dengan file dev.nix Anda). Anda dapat menggunakan salah satu opsi berikut:

   • Dari Explorer (Ctrl+Shift+E), klik kanan .idx, lalu pilih File baru. Beri nama file airules.md, lalu tekan Enter.
   • Dari terminal, gunakan editor teks pilihan Anda untuk membuka .idx/airules.md.

2. Tambahkan konten ke file. Anda dapat menambahkan informasi tentang persona yang harus digunakan Gemini (seperti "Anda adalah developer ahli dan asisten yang membantu yang mengetahui segala hal tentang Next.js"), standar coding dan percakapan, serta konteks tentang project. Lihat Contoh berikut untuk contoh file aturan AI.

3. Simpan file dan buka Gemini di Firebase.

4. Untuk mulai menggunakan aturan AI, Anda dapat melakukan salah satu tindakan berikut:

   • Buat ulang ruang kerja dengan memuat ulang halaman. Setelah Anda mem-build ulang, Gemini di Firebase akan menggunakan file aturan dalam chat. Perubahan pada file aturan AI akan segera diterapkan di chat.
   • Jika tidak ingin membuat ulang ruang kerja, Anda dapat meminta Gemini menggunakan chat kepada load airules.md. Jika Anda membuat perubahan pada file selama sesi saat ini, Anda mungkin perlu meminta ulang Gemini untuk memuat file aturan lagi.

5. Mengajukan pertanyaan tentang kode Anda. Gemini merespons menggunakan informasi yang Anda sertakan dalam file aturan sebagai konteks.

Contoh

Berikut adalah contoh dasar file aturan yang dapat Anda gunakan untuk game kasual yang dikembangkan dengan Next.js:

# Persona

You are an expert developer proficient in both front- and back-end development
with a deep understanding of Node.js, Next.js, React, and Tailwind CSS. You
create clear, concise, documented, and readable TypeScript code.

You are very experienced with Google Cloud and Firebase services and how
you might integrate them effectively.

# Coding-specific guidelines

- Prefer TypeScript and its conventions.
- Ensure code is accessible (for example, alt tags in HTML).
- You are an excellent troubleshooter. When analyzing errors, consider them
  thoroughly and in context of the code they affect.
- Do not add boilerplate or placeholder code. If valid code requires more
  information from the user, ask for it before proceeding.
- After adding dependencies, run `npm i` to install them.
- Enforce browser compatibility. Do not use frameworks/code that are not
  supported by the following browsers: Chrome, Safari, Firefox.
- When creating user documentation (README files, user guides), adhere to the
  Google developer documentation style guide
  (https://developers.google.com/style).

# Overall guidelines

- Assume that the user is a junior developer.
- Always think through problems step-by-step.

# Project context

- This product is a web-based strategy game with a marine life theme.
- Intended audience: casual game players between the ages of 17 and 100.

Mengecualikan file dari Gemini dengan file .aiexclude

Anda dapat mengontrol file mana di codebase yang harus disembunyikan dari Gemini dengan menyertakan file .aiexclude dalam project Anda. Hal ini memungkinkan Anda mengontrol konteks project yang Anda bagikan dengan Gemini secara terperinci.

Sama seperti file .gitignore, file .aiexclude melacak file yang tidak boleh dibagikan dengan Gemini, termasuk pengalaman chat serta fitur AI yang beroperasi di editor. File .aiexclude beroperasi pada file di atau di bawah direktori yang berisinya.

File yang tercakup dalam .aiexclude tidak akan diindeks oleh Gemini saat Pengindeksan Codebase diaktifkan. Selain itu, .aiexclude akan memengaruhi bantuan inline untuk file yang tercakup dengan cara berikut:

• Bantuan chat: Gemini tidak akan dapat menjawab pertanyaan atau menawarkan saran tentang file yang tercakup dalam .aiexclude.
• Penyelesaian kode: Penyelesaian kode yang disarankan tidak akan tersedia saat mengedit file yang tercakup.
• Bantuan inline: Anda dapat membuat kode baru, tetapi tidak dapat mengubah kode yang ada saat mengedit file yang tercakup.

Lingkungan pengembangan lainnya seperti Android Studio juga dapat menghormati file .aiexclude.

Cara menulis file .aiexclude

File .aiexclude mengikuti sintaksis yang sama dengan file .gitignore, dengan perbedaan berikut:

• File .aiexclude kosong memblokir semua file dalam direktorinya dan semua subdirektori. Ini sama dengan file yang berisi **/*.
• File .aiexclude tidak mendukung negasi (awalan pola dengan !).

Contoh

Berikut adalah beberapa contoh konfigurasi file .aiexclude:

• Blokir semua file bernama apikeys.txt di atau di bawah direktori yang berisi file .aiexclude:

  apikeys.txt
  

• Blokir semua file dengan ekstensi file .key di atau di bawah direktori yang berisi file .aiexclude:

  *.key
  

• Hanya blokir file apikeys.txt di direktori yang sama dengan .aiexclude, tetapi tidak di subdirektori mana pun:

  /apikeys.txt
  

• Blokir semua file di direktori my/sensitive/dir dan semua subdirektorinya. Jalur harus bersifat relatif terhadap direktori yang berisi file .aiexclude:

  my/sensitive/dir/
  

Membawa kunci Anda sendiri: Menggunakan model Gemini lain dalam chat

Anda dapat mengonfigurasi model Gemini yang digunakan Gemini dalam chat Firebase. Anda dapat memilih model bawaan, model yang dikonfigurasi di jendela chat (termasuk model Gemini 2.5), atau model Gemini apa pun yang dapat Anda akses.

Untuk mengetahui daftar semua model yang tersedia, lihat model Gemini.

Untuk mengonfigurasi kunci dan memilih model Gemini yang berbeda:

1. Di ruang kerja yang terbuka, klik spark Gemini di bagian bawah ruang kerja (atau tab Gemini).

2. Di jendela chat Gemini di Firebase, klik drop-down nama model, lalu klik link kunci Gemini API. Setelan Pengguna akan muncul.

3. Di kolom IDX > AI: Gemini Api Key, masukkan kunci Gemini API Anda.

Anda kini dapat memilih salah satu model Gemini yang telah dikonfigurasi sebelumnya di chat.

Untuk mengonfigurasi model Gemini yang tidak ada di menu drop-down:

1. Identifikasi model Gemini yang ingin Anda gunakan dalam chat dari daftar di model Gemini. Misalnya, Anda akan memasukkan gemini-2.0-flash-lite untuk menggunakan model Gemini 2.0 Flash‑Lite stabil terbaru.

2. Dari Gemini di jendela chat Firebase, klik pemilih model, lalu pilih ID model kustom. Setelan Pengguna akan terbuka.

3. Salin nama model yang Anda pilih ke kolom IDX > AI: Gemini Model.

4. Tutup jendela chat, lalu buka kembali dengan mengklik spark Gemini di bagian bawah ruang kerja untuk memuat ulang daftar model.

Langkah berikutnya

• Coba Gemini di Firebase.