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

เอกสารนี้อธิบายวิธีกำหนดค่าการบันทึกมาตรฐานและ Enterprise ของ Gemini Code Assist สำหรับโปรเจ็กต์โดยใช้คอนโซล Google API หรือ 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 คุณต้องมีสิทธิ์การจัดการข้อมูลประจำตัวและการเข้าถึงที่เฉพาะเจาะจง ซึ่งระบุไว้อย่างละเอียดในส่วนต่อไปนี้ ตรวจสอบว่าได้เพิ่มสิทธิ์เหล่านี้ลงในบทบาท IAM ที่กําหนดเอง

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

(ไม่บังคับ) เชื่อมโยงสิทธิ์กับการตั้งค่าและเป้าหมาย

หากกําลังกําหนดการตั้งค่าผู้ดูแลระบบของ Gemini Code Assist Standard และ Enterprise ในคอนโซล Google API ให้ข้ามส่วนนี้

หากต้องการกำหนดค่าการตั้งค่าผู้ดูแลระบบของ Gemini Code Assist แบบมาตรฐานและแบบองค์กรด้วย Gemini สำหรับ Google Cloud API ก่อนอื่นคุณต้องสร้างการตั้งค่า จากนั้นสร้างการเชื่อมโยงเพื่อ "เชื่อมโยง" การตั้งค่าและเป้าหมายเหล่านั้น (เช่น อินสแตนซ์ หัวข้อ หรือโปรเจ็กต์) สำหรับผลิตภัณฑ์ที่เฉพาะเจาะจง (เช่น Gemini Cloud Assist หรือ Gemini Code Assist)

สิทธิ์ทั้งหมดในการสร้างและอัปเดตการตั้งค่าจะอยู่ในระดับโปรเจ็กต์

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

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

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

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

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

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

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

คอนโซล

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

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

   • 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. (ไม่บังคับ) คลิกการบันทึกพรอมต์และคำตอบของเครื่องมือช่วยเขียนโค้ดเพื่อบันทึกพรอมต์และคำตอบที่ผู้ใช้ Gemini Code Assist Standard และ Enterprise สร้างขึ้นในโปรเจ็กต์

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

API

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

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

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

   • 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

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

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

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

      • CONTAINER_PROJECT_NAME: ป้อนรหัสโปรเจ็กต์หลัก
      • SETTING_ID: ป้อนชื่อการตั้งค่าที่ไม่ซ้ำกัน เช่น gcalm1 สำหรับ Gemini Code Assist log metadata

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

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

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

      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/SETTING_ID/settingBindings?setting_binding_id=BINDING_ID"
      

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

   • TARGET_PROJECT_NAME: ป้อนโปรเจ็กต์เป้าหมายที่จะใช้การตั้งค่า
   • SETTING_ID: ใช้ SETTING_ID เดียวกันกับตอนที่คุณสร้างการตั้งค่า แต่เพิ่ม b1 ต่อท้าย เช่น ใช้ gcalmb1 สำหรับ Gemini Code Assist log metadata

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

   {
     "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>SETTING_ID</var>/settingBindings/<var>BINDING_ID</var>",
       "verb": "create",
       "requestedCancellation": false,
       "apiVersion": "v1"
     },
     "done": false
   }
   

5. เปิดใช้บันทึกผู้ใช้ของ Gemini Code Assist แบบมาตรฐานและ Enterprise

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

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

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

      • CONTAINER_PROJECT_NAME: ป้อนรหัสโปรเจ็กต์หลัก
      • SETTING_ID: ป้อนชื่อการตั้งค่าที่ไม่ซ้ำกัน เช่น gcapar1 สำหรับ Gemini Code Assist prompts and responses

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

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

   2. เรียกใช้คําสั่งต่อไปนี้เพื่อสร้างการเชื่อมโยงการตั้งค่าบันทึกผู้ใช้ Gemini Code Assist Standard และ Enterprise

      curl \
        -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/SETTING_ID/settingBindings?setting_binding_id=BINDING_ID"
      

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

   • TARGET_PROJECT_NAME: ป้อนโปรเจ็กต์เป้าหมายที่จะใช้การตั้งค่า
   • SETTING_ID: ใช้ SETTING_ID เดียวกันกับตอนที่คุณสร้างการตั้งค่า แต่เพิ่ม b1 ต่อท้าย เช่น ใช้ gcaparb1 สำหรับ Gemini Code Assist prompts and responses

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

   {
     "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>SETTING_ID</var>/settingBindings/<var>BINDING_ID</var>",
       "verb": "create",
       "requestedCancellation": false,
       "apiVersion": "v1"
     },
     "done": false
   }
   

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

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

คอนโซล

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

   • 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 Standard และ Enterprise ในโปรเจ็กต์

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

API

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

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

   • 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 แบบมาตรฐานและ Enterprise

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

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

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

   • SETTING_ID: ป้อนชื่อการตั้งค่าที่มีอยู่ เช่น gcalm1 สำหรับ Gemini Code Assist log metadata

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

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

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

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

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

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

   • SETTING_ID: ป้อนชื่อการตั้งค่าที่มีอยู่ เช่น gcapar1 สำหรับ Gemini Code Assist prompts and responses

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

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

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

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