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

הערה: התאמה אישית של קוד ב-Gemini Code Assist זמינה רק ב-Gemini Code Assist Enterprise. מידע נוסף זמין במאמר בנושא תכונות נתמכות של Gemini Code Assist.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

המסוף

1. במסוף API, עוברים לדף Code Customization.

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

   הדף Code customization for Gemini Code Assist נטען.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

CLI

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

2. בסביבת מעטפת, מריצים את הפקודה gcloud components update כדי לוודא שעדכנתם את כל הרכיבים המותקנים של gcloud לגרסה האחרונה. בשלב הזה אפשר להתקין ולהפעיל את 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 בפרויקט Cloud.

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

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

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

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

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

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

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

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

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

   מעבר למוצרי 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 בפרויקט 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: כתיבת קוד באמצעות Gemini Code Assist
  • תחנות עבודה בענן: כתיבת קוד באמצעות Gemini Code Assist
• איך משתמשים בהתאמה אישית של קודים ומהן השיטות המומלצות.
• איך מצפינים נתונים באמצעות מפתחות הצפנה בניהול הלקוח (CMEK)
• מידע נוסף על Developer Connect
• איך Gemini for Google Cloud משתמש בנתונים שלכם, ובאילו מקרים