Настройте поведение Gemini Code Assist в GitHub

Вы можете изменить поведение Gemini Code Assist на GitHub для отдельных репозиториев, добавив файл config.yaml в папку .gemini/ , расположенную в корне репозитория. Файл config.yaml содержит различные настраиваемые параметры, которые можно включить или отключить. Вы можете выполнять групповые настройки для нескольких репозиториев для определенного набора параметров Gemini Code Assist на GitHub.

Gemini Code Assist также поддерживает добавление файла styleguide.md в папку .gemini/ , который указывает Gemini Code Assist определенные правила, которым он должен следовать при проведении проверки кода. Для получения дополнительной информации о руководствах по стилю для Gemini Code Assist см. руководство по стилю для проверки кода .

Поля конфигурации

В этом разделе описаны особенности работы с настраиваемыми полями в Gemini Code Assist на GitHub. Полный список полей см. в схеме config.yaml .

  • code_review: comment_severity_threshold : Это поле устанавливает минимальный уровень серьезности, при котором Gemini Code Assist публикует комментарии. Например, если вы установили code_review: comment_severity_threshold: HIGH , Gemini Code Assist не будет публиковать комментарии к запросам на слияние для проблем, которые он считает LOW или MEDIUM по степени серьезности, таких как незначительные рефакторинги. Gemini Code Assist определяет серьезность комментария на основе типа и значимости рассматриваемой проблемы, при этом нарушения вашего пользовательского руководства по стилю обычно достигают или превышают пороговое значение серьезности.

  • ignore_patterns : В этом поле используются шаблоны glob . При взаимодействии с репозиторием Gemini Code Assist игнорирует файлы, соответствующие любому шаблону из этого списка.

  • memory_config : Это поле необходимо, если вы ранее включили улучшенное качество ответа для нескольких репозиториев. При включении улучшенного качества ответа для нескольких репозиториев вы можете установить memory_config: disabled: true для конкретного репозитория в группе, что отключит эту функцию для данного репозитория.

схема config.yaml

Приведённый ниже фрагмент кода представляет собой схему файла config.yaml . Он определяет все возможные параметры конфигурации и их допустимые значения:

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

Приведённый ниже фрагмент кода — пример файла config.yaml . В этом примере каждому свойству присвоено значение по умолчанию, используемое Gemini Code Assist. Вы можете использовать этот фрагмент в качестве шаблона для создания собственного файла config.yaml :

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: true
    code_review: true
    include_drafts: true
ignore_patterns: []

Управление конфигурациями в нескольких репозиториях.

Некоторые аспекты Gemini Code Assist на GitHub можно управлять в нескольких репозиториях:

  • Если у вас потребительская версия, вы можете переключать определенные настройки для всех репозиториев, связанных с учетной записью.

  • В корпоративной версии вы можете переключать определенные настройки для нескольких репозиториев, сгруппированных по подключению Developer Connect. В этом случае вы управляете их общими настройками через консоль Google Cloud.

Если репозиторий управляется как часть группы, но также имеет собственный config.yaml , то настройки config.yaml репозитория переопределяют настройки группы.

Для получения информации о поведении конкретных настроек и исключениях ознакомьтесь со схемой config.yaml .

Следующие шаги показывают, как управлять одним набором конфигураций в нескольких репозиториях. Предполагается, что вы ранее настроили Gemini Code Assist на GitHub .

Потребитель

  1. В Gemini Code Assist перейдите на страницу настроек.

    Перейдите в настройки

  2. Если появится запрос, нажмите « Войти через GitHub» и следуйте инструкциям, чтобы войти в GitHub из Gemini Code Assist.

  3. На странице Gemini выберите учетную запись, с которой хотите работать, ознакомьтесь с условиями обслуживания и нажмите «Продолжить» .

  4. На странице свободного агента обновите настройки по мере необходимости.

  5. Нажмите « Сохранить ».

Предприятие

  1. В консоли Google Cloud перейдите на страницу «Агенты и инструменты Gemini Code Assist».

    Перейдите в раздел «Агенты и инструменты».

  2. В разделе «Агенты» найдите карточку «Управление исходным кодом Code Assist» и нажмите «Дополнительно» .

    Открывается панель «Управление исходным кодом» в разделе «Редактирование кода» .

  3. В таблице «Подключения» щелкните имя подключения, к которому вы хотите применить конфигурацию.

    Открывается страница с подробной информацией о подключении.

  4. На вкладке «Настройки» обновите параметры, которые хотите изменить.

  5. Нажмите « Сохранить ».

Что дальше?