Menyesuaikan perilaku Gemini Code Assist di GitHub

Anda dapat mengubah perilaku Gemini Code Assist di GitHub untuk setiap repositori dengan menambahkan file config.yaml ke folder .gemini/ yang berada di root repositori. File config.yaml berisi berbagai fitur yang dapat dikonfigurasi yang dapat Anda aktifkan atau nonaktifkan. Anda dapat melakukan konfigurasi grup di beberapa repositori untuk sebagian perilaku Gemini Code Assist di GitHub.

Gemini Code Assist juga mendukung penambahan file styleguide.md ke folder .gemini/, yang memberikan petunjuk kepada Gemini Code Assist dengan beberapa aturan khusus yang Anda inginkan saat melakukan peninjauan kode. Untuk mengetahui informasi selengkapnya tentang panduan gaya untuk Gemini Code Assist, lihat Panduan gaya peninjauan kode.

Kolom konfigurasi

Bagian ini menjelaskan pertimbangan untuk kolom tertentu yang dapat disesuaikan di Gemini Code Assist di GitHub. Untuk mengetahui daftar lengkap kolom, lihat skema config.yaml.

• code_review: comment_severity_threshold: Kolom ini menetapkan tingkat keparahan minimum yang akan dikomentari oleh Gemini Code Assist. Misalnya, jika Anda telah menetapkan code_review: comment_severity_threshold: HIGH, Gemini Code Assist tidak akan memberikan komentar permintaan pull untuk masalah yang dianggap memiliki tingkat keparahan LOW atau MEDIUM, seperti refaktorisasi kecil. Gemini Code Assist menentukan tingkat keparahan komentar berdasarkan jenis dan signifikansi masalah yang sedang dipertimbangkan, dengan pelanggaran terhadap panduan gaya kustom Anda biasanya memenuhi atau melampaui batas tingkat keparahan.

• ignore_patterns: Kolom ini menggunakan pola glob. Saat berinteraksi dengan repositori, Gemini Code Assist mengabaikan file yang cocok dengan pola apa pun dalam daftar ini.

• memory_config: Kolom ini berlaku jika sebelumnya Anda mengaktifkan kualitas respons yang lebih baik untuk beberapa repositori. Jika Anda mengaktifkan kualitas respons yang lebih baik untuk beberapa repositori, Anda dapat menetapkan memory_config: disabled: true untuk repositori tertentu dalam pengelompokan, yang akan menonaktifkan fitur untuk repositori tersebut.

Skema config.yaml

Cuplikan kode berikut adalah skema untuk file config.yaml. File ini menentukan semua opsi konfigurasi yang memungkinkan dan nilai yang diterima:

$schema: "http://json-schema.org/draft-07/schema#"
title: RepoConfig
description: Configuration for Gemini Code Assist on a repository. All fields are optional and have default values.
type: object
properties:
  have_fun:
    type: boolean
    description: Enables fun features such as a poem in the initial pull request summary. Default: false.
  ignore_patterns:
    type: array
    items:
      type: string
    description: A list of glob patterns for files and directories that Gemini Code Assist should ignore. Default: [].
  memory_config:
    type: object
    description: Configuration for persistent memory, which is used to improve responses.
    properties:
      disabled:
        type: boolean
        description: Whether to disable persistent memory for this specific repository. Default: false.
  code_review:
    type: object
    description: Configuration for code reviews. All fields are optional and have default values.
    properties:
      disable:
        type: boolean
        description: Disables Gemini from acting on pull requests. Default: false.
      comment_severity_threshold:
        type: string
        enum:
          - LOW
          - MEDIUM
          - HIGH
          - CRITICAL
        description: The minimum severity of review comments to consider. Default: MEDIUM.
      max_review_comments:
        type: integer
        format: int64
        description: The maximum number of review comments to consider. Use -1 for unlimited. Default: -1.
      pull_request_opened:
        type: object
        description: Configuration for pull request opened events. All fields are optional and have default values.
        properties:
          help:
            type: boolean
            description: Posts a help message on pull request open. Default: false.
          summary:
            type: boolean
            description: Posts a pull request summary on the pull request open. Default: false.
          code_review:
            type: boolean
            description: Posts a code review on pull request open. Default: true.
          include_drafts:
            type: boolean
            description: Enables agent functionality on draft pull requests. Default: true.

Contoh config.yaml

Cuplikan kode berikut adalah contoh file config.yaml. Dalam contoh ini, setiap properti ditetapkan ke nilai default yang digunakan oleh Gemini Code Assist. Anda dapat menggunakan cuplikan ini sebagai template untuk membuat file config.yaml Anda sendiri:

have_fun: false
memory_config:
  disabled: false
code_review:
  disable: false
  comment_severity_threshold: MEDIUM
  max_review_comments: -1
  pull_request_opened:
    help: false
    summary: false
    code_review: true
    include_drafts: true
ignore_patterns: []

Mengelola konfigurasi di beberapa repositori

Anda dapat mengaktifkan atau menonaktifkan setelan tertentu untuk beberapa repositori saat dikelompokkan berdasarkan koneksi Developer Connect. Setelan kolektif ini dikelola melalui konsol Google Cloud .

Jika repositori dikelola sebagai bagian dari grup, tetapi juga memiliki config.yaml sendiri, setelan config.yaml repositori akan menggantikan setelan grup.

Untuk mengetahui perilaku dan pengecualian setelan tertentu, tinjau skema config.yaml.

Langkah-langkah berikut menunjukkan cara mengontrol satu set konfigurasi di beberapa repositori. Langkah-langkah ini mengasumsikan bahwa Anda telah menyiapkan Gemini Code Assist di GitHub sebelumnya.

Pratinjau

Fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dari Persyaratan Khusus Layanan untuk Google Cloud. Fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat Google Cloud deskripsi tahap peluncuran.

1. Di konsol Google Cloud , buka halaman Gemini Code Assist Agents & Tools.

   Buka Agen & Alat

2. Di bagian Agen, temukan kartu Pengelolaan Kode Sumber Bantuan Kode, lalu klik Lanjutan.

   Panel Edit Pengelolaan Kode Sumber Code Assist akan terbuka.

3. Di tabel Connections, klik nama koneksi yang ingin Anda terapkan konfigurasinya.

   Halaman detail koneksi akan terbuka.

4. Di tab Setelan, perbarui setelan yang ingin Anda ubah.

   Catatan: Jika Anda ingin mengaktifkan Tingkatkan kualitas respons, Anda tidak boleh menempatkan project Google Cloud Anda dalam perimeter layanan Kontrol Layanan VPC.

5. Klik Simpan.

Langkah berikutnya

• Tambahkan panduan gaya untuk Gemini Code Assist di GitHub.