Verhalten von Gemini Code Assist in GitHub anpassen

Sie können das Verhalten von Gemini Code Assist in GitHub für einzelne Repositories ändern, indem Sie dem Ordner .gemini/im Stammverzeichnis des Repositorys eine config.yaml-Datei hinzufügen. Die Datei config.yaml enthält verschiedene konfigurierbare Funktionen, die Sie aktivieren oder deaktivieren können. Sie können Gruppenkonfigurationen für mehrere Repositorys für eine Teilmenge des Verhaltens von Gemini Code Assist in GitHub ausführen.

Gemini Code Assist unterstützt auch das Hinzufügen einer styleguide.md-Datei zum Ordner .gemini/. Diese Datei enthält bestimmte Regeln, die Gemini Code Assist bei der Codeüberprüfung befolgen soll. Weitere Informationen zu Styleguides für Gemini Code Assist, finden Sie unter Styleguide für die Codeüberprüfung.

Felder für die Konfiguration

In diesem Abschnitt werden Überlegungen zu bestimmten anpassbaren Feldern in Gemini Code Assist in GitHub beschrieben. Eine vollständige Liste der Felder finden Sie im config.yaml Schema.

• code_review: comment_severity_threshold: Mit diesem Feld wird der Mindestschweregrad festgelegt, für den Gemini Code Assist Kommentare postet. Wenn Sie beispielsweise code_review: comment_severity_threshold: HIGH festgelegt haben, gibt Gemini Code Assist keine Kommentare zu Pull-Anfragen für Probleme, die als LOW oder MEDIUM eingestuft werden, z. B. kleinere Refactorings. Gemini Code Assist bestimmt den Schweregrad eines Kommentars anhand des Typs und der Bedeutung des betreffenden Problems. Verstöße gegen Ihren benutzerdefinierten Styleguide erreichen oder überschreiten in der Regel den Schwellenwert für den Schweregrad.

• ignore_patterns: Dieses Feld verwendet Glob-Muster. Bei der Interaktion mit dem Repository ignoriert Gemini Code Assist Dateien, die mit einem Muster in dieser Liste übereinstimmen.

• memory_config: Dieses Feld ist anwendbar, wenn Sie die verbesserte Antwortqualität zuvor für mehrere Repositories aktiviert haben. Wenn Sie die verbesserte Antwortqualität für mehrere Repositories aktivieren, können Sie memory_config: disabled: true für ein bestimmtes Repository in der Gruppierung festlegen. Dadurch wird die Funktion für dieses Repository deaktiviert.

config.yaml-Schema

Das folgende Code-Snippet ist das Schema für die Datei config.yaml. Es definiert alle möglichen Konfigurationsoptionen und die akzeptierten Werte:

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

config.yaml-Beispiel

Das folgende Code-Snippet ist ein Beispiel für eine config.yaml-Datei. In diesem Beispiel ist jede Property auf den Standardwert festgelegt, der von Gemini Code Assist verwendet wird. Sie können dieses Snippet als Vorlage verwenden, um Ihre eigene config.yaml-Datei zu erstellen:

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: []

Konfigurationen für mehrere Repositories verwalten

Einige Aspekte von Gemini Code Assist in GitHub können für mehrere Repositories verwaltet werden:

• Wenn Sie die Consumer-Version haben, können Sie bestimmte Einstellungen für alle Repositories aktivieren oder deaktivieren, die mit einem Konto verknüpft sind.

• Wenn Sie die Enterprise-Version haben, können Sie bestimmte Einstellungen für mehrere Repositories aktivieren oder deaktivieren, die durch eine Developer Connect-Verbindung gruppiert sind. In diesem Fall verwalten Sie die gemeinsamen Einstellungen über die Google Cloud Console.

Wenn ein Repository als Teil einer Gruppe verwaltet wird, aber auch eine eigene config.yaml-Datei hat, überschreiben die config.yaml-Einstellungen des Repositorys die Gruppeneinstellungen.

Informationen zum spezifischen Verhalten von Einstellungen und zu Ausnahmen finden Sie im `config.yaml`-Schema. review the config.yaml schema.

In den folgenden Schritten wird gezeigt, wie Sie eine Reihe von Konfigurationen für mehrere Repositories steuern. Bei diesen Schritten wird davon ausgegangen, dass Sie Gemini Code Assist in GitHub bereits eingerichtet haben .

Nutzer

1. Rufen Sie in Gemini Code Assist die Seite mit den Einstellungen auf.

   Zu den Einstellungen

2. Klicken Sie bei Aufforderung auf Mit GitHub anmelden und folgen Sie der Anleitung, um sich in Gemini Code Assist bei GitHub anzumelden.

3. Wählen Sie auf der Seite Gemini das Konto aus, mit dem Sie arbeiten möchten, lesen Sie die Nutzungsbedingungen und klicken Sie auf Weiter.

4. Aktualisieren Sie auf der Seite Kostenloser Agent die Einstellungen nach Bedarf.

5. Klicken Sie auf Speichern.

Unternehmen

Vorschau

Diese Funktion unterliegt den "Bedingungen für Pre-GA-Angebote" im Abschnitt "Allgemeine Dienstbedingungen" der dienstspezifischen Nutzungsbedingungen für Google Cloud. Pre-GA‑Funktionen stehen in der vorliegenden Form zur Verfügung und bieten möglicherweise nur eingeschränkten Support. Weitere Informationen finden Sie in den Beschreibungen der Produkteinführungsphasen von Google Cloud.

1. Rufen Sie in der Google Cloud Console die Seite Agents &Tools von Gemini Code Assist auf.

   Zu „Agents &Tools“

2. Suchen Sie im Abschnitt Agents die Karte Code Assist für Quellcodeverwaltung und klicken Sie auf Erweitert.

   Der Bereich Code Assist für Quellcodeverwaltung bearbeiten wird geöffnet.

3. Klicken Sie in der Tabelle Verbindungen auf den Namen der Verbindung, auf die Sie eine Konfiguration anwenden möchten.

   Die Detailseite für die Verbindung wird geöffnet.

4. Aktualisieren Sie auf dem Tab Einstellungen die Einstellungen, die Sie ändern möchten.

   Hinweis: Wenn Sie Antwortqualität verbessern aktivieren möchten, darf sich Ihr Google Cloud-Projekt nicht in einem VPC Service Controls-Dienstperimeter befinden.

5. Klicken Sie auf Speichern.

Nächste Schritte

• Styleguide für Gemini Code Assist in GitHub hinzufügen.