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

เอกสารนี้อธิบายวิธีกำหนดค่าการบันทึกมาตรฐานและระดับองค์กรของ Gemini Code Assist สำหรับโปรเจ็กต์โดยใช้ Google Cloud 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 คุณสามารถให้ ผู้ดูแลการตั้งค่า Gemini สำหรับ Google Cloud (roles/cloudaicompanion.settingsAdmin) บทบาทที่กำหนดล่วงหน้าของ Identity and Access Management ซึ่งรวมถึงสิทธิ์ที่จำเป็นทั้งหมด ที่ต้องใช้ในการทำงานกับการตั้งค่าผู้ดูแลระบบทั้งหมดของ Gemini สำหรับ Google Cloud

หรือจะอัปเดตบทบาท IAM ที่กำหนดเองก็ได้ คุณต้องมีสิทธิ์ IAM ที่เฉพาะเจาะจง ซึ่งมีรายละเอียดอยู่ในส่วนต่อไปนี้

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

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

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

• บันทึกเมตาดาต้าของ Gemini Code Assist แบบมาตรฐานและ 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. ใน Google Cloud 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 แบบมาตรฐานและ 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. ใน Google Cloud 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