ตั้งค่าเทมเพลตแอป Databricks ใน ChatGPT

ใช้คู่มือนี้หากคุณเป็นผู้ดูแลเวิร์กสเปซ ChatGPT หรือผู้ใช้ ChatGPT Plus หรือ Pro ที่กำลังตั้งค่าตัวเชื่อมต่อ Databricks Genie ด้วยไคลเอ็นต์ OAuth ของ Databricks ในองค์กร

สำหรับ Databricks การตั้งค่าส่วนใหญ่จะดำเนินการใน Databricks Account Console คุณจะสร้างการเชื่อมต่อแอป OAuth แบบกำหนดเอง ลงทะเบียน URL เรียกกลับของ ChatGPT คัดลอกข้อมูลประจำตัวไคลเอ็นต์ที่สร้างขึ้น แล้วป้อนค่าเหล่านั้นในขั้นตอนการตั้งค่าตัวเชื่อมต่อของ ChatGPT

สิ่งที่คุณกำลังตั้งค่า

คุณกำลังสร้างการเชื่อมต่อแอป Databricks สำหรับบัญชีหรือเวิร์กสเปซ ChatGPT ของคุณ การเชื่อมต่อนี้ใช้:

• การเชื่อมต่อแอป OAuth ของ Databricks ที่สร้างใน Databricks Account Console

• รหัสไคลเอ็นต์และรหัสลับไคลเอ็นต์ OAuth ของ Databricks

• URL เรียกกลับที่คัดลอกมาจาก ChatGPT โดยตรง

• ขอบเขตของ Databricks ที่ตรงกับความสามารถของตัวเชื่อมต่อที่คุณต้องการเปิดใช้

• รายละเอียดผู้ให้บริการ Databricks ที่ขั้นตอนการตั้งค่า ChatGPT ร้องขอ เช่น โฮสต์ของเวิร์กสเปซ โฮสต์ของบัญชี รหัสบัญชี หรือคลังข้อมูล

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

สิ่งที่จำเป็น:

• สิทธิ์ผู้ดูแลหรือเจ้าของเวิร์กสเปซ ChatGPT หรือบัญชี ChatGPT Plus หรือ Pro

• สิทธิ์ผู้ดูแลบัญชี Databricks สิทธิ์ผู้ดูแลเวิร์กสเปซอาจเพียงพอสำหรับงานบางอย่าง แต่การเชื่อมต่อแอปแบบกำหนดเองต้องตั้งค่าจาก Databricks Account Console

• เปิด Databricks Account Console ไว้ในแท็บแยกต่างหาก

• เปิดหน้าจอการเชื่อมต่อ Databricks Genie ใน ChatGPT ไว้เพื่อคัดลอก URL เรียกกลับให้ตรงทุกอักขระ

• ตัดสินใจว่าแอปต้องมีสิทธิ์เข้าถึง API ทั่วไปของ Databricks หรือต้องการเฉพาะสิทธิ์เข้าถึง Databricks SQL

• พื้นที่ปลอดภัยสำหรับจัดการรหัสลับไคลเอ็นต์ของ Databricks

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

หมายเหตุ: คุณต้องคัดลอก URL เรียกกลับ ที่แสดงใน ChatGPT ให้ตรงทุกอักขระ

ค่าที่ต้องเตรียม

• URL เรียกกลับ: คัดลอกจากขั้นตอนการตั้งค่าตัวเชื่อมต่อ ChatGPT

• รหัสไคลเอ็นต์ OAuth ของ Databricks

• รหัสลับไคลเอ็นต์ OAuth ของ Databricks

• ขอบเขตการเข้าถึง Databricks เช่น ALL APIs หรือ SQL

• ช่องข้อมูลเวิร์กสเปซหรือบัญชี Databricks ที่ขั้นตอนการตั้งค่า ChatGPT ร้องขอ

เริ่มตั้งค่าแอปใน ChatGPT

1. ใน ChatGPT ให้สลับไปยังบัญชีหรือเวิร์กสเปซที่ต้องการให้แอปพร้อมใช้งาน

2. ไปที่ การตั้งค่าเวิร์กสเปซ > ปลั๊กอิน ในฐานะผู้ดูแลหรือเจ้าของเวิร์กสเปซ

3. เลือก Databricks Genie ใน ไดเรกทอรี

4. เลือก เพิ่มการเชื่อมต่อแอป

5. ในกล่องโต้ตอบ เชื่อมต่อ Databricks Genie ให้ค้นหาส่วนไคลเอ็นต์ OAuth

6. URL เรียกกลับ จาก ChatGPT เปิดกล่องโต้ตอบนี้ทิ้งไว้

ตัวอย่าง URL เรียกกลับ:

https://chatgpt.com/connector/oauth/<callback_id>

อย่าลบรหัสเรียกกลับ เพิ่มเครื่องหมายทับต่อท้าย หรือแทนที่ด้วย URL ทั่วไปของ ChatGPT URL ที่ลงทะเบียนใน Databricks ต้องตรงกับ URL เรียกกลับ ที่แสดงใน ChatGPT ทุกอักขระ

สร้างการเชื่อมต่อแอป OAuth ใน Databricks

1. เปิด Databricks Account Console สำหรับบัญชี Databricks ของคุณ

2. เปิด การตั้งค่า ในแถบด้านข้างทางซ้าย

3. เปิดแท็บ การเชื่อมต่อแอป

4. เลือก เพิ่มการเชื่อมต่อ

   

5. ป้อนชื่อแอปพลิเคชัน เช่น ตัวเชื่อมต่อ ChatGPT Databricks

6. ในช่อง URL เปลี่ยนเส้นทาง ให้วาง URL เรียกกลับที่คัดลอกจาก ChatGPT โดยตรง

7. ในส่วน ขอบเขตการเข้าถึง ให้เลือกขอบเขตที่แอปต้องใช้

8. ใช้ ALL APIs สำหรับแอป Databricks ทั่วไปที่ต้องใช้ API ของ Databricks นอกเหนือจาก SQL

9. ใช้เฉพาะ SQL สำหรับแอปที่จำกัดไว้เฉพาะ API ของ Databricks SQL

10. ตรวจสอบให้แน่ใจว่าเปิดใช้ทุกขอบเขตที่จะระบุใน ChatGPT ภายหลังบนแอป OAuth ของ Databricks นี้ Databricks จะอนุญาต openid, email, profile และ offline_access โดยอัตโนมัติสำหรับแอปที่สร้างผ่าน UI

11. ใช้ค่า TTL เริ่มต้นของ Databricks ต่อไป เว้นแต่องค์กรของคุณมีนโยบายเฉพาะ ได้แก่ 60 นาทีสำหรับ Token การเข้าถึง และ 10080 นาทีสำหรับ Token การรีเฟรช

12. เปิด สร้างรหัสลับไคลเอ็นต์ ChatGPT ต้องใช้ไคลเอ็นต์ OAuth แบบเป็นความลับสำหรับขั้นตอนนี้

13. สร้างการเชื่อมต่อ

คัดลอกข้อมูลประจำตัวจาก Databricks

1. ในกล่องโต้ตอบ สร้างการเชื่อมต่อแล้ว ให้คัดลอก รหัสไคลเอ็นต์

2. คัดลอก รหัสลับไคลเอ็นต์ ทันทีและจัดเก็บไว้อย่างปลอดภัย

3. หากปิดกล่องโต้ตอบก่อนคัดลอกรหัสลับ ให้สร้างหรือหมุนเวียนข้อมูลประจำตัวของแอป OAuth แล้วใช้รหัสลับใหม่

Databricks จะแสดงรหัสลับเพียงครั้งเดียว ให้ถือว่าเป็นข้อมูลประจำตัวและอย่าใส่ไว้ในภาพหน้าจอ ทิกเก็ต ความคิดเห็น หรือแชต

ตั้งค่าใน ChatGPT ให้เสร็จสิ้น

1. กลับไปที่กล่องโต้ตอบ เชื่อมต่อ Databricks Genie

2. ป้อนรหัสไคลเอ็นต์ Databricks ในช่อง รหัสไคลเอ็นต์ OAuth

3. ป้อนรหัสลับไคลเอ็นต์ Databricks ในช่อง รหัสลับไคลเอ็นต์ OAuth

4. ในช่อง ขอบเขต (ไม่บังคับ) ให้คง all-apis และ offline_access ไว้สำหรับการเข้าถึง API ทั่วไป

5. ป้อนขอบเขตบรรทัดละหนึ่งรายการ หรือคั่นแต่ละขอบเขตด้วยเครื่องหมายจุลภาค ต้องเปิดใช้ทุกขอบเขตที่ระบุใน ChatGPT บนแอป OAuth ของ Databricks

6. ป้อน ชื่อโฮสต์ของเวิร์กสเปซ (จำเป็น) โดยไม่ใส่ https:// หรือพาธ URL กรอกช่องข้อมูลผู้ให้บริการ Databricks อื่นๆ ที่จำเป็นและแสดงในขั้นตอนการตั้งค่า

7. เลือก ดำเนินการต่อ

ChatGPT จะขอเฉพาะขอบเขตที่ป้อนในช่อง ขอบเขต (ไม่บังคับ) เท่านั้น ระบบจะไม่เพิ่มขอบเขตที่กว้างกว่าจากเทมเพลตโดยอัตโนมัติ

เชื่อมต่อและทดสอบ

1. ตรวจสอบรายละเอียด การดำเนินการ และการตั้งค่าการยืนยันตัวตนของตัวเชื่อมต่อ

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

3. เริ่มขั้นตอนการเชื่อมต่อจาก ChatGPT ในฐานะผู้ใช้ทดสอบที่ได้รับอนุญาต แล้วลงชื่อเข้าใช้ Databricks

4. ยืนยันว่าเบราว์เซอร์เปิดบัญชีหรือเวิร์กสเปซ Databricks ที่ต้องการ

5. ตรวจสอบขอบเขตที่ร้องขอ แล้วเลือก อนุญาต

   

6. ตรวจสอบว่าเบราว์เซอร์กลับมาที่ ChatGPT และตัวเชื่อมต่อแสดงสถานะว่าเชื่อมต่อแล้ว

7. เริ่มจากการดำเนินการอ่านที่มีความเสี่ยงต่ำ เช่น ดึงข้อมูลผู้ใช้ปัจจุบันหรือสืบค้นทรัพยากร Databricks SQL ที่ได้รับอนุมัติ

8. หากเปิดใช้การดำเนินการเขียน ให้ทดสอบด้วยเวิร์กโฟลว์ Databricks ที่มีความเสี่ยงต่ำอย่างชัดเจนก่อนเปิดใช้งานในวงกว้าง

9. สำหรับการตั้งค่าเวิร์กสเปซ ให้สมาชิกเวิร์กสเปซที่ไม่ใช่ผู้ดูแลและได้รับอนุญาตลองเชื่อมต่อและทดสอบแบบความเสี่ยงต่ำซ้ำ

จัดการสิทธิ์เข้าถึง

ทั้ง Databricks และ ChatGPT มีส่วนในการควบคุมสิทธิ์เข้าถึง

ใน ChatGPT ผู้ดูแลเวิร์กสเปซจะจัดการว่าแอปพร้อมใช้งานหรือไม่และสมาชิกใช้งานแอปได้อย่างไร ตรวจสอบการควบคุมสำหรับผู้ดูแลแอป Databricks (การตั้งค่าเวิร์กสเปซ > แอป) ในหัวข้อต่อไปนี้:

• สิทธิ์เข้าถึงของผู้ใช้ เพื่อกำหนดว่าบทบาทใดในเวิร์กสเปซสามารถใช้ตัวเชื่อมต่อได้

• การควบคุมการดำเนินการ เพื่อกำหนดว่าจะเปิดใช้การดำเนินการใดของ Databricks

• สิทธิ์ของแอป เพื่อกำหนดว่า ChatGPT จะขออนุญาตสมาชิกก่อนใช้ตัวเชื่อมต่อเมื่อใด

สิทธิ์ของแอปเหล่านี้ใช้กับการสนทนาใน ChatGPT เอเจนต์ในเวิร์กสเปซจะใช้การควบคุมเฉพาะเอเจนต์ที่ผู้สร้างเอเจนต์กำหนด เพื่อพิจารณาว่ามีการดำเนินการใดของแอปให้ใช้ได้บ้างและจะขอให้ผู้ใช้ปลายทางอนุมัติเมื่อใด ดูข้อมูลเกี่ยวกับลักษณะการทำงานของเอเจนต์ได้ที่ เอเจนต์ในเวิร์กสเปซ ChatGPT สำหรับ Enterprise และ Business

ใน Databricks ผู้ดูแลจะกำหนดว่าผู้ใช้รายใดอนุญาตแอป OAuth ได้และผู้ใช้เหล่านั้นเข้าถึงทรัพยากรใดของ Databricks ได้บ้าง สิทธิ์ของผู้ให้บริการยังคงมีผลหลังจากเปิดใช้แอปใน ChatGPT

แก้ปัญหาการตั้งค่าตัวเชื่อมต่อ Databricks

• URI เปลี่ยนเส้นทางไม่ตรงกัน: ตรวจสอบว่าค่า URL เปลี่ยนเส้นทาง ของ Databricks ตรงกับ URL เรียกกลับ ที่แสดงใน ChatGPT ทุกอักขระ รวมถึงพาธและรหัสเรียกกลับ อย่าลบรหัสเรียกกลับ เพิ่มเครื่องหมายทับต่อท้าย หรือใช้ URL เปลี่ยนเส้นทางอื่นของ ChatGPT แทน

• ไม่มีรหัสลับ: Databricks จะแสดงรหัสลับเพียงครั้งเดียว สร้างรหัสลับไคลเอ็นต์ใหม่หากยังไม่ได้คัดลอก

• แอป OAuth ยังไม่พร้อมใช้งานทันที: Databricks ระบุว่าการประมวลผลการอัปเดตแอปพลิเคชัน OAuth อาจใช้เวลาถึง 30 นาที

• ขอบเขตไม่เพียงพอหรือไม่ตรงกัน: เปรียบเทียบ ขอบเขต (ไม่บังคับ) ใน ChatGPT กับ ขอบเขตการเข้าถึง ในแอป OAuth ของ Databricks ต้องเปิดใช้ทุกขอบเขตที่ ChatGPT ร้องขอในแอปดังกล่าว สำหรับ API ที่ไม่ใช่ SQL ให้ตรวจสอบว่าเปิดใช้ all-apis ใน Databricks และยังมีรายการนี้อยู่ในรายการขอบเขตของ ChatGPT

• การดำเนินการ SQL ล้มเหลว: ตรวจสอบขอบเขต SQL การกำหนดค่าคลังข้อมูล และสิทธิ์ของ Databricks

• เวิร์กสเปซ ChatGPT ไม่ถูกต้อง: สร้างและเปิดใช้ตัวเชื่อมต่อในเวิร์กสเปซ ChatGPT เดียวกับที่ผู้ใช้จะเชื่อมต่อ

• บัญชีหรือเวิร์กสเปซ Databricks ไม่ถูกต้อง: ตรวจสอบค่า ชื่อโฮสต์ของเวิร์กสเปซ (จำเป็น) แล้วลงชื่อเข้าใช้อีกครั้งและตรวจสอบว่า Databricks เปิดบัญชีหรือเวิร์กสเปซที่ต้องการ

• ผู้ใช้เชื่อมต่อไม่ได้: ตรวจสอบว่าผู้ใช้มีสิทธิ์เข้าถึง Databricks และได้รับอนุญาตให้อนุมัติแอป OAuth ตรวจสอบด้วยว่า สิทธิ์เข้าถึงของผู้ใช้ ใน ChatGPT อนุญาตให้ผู้ใช้ใช้ตัวเชื่อมต่อ

• นโยบายเครือข่าย Databricks บล็อกตัวเชื่อมต่อ: หาก Databricks อนุญาตเฉพาะ IP ต้นทางที่กำหนด ผู้ดูแล Databricks ต้องอัปเดตรายการ IP ที่อนุญาตของบัญชีหรือเวิร์กสเปซ การควบคุมขาเข้าตามบริบท ไฟร์วอลล์ หรือกฎเครือข่ายอื่นที่ลูกค้าควบคุม

  • อนุญาตการเชื่อมต่อขาเข้าจากช่วง IP ขาออกปัจจุบันของตัวเชื่อมต่อ ChatGPT

  • กำหนดรายการอนุญาตนี้ใน Databricks หรือชั้นเครือข่ายที่ลูกค้าควบคุม การตั้งค่านี้แยกจากรายการ IP ที่อนุญาตของเวิร์กสเปซ ChatGPT

  • ช่วง IP ที่เผยแพร่อาจเปลี่ยนแปลงได้ หากเป็นไปได้ ให้ตั้งค่าการอัปเดตอัตโนมัติจาก JSON

  • อย่าหมุนเวียนรหัสลับไคลเอ็นต์หรือเปลี่ยนขอบเขต OAuth เพื่อหลีกเลี่ยงการบล็อกของเครือข่าย ก่อนอื่น ให้ตรวจสอบว่า Databricks กำลังปฏิเสธ IP ต้นทางของตัวเชื่อมต่อหรือไม่

ข้อมูลอ้างอิง

• เอกสาร Databricks: การยืนยันตัวตนด้วย OAuth แบบผู้ใช้กับเครื่อง

• เอกสาร Databricks: จัดการการเชื่อมต่อแอป OAuth

• เอกสาร Databricks: จัดการรายการ IP ที่อนุญาต