GitHub에서 Gemini Code Assist 동작 맞춤설정

저장소의 루트에 있는 .gemini/ 폴더에 config.yaml 파일을 추가하여 GitHub의 Gemini Code Assist 동작을 수정할 수 있습니다. config.yaml 파일에는 glob 패턴을 사용하여 무시할 파일을 지정하는 등 사용 설정하거나 사용 중지할 수 있는 다양한 구성 가능한 기능이 포함되어 있습니다.

Gemini Code Assist는 styleguide.md 파일을 .gemini/ 폴더에 추가하는 것도 지원합니다. 이 파일은 코드 검토를 실행할 때 따라야 하는 특정 규칙을 Gemini Code Assist에 알려줍니다. Gemini Code Assist의 스타일 가이드에 관한 자세한 내용은 코드 검토 스타일 가이드를 참고하세요.

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

스키마 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. Files matching any pattern in this list will be skipped during interactions. 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, if Improve response quality has been enabled for multiple repositories. 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.

여러 저장소에서 구성 관리

GitHub의 Gemini Code Assist의 일부 측면은 여러 저장소에서 관리할 수 있습니다.

  • 일반 버전이 있는 경우 계정과 연결된 모든 저장소에 대해 특정 설정을 전환할 수 있습니다.

  • 엔터프라이즈 버전을 사용하는 경우 Developer Connect 연결로 그룹화된 여러 저장소의 특정 설정을 전환할 수 있습니다. 이 경우 Google Cloud 콘솔을 통해 집합적 설정을 관리합니다.

저장소가 그룹의 일부로 관리되지만 자체 config.yaml도 있는 경우 저장소의 config.yaml 설정이 그룹 설정을 재정의합니다.

구체적인 설정 동작 및 예외는 config.yaml 스키마를 검토하세요.

다음 단계에서는 여러 저장소에서 하나의 구성 집합을 제어하는 방법을 보여줍니다. 이 단계에서는 이전에 GitHub에서 Gemini Code Assist를 설정했다고 가정합니다.

소비자

  1. Gemini Code Assist에서 설정 페이지로 이동합니다.

    설정으로 이동

  2. 메시지가 표시되면 GitHub로 로그인을 클릭하고 메시지에 따라 Gemini Code Assist 내에서 GitHub에 로그인합니다.

  3. Gemini 페이지에서 사용할 계정을 선택하고 서비스 약관을 검토한 후 계속을 클릭합니다.

  4. 무료 상담사 페이지에서 필요에 따라 설정을 업데이트합니다.

  5. 저장을 클릭합니다.

Enterprise

  1. Google Cloud 콘솔에서 Gemini Code Assist 에이전트 및 도구 페이지로 이동합니다.

    에이전트 및 도구로 이동

  2. 에이전트 섹션에서 Code Assist 소스 코드 관리 카드를 찾아 고급을 클릭합니다.

    Code Assist 소스 코드 관리 수정 창이 열립니다.

  3. 연결 표에서 구성을 적용할 연결의 이름을 클릭합니다.

    연결 세부정보 페이지가 열립니다.

  4. 설정 탭에서 변경하려는 설정을 업데이트합니다.

  5. 저장을 클릭합니다.

다음 단계