הגדרת התאמה אישית של קוד ב-Gemini Code Assist

במאמר הזה מוסבר איך להגדיר עיגון בקוד של הארגון ב-Gemini Code Assist במסוף Google Cloud , באמצעות Google Cloud CLI או באמצעות Terraform, על ידי קישור Gemini Code Assist למאגרי הקוד הפרטיים שלכם. התכונה של עיגון בקוד של הארגון ב-Gemini Code Assist מאפשרת לקבל המלצות לקוד שמבוססות על הספריות הפנימיות, ממשקי ה-API הפרטיים וסגנון התכנות של הארגון.

לפני שמתחילים

1. מגדירים את Gemini Code Assist עם מינוי Enterprise.

2. מוודאים שיש לכם את התפקידים הבאים בניהול זהויות והרשאות גישה (IAM) בפרויקט שבבעלותו המינוי:

   • אדמין של אינדקסים במאגר קודים (roles/cloudaicompanion.codeRepositoryIndexesAdmin)
   • משתמש Gemini ל-Google Cloud‏ (roles/cloudaicompanion.user)

3. ליצור או להגדיר חשבונות משתמשים. לכל מפתח בארגון שמשתמש ב-Gemini Code Assist צריך להיות משתמש ב-Google Cloud עם הרשאה לגשת לפרויקט Google Cloud . מידע נוסף זמין במאמר בנושא הקצאת תפקידים במסוף. Google Cloud מוודאים שלכל משתמש יש את התפקידים הבאים:

   • משתמש Gemini ל-Google Cloud
   • משתמש בקבוצות מאגרי מידע

4. התכונה עיגון בקוד של הארגון משתמשת ב-Developer Connect כדי לגשת למאגרים הפרטיים שלכם ולהוסיף אותם לאינדקס. חשוב לוודא שהאזור של Developer Connect שבו נמצא החיבור למאגר של Developer Connect הוא גם מיקום נתמך לעיגון בקוד של הארגון. אי אפשר להשתמש בתכונה של עיגון בקוד של הארגון אם החיבור של Developer Connect נמצא באזור לא נתמך. רשימת האזורים הנתמכים מופיעה במאמר בנושא הגבלות על עיגון בקוד של הארגון.

בחירת המאגרים שיעברו אינדוקס

מומלץ ליצור אינדקס למאגרי מידע עם המאפיינים הבאים:

• קוד בסגנון או במבנה דומים למה שאתם רוצים שהמפתחים שלכם יכתבו.
• ספריות פרטיות או ממשקי API שרוצים להפעיל מבסיס הקוד הנוכחי.

אופציונלי: בוחרים אילו קבצים לא ייכללו באינדקס

כברירת מחדל, עיגון בקוד של הארגון יוצר אינדקס של כל קבצי הקוד הנתמכים במאגרים שציינתם.

כדי למנוע חשיפה של קוד שאתם לא רוצים לאנדקס, אתם יכולים להשתמש בתבניות של ענפים כדי לשלוט בגישה לאינדקס ולהשתמש בענף יציב, כמו main.

אפשר גם להחריג קבצים מהאינדקס על ידי יצירת קובץ .aiexclude.

הגדרת עיגון בקוד של הארגון ב-Gemini Code Assist

בוחרים באחת מהאפשרויות הבאות:

המסוף

1. נכנסים לדף Code Customization במסוף Google Cloud .

   מעבר לעיגון בקוד של הארגון ב-Gemini Code Assist

   הדף עיגון בקוד של הארגון עבור Gemini Code Assist נטען.

2. יוצרים אינדקס. עיגון בקוד של הארגון מסתמך על אינדקס כדי לנתח ולפרסס את המאגר שלכם, וכך להציע הצעות ליצירת קוד ולבצע חיפושים מהר יותר.

   1. לוחצים על יצירה ומגדירים את פרטי האינדקס:

      • בוחרים את האזור שהוגדר ב-Developer Connect בפרויקט Google Cloud .
      • מזינים שם לאינדקס. רושמים את שם האינדקס. תצטרכו אותו בכמה שלבים במסמך הזה.

   2. לוחצים על יצירה.

   יצירת האינדקס נמשכת בדרך כלל 30 דקות, אבל היא עשויה להימשך עד שעה. כשהוספת האינדקס תסתיים, תקבלו הודעה במסוף Google Cloud .

   ‫Google מגבילה את מספר האינדקסים של מאגרי המקורות של הקוד לאחד לכל פרויקט וארגון.

3. שליטה בגישה לאינדקס באמצעות קבוצות מאגרים.

   קבוצת מאגרים היא מאגר להגדרת האינדקס, שכולל מאגרים ודפוסי הסתעפות שלהם. קבוצות מאגרי מידע מיועדות לשליטה פרטנית ב-IAM, ומאפשרות למפתחים לגשת לנתונים המאונדקסים מהקבוצות האלה, אם יש להם הרשאת cloudaicompanion.repositoryGroups.use.

   קבוצות מאגרים מכילות מאגרי Developer Connect או קישורים מאותו פרויקט ומאותו מיקום.

4. בדף עיגון בקוד של הארגון ל-Gemini Code Assist, לוחצים על Add repositories (הוספת מאגרי מידע) ואז על Add source repositories (הוספת מאגרי מידע של מקורות).

   מוצגת רשימה של מאגרי מידע קיימים ב-Developer Connect באזור שהגדרתם בשלב הקודם ליצירת האינדקס.

   אם צריך להוסיף מאגרים חדשים לקבוצת המאגרים, לוחצים על Link repository ופועלים לפי השלבים במסוף Google Cloud .

   בנוסף, אתם יכולים לבחור מאגר אחד או יותר ואז לערוך אותם כדי להוסיף ענף חדש.

5. בוחרים את קבוצת המאגרים שאליה רוצים להוסיף מאגרים חדשים. לחלופין, לוחצים על יצירת קבוצת מאגרים חדשה כדי ליצור ולהגדיר קבוצת מאגרים חדשה.

6. כדי להתחיל ליצור אינדקס למאגרים שנבחרו, לוחצים על יצירת אינדקס.

   זמן היצירה של האינדקס משתנה בהתאם לגודל המאגרים.

CLI

1. מוודאים שהגדרתם את Developer Connect ושהתחברתם למאגר:
   • GitHub.com
   • GitLab.com
   • Bitbucket.org

2. בסביבת מעטפת, מריצים את הפקודה gcloud components update כדי לוודא שעדכנתם את כל הרכיבים המותקנים של ה-CLI של gcloud לגרסה העדכנית. בשלב הזה אפשר להתקין ולהפעיל את ה-CLI של gcloud, או להשתמש ב-Cloud Shell Editor.

   gcloud components update
   

3. יוצרים אינדקס. עיגון בקוד של הארגון מסתמך על אינדקס כדי לנתח ולפרסס את המאגר שלכם, וכך להציע הצעות ליצירת קוד ולבצע חיפושים מהר יותר.

   1. כדי ליצור את האינדקס, בסביבת מעטפת, משתמשים בפקודה gemini code-repository-indexes create:

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

      מחליפים את מה שכתוב בשדות הבאים:

      • ‫INDEX_NAME: שם האינדקס. חשוב: שימו לב לשם האינדקס. תצטרכו אותו בכמה שלבים במאמר הזה.
      • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
      • ‫REGION: האזור שמוגדר ב-Developer Connect בפרויקט Google Cloud . כדי שהפקודות יפעלו, צריך לציין אזור נתמך.

      יצירת האינדקס נמשכת בדרך כלל 30 דקות, אבל היא עשויה להימשך עד שעה.

      ‫Google מגבילה את מספר האינדקסים של מאגרי המקורות של הקוד לאחד לכל פרויקט וארגון.

4. שליטה בגישה לאינדקס באמצעות קבוצות מאגרים. קבוצת מאגרים היא קונטיינר להגדרת האינדקס, שכולל מאגרים ודפוסי הסתעפות שלהם. קבוצות מאגרי מידע מיועדות לשליטה פרטנית ב-IAM, ומאפשרות למפתחים גישה לנתונים המאונדקסים מהקבוצות האלה, אם יש להם הרשאת cloudaicompanion.repositoryGroups.use.

   קבוצות מאגרים מכילות מאגרים של Developer Connect או קישורים מאותו פרויקט ומאותו מיקום.

   אדמינים מבצעים את הפעולות הבאות:

   • יוצרים את משאב האינדקס של מאגר הקוד.
   • באותו פרויקט ובאותו מיקום, מגדירים חיבור חדש של Developer Connect.
   • לקשר מאגרי Git בחיבור.
   • מקבלים את שמות המשאבים של הקישורים, בוחרים תבנית של ענף לאינדקס לכל קישור ומציבים אותה בקבוצת מאגר אחת או יותר.

   כדי ליצור קבוצת מאגרים, משתמשים בפקודה gemini code-repository-indexes repository-groups create בסביבת מעטפת:

   ‫

   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 repositories במסוף, ובכרטיסייה Repositories מחפשים את מזהה החיבור בעמודה Connection בטבלה. Google Cloud כדי להעתיק את שם המשאב, לוחצים על התפריט more_vert כדי לראות אפשרויות נוספות, ובוחרים באפשרות Copy resource path (העתקת נתיב המשאב).
   • ‫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) דרך Cloud Key Management Service. מידע נוסף על שימוש ב-CMEK זמין במאמר בנושא הצפנת נתונים באמצעות מפתחות הצפנה בניהול הלקוח.

5. מקצים תפקידי IAM לקבוצת המאגר בפרויקט.

   אתם מקבלים הצעות רק ממאגרי מידע שנמצאים באינדקס. כל מאגר שייך לקבוצת מאגרים אחת או יותר. כדי לגשת להצעות, צריך להקצות לקבוצת המאגרים את תפקיד ה-IAM 'משתמש במאגרי Cloud AI Companion' (roles/cloudaicompanion.repositoryGroupsUser), שכולל את הרשאת ה-IAM הנדרשת cloudaicompanion.repositoryGroups.user. אפשר לעשות זאת באחת מהדרכים הבאות:

   • נותנים לחשבונות משתמש הרשאה לגשת לאינדקס כולו.

   • הענקת גישה לישויות מרכזיות לקבוצת משנה של האינדקס.

   כל האינדקס

   1. כדי לקשר מדיניות IAM לפרויקט, משתמשים בפקודה projects add-iam-policy-binding בסביבת מעטפת:

      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.

   כדי להגדיר מדיניות IAM, צריך להכין קובץ JSON או YAML של מדיניות IAM, שיכיל רשימה של קבוצות IAM ותפקידים שהוקצו להן. לדוגמה:

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

   פרטים נוספים ותחביר מופיעים במאמר הסבר על מדיניות ההרשאות.

   הערה: אפשר להקצות תפקידים בהתאמה אישית לקבוצות IAM, אבל התפקיד בהתאמה אישית חייב לכלול את כל ההרשאות של התפקיד roles/cloudaicompanion.repositoryGroupsUser.

   כדי להגדיר את מדיניות ה-IAM, משתמשים בgemini code-repository-indexes repository-groups set-iam-policy בסביבת מעטפת:

     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: מדיניות ה-IAM.

     מידע נוסף זמין במאמר 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 בפרויקט Google Cloud . כדי שהפקודות יפעלו, צריך לציין אזור נתמך.

   יצירת האינדקס נמשכת בדרך כלל 30 דקות, אבל היא עשויה להימשך עד שעה.

   ‫Google מגבילה את מספר האינדקסים של מאגרי המקורות של הקוד לאחד לכל פרויקט וארגון.

3. שליטה בגישה לאינדקס באמצעות קבוצות מאגרים. קבוצת מאגרים היא קונטיינר להגדרת האינדוקס, שכולל מאגרים ודפוסי הסתעפות שלהם. קבוצות מאגרי מידע מיועדות לשליטה פרטנית ב-IAM, ומאפשרות למפתחים גישה לנתונים המאונדקסים מהקבוצות האלה, אם יש להם הרשאת cloudaicompanion.repositoryGroups.use.

   קבוצות מאגרים מכילות מאגרי Developer Connect או קישורים מאותו פרויקט ומאותו מיקום.

   אדמינים מבצעים את הפעולות הבאות:

   • יוצרים את המשאב Repository Index.
   • באותו פרויקט ובאותו מיקום, מגדירים חיבור חדש של 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 repositories במסוף, ובכרטיסייה Repositories מחפשים את מזהה החיבור בעמודה Connection בטבלה. Google Cloud כדי להעתיק את שם המשאב, לוחצים על התפריט 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) דרך Cloud Key Management Service. מידע נוסף על שימוש ב-CMEK זמין במאמר בנושא הצפנת נתונים באמצעות מפתחות הצפנה בניהול הלקוח.

4. מקצים תפקידי IAM לקבוצת המאגר בפרויקט.

   אתם מקבלים הצעות רק ממאגרי מידע שנמצאים באינדקס. כל מאגר שייך לקבוצת מאגרים אחת או יותר. כדי לגשת להצעות, צריך להקצות לקבוצת המאגרים את תפקיד ה-IAM 'משתמש במאגרי Cloud AI Companion' (roles/cloudaicompanion.repositoryGroupsUser), שכולל את הרשאת ה-IAM הנדרשת cloudaicompanion.repositoryGroups.user. אפשר לעשות זאת באחת מהדרכים הבאות:

   • נותנים לחשבונות משתמש הרשאה לגשת לאינדקס כולו.

   • הענקת גישה לישויות מרכזיות לקבוצת משנה של האינדקס.

   כל האינדקס

   1. כדי לקשר מדיניות IAM לפרויקט, משתמשים בפקודה projects add-iam-policy-binding בסביבת מעטפת:

      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 Cloud , נכנסים אל Logs Explorer.

      כניסה לדף Logs Explorer

   2. אפשר להשתמש במסנן של שמות היומנים כדי להציג יומנים של indexing.

   CLI

   כדי לחפש ביומני האינדוקס, משתמשים בפקודה logging read בסביבת מעטפת:

   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. בודקים את סטטוסי ההוספה לאינדקס שמשויכים לכתובת ה-URL, למשל:

   • תחילת יצירת האינדקס של המאגר – לדוגמה, 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. בודקים את שגיאות האינדוקס המשויכות, כמו השגיאות הבאות:

   • אחזור המאגר נכשל.
   • הצגת הקבצים במאגר נכשלה.
   • לא ניתן לאחזר מידע על המאגר מהאינדקס.
   • האחזור של הקבצים מהאינדקס נכשל.
   • שגיאה פנימית.

שימוש בהתאמה אישית של הקוד

אחרי שמגדירים עיגון בקוד של הארגון, מתחילות להופיע הצעות להשלמת קוד וליצירת קוד, שיכולות להתבסס על קוד פרטי שבוצע בו אינדוקס, בנוסף לתוצאות שמגיעות מהבנה מלאה של בסיס קוד.

מפתחים שנוספו לקבוצת המאגר שבה לפחות משאב אחד עבר אינדוקס יקבלו הודעה בסביבת הפיתוח המשולבת שלהם על כך שהופעל עיגון בקוד של הארגון. כדי לראות את סטטוס עיגון בקוד של הארגון, מפתחים יכולים ללחוץ על הסמל spark Gemini בפינה השמאלית התחתונה ולחפש את אחד מסטטוסי עיגון בקוד של הארגון בסרגל החיפוש:

• הכול מוכן. עיגון בקוד של הארגון מופעל ומוגדר.
• לא זמין. למפתח אין גישה לקבוצת המאגר או שקבוצת המאגר שלמשתמש יש גישה אליה ריקה.
• Unset. האדמין לא הפעיל או לא הגדיר את עיגון בקוד של הארגון.

מידע נוסף על שימוש בעיגון בקוד של הארגון ושיטות מומלצות זמין במאמר שימוש בעיגון בקוד של הארגון.

השבתת התאמה אישית של קוד

בוחרים באחת מהאפשרויות הבאות:

המסוף

1. נכנסים לדף Gemini Products במסוף Google Cloud .

   מעבר למוצרי Gemini

   הדף מוצרי Gemini נטען.

2. בתפריט הניווט, לוחצים על Code customization (עיגון בקוד של הארגון).

   הדף Code customization (עיגון בקוד של הארגון) נטען.

3. כדי למחוק את האינדקס, לוחצים על מחיקה.

   מוצגת הודעת אזהרה. אם רוצים להמשיך ולמחוק את האינדקס, מזינים את שם האינדקס ולוחצים על מחיקה.

CLI

1. כדי לראות את כל קבוצות המאגרים באינדקס הנוכחי, משתמשים בפקודה gemini code-repository-indexes repository-groups list בסביבת מעטפת:

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

   מחליפים את מה שכתוב בשדות הבאים:

   • ‫REGION: האזור שמוגדר ב-Developer Connect בפרויקט Google Cloud . כדי שהפקודות יפעלו, צריך לציין אזור נתמך.
   • ‫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:

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

המאמרים הבאים

• כדי להתחיל להשתמש ב-Gemini Code Assist:
  • ‫VS Code,‏ IntelliJ וסביבות פיתוח משולבות (IDE) אחרות של JetBrains שנתמכות: תכנות באמצעות Gemini Code Assist
  • Cloud Shell Editor: כתיבת קוד באמצעות Gemini Code Assist
  • ‫Cloud Workstations: Code with Gemini Code Assist
• איך משתמשים בהתאמה אישית של קודים ושיטות מומלצות
• איך מצפינים נתונים באמצעות מפתחות הצפנה בניהול הלקוח (CMEK)
• מידע נוסף על Developer Connect
• איך Gemini for Google Cloud ‎ משתמש בנתונים שלכם, ובאילו מקרים