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

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

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

הגדרת Gemini Code Assist עם מינוי Enterprise
מוודאים שיש לכם את התפקידים הבאים בניהול הזהויות והרשאות הגישה (IAM) בפרויקט שבבעלותו המינוי:
- אדמין של אינדקסים במאגר קודים (roles/cloudaicompanion.codeRepositoryIndexesAdmin)
- Gemini for Google Cloud User (roles/cloudaicompanion.user)
ליצור או להגדיר חשבונות משתמשים. לכל מפתח בארגון שמשתמש ב-Gemini Code Assist צריך להיות זהות משתמש ב-Google Cloud עם הרשאה לגשת לפרויקט Google Cloud . מידע נוסף זמין במאמר בנושא הקצאת תפקידים במסוף. Google Cloud מוודאים שלכל משתמש יש את התפקידים הבאים:
- ‫Gemini for Google Cloud User
- משתמש בקבוצות מאגרי מידע
התכונה להתאמה אישית של קוד משתמשת ב-Developer Connect כדי לגשת למאגרים הפרטיים שלכם ולבצע בהם אינדקס. חשוב לוודא שהאזור של Developer Connect שבו נמצא החיבור למאגר של Developer Connect הוא גם מיקום נתמך להתאמה אישית של קוד. אי אפשר להשתמש בתכונה של התאמה אישית של קוד אם החיבור של Developer Connect נמצא באזור לא נתמך. רשימת האזורים הנתמכים מופיעה במאמר בנושא הגבלות על התאמה אישית של קוד.

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

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

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

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

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

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

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

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

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

המסוף

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

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

הדף Code customization for Gemini Code Assist נטען.
יוצרים אינדקס. התאמה אישית של קוד מסתמכת על אינדקס כדי לנתח ולפרש את המאגר שלכם, וכך לספק הצעות ליצירת קוד ולחיפושים מהירים יותר.
1. לוחצים על יצירה ומגדירים את פרטי האינדקס:
  - בוחרים את האזור שהוגדר ב-Developer Connect בפרויקט Google Cloud .
  - מזינים שם לאינדקס. רושמים את שם האינדקס. תצטרכו אותו בכמה שלבים במסמך הזה.
2. לוחצים על יצירה.
יצירת האינדקס נמשכת בדרך כלל 30 דקות, אבל היא עשויה להימשך עד שעה. כשהוספת האינדקס תסתיים, תקבלו הודעה במסוף. Google Cloud

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

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

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

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

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

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

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

CLI

מוודאים שהגדרתם את Developer Connect ושהתחברתם למאגר:
בסביבת מעטפת, מריצים את הפקודה gcloud components update כדי לוודא שעדכנתם את כל הרכיבים המותקנים של ה-CLI של gcloud לגרסה האחרונה. בשלב הזה אפשר להתקין ולהפעיל את ה-CLI של gcloud, או להשתמש ב-Cloud Shell Editor.
```
gcloud components update
```
יוצרים אינדקס. התאמה אישית של קוד מסתמכת על אינדקס כדי לנתח ולפרש את המאגר שלכם, וכך לספק הצעות ליצירת קוד ולחיפושים מהירים יותר.
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 מגבילה את מספר האינדקסים של מאגרי קוד לאחד לכל פרויקט וארגון.
שליטה בגישה לאינדקס באמצעות קבוצות מאגרים. קבוצת מאגרים היא קונטיינר להגדרת האינדקס, שכולל מאגרים ודפוסי הסתעפות שלהם. קבוצות מאגרי מידע מיועדות לשליטה פרטנית ב-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 כדי לראות אפשרויות נוספות, ובוחרים באפשרות העתקת נתיב המשאב.
- ‫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 זמין במאמר הצפנת נתונים באמצעות מפתחות הצפנה בניהול הלקוח.
מקצים תפקידי 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:test-user@gmail.com עבור אדם פרטי או group:admins@example.com עבור קבוצה.
  מידע נוסף זמין במאמר gcloud projects set-iam-policy.
2. כשמוצגת בקשה לציין תנאי, מזינים None.
תת-קבוצה של האינדקס
אתם יכולים ליצור כמה קבוצות מאגרי מידע ולהקצות תפקידי IAM למשתמשים שונים ב-IAM.

כדי להגדיר מדיניות IAM, צריך להכין קובץ JSON או YAML של מדיניות IAM, שיכיל רשימה של קבוצות IAM ותפקידים שהוקצו. לדוגמה:
```
  bindings:
  - members:
    - group:my-group@example.com
    - user:test-user@example.com
    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

מוודאים שהגדרתם את Developer Connect וחיברתם אותו למאגר:
יוצרים אינדקס. התאמה אישית של קוד מסתמכת על אינדקס כדי לנתח ולפרש את המאגר שלכם, וכך לספק הצעות ליצירת קוד ולחיפושים מהירים יותר.
```
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 מגבילה את מספר האינדקסים של מאגרי קוד לאחד לכל פרויקט וארגון.
שליטה בגישה לאינדקס באמצעות קבוצות מאגרים. קבוצת מאגרים היא קונטיינר להגדרת האינדוקס, שכולל מאגרים ותבניות של ענפים. קבוצות מאגרי מידע מיועדות לשליטה פרטנית ב-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 זמין במאמר הצפנת נתונים באמצעות מפתחות הצפנה בניהול הלקוח.
מקצים תפקידי 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:test-user@gmail.com עבור אדם פרטי או group:admins@example.com עבור קבוצה.
    
    מידע נוסף זמין במאמר gcloud projects set-iam-policy.
2. כשמוצגת בקשה לציין תנאי, מזינים None.
תת-קבוצה של האינדקס
אתם יכולים ליצור כמה קבוצות מאגרי מידע ולהקצות תפקידי IAM למשתמשים שונים ב-IAM.
```
  data "google_iam_policy" "foo" {
    binding {
      role = "roles/cloudaicompanion.repositoryGroupsUser"
      members = ["test-user@example.com"]
    }
  }

  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 = ["test-user@example.com"]
  }
```
מחליפים את מה שכתוב בשדות הבאים:
- ‫GROUP_NAME: השם של קבוצת המאגר שיצרתם בשלב הקודם כדי לשלוט בגישה לאינדקס באמצעות קבוצות מאגרים.

בדיקת סטטוס ההוספה לאינדקס

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

מחפשים את היומנים 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"
```
בודקים את סטטוסי ההוספה לאינדקס שמשויכים לכתובת ה-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 הוא המאגר שרוצים לבדוק.
בודקים את שגיאות האינדוקס המשויכות, כמו השגיאות הבאות:
- אחזור המאגר נכשל.
- הצגת רשימת הקבצים במאגר נכשלה.
- לא הצלחנו לאחזר מידע על המאגר מהאינדקס.
- האחזור של קבצים מהאינדקס נכשל.
- שגיאה פנימית.

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

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

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

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

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

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

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

המסוף

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

מעבר למוצרי Gemini

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

הדף Code customization (התאמה אישית של קוד) נטען.
כדי למחוק את האינדקס, לוחצים על מחיקה.

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

CLI

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

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

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

הגדרת התאמה אישית של קוד ב-Gemini Code Assist קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.

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

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

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

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

המסוף

CLI

JSON

YAML

JSON

YAML

כל האינדקס

תת-קבוצה של האינדקס

Terraform

JSON

YAML

JSON

YAML

כל האינדקס

תת-קבוצה של האינדקס

בדיקת סטטוס ההוספה לאינדקס

המסוף

CLI

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

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

המסוף

CLI

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

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