กำหนดค่าการปรับแต่งโค้ดของ Gemini Code Assist

หมายเหตุ: การปรับแต่งโค้ด Gemini Code Assist พร้อมให้บริการใน Gemini Code Assist Enterprise เท่านั้น ดูข้อมูลเพิ่มเติมได้ที่ ฟีเจอร์ที่ Gemini Code Assist รองรับ

เอกสารนี้อธิบายวิธีตั้งค่าการปรับแต่งโค้ดของ Gemini Code Assist ใน API Console, Google Cloud CLI หรือ Terraform โดยเชื่อมต่อ Gemini Code Assist กับที่เก็บโค้ดส่วนตัว ฟีเจอร์การปรับแต่งโค้ดของ Gemini Code Assist ช่วยให้คุณได้รับคำแนะนำโค้ดที่ดึงมาจากไลบรารีภายใน API ส่วนตัว และรูปแบบการเขียนโค้ดขององค์กร

ก่อนเริ่มต้น

1. ตั้งค่า Gemini Code Assist ด้วยการสมัครใช้บริการ Enterprise

2. ตรวจสอบว่าคุณมีบทบาท Identity and Access Management ต่อไปนี้ในโปรเจ็กต์ที่เป็นเจ้าของ การสมัครใช้บริการ

   • ผู้ดูแลดัชนีที่เก็บโค้ด (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 อยู่ ในภูมิภาคที่ไม่รองรับ ดูรายชื่อภูมิภาคที่รองรับได้ที่ ข้อจำกัดในการปรับแต่งโค้ด

เลือกที่เก็บที่จะจัดทำดัชนี

แนวทางปฏิบัติแนะนำคือคุณควรจัดทำดัชนีที่เก็บที่มีลักษณะต่อไปนี้

• โค้ดที่มีรูปแบบหรือโครงสร้างคล้ายกับโค้ดที่คุณต้องการให้นักพัฒนาแอปเขียน
• ไลบรารีหรือ API ส่วนตัวที่ต้องการเรียกใช้จากโค้ดเบสปัจจุบัน

ไม่บังคับ: เลือกไฟล์ที่จะไม่จัดทำดัชนี

โดยค่าเริ่มต้น การปรับแต่งโค้ดจะจัดทำดัชนีไฟล์โค้ดที่รองรับ ทั้งหมดในที่เก็บที่ระบุ

หากไม่ต้องการให้โค้ดที่คุณไม่ต้องการจัดทำดัชนีปรากฏ คุณสามารถใช้รูปแบบสาขาเพื่อควบคุมการเข้าถึงดัชนีและใช้สาขาที่เสถียร เช่น main

หรือคุณจะยกเว้นไฟล์จากดัชนีโดย สร้างไฟล์ .aiexclude ก็ได้

กำหนดค่าการปรับแต่งโค้ดของ Gemini Code Assist

โปรดเลือกจากตัวเลือกต่อไปนี้

คอนโซล

1. ไปที่หน้าการปรับแต่งโค้ดใน API Console

   ไปที่การปรับแต่งโค้ดสำหรับ Gemini Code Assist

   หน้าการปรับแต่งโค้ดสำหรับ Gemini Code Assist จะโหลดขึ้น

2. สร้างดัชนี การปรับแต่งโค้ดอาศัยดัชนีในการวิเคราะห์และแยกวิเคราะห์ ที่เก็บของคุณเพื่อให้คำแนะนำในการสร้างโค้ดและการค้นหาที่เร็วขึ้น

   1. คลิกสร้างและกำหนดค่ารายละเอียดดัชนี

      • เลือกภูมิภาคที่กำหนดค่าไว้ใน Developer Connect ในโปรเจ็กต์ Cloud
      • ป้อนชื่อดัชนี จดชื่อดัชนี คุณต้องใช้ ในหลายขั้นตอนของเอกสารนี้

   2. คลิกสร้าง

   โดยทั่วไปการสร้างดัชนีจะใช้เวลา 30 นาที แต่บางครั้งอาจใช้เวลาถึง 1 ชั่วโมง เมื่อจัดทำดัชนีเสร็จสมบูรณ์ คุณจะได้รับการแจ้งเตือนในคอนโซล Google API

   Google จำกัดจำนวนดัชนีที่เก็บโค้ดไว้ที่ 1 รายการสำหรับแต่ละโปรเจ็กต์และองค์กร

3. ควบคุมการเข้าถึงดัชนีโดยใช้กลุ่มที่เก็บ

   กลุ่มที่เก็บคือคอนเทนเนอร์สำหรับการกำหนดค่าการจัดทำดัชนี ซึ่งรวมถึงที่เก็บและรูปแบบสาขาของที่เก็บ กลุ่มที่เก็บได้รับการออกแบบมาเพื่อการควบคุม IAM แบบละเอียด ซึ่งจะให้สิทธิ์นักพัฒนาแอปเข้าถึงข้อมูลที่จัดทำดัชนีจากกลุ่มเหล่านั้น โดยนักพัฒนาแอปต้องมีcloudaicompanion.repositoryGroups.useสิทธิ์

   กลุ่มที่เก็บมีที่เก็บ Developer Connect หรือลิงก์จากโปรเจ็กต์และตำแหน่งเดียวกัน

4. ในหน้าการปรับแต่งโค้ดสำหรับ Gemini Code Assist ให้คลิก เพิ่มที่เก็บ แล้วเลือกเพิ่มที่เก็บแหล่งที่มา

   รายการจะแสดงที่เก็บที่มีอยู่ใน Developer Connect สำหรับ ภูมิภาคที่คุณกำหนดค่าในขั้นตอนก่อนหน้าเพื่อสร้างดัชนี

   หากต้องการเพิ่มที่เก็บใหม่ลงในกลุ่มที่เก็บ ให้คลิกลิงก์ที่เก็บ แล้วทำตามขั้นตอนในคอนโซล Google API

   นอกจากนี้ คุณยังเลือกและแก้ไขที่เก็บอย่างน้อย 1 รายการเพื่อเพิ่ม สาขาใหม่ได้ด้วย

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 นาที แต่บางครั้งอาจใช้เวลาถึง 1 ชั่วโมง

      Google จำกัดจำนวนดัชนีที่เก็บโค้ดไว้ที่ 1 รายการสำหรับแต่ละโปรเจ็กต์และองค์กร

4. ควบคุมการเข้าถึงดัชนีโดยใช้กลุ่มที่เก็บ กลุ่มที่เก็บเป็นคอนเทนเนอร์สำหรับการกำหนดค่าการจัดทำดัชนี ซึ่งรวมถึงที่เก็บและรูปแบบสาขาของที่เก็บ กลุ่มที่เก็บได้รับการออกแบบมาเพื่อการควบคุม IAM แบบละเอียด ซึ่งจะช่วยให้นักพัฒนาซอฟต์แวร์เข้าถึงข้อมูลที่จัดทำดัชนี จากกลุ่มเหล่านั้นได้เมื่อมีสิทธิ์ cloudaicompanion.repositoryGroups.use

   กลุ่มที่เก็บมีที่เก็บ Developer Connect หรือลิงก์จากโปรเจ็กต์และตำแหน่งเดียวกัน

   ผู้ดูแลระบบจะดำเนินการต่อไปนี้

   • สร้างทรัพยากรดัชนีที่เก็บโค้ด
   • กำหนดค่าการเชื่อมต่อ Developer Connect ใหม่ในโปรเจ็กต์และตำแหน่งเดียวกัน
   • ลิงก์ที่เก็บ Git ในการเชื่อมต่อ
   • รับชื่อทรัพยากรของลิงก์ เลือกรูปแบบสาขาที่จะจัดทำดัชนีสำหรับแต่ละลิงก์ และวางไว้ในกลุ่มที่เก็บอย่างน้อย 1 กลุ่ม

   หากต้องการสร้างกลุ่มที่เก็บ ให้ใช้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 ใน 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

   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 ให้กับกลุ่มที่เก็บในโปรเจ็กต์

   คุณจะได้รับคำแนะนำจากที่เก็บในดัชนีเท่านั้น แต่ละ ที่เก็บจะเป็นของกลุ่มที่เก็บอย่างน้อย 1 กลุ่ม หากต้องการเข้าถึงคำแนะนำ คุณต้องให้บทบาท IAM ของผู้ใช้กลุ่มที่เก็บข้อมูล Cloud AI Companion (roles/cloudaicompanion.repositoryGroupsUser) ซึ่งมีสิทธิ์ cloudaicompanion.repositoryGroups.user IAM ที่จำเป็นแก่กลุ่มที่เก็บข้อมูลด้วยวิธีใดวิธีหนึ่งต่อไปนี้

   • ให้สิทธิ์หลักในการเข้าถึงดัชนีทั้งหมด

   • ให้สิทธิ์เข้าถึงส่วนย่อยของดัชนีแก่ผู้ใช้หลัก

   ดัชนีทั้งหมด

   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 นาที แต่บางครั้งอาจใช้เวลาถึง 1 ชั่วโมง

   Google จำกัดจำนวนดัชนีที่เก็บโค้ดไว้ที่ 1 รายการสำหรับแต่ละโปรเจ็กต์และองค์กร

3. ควบคุมการเข้าถึงดัชนีโดยใช้กลุ่มที่เก็บ กลุ่มที่เก็บ คือคอนเทนเนอร์สำหรับการกำหนดค่าการจัดทำดัชนี ซึ่งรวมถึงที่เก็บ และรูปแบบสาขาของที่เก็บ กลุ่มที่เก็บได้รับการออกแบบมาเพื่อการควบคุม IAM แบบละเอียด ซึ่งจะช่วยให้นักพัฒนาซอฟต์แวร์เข้าถึงข้อมูลที่จัดทำดัชนี จากกลุ่มเหล่านั้นได้เมื่อมีสิทธิ์ cloudaicompanion.repositoryGroups.use

   กลุ่มที่เก็บมีที่เก็บ Developer Connect หรือลิงก์จากโปรเจ็กต์และตำแหน่งเดียวกัน

   ผู้ดูแลระบบจะดำเนินการต่อไปนี้

   • สร้างทรัพยากรดัชนีที่เก็บโค้ด
   • กำหนดค่าการเชื่อมต่อ Developer Connect ใหม่ในโปรเจ็กต์และตำแหน่งเดียวกัน
   • ลิงก์ที่เก็บ Git ในการเชื่อมต่อ
   • รับชื่อทรัพยากรของลิงก์ เลือกรูปแบบสาขาที่จะจัดทำดัชนีสำหรับแต่ละลิงก์ และวางไว้ในกลุ่มที่เก็บอย่างน้อย 1 กลุ่ม

   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

   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 ให้กับกลุ่มที่เก็บในโปรเจ็กต์

   คุณจะได้รับคำแนะนำจากที่เก็บในดัชนีเท่านั้น แต่ละ ที่เก็บจะเป็นของกลุ่มที่เก็บอย่างน้อย 1 กลุ่ม หากต้องการเข้าถึงคำแนะนำ คุณต้องให้บทบาท IAM ของผู้ใช้กลุ่มที่เก็บข้อมูล Cloud AI Companion (roles/cloudaicompanion.repositoryGroupsUser) ซึ่งมีสิทธิ์ cloudaicompanion.repositoryGroups.user IAM ที่จำเป็นแก่กลุ่มที่เก็บข้อมูลด้วยวิธีใดวิธีหนึ่งต่อไปนี้

   • ให้สิทธิ์หลักในการเข้าถึงดัชนีทั้งหมด

   • ให้สิทธิ์เข้าถึงส่วนย่อยของดัชนีแก่ผู้ใช้หลัก

   ดัชนีทั้งหมด

   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. ไปที่Logs Explorer ในคอนโซล Google API

      ไปที่เครื่องมือสำรวจบันทึก

   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 Console ให้ไปที่หน้าผลิตภัณฑ์ Gemini

   ไปที่ผลิตภัณฑ์ Gemini

   หน้าผลิตภัณฑ์ Gemini จะโหลดขึ้นมา

2. ในเมนูการนำทาง ให้คลิกการปรับแต่งโค้ด

   ระบบจะโหลดหน้าการปรับแต่งโค้ด

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
  • Cloud Workstations: เขียนโค้ดด้วย Gemini Code Assist
• ดูวิธีใช้การปรับแต่งโค้ด และแนวทางปฏิบัติแนะนำ
• ดูวิธีเข้ารหัสข้อมูลด้วยคีย์การเข้ารหัสที่จัดการโดยลูกค้า (CMEK)
• ดูข้อมูลเพิ่มเติมเกี่ยวกับ Developer Connect
• ดูวิธีและเวลาที่ Gemini สำหรับ Google Cloud ใช้ข้อมูลของคุณ