تخصيص سلوك ميزة Gemini Code Assist في GitHub

يمكنك تعديل سلوك Gemini Code Assist على GitHub من خلال إضافة ملف config.yaml إلى مجلد .gemini/ يقع في جذر المستودع. يحتوي ملف 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.

إدارة الإعدادات في مستودعات متعددة

يمكن إدارة بعض جوانب 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. في صفحة Free agent، عدِّل الإعدادات حسب الحاجة.

  5. انقر على حفظ.

للمؤسسات

  1. في Google Cloud Console، انتقِل إلى صفحة الوكلاء والأدوات في Gemini Code Assist.

    الانتقال إلى "الوكلاء والأدوات"

  2. في قسم الوكلاء، ابحث عن بطاقة إدارة الرمز المصدر في Code Assist وانقر على خيارات متقدمة.

    يتم فتح لوحة إدارة رمز المصدر في "مساعد التعديل".

  3. في جدول عمليات الربط، انقر على اسم عملية الربط التي تريد تطبيق إعدادات عليها.

    سيتم فتح صفحة التفاصيل الخاصة بالاتصال.

  4. في علامة التبويب الإعدادات، عدِّل الإعدادات التي تريد تغييرها.

  5. انقر على حفظ.

الخطوات التالية