กำหนดค่าเวอร์ชันการเผยแพร่ Gemini Code Assist

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

เราจะเปิดตัวฟีเจอร์ Gemini Code Assist ในช่องทางการเผยแพร่ต่างๆ คุณตั้งค่าโปรเจ็กต์ Google Cloud แต่ละโปรเจ็กต์ให้ใช้ช่องเผยแพร่เดียวได้ โดยขึ้นอยู่กับความสมดุลที่คุณเลือกไว้ระหว่างความพร้อมใช้งานของฟีเจอร์และความเสถียร ผู้ใช้ในองค์กรที่ใช้ Gemini Code Assist ใน IDE ในเครื่องจะใช้ฟีเจอร์และโมเดลตามเวอร์ชันการเผยแพร่ที่กำหนดค่าไว้สำหรับโปรเจ็กต์ได้

โดยมีเวอร์ชันการเผยแพร่ต่อไปนี้ให้ใช้งาน

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

  • ดูตัวอย่าง ช่วยให้คุณเข้าถึงฟีเจอร์เวอร์ชันตัวอย่างบางอย่างสำหรับ Gemini Code Assist และแสดงความคิดเห็น ข้อมูลการใช้งาน เพื่อช่วย Google ปรับปรุงเวอร์ชันในอนาคตได้ (ไม่บังคับ) โปรดทราบว่าขณะนี้ไม่มีฟีเจอร์ที่แตกต่างกันในช่องการเผยแพร่เวอร์ชันตัวอย่าง

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

ส่วนต่อไปนี้จะแสดงขั้นตอนที่จำเป็นในการตั้งค่าหรือเปลี่ยน ช่องการเผยแพร่ Gemini Code Assist

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

บทบาทที่จำเป็น

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

หากต้องการดูสิทธิ์ที่จำเป็นอย่างแน่นอน ให้ขยายส่วนสิทธิ์ที่จำเป็น

สิทธิ์ที่จำเป็น

  • cloudaicompanion.releaseChannelSettings.create
  • cloudaicompanion.releaseChannelSettings.delete
  • cloudaicompanion.releaseChannelSettings.get
  • cloudaicompanion.releaseChannelSettings.list
  • cloudaicompanion.releaseChannelSettings.update
  • cloudaicompanion.dataSharingWithGoogleSettings.create
  • วิธีกำหนดค่าเวอร์ชันการเผยแพร่โดยใช้ API
    • cloudaicompanion.settingBindings.releaseChannelSettingsCreate
    • cloudaicompanion.settingBindings.releaseChannelSettingsDelete
    • cloudaicompanion.settingBindings.releaseChannelSettingsGet
    • cloudaicompanion.settingBindings.releaseChannelSettingsList
    • cloudaicompanion.settingBindings.releaseChannelSettingsUpdate
    • cloudaicompanion.settingBindings.releaseChannelSettingsUse
  • วิธีกำหนดค่าการแชร์พรอมต์และการตอบกลับโดยใช้ API
    • cloudaicompanion.settingBindings.dataSharingWithGoogleSettingsCreate
    • cloudaicompanion.settingBindings.dataSharingWithGoogleSettingsUse
  • ดูการตั้งค่าผู้ดูแลระบบ Gemini สำหรับ Google Cloud
    • cloudaicompanion.instances.queryEffectiveSetting
    • cloudaicompanion.instances.queryEffectiveSettingBindings

กำหนดค่าเวอร์ชันการเผยแพร่ Gemini Code Assist

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

คอนโซล

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

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

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

  2. คลิกการตั้งค่าในเมนูการนำทาง

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

  3. ในส่วนเวอร์ชันการเผยแพร่สำหรับ Gemini Code Assist ใน IDE ท้องถิ่น ให้เลือกเวอร์ชันการเผยแพร่ที่เหมาะกับความต้องการของคุณมากที่สุด

    Preview

    1. เลือกตัวอย่าง
    2. ตรวจสอบรายละเอียดช่องรุ่นแสดงตัวอย่างและข้อกำหนดของโปรแกรมผู้ทดสอบที่เชื่อถือได้ แล้วคลิกบันทึกการเปลี่ยนแปลง

    พร้อมใช้งานสำหรับผู้ใช้ทั่วไป

    1. เลือก GA
    2. คลิกบันทึกการเปลี่ยนแปลง

API

  1. สร้างการตั้งค่าเวอร์ชันการเผยแพร่และค่าเฉพาะการตั้งค่า

    1. รับโทเค็นการตรวจสอบสิทธิ์ คุณต้องตรวจสอบสิทธิ์โดยใช้การตรวจสอบสิทธิ์ gcloud เพื่อรับข้อมูลดังกล่าว

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

    2. สร้างการตั้งค่า วิธีการเหล่านี้ใช้ cURL เพื่อเรียกเมธอด API ดังนี้

        curl -H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' -d '{
      "release_channel": "RELEASE_CHANNEL",
    } ' -X POST "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/releaseChannelSettings?release_channel_setting_id=RC_SETTING_ID"

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

      • RELEASE_CHANNEL: ช่องทางการเผยแพร่ ไม่ว่าจะเป็น EXPERIMENTAL สำหรับเวอร์ชันตัวอย่างหรือ STABLE สำหรับ เวอร์ชันที่พร้อมใช้งานโดยทั่วไป
      • CONTAINER_PROJECT_NAME: รหัสโปรเจ็กต์ ของโปรเจ็กต์ที่จัดเก็บทรัพยากรการเชื่อมโยง นี่คือ โปรเจ็กต์หลักของการเชื่อมโยง
      • RC_SETTING_ID: ชื่อการตั้งค่าที่ไม่ซ้ำกัน เช่น rc1 สำหรับ Release Channel

      เอาต์พุตจะแสดง releaseChannel ตั้งค่าเป็น RELEASE_CHANNEL ดังนี้

      {
  "name": "projects/CONTAINER_PROJECT_NAME
/locations/global/releaseChannelSettings/RC_SETTING_ID",
  "createTime": "2025-01-23T15:22:49.717166932Z",
  "updateTime": "2025-01-23T15:22:49.717166932Z",
  "releaseChannel": RELEASE_CHANNEL
}

    3. สร้างการเชื่อมโยงการตั้งค่าเวอร์ชันการเผยแพร่

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

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

      • TARGET_PROJECT_NAME: โปรเจ็กต์เป้าหมายที่ควรเชื่อมโยงการเชื่อมโยง ซึ่งมักจะเหมือนกับโปรเจ็กต์คอนเทนเนอร์ อย่างไรก็ตาม คุณสามารถเชื่อมโยงการตั้งค่ากับหลายโปรเจ็กต์ได้ เพื่อไม่ให้ต้องทำซ้ำทรัพยากรการตั้งค่า
      • CONTAINER_PROJECT_NAME: รหัสโปรเจ็กต์ ของโปรเจ็กต์ที่จัดเก็บทรัพยากรการเชื่อมโยง นี่คือ โปรเจ็กต์หลักของการเชื่อมโยง
      • RC_SETTING_ID: เหมือนกับ RC_SETTING_ID ที่คุณใช้เมื่อ สร้างการตั้งค่า แต่ต่อท้ายด้วย b1 เช่น ใช้ rc1b1 สำหรับ Release Channel
      • RC_BINDING_ID: ชื่อที่ไม่ซ้ำกันสำหรับการเชื่อมโยงการตั้งค่า เช่น rc_binding

      เอาต์พุตจะมีข้อมูลเมตาของการดำเนินการในรูปแบบต่อไปนี้

      {
  "name": "projects/CONTAINER_PROJECT_NAME/locations/global/operations/operation-RC_BINDING_OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.cloudaicompanion.v1.OperationMetadata",
    "createTime": "2025-01-23T15:27:50.076075570Z",
    "target": "projects/TARGET_PROJECT_NAME/locations/global/releaseChannelSettings/RC_SETTING_ID/settingBindings/RC_BINDING_ID",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

    4. ไม่บังคับ: ตรวจสอบสถานะการเชื่อมโยงการตั้งค่าเวอร์ชันการเผยแพร่ การสร้าง:

      curl -H "Authorization: Bearer $TOKEN" \
https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/operations/operation-RC_BINDING_OPERATION_ID

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

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

  2. ไม่บังคับ: สร้างการตั้งค่าการแชร์พรอมต์และการตอบกลับ รวมถึงค่าเฉพาะการตั้งค่า ดังนี้

    1. รับโทเค็น

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

    2. สร้างการตั้งค่าโดยทำดังนี้

      curl -H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' -d '{
    "enable_preview_data_sharing": true,
  } ' -X POST "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/dataSharingWithGoogleSettings?data_sharing_with_google_setting_id=DSWG_SETTING_ID"

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

      • CONTAINER_PROJECT_NAME: รหัสโปรเจ็กต์ ระดับบนสุด
      • DSWG_SETTING_ID: ชื่อการตั้งค่าที่ไม่ซ้ำกัน เช่น dswg1 สำหรับ Data Sharing with Google

      เอาต์พุตจะแสดง enablePreviewDataSharing ตั้งค่าเป็น true ดังนี้

      {
  "name": "projects/CONTAINER_PROJECT_NAME
/locations/global/dataSharingWithGoogleSettings/DSWG_SETTING_ID",
  "createTime": "2025-01-23T15:22:49.717166932Z",
  "updateTime": "2025-01-23T15:22:49.717166932Z",
  "enablePreviewDataSharing": true
}

    3. สร้างการเชื่อมโยงการตั้งค่าพรอมต์และการตอบกลับ

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

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

      • TARGET_PROJECT_NAME: โปรเจ็กต์เป้าหมายที่ควรใช้การตั้งค่า
      • CONTAINER_PROJECT_NAME: รหัสโปรเจ็กต์ หลัก
      • DSWG_SETTING_ID: เหมือนกับ DSWG_SETTING_ID ที่คุณใช้เมื่อ สร้างการตั้งค่า แต่ต่อท้ายด้วย b1 เช่น ใช้ dswg1b1 สำหรับ Data Sharing with Google
      • DSWG_BINDING_ID: ชื่อที่ไม่ซ้ำกันสำหรับการเชื่อมโยงการตั้งค่า เช่น dswg_binding

      เอาต์พุตจะมีข้อมูลเมตาของการดำเนินการในรูปแบบต่อไปนี้

      {
"name": "projects/CONTAINER_PROJECT_NAME/locations/global/operations/operation-DSWG_BINDING_OPERATION_ID",
"metadata": {
  "@type": "type.googleapis.com/google.cloud.cloudaicompanion.v1.OperationMetadata",
  "createTime": "2025-01-23T15:27:50.076075570Z",
  "target": "projects/TARGET_PROJECT_NAME/locations/global/dataSharingWithGoogleSettings/DSWG_SETTING_ID/settingBindings/DSWG_BINDING_ID",
  "verb": "create",
  "requestedCancellation": false,
  "apiVersion": "v1"
},
"done": false
}

    4. ไม่บังคับ: ตรวจสอบสถานะการเชื่อมโยงการตั้งค่าพรอมต์และการตอบกลับ การสร้าง:

      curl -H "Authorization: Bearer $TOKEN" \
https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/operations/operation-DSWG_BINDING_OPERATION_ID

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

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