กำหนดค่าการบันทึกของ Gemini Code Assist แบบมาตรฐานและ Enterprise

เอกสารนี้อธิบายวิธีกำหนดค่าการบันทึกมาตรฐานและระดับองค์กรของ Gemini Code Assist สำหรับโปรเจ็กต์โดยใช้ Google API Console หรือ API

ข้อจำกัด

การบันทึกข้อมูลบันทึกของ Gemini Standard และ Enterprise ใน Google Cloud จะจำกัดไว้ที่การโต้ตอบของผู้ใช้กับ Gemini Code Assist ภายใน IDE

นอกจากนี้ Gemini สำหรับ Google Cloud จะไม่บันทึกข้อมูลสำหรับ Gemini Code Assist Standard และ Enterprise หากผู้ใช้ปิดการวัดและส่งข้อมูลของ VS Code

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

ตรวจสอบว่าโปรเจ็กต์ Google Cloud เชื่อมต่อกับบัญชีสำหรับการเรียกเก็บเงิน

(ไม่บังคับ) ให้สิทธิ์ IAM

หากต้องการกำหนดค่าการบันทึก Gemini Code Assist Standard และ Enterprise คุณต้องมีสิทธิ์ Identity and Access Management ที่เฉพาะเจาะจง ซึ่งมี รายละเอียดอยู่ในส่วนต่อไปนี้ ตรวจสอบว่าได้เพิ่มสิทธิ์เหล่านี้ลงในบทบาท IAM ที่กำหนดเองแล้ว

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

กำหนดค่าการบันทึก Gemini Code Assist

ส่วนต่อไปนี้จะแสดงขั้นตอนที่จำเป็นในการเปิดใช้การรวบรวมและ จัดเก็บกิจกรรม Gemini Code Assist Standard และ Enterprise ใน Cloud Logging ซึ่งรวมถึง

• พรอมต์และการตอบกลับของ Gemini Code Assist Standard และ Enterprise บันทึก เช่น ข้อมูลที่ผู้ใช้ป้อน ข้อมูลตามบริบท และคำตอบ

• บันทึกข้อมูลเมตาของ Gemini Code Assist Standard และ Enterprise เช่น ข้อมูลเมตาการวัดและบันทึกข้อมูล และบรรทัดของโค้ดที่ผู้ใช้ยอมรับ

ดูรายละเอียดเพิ่มเติมเกี่ยวกับบันทึกทั้ง 2 ประเภทได้ที่ ดูบันทึกของ Gemini

เปิดใช้การบันทึกสำหรับ Gemini Code Assist

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

คอนโซล

1. ยืนยันว่าคุณได้เปิดใช้ Cloud Logging API ในโปรเจ็กต์แล้ว

2. ตรวจสอบว่าคุณมีสิทธิ์การจัดการข้อมูลประจำตัวและการเข้าถึง (IAM) ต่อไปนี้ในโปรเจ็กต์ที่เป็นเจ้าของการสมัครใช้บริการ

   • instance.queryEffectiveSetting
   • instance.queryEffectiveSettingBindings
   • loggingSettings.create
   • loggingSettings.list
   • loggingSettings.update
   • loggingSettings.get
   • cloudaicompanion.instances.loggingSettings.use
   • cloudaicompanion.instances.queryEffectiveSetting
   • settingBindings.loggingSettingsList
   • settingBindings.loggingSettingsGet
   • settingBindings.loggingSettingsUpdate
   • settingBindings.loggingSettingsCreate
   • cloudaicompanion.settingBindings.loggingSettingsUse
   • cloudaicompanion.instances.queryEffectiveSettingBindings

3. ใน API Console ให้ไปที่หน้าผู้ดูแลระบบสำหรับ Gemini

   ไปที่ Gemini สำหรับ Google Cloud

   หน้า Gemini สำหรับ Google Cloud จะโหลดขึ้น

4. คลิกการตั้งค่าในเมนูการนำทางด้านซ้าย

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

5. (ไม่บังคับ) คลิกการบันทึกข้อมูลเมตาสำหรับ Code Assist เพื่อบันทึก ข้อมูลเมตาที่ผู้ใช้ Gemini Code Assist Standard และ Enterprise สร้างขึ้นในโปรเจ็กต์

6. (ไม่บังคับ) คลิกการบันทึกพรอมต์และคำตอบของ Code Assist เพื่อ บันทึกพรอมต์และคำตอบที่ผู้ใช้ Gemini Code Assist Standard และ Enterprise สร้างขึ้นใน โปรเจ็กต์

7. คลิกบันทึกการเปลี่ยนแปลง

API

หากต้องการเปิดใช้การบันทึกสำหรับ Gemini Code Assist Standard และ Enterprise ให้ใช้ทรัพยากร loggingSettings เพื่อกำหนดการตั้งค่าการบันทึก ที่คุณต้องการ และใช้ทรัพยากร loggingSettings.settingBindings เพื่อ เชื่อมโยงการตั้งค่ากับโปรเจ็กต์

1. ตรวจสอบว่าคุณได้เปิดใช้ API Cloud Logging ใน โปรเจ็กต์แล้ว

2. ตรวจสอบว่าคุณมีสิทธิ์การจัดการข้อมูลประจำตัวและการเข้าถึง (IAM) ต่อไปนี้ในโปรเจ็กต์ที่เป็นเจ้าของการสมัครใช้บริการ

   • instance.queryEffectiveSetting
   • instance.queryEffectiveSettingBindings
   • loggingSettings.create
   • loggingSettings.list
   • loggingSettings.update
   • loggingSettings.get
   • cloudaicompanion.instances.loggingSettings.use
   • cloudaicompanion.instances.queryEffectiveSetting
   • settingBindings.loggingSettingsList
   • settingBindings.loggingSettingsGet
   • settingBindings.loggingSettingsUpdate
   • settingBindings.loggingSettingsCreate
   • cloudaicompanion.settingBindings.loggingSettingsUse
   • cloudaicompanion.instances.queryEffectiveSettingBindings

3. สร้างการตั้งค่าและค่าเฉพาะการตั้งค่า

   1. รับโทเค็น

      TOKEN=$(gcloud auth print-access-token)
      

4. เปิดใช้บันทึก Gemini Code Assist แบบมาตรฐานและ Enterprise ระบบจะเปิดใช้บันทึกของผู้ใช้และบันทึกข้อมูลเมตาด้วยฟิลด์ log_prompts_and_responses และ log_metadata ตามลำดับ หากไม่ต้องการเปิดใช้ช่องใดช่องหนึ่ง ให้ยกเว้นช่องนั้นจากคำขอ

   1. เรียกใช้คำสั่งต่อไปนี้เพื่อสร้างการตั้งค่า

      curl -X POST \
        -H "Authorization: Bearer $TOKEN" \
        -H 'Content-Type: application/json' \
        -d '{
          "log_prompts_and_responses": true,
          "log_metadata": true,
          } ' \
        "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/loggingSettings?logging_setting_id=LOGS_SETTING_ID"
      

      แทนที่ค่าต่อไปนี้

      • CONTAINER_PROJECT_NAME: ป้อนรหัสโปรเจ็กต์ ของโปรเจ็กต์ที่จัดเก็บทรัพยากรการเชื่อมโยง นี่คือ โปรเจ็กต์หลักของการเชื่อมโยง
      • LOGS_SETTING_ID: ป้อนชื่อการตั้งค่าที่ไม่ซ้ำกัน เช่น gcalm

      หากคำสั่งสำเร็จ ระบบจะแสดงเนื้อหาการตอบกลับที่แสดง log_prompts_and_responses และ log_metadata ซึ่งตั้งค่าเป็น true

      {
        "name": "projects/CONTAINER_PROJECT_NAME/locations/global/loggingSettings/LOGS_SETTING_ID",
        "createTime": "2025-01-23T15:22:49.717166932Z",
        "updateTime": "2025-01-23T15:22:49.717166932Z",
        "log_prompts_and_responses": true,
        "log_metadata": true
      }
      

   2. เรียกใช้คำสั่งต่อไปนี้เพื่อสร้างการเชื่อมโยงการตั้งค่า บันทึกมาตรฐานและบันทึกระดับองค์กรของ Gemini Code Assist

      curl -X POST \
        -H "Authorization: Bearer $TOKEN" \
        -H 'Content-Type: application/json' \
        -d '{
          "target": "projects/TARGET_PROJECT_NAME"
          }' \
        "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/loggingSettings/LOGS_SETTING_ID/settingBindings?setting_binding_id=LOGS_BINDING_ID"
      

   แทนที่ค่าต่อไปนี้

   • TARGET_PROJECT_NAME: ป้อนโปรเจ็กต์เป้าหมายที่จะ ผูกการเชื่อมโยง ซึ่งมักจะเหมือนกับโปรเจ็กต์คอนเทนเนอร์ อย่างไรก็ตาม คุณสามารถเชื่อมโยงการตั้งค่ากับโปรเจ็กต์หลายรายการได้ เพื่อไม่ให้ต้องทำซ้ำทรัพยากรการตั้งค่า
   • LOGS_BINDING_ID: ใช้ LOGS_SETTING_ID เดียวกันเมื่อ คุณสร้างการตั้งค่า แต่ต่อท้ายด้วย b1 เช่น ใช้ gcalmb1

   หากคำสั่งสำเร็จ ระบบจะแสดงข้อมูลเมตาของการดำเนินการในรูปแบบต่อไปนี้

   {
     "name": "projects/<var>CONTAINER_PROJECT_NAME</var>/locations/global/operations/operation-1737646069712-62c6140bb04bb-49261230-43701daf",
     "metadata": {
       "@type": "type.googleapis.com/google.cloud.cloudaicompanion.v1.OperationMetadata",
       "createTime": "2025-01-23T15:27:50.076075570Z",
       "target": "projects/<var>TARGET_PROJECT_NAME</var>/locations/global/loggingSettings/<var>LOGS_SETTING_ID</var>/settingBindings/<var>LOGS_BINDING_ID</var>",
       "verb": "create",
       "requestedCancellation": false,
       "apiVersion": "v1"
     },
     "done": false
   }
   

ปิดใช้การบันทึกสำหรับ Gemini Code Assist

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

คอนโซล

1. ตรวจสอบว่าคุณมีสิทธิ์การจัดการข้อมูลประจำตัวและการเข้าถึง (IAM) ต่อไปนี้ในโปรเจ็กต์ที่เป็นเจ้าของการสมัครใช้บริการ

   • instance.queryEffectiveSetting
   • instance.queryEffectiveSettingBindings
   • loggingSettings.delete
   • loggingSettings.list
   • loggingSettings.update
   • loggingSettings.get
   • cloudaicompanion.instances.loggingSettings.use
   • cloudaicompanion.instances.queryEffectiveSetting
   • settingBindings.loggingSettingsList
   • settingBindings.loggingSettingsGet
   • settingBindings.loggingSettingsUpdate
   • settingBindings.loggingSettingsDelete
   • cloudaicompanion.settingBindings.loggingSettingsUse
   • cloudaicompanion.instances.queryEffectiveSettingBindings

2. ใน API Console ให้ไปที่หน้าผู้ดูแลระบบสำหรับ Gemini

   ไปที่ Gemini สำหรับ Google Cloud

   หน้า Gemini สำหรับ Google Cloud จะโหลดขึ้น

3. คลิกการตั้งค่าในเมนูการนำทางด้านซ้าย

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

4. คลิกการบันทึกข้อมูลเมตาสำหรับ Code Assist เพื่อปิดการบันทึกข้อมูลเมตา จากการใช้งาน Gemini Code Assist แบบมาตรฐานและ Enterprise ในโปรเจ็กต์

5. คลิกบันทึกการเปลี่ยนแปลง

API

หากต้องการปิดใช้การบันทึกสำหรับ Gemini Code Assist แบบมาตรฐานและ Enterprise ให้ใช้วิธีloggingSetting

1. ตรวจสอบว่าคุณมีสิทธิ์การจัดการข้อมูลประจำตัวและการเข้าถึง (IAM) ต่อไปนี้ในโปรเจ็กต์ที่เป็นเจ้าของการสมัครใช้บริการ

   • instance.queryEffectiveSetting
   • instance.queryEffectiveSettingBindings
   • loggingSettings.create
   • loggingSettings.list
   • loggingSettings.update
   • loggingSettings.get
   • cloudaicompanion.instances.loggingSettings.use
   • cloudaicompanion.instances.queryEffectiveSetting
   • settingBindings.loggingSettingsList
   • settingBindings.loggingSettingsGet
   • settingBindings.loggingSettingsUpdate
   • settingBindings.loggingSettingsCreate
   • serviceusage.services.enable

2. สร้างการตั้งค่าและค่าเฉพาะการตั้งค่า

   1. รับโทเค็น

      TOKEN=$(gcloud auth print-access-token)
      

3. เรียกใช้คำสั่งต่อไปนี้เพื่อปิดใช้การตั้งค่า บันทึก Gemini Code Assist Standard และ Enterprise

     curl -X POST \
       -H "Authorization: Bearer $TOKEN" \
       -H 'Content-Type: application/json' \
       -d '{
         "log_prompts_and_responses": false,
         "log_metadata": false,
         } ' \
       "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/loggingSettings?logging_metadata_id=LOGS_SETTING_ID"
   

   แทนที่ค่าต่อไปนี้

   • CONTAINER_PROJECT_NAME: ป้อนรหัสโปรเจ็กต์หลัก

   • LOGS_SETTING_ID: ป้อนชื่อการตั้งค่าที่มีอยู่ เช่น gcalm

     หากคำสั่งสำเร็จ ระบบจะแสดงเนื้อหาการตอบกลับที่แสดง log_prompts_and_responses และ log_metadata ซึ่งตั้งค่าเป็น false

     {
       "name": "projects/CONTAINER_PROJECT_NAME/locations/global/loggingSettings/LOGS_SETTING_ID",
       "createTime": "2025-01-23T15:22:49.717166932Z",
       "updateTime": "2025-01-23T15:22:49.717166932Z",
       "log_prompts_and_responses": false,
       "log_metadata": false
     }
     

ขั้นตอนถัดไป

• ดูบันทึกของ Gemini Code Assist
• ดูการตั้งค่าผู้ดูแลระบบอื่นๆ ของ Gemini Code Assist