تخصيص سلوك ميزة 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.

مخطّط 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 في مستودعات متعددة:

  • إذا كان لديك الإصدار للمستهلكين، يمكنك تفعيل إعدادات معيّنة أو إيقافها لجميع المستودعات المرتبطة بحساب.

  • إذا كان لديك إصدار Enterprise، يمكنك تفعيل إعدادات معيّنة أو إيقافها لمستودعات متعددة تم تجميعها حسب اتصال Developer Connect. عند إجراء ذلك، يمكنك إدارة إعداداتها الجماعية من خلال Google Cloud Console.

إذا كان يتم إدارة مستودع كجزء من مجموعة ولكن لديه أيضًا ملف config.yaml خاص به، ستلغي إعدادات config.yaml الخاصة بالمستودع إعدادات المجموعة.

للتعرّف على سلوك الإعدادات والاستثناءات المحدّدة، يُرجى مراجعة مخطّط config.yaml.

توضّح الخطوات التالية كيفية التحكّم في مجموعة واحدة من عمليات الضبط في مستودعات متعددة. تفترض هذه الخطوات أنّك سبق لك إعداد Gemini Code Assist على GitHub.

للمستهلكين

  1. في Gemini Code Assist، انتقِل إلى صفحة الإعدادات.

    الانتقال إلى الإعدادات

  2. إذا طُلب منك ذلك، انقر على تسجيل الدخول باستخدام GitHub واتّبِع التعليمات لتسجيل الدخول إلى GitHub من داخل Gemini Code Assist.

  3. في صفحة Gemini ، اختَر الحساب الذي تريد استخدامه، وراجِع بنود الخدمة، وانقر على متابعة.

  4. في صفحة مساعدك الشخصي ، عدِّل الإعدادات حسب الحاجة.

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

Enterprise

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

    الانتقال إلى "المساعدون والأدوات"

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

    يُفتح جزء تعديل "إدارة رمز المصدر في Code Assist".

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

    تُفتح صفحة التفاصيل الخاصة بالاتصال.

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

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

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