ضبط إعدادات تخصيص الرموز البرمجية في Gemini Code Assist

ملاحظة: لا تتوفّر ميزة تخصيص الرموز البرمجية في Gemini Code Assist إلا في Gemini Code Assist Enterprise. لمزيد من المعلومات، يُرجى الاطّلاع على الميزات المتوافقة مع "مساعد الترميز" من Gemini.

يوضّح هذا المستند كيفية إعداد تخصيص رمز Gemini Code Assist في API Console أو باستخدام Google Cloud CLI أو Terraform من خلال ربط Gemini Code Assist بمستودعات الرموز الخاصة بك. تتيح لك ميزة تخصيص الرموز البرمجية في Gemini Code Assist تلقّي اقتراحات للرموز البرمجية مستندة إلى المكتبات الداخلية وواجهات برمجة التطبيقات الخاصة وأسلوب الترميز في مؤسستك.

قبل البدء

1. إعداد Gemini Code Assist من خلال اشتراك Enterprise

2. تأكَّد من أنّ لديك أدوار "إدارة الهوية وإمكانية الوصول" التالية في المشروع الذي يملك الاشتراك:

   • مشرف فهارس مستودع الرموز (roles/cloudaicompanion.codeRepositoryIndexesAdmin)
   • مستخدم "Gemini في Google Cloud" (roles/cloudaicompanion.user)

3. إنشاء حسابات المستخدمين أو ضبطها يجب أن يكون لكل مطوّر في مؤسستك يستخدم Gemini Code Assist هوية مستخدم في Google Cloud لديه إذن بالوصول إلى مشروعك على Google Cloud. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة منح الأدوار في Google Cloud Console. تأكَّد من أنّ كل مستخدم لديه الأدوار التالية:

   • مستخدم "Gemini في Google Cloud"
   • مستخدم مجموعات المستودعات

4. تستخدم ميزة تخصيص الرمز Developer Connect للوصول إلى مستودعاتك الخاصة وفهرستها. تأكَّد من أنّ منطقة Developer Connect التي يتوفّر فيها ربط مستودع Developer Connect هي أيضًا موقع جغرافي متاح لتخصيص الرموز البرمجية. لا يمكن استخدام ميزة تخصيص الرمز إذا كان اتصال Developer Connect في منطقة غير متوافقة. للاطّلاع على قائمة المناطق المتوافقة، يُرجى الرجوع إلى قيود تخصيص الرموز.

اختيار المستودعات التي سيتم فهرسة محتواها

كأفضل ممارسة، يجب فهرسة المستودعات التي تتضمّن الخصائص التالية:

• التعليمات البرمجية التي تتضمّن نمطًا أو بنية مشابهة لما تريد أن يكتبه المطوّرون
• المكتبات أو واجهات برمجة التطبيقات الخاصة التي تريد استدعاءها من قاعدة الرموز البرمجية الحالية

اختياري: اختيار الملفات التي لا يتم فهرسة محتواها

بشكلٍ تلقائي، يفهرس تخصيص الرمز البرمجي جميع ملفات الرمز البرمجي المتوافقة في المستودعات التي تحدّدها.

لمنع عرض الرمز الذي لا تريد فهرسته، يمكنك استخدام أنماط الفروع من أجل التحكّم في الوصول إلى الفهرس واستخدام فرع ثابت، مثل main.

بدلاً من ذلك، يمكنك أيضًا استبعاد الملفات من الفهرس عن طريق إنشاء ملف .aiexclude.

ضبط إعدادات تخصيص الرموز البرمجية في Gemini Code Assist

اختر أحد الخيارات التالية:

وحدة التحكّم

1. في "وحدة تحكّم واجهة برمجة التطبيقات"، انتقِل إلى صفحة تخصيص الرمز.

   الانتقال إلى "تخصيص الرمز البرمجي" في Gemini Code Assist

   يتم تحميل صفحة تخصيص الرمز البرمجي في Gemini Code Assist.

2. إنشاء فهرس تعتمد عملية تخصيص الرموز البرمجية على فهرس لتحليل مستودعك وتفسيره من أجل تقديم اقتراحات وعمليات بحث أسرع بشأن إنشاء الرموز البرمجية.

   1. انقر على إنشاء واضبط تفاصيل الفهرس:

      • اختَر المنطقة التي تم ضبطها في Developer Connect في مشروعك على السحابة الإلكترونية.
      • أدخِل اسمًا للفهرس. دوِّن اسم الفهرس. ستحتاج إليها في عدة خطوات في هذا المستند.

   2. انقر على إنشاء.

   تستغرق عملية إنشاء الفهرس عادةً 30 دقيقة، ولكن قد تستغرق ما يصل إلى ساعة واحدة. عند اكتمال عملية الفهرسة، ستتلقّى إشعارًا في وحدة تحكّم Google API.

   يفرض Google حدًا على عدد فهارس مستودعات الرموز، وهو فهرس واحد لكل مشروع ومؤسسة.

3. التحكّم في الوصول إلى الفهرس باستخدام مجموعات المستودعات

   مجموعة المستودعات هي حاوية لإعدادات الفهرسة، والتي تتضمّن المستودعات وأنماط الفروع الخاصة بها. تم تصميم مجموعات المستودعات لتوفير تحكّم دقيق في إدارة الهوية وإمكانية الوصول (IAM)، ما يتيح للمطوّرين الوصول إلى البيانات المفهرسة من تلك المجموعات التي لديهم إذن cloudaicompanion.repositoryGroups.use بالوصول إليها.

   تحتوي مجموعات المستودعات على مستودعات أو روابط Developer Connect من المشروع والموقع الجغرافي نفسهما.

4. في صفحة تخصيص الرمز البرمجي في Gemini Code Assist، انقر على إضافة مستودعات، ثم اختَر إضافة مستودعات المصدر.

   يتم عرض قائمة بالمستودعات الحالية في Developer Connect للمنطقة التي أعددتها في الخطوة السابقة لإنشاء الفهرس.

   إذا كنت بحاجة إلى إضافة مستودعات جديدة إلى مجموعة المستودعات، انقر على ربط المستودع واتّبِع الخطوات في Google API Console.

   بالإضافة إلى ذلك، يمكنك اختيار مستودع واحد أو أكثر ثم تعديله لإضافة فرع جديد.

5. اختَر مجموعة المستودعات التي تريد إضافة مستودعات جديدة إليها. بدلاً من ذلك، انقر على إنشاء مجموعة مستودع جديدة لإنشاء مجموعة مستودع جديدة وإعدادها.

6. لبدء فهرسة المستودعات المحدّدة، انقر على فهرسة.

   يختلف وقت الفهرسة حسب حجم المستودعات.

CLI

1. تأكَّد من أنّك أعددت Developer Connect وتم ربطها بمستودعك:
   • GitHub.com
   • GitLab.com
   • Bitbucket.org

2. في بيئة shell، شغِّل الأمر gcloud components update للتأكّد من أنّك حدّثت جميع المكوّنات المثبَّتة من gcloud إلى أحدث إصدار. في هذه الخطوة، يمكنك تثبيت gcloud وتهيئة إعداداته، أو يمكنك استخدام محرّر Cloud Shell.

   gcloud components update
   

3. إنشاء فهرس تعتمد عملية تخصيص الرموز البرمجية على فهرس لتحليل مستودعك وتفسيره من أجل تقديم اقتراحات وعمليات بحث أسرع بشأن إنشاء الرموز البرمجية.

   1. لإنشاء الفهرس، استخدِم الأمر gemini code-repository-indexes create في بيئة shell:

      gcloud gemini code-repository-indexes create INDEX_NAME \
          --project=PROJECT_ID \
          --location=REGION
      

      غيِّر القيم في السلسلة على الشكل التالي:

      • INDEX_NAME: اسم الفهرس. ملاحظة مهمة: دوِّن اسم الفهرس. ستحتاج إليه في عدة خطوات في هذا المستند.
      • استبدِل PROJECT_ID بمعرّف مشروع Google Cloud.
      • REGION: المنطقة التي تم ضبطها في Developer Connect في مشروعك على السحابة الإلكترونية

      تستغرق عملية إنشاء الفهرس عادةً 30 دقيقة، ولكن قد تستغرق ما يصل إلى ساعة واحدة.

      يفرض Google حدًا على عدد فهارس مستودعات الرموز، وهو فهرس واحد لكل مشروع ومؤسسة.

4. التحكّم في الوصول إلى الفهرس باستخدام مجموعات المستودعات مجموعة المستودعات هي حاوية لإعدادات الفهرسة، وتشمل المستودعات وأنماط الفروع الخاصة بها. تم تصميم مجموعات المستودعات لتوفير تحكّم دقيق في إدارة الهوية وإمكانية الوصول، ما يتيح للمطوّرين الوصول إلى البيانات المفهرسة من تلك المجموعات التي لديهم فيها إذن cloudaicompanion.repositoryGroups.use.

   تحتوي مجموعات المستودعات على مستودعات Developer Connect أو روابط من المشروع والموقع الجغرافي نفسهما.

   ينفّذ المشرفون الإجراءات التالية:

   • أنشئ مورد فهرس المستودع البرمجي.
   • في المشروع والموقع الجغرافي نفسهما، اضبط إعدادات اتصال جديد في Developer Connect.
   • ربط مستودعات Git في عملية الربط
   • الحصول على أسماء موارد الروابط، واختيار نمط الفروع لفهرسة كل رابط، ووضعه في مجموعة واحدة أو أكثر من مستودعات البيانات

   لإنشاء مجموعة مستودعات، استخدِم الأمر gemini code-repository-indexes repository-groups create في بيئة shell:

   gcloud gemini code-repository-indexes repository-groups create REPOSITORY_GROUP \
       --project=PROJECT_ID \
       --location=REGION \
       --code-repository-index=INDEX_NAME \
       --repositories='[{"resource": "REPOSITORY_RESOURCE_NAME", "branchPattern": "BRANCH_NAMES"}]'
   

   ملاحظة: يمكنك استخدام التعبير العادي في بنية RE2 لتحديد أسماء الفروع.

   غيِّر القيم في السلسلة على الشكل التالي:

   • REPOSITORY_GROUP: اسم مجموعة المستودع، مثل default
   • ‫REPOSITORY_RESOURCE_NAME: اسم المستودع داخل اتصال Developer Connect. للعثور على اسم المستودع، انتقِل إلى صفحة مستودعات Git في Google Cloud Console، وفي علامة التبويب المستودعات، ابحث عن معرّف الاتصال ضمن عمود الاتصال في الجدول. لنسخ اسم المورد، انقر على قائمة more_vert للاطّلاع على المزيد من الخيارات، ثم انقر على نسخ مسار المورد.
   • BRANCH_NAMES: اسم الفروع التي تريد فهرستها، مثل main|dev

   يمكنك أيضًا إنشاء مجموعة مستودعات باستخدام مستودعات محدّدة في ملف JSON (أو YAML) منسّق على النحو التالي:

   JSON

   [
     {
         "resource": "REPOSITORY_RESOURCE_NAME", "branchPattern": "main|dev"
     },
     {
         "resource": "REPOSITORY_RESOURCE_NAME", "branchPattern": "dev"
     }
   ]
   

   YAML

   - resource: REPOSITORY_RESOURCE_NAME
     branchPattern: main|dev
   
   - resource: REPOSITORY_RESOURCE_NAME
     branchPattern: dev
   

   لإنشاء مجموعة مستودعات استنادًا إلى ملف JSON أو YAML، استخدِم الأمر gemini code-repository-indexes repository-groups create في بيئة shell:

   JSON

   gcloud gemini code-repository-indexes repository-groups create REPOSITORY_GROUP \
       --project=PROJECT_ID \
       --location=REGION \
       --code-repository-index=INDEX_NAME \
       --repositories=FILEPATH.json
   

   YAML

   gcloud gemini code-repository-indexes repository-groups create REPOSITORY_GROUP \
       --project=PROJECT_ID \
       --location=REGION \
       --code-repository-index=INDEX_NAME \
       --repositories=FILEPATH.yaml
   

   إذا كنت تفضّل ذلك، يمكنك تشفير بياناتك والتحكّم فيها باستخدام مفتاح تشفير يديره العميل (CMEK) من خلال خدمة إدارة المفاتيح في السحابة الإلكترونية. لمزيد من المعلومات حول استخدام مفتاح CMEK، يُرجى الاطّلاع على تشفير البيانات باستخدام مفاتيح التشفير التي يديرها العميل.

5. امنح أدوار "إدارة الهوية وإمكانية الوصول" لمجموعة المستودع في أحد المشاريع.

   لن تتلقّى اقتراحات إلا من المستودعات المتوفّرة في الفهرس. ينتمي كل مستودع إلى مجموعة واحدة أو أكثر من مجموعات المستودعات. للوصول إلى الاقتراحات، يجب منح دور Cloud AI Companion Repository Groups User IAM (roles/cloudaicompanion.repositoryGroupsUser)، الذي يتضمّن إذن cloudaicompanion.repositoryGroups.user IAM المطلوب، إلى مجموعة المستودع بإحدى الطرق التالية:

   • امنح الجهات الرئيسية إذن الوصول إلى الفهرس بأكمله.

   • منح الجهات الرئيسية إذن الوصول إلى مجموعة فرعية من الفهرس

   الفهرس بأكمله

   1. لربط سياسة إدارة الهوية وإمكانية الوصول (IAM) بمشروع، استخدِم الأمر projects add-iam-policy-binding في بيئة shell:

      gcloud projects add-iam-policy-binding PROJECT_ID \
          --member='PRINCIPAL' \
          --role='roles/cloudaicompanion.repositoryGroupsUser'
      

      غيِّر القيم في السلسلة على الشكل التالي:

      • استبدِل PRINCIPAL بعنوان البريد الإلكتروني الخاص بالجهة الرئيسية التي تحتاج إلى إذن الوصول، مثل user:[e-mail] لفرد أو group:[e-mail] لمجموعة.

      لمزيد من المعلومات، يُرجى الاطّلاع على gcloud projects set-iam-policy.

   2. عندما يُطلب منك تحديد شرط، أدخِل None.

   مجموعة فرعية من الفهرس

   يمكنك إنشاء عدة مجموعات مستودعات وتعيين أدوار IAM لمختلف الجهات الرئيسية في IAM.

   لإعداد سياسة إدارة الهوية وإمكانية الوصول، يجب إعداد ملف JSON أو YAML الخاص بسياسة إدارة الهوية وإمكانية الوصول، والذي سيتضمّن قائمة بمجموعات إدارة الهوية وإمكانية الوصول والأدوار المخصّصة. على سبيل المثال:

     bindings:
     - members:
       - group:[e-mail]
       - user:[e-mail]
       role: roles/cloudaicompanion.repositoryGroupsUser
   

   لمزيد من التفاصيل والصيغة، يُرجى الاطّلاع على التعرّف على سياسات السماح.

   ملاحظة: يمكنك منح أدوار مخصّصة لمجموعات "إدارة الهوية وإمكانية الوصول"، ولكن يجب أن يتضمّن الدور المخصّص جميع أذونات دور roles/cloudaicompanion.repositoryGroupsUser.

   لضبط سياسة إدارة الهوية وإمكانية الوصول، استخدِم الأمر gemini code-repository-indexes repository-groups set-iam-policy في بيئة shell:

     gcloud gemini code-repository-indexes repository-groups set-iam-policy GROUP_NAMEPOLICY_FILE \
         --project=PROJECT_ID \
         --location=REGION \
         --code-repository-index=INDEX_NAME
   

   غيِّر القيم في السلسلة على الشكل التالي:

   • GROUP_NAME: اسم مجموعة المستودع التي أنشأتها في خطوة سابقة للتحكّم في الوصول إلى الفهرس باستخدام مجموعات المستودع.

   • ‫POLICY_FILE: سياسة إدارة الهوية وإمكانية الوصول

     لمزيد من المعلومات، يُرجى الاطّلاع على gcloud gemini code-repository-indexes repository-groups set-iam-policy.

Terraform

1. تأكَّد من أنّك أعددت Developer Connect وتم ربطها بمستودعك:

   • GitHub.com
   • GitLab.com
   • Bitbucket.org

2. إنشاء فهرس تعتمد عملية تخصيص الرموز البرمجية على فهرس لتحليل مستودعك وتفسيره من أجل تقديم اقتراحات وعمليات بحث أسرع بشأن إنشاء الرموز البرمجية.

   resource "google_gemini_code_repository_index" "example" {
     location = "REGION"
     code_repository_index_id = "INDEX_NAME"
   }
   

   غيِّر القيم في السلسلة على الشكل التالي:

   • INDEX_NAME: اسم الفهرس. ملاحظة مهمة: دوِّن اسم الفهرس. ستحتاج إليها في عدة خطوات في هذا المستند.
   • استبدِل PROJECT_ID بمعرّف مشروع Google Cloud.
   • REGION: المنطقة التي تم ضبطها في Developer Connect في مشروعك على السحابة الإلكترونية

   تستغرق عملية إنشاء الفهرس عادةً 30 دقيقة، ولكن قد تستغرق ما يصل إلى ساعة واحدة.

   يفرض Google حدًا على عدد فهارس مستودعات الرموز، وهو فهرس واحد لكل مشروع ومؤسسة.

3. التحكّم في الوصول إلى الفهرس باستخدام مجموعات المستودعات مجموعة المستودعات هي حاوية لإعدادات الفهرسة، وتشمل المستودعات وأنماط الفروع الخاصة بها. تم تصميم مجموعات المستودعات لتوفير تحكّم دقيق في إدارة الهوية وإمكانية الوصول، ما يتيح للمطوّرين الوصول إلى البيانات المفهرسة من تلك المجموعات التي لديهم فيها إذن cloudaicompanion.repositoryGroups.use.

   تحتوي مجموعات المستودعات على مستودعات أو روابط Developer Connect من المشروع والموقع الجغرافي نفسهما.

   ينفّذ المشرفون الإجراءات التالية:

   • أنشئ مورد فهرس المستودع البرمجي.
   • في المشروع والموقع الجغرافي نفسهما، اضبط إعدادات اتصال جديد في Developer Connect.
   • ربط مستودعات Git في عملية الربط
   • الحصول على أسماء موارد الروابط، واختيار نمط الفروع المراد فهرسته لكل رابط، ووضعه في مجموعة واحدة أو أكثر من مجموعات المستودعات

   resource "google_gemini_repository_group" "example" {
     location = "REGION"
     code_repository_index = "INDEX_NAME"
     repository_group_id = "REPOSITORY_GROUP"
     repositories {
       resource = "REPOSITORY_RESOURCE_NAME"
       branch_pattern = "BRANCH_NAMES"
     }
   }
   

   ملاحظة: يمكنك استخدام التعبير العادي في بنية RE2 لتحديد أسماء الفروع.

   غيِّر القيم في السلسلة على الشكل التالي:

   • ‫REPOSITORY_GROUP: اسم مجموعة المستودع، مثل default
   • ‫REPOSITORY_RESOURCE_NAME: اسم المستودع داخل اتصال Developer Connect. للعثور على اسم المستودع، انتقِل إلى صفحة مستودعات Git في Google Cloud Console، وفي علامة التبويب المستودعات، ابحث عن معرّف الاتصال ضمن عمود الاتصال في الجدول. لنسخ اسم المورد، انقر على قائمة more_vert للاطّلاع على المزيد من الخيارات، ثم اختَر نسخ مسار المورد.
   • BRANCH_NAMES: اسم الفروع التي تريد فهرستها، مثل main|dev

   يمكنك أيضًا إنشاء مجموعة مستودعات تتضمّن مستودعات محدّدة في ملف JSON (أو YAML) بالتنسيق التالي:

   JSON

   [
     {
         "resource": "REPOSITORY_RESOURCE_NAME", "branchPattern": "main|dev"
     },
     {
         "resource": "REPOSITORY_RESOURCE_NAME", "branchPattern": "dev"
     }
   ]
   

   YAML

   - resource: REPOSITORY_RESOURCE_NAME
     branchPattern: main|dev
   
   - resource: REPOSITORY_RESOURCE_NAME
     branchPattern: dev
   

   لإنشاء مجموعة مستودعات استنادًا إلى ملف JSON أو YAML، استخدِم الأمر gemini code-repository-indexes repository-groups create في بيئة shell:

   JSON

   gcloud gemini code-repository-indexes repository-groups create REPOSITORY_GROUP \
       --project=PROJECT_ID \
       --location=REGION \
       --code-repository-index=INDEX_NAME \
       --repositories=FILEPATH.json
   

   YAML

   gcloud gemini code-repository-indexes repository-groups create REPOSITORY_GROUP \
       --project=PROJECT_ID \
       --location=REGION \
       --code-repository-index=INDEX_NAME \
       --repositories=FILEPATH.yaml
   

   إذا كنت تفضّل ذلك، يمكنك تشفير بياناتك والتحكّم فيها باستخدام مفتاح تشفير يديره العميل (CMEK) من خلال خدمة إدارة المفاتيح في السحابة الإلكترونية. لمزيد من المعلومات حول استخدام مفتاح CMEK، يُرجى الاطّلاع على تشفير البيانات باستخدام مفاتيح التشفير التي يديرها العميل.

4. امنح أدوار "إدارة الهوية وإمكانية الوصول" لمجموعة المستودع في أحد المشاريع.

   لن تتلقّى اقتراحات إلا من المستودعات المتوفّرة في الفهرس. ينتمي كل مستودع إلى مجموعة واحدة أو أكثر من مجموعات المستودعات. للوصول إلى الاقتراحات، يجب منح دور Cloud AI Companion Repository Groups User IAM (roles/cloudaicompanion.repositoryGroupsUser)، الذي يتضمّن إذن cloudaicompanion.repositoryGroups.user IAM المطلوب، إلى مجموعة المستودع بإحدى الطرق التالية:

   • امنح الجهات الرئيسية إذن الوصول إلى الفهرس بأكمله.

   • منح الجهات الرئيسية إذن الوصول إلى مجموعة فرعية من الفهرس

   الفهرس بأكمله

   1. لربط سياسة إدارة الهوية وإمكانية الوصول (IAM) بمشروع، استخدِم الأمر projects add-iam-policy-binding في بيئة shell:

      gcloud projects add-iam-policy-binding PROJECT_ID \
          --member='PRINCIPAL' \
          --role='roles/cloudaicompanion.repositoryGroupsUser'
      

      غيِّر القيم في السلسلة على الشكل التالي:

      • استبدِل PRINCIPAL بعنوان البريد الإلكتروني الخاص بالجهة الرئيسية التي تحتاج إلى إذن الوصول، مثل user:[e-mail] لفرد أو group:[e-mail] لمجموعة.

        لمزيد من المعلومات، يُرجى الاطّلاع على gcloud projects set-iam-policy.

   2. عندما يُطلب منك تحديد شرط، أدخِل None.

   مجموعة فرعية من الفهرس

   يمكنك إنشاء عدة مجموعات مستودعات وتعيين أدوار IAM لمختلف الجهات الرئيسية في IAM.

     data "google_iam_policy" "foo" {
       binding {
         role = "roles/cloudaicompanion.repositoryGroupsUser"
         members = ["[e-mail]"]
       }
     }
   
     resource "google_gemini_repository_group_iam_policy" "foo" {
       project = "PROJECT_ID"
       location = "REGION"
       code_repository_index_id = "INDEX_NAME"
       repository_group_id = "GROUP_NAME"
       policy_data = data.google_iam_policy.foo.policy_data
     }
   
     data "google_gemini_repository_group_iam_policy" "foo" {
       project = "PROJECT_ID"
       location = "REGION"
       code_repository_index_id = "INDEX_NAME"
       repository_group_id = "GROUP_NAME"
       depends_on = [
         google_gemini_repository_group_iam_policy.foo
       ]
     }
   

   يمكنك أيضًا إنشاء ربط:

     resource "google_gemini_repository_group_iam_binding" "foo" {
       project = "PROJECT_ID"
       location = "REGION"
       code_repository_index_id = "INDEX_NAME"
       repository_group_id = "GROUP_NAME"
       role = "roles/cloudaicompanion.repositoryGroupsUser"
       members = ["[e-mail]"]
     }
   

   غيِّر القيم في السلسلة على الشكل التالي:

   • GROUP_NAME: اسم مجموعة المستودع التي أنشأتها في خطوة سابقة للتحكّم في الوصول إلى الفهرس باستخدام مجموعات المستودع

التحقّق من حالة الفهرسة

بناءً على عدد المستودعات التي تريد فهرستها وحجمها، قد تستغرق عملية فهرسة المحتوى ما يصل إلى 24 ساعة. بالنسبة إلى المستودعات الكبيرة، قد يستغرق الفهرسة وقتًا أطول. تتم الفهرسة مرة واحدة كل 24 ساعة، ويتم رصد أي تغييرات تم إجراؤها في المستودع.

1. ابحث عن سجلّات indexing. لمزيد من المعلومات، راجِع لغة طلب البحث في السجلات.

   وحدة التحكّم

   1. في "وحدة تحكّم Google API"، انتقِل إلى مستكشف السجلات.

      الانتقال إلى "مستكشف السجلات"

   2. استخدِم فلتر أسماء السجلات لعرض سجلات indexing.

   CLI

   للبحث عن سجلّات الفهرسة، استخدِم الأمر logging read في بيئة shell:

   gcloud logging read "logName="projects/PROJECT_ID/logs/indexing""
   

   استبدِل PROJECT_ID برقم تعريف المشروع الذي توجد فيه مجموعة المستودع.

   على سبيل المثال، لعرض الأخطاء في سجلّات indexing، شغِّل الأمر التالي:

   gcloud logging read "logName="projects/PROJECT_ID/logs/indexing" AND severity>=ERROR"
   

2. راجِع حالات الفهرسة المرتبطة، مثل ما يلي:

   • بداية فهرسة المستودع، على سبيل المثال Indexing repository REPOSITORY_NAME. Total number of repositories: 10, succeeded: 6, failed: 0.
   • نهاية فهرسة المستودع الفردي، على سبيل المثال:
     • تمّ بنجاح: Successfully finished indexing repository REPOSITORY_NAME. Total number of repositories: 10, succeeded: 7, failed: 0.
     • الإخفاق: Failed to index repository REPOSITORY_NAME. Error: [<error message>]. Total number of repositories: 10, succeeded: 7, failed: 1.
   • نهاية فهرسة المستودع، على سبيل المثال:
     • تمّ بنجاح: Finished indexing process. Repositories attempted: 10. Repositories successfully indexed: 9. Repositories unsuccessfully fetched: 0.
     • الإخفاق: Finished indexing process. Repositories attempted: 10. Repositories successfully indexed: 9. Repositories unsuccessfully fetched: 1. Repositories that were not successfully fetched will be retried in the next run.

   في حالات الفهرس، REPOSITORY_NAME هو المستودع الذي تريد مراجعته.

3. راجِع أخطاء الفهرسة المرتبطة، مثل ما يلي:

   • تعذَّر جلب المستودع.
   • تعذّر إدراج ملفات المستودع.
   • تعذّر استرداد معلومات المستودع من الفهرس.
   • تعذّر استرداد الملفات من الفهرس.
   • حدث خطأ داخلي.

استخدام تخصيص الرمز

بعد إعداد تخصيص الرموز البرمجية، ستبدأ في تلقّي اقتراحات بشأن إكمال الرموز البرمجية وإنشائها، وقد تستند هذه الاقتراحات إلى رموز برمجية خاصة سبق لك فهرسةها، بالإضافة إلى نتائج من ميزة "التعرّف على قاعدة الرموز البرمجية الكاملة".

لمزيد من المعلومات عن استخدام ميزة "تخصيص الرمز" وأفضل الممارسات، يُرجى الاطّلاع على مقالة استخدام ميزة "تخصيص الرمز".

إيقاف تخصيص الرمز

اختر أحد الخيارات التالية:

وحدة التحكّم

1. في API Console، انتقِل إلى صفحة منتجات Gemini.

   الانتقال إلى "منتجات Gemini"

   سيتم تحميل صفحة منتجات Gemini.

2. في قائمة التنقّل، انقر على تخصيص الرمز.

   يتم تحميل صفحة تخصيص الرمز.

3. لحذف الفهرس، انقر على حذف الفهرس.

   تظهر رسالة تحذير. إذا أردت المتابعة وحذف الفهرس، أدخِل اسم الفهرس، ثم انقر على حذف.

CLI

1. لعرض جميع مجموعات المستودعات للفهرس الحالي، استخدِم الأمر gemini code-repository-indexes repository-groups list في بيئة shell:

   gcloud gemini code-repository-indexes repository-groups list --location=REGION \
       --project=PROJECT_ID \
       --code-repository-index=INDEX_NAME --uri
   

   غيِّر القيم في السلسلة على الشكل التالي:

   • REGION: المنطقة التي تم ضبطها في Developer Connect في مشروعك على السحابة الإلكترونية يُرجى العِلم بأنّ الأوامر ستفشل إذا حدّدت منطقة غير متوافقة. اطّلِع على قيود تخصيص الرمز للحصول على قائمة بالمناطق المتاحة.
   • استبدِل PROJECT_ID بمعرّف مشروع Google Cloud.
   • INDEX_NAME: اسم الفهرس الذي أنشأته في خطوة سابقة لإنشاء فهرس.

2. لحذف مجموعة مستودع من الفهرس الحالي، استخدِم الأمر gemini code-repository-indexes repository-groups delete:

   gcloud gemini code-repository-indexes repository-groups delete REPOSITORY_GROUP \
       --location=REGION \
       --project=PROJECT_ID \
       --code-repository-index=INDEX_NAME
   

3. كرِّر الخطوات السابقة لكل مجموعة مستودعات إلى أن تحذف جميع مجموعات المستودعات من الفهرس.

4. اختياري: لحذف الفهرس، استخدِم الأمر gemini code-repository-indexes delete في بيئة shell:

   gcloud gemini code-repository-indexes delete INDEX_NAME \
       --location=REGION \
       --project=PROJECT_ID
   

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

• لبدء استخدام Gemini Code Assist، اتّبِع الخطوات التالية:
  • ‫VS Code وIntelliJ وبيئات تطوير JetBrains المتكاملة الأخرى المتوافقة: الترميز باستخدام Gemini Code Assist
  • ‫Cloud Shell: كتابة الرموز البرمجية باستخدام Gemini Code Assist
  • ‫Cloud Workstations: الترميز باستخدام Gemini Code Assist
• تعرَّف على كيفية استخدام تخصيص الرمز وأفضل الممارسات.
• كيفية ترميز البيانات باستخدام مفاتيح التشفير التي يديرها العميل (CMEK)
• مزيد من المعلومات عن Developer Connect
• كيف ومتى يستخدم "Gemini في Google Cloud" بياناتك؟