Tuỳ chỉnh hành vi của tính năng Gemini Code Assist trong GitHub

Bạn có thể sửa đổi hành vi của Gemini Code Assist trên GitHub cho từng kho lưu trữ bằng cách thêm tệp config.yaml vào thư mục .gemini/ nằm ở gốc của kho lưu trữ. Tệp config.yaml chứa nhiều tính năng có thể định cấu hình mà bạn có thể bật hoặc tắt. Bạn có thể thực hiện các cấu hình nhóm trên nhiều kho lưu trữ cho một nhóm nhỏ các hành vi của Gemini Code Assist trên GitHub.

Gemini Code Assist cũng hỗ trợ thêm tệp styleguide.md vào thư mục .gemini/. Tệp này hướng dẫn Gemini Code Assist tuân theo một số quy tắc cụ thể mà bạn muốn khi thực hiện quy trình đánh giá mã. Để biết thêm thông tin về các hướng dẫn về phong cách cho Gemini Code Assist, hãy xem Hướng dẫn về phong cách đánh giá mã.

Các trường cấu hình

Phần này mô tả những điểm cần cân nhắc đối với các trường cụ thể có thể tuỳ chỉnh trong Gemini Code Assist trên GitHub. Để xem danh sách đầy đủ các trường, hãy xem giản đồ config.yaml.

• code_review: comment_severity_threshold: Trường này đặt mức độ nghiêm trọng tối thiểu mà Gemini Code Assist đăng nhận xét. Ví dụ: nếu bạn đã đặt code_review: comment_severity_threshold: HIGH, Gemini Code Assist sẽ không cung cấp bình luận về yêu cầu kéo cho các vấn đề mà công cụ này cho là có mức độ nghiêm trọng LOW hoặc MEDIUM, chẳng hạn như các hoạt động tái cấu trúc nhỏ. Gemini Code Assist xác định mức độ nghiêm trọng của một nhận xét dựa trên loại và mức độ quan trọng của vấn đề đang được xem xét, trong đó các lỗi vi phạm hướng dẫn về phong cách tuỳ chỉnh thường đáp ứng hoặc vượt quá ngưỡng nghiêm trọng.

• ignore_patterns: Trường này sử dụng mẫu glob. Khi tương tác với kho lưu trữ, Gemini Code Assist sẽ bỏ qua những tệp khớp với bất kỳ mẫu nào trong danh sách này.

• memory_config: Trường này áp dụng nếu trước đây bạn đã bật tính năng cải thiện chất lượng phản hồi cho nhiều kho lưu trữ. Khi bật tính năng cải thiện chất lượng phản hồi cho nhiều kho lưu trữ, bạn có thể đặt memory_config: disabled: true cho một kho lưu trữ cụ thể trong nhóm. Thao tác này sẽ tắt tính năng cho kho lưu trữ đó.

config.yaml giản đồ

Đoạn mã sau đây là giản đồ cho tệp config.yaml. Tệp này xác định tất cả các lựa chọn cấu hình có thể có và các giá trị được chấp nhận:

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

Ví dụ về config.yaml

Đoạn mã sau đây là một ví dụ về tệp config.yaml. Trong ví dụ này, mỗi thuộc tính được đặt thành giá trị mặc định mà Gemini Code Assist sử dụng. Bạn có thể sử dụng đoạn mã này làm mẫu để tạo tệp config.yaml của riêng mình:

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

Quản lý cấu hình trên nhiều kho lưu trữ

Bạn có thể quản lý một số khía cạnh của Gemini Code Assist trên GitHub trên nhiều kho lưu trữ:

• Nếu đang dùng phiên bản dành cho người tiêu dùng, bạn có thể bật/tắt một số chế độ cài đặt cho tất cả kho lưu trữ được liên kết với một tài khoản.

• Nếu có phiên bản dành cho doanh nghiệp, bạn có thể bật/tắt một số chế độ cài đặt cho nhiều kho lưu trữ được nhóm theo một mối kết nối Developer Connect. Khi đó, bạn sẽ quản lý chế độ cài đặt chung của các tài khoản này thông qua bảng điều khiển Cloud.

Nếu một kho lưu trữ được quản lý trong một nhóm nhưng cũng có config.yaml riêng, thì chế độ cài đặt config.yaml của kho lưu trữ sẽ ghi đè chế độ cài đặt của nhóm.

Để biết hành vi và các trường hợp ngoại lệ cụ thể của chế độ cài đặt, hãy xem giản đồ config.yaml.

Các bước sau đây cho thấy cách kiểm soát một nhóm cấu hình trên nhiều kho lưu trữ. Các bước này giả định rằng trước đây bạn đã thiết lập Gemini Code Assist trên GitHub.

Người tiêu dùng

1. Trong Gemini Code Assist, hãy chuyển đến trang cài đặt.

   Chuyển đến phần cài đặt

2. Nếu được nhắc, hãy nhấp vào Đăng nhập bằng GitHub rồi làm theo lời nhắc để đăng nhập vào GitHub trong Gemini Code Assist.

3. Trên trang Gemini, hãy chọn tài khoản bạn muốn sử dụng, xem kỹ điều khoản dịch vụ rồi nhấp vào Tiếp tục.

4. Trên trang Free agent (Tác nhân tự do), hãy cập nhật các chế độ cài đặt nếu cần.

5. Nhấp vào Lưu.

Doanh nghiệp

Xem trước

Tính năng này tuân theo "Điều khoản dành cho sản phẩm/dịch vụ ở giai đoạn trước khi phát hành rộng rãi" trong phần Điều khoản chung về dịch vụ của Điều khoản dành riêng cho dịch vụ của Google Cloud. Các tính năng ở giai đoạn trước khi phát hành rộng rãi được cung cấp "theo nguyên trạng" và có thể bị hạn chế về khả năng hỗ trợ. Để biết thêm thông tin, hãy xem phần mô tả giai đoạn ra mắt của Google Cloud.

1. Trong bảng điều khiển Cloud, hãy chuyển đến trang Agents & Tools (Công cụ và tác nhân) của Gemini Code Assist.

   Chuyển đến phần Agents & Tools (Trợ lý ảo và công cụ)

2. Trong phần Agents (Tác nhân), hãy tìm thẻ Code Assist Source Code Management (Quản lý mã nguồn của Trợ lý viết mã) rồi nhấp vào Nâng cao.

   Ngăn Chỉnh sửa tính năng Quản lý mã nguồn của Trợ lý mã sẽ mở ra.

3. Trong bảng Kết nối, hãy nhấp vào tên của kết nối mà bạn muốn áp dụng cấu hình.

   Trang thông tin chi tiết về mối kết nối sẽ mở ra.

4. Trong thẻ Cài đặt, hãy cập nhật các chế độ cài đặt mà bạn muốn thay đổi.

   Lưu ý: Nếu muốn bật chế độ Cải thiện chất lượng phản hồi, bạn không nên đặt dự án trên đám mây Google Cloud của mình trong chu vi dịch vụ VPC Service Controls.

5. Nhấp vào Lưu.

Bước tiếp theo

• Thêm một bản hướng dẫn về phong cách cho Gemini Code Assist trên GitHub.