OpenAI
หน้านี้แปลด้วยระบบอัตโนมัติ ดูต้นฉบับภาษาอังกฤษ.

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

เรียนรู้วิธีที่ผู้ดูแลเวิร์กสเปซสามารถกำหนดค่าเทมเพลตแอป GitHub Enterprise ใน ChatGPT โดยใช้ GitHub App ขององค์กรตนเอง

อัปเดตล่าสุด: 12 days ago

ภาพรวม

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

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

สำหรับวิธีเข้าถึงส่วนต่างๆ ในเวิร์กสเปซและการเข้าถึงแอป โปรดดู: การควบคุมสำหรับผู้ดูแลระบบ ความปลอดภัย และการปฏิบัติตามข้อกำหนดสำหรับปลั๊กอินและแอป

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

คุณกำลังสร้างแอป GitHub Enterprise ใน ChatGPT สำหรับเวิร์กสเปซโดยเฉพาะ แอปนี้ใช้สิ่งต่อไปนี้:

  • GitHub App ที่ลงทะเบียนบนโฮสต์ GitHub Enterprise ของคุณ

  • ID ไคลเอนต์และข้อมูลลับไคลเอนต์ของ GitHub App สำหรับการอนุญาตจากผู้ใช้ผ่าน OAuth

  • คีย์ส่วนตัวของ GitHub App เพื่อให้ ChatGPT สร้างโทเค็นการติดตั้งสำหรับดำเนินการกับ Repository ได้

  • ข้อมูลลับเว็บฮุกและ URL เว็บฮุก เพื่อให้ GitHub Enterprise ส่งเหตุการณ์เกี่ยวกับการติดตั้งและ Repository กลับไปยัง ChatGPT ได้

  • ชื่อโฮสต์ GitHub Enterprise ของคุณ เช่น github.example.com

ให้สร้าง GitHub App ไม่ใช่ GitHub OAuth App แบบแยกต่างหาก การตั้งค่าเทมเพลต ChatGPT ต้องใช้ข้อมูลประจำตัวของ GitHub App คีย์ส่วนตัว และการตั้งค่าเว็บฮุก

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

คุณต้องมี:

  • สิทธิ์ผู้ดูแลระบบหรือเจ้าของเวิร์กสเปซ ChatGPT

  • สิทธิ์ผู้ดูแล GitHub Enterprise หรือเจ้าขององค์กรที่สามารถสร้างและติดตั้ง GitHub Apps ได้

  • ชื่อโฮสต์ GitHub Enterprise เท่านั้น โดยไม่มี https:// หรือพาธ

  • ข้อสรุปว่า ChatGPT ควรรองรับการดำเนินการใดกับ Repository บ้าง เช่น การค้นหา Repository แบบอ่านอย่างเดียว เวิร์กโฟลว์ pull request เวิร์กโฟลว์ประเด็นปัญหา การแก้ไขไฟล์ GitHub Actions หรือเวิร์กโฟลว์ Codex ที่ครอบคลุมมากขึ้น

  • พื้นที่ที่ปลอดภัยสำหรับจัดการคีย์ส่วนตัวและข้อมูลลับไคลเอนต์ของ GitHub App

เปิด ChatGPT และ GitHub Enterprise ค้างไว้ในคนละแท็บ อย่ากำหนด URL เรียกกลับขึ้นเอง คัดลอก URL เรียกกลับที่แสดงใน ChatGPT ให้ตรงทุกตัวอักษร

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

  • ชื่อโฮสต์ GitHub Enterprise: เช่น github.example.com

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

  • ID ไคลเอนต์ของ GitHub App

  • ข้อมูลลับไคลเอนต์ของ GitHub App

  • คีย์ส่วนตัวของ GitHub App ในรูปแบบ PEM

  • ข้อมูลลับเว็บฮุกที่ ChatGPT สร้างขึ้น

  • URL เว็บฮุกที่สร้างขึ้นหลังจากสร้างแอปฉบับร่างใน ChatGPT

เริ่มตั้งค่าเทมเพลตใน ChatGPT

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

  2. เปิด การตั้งค่าเวิร์กสเปซ > แอป คุณยังสามารถไปที่คอนโซลผู้ดูแลระบบ เลือกเวิร์กสเปซ ChatGPT ที่ต้องการ แล้วเปิด ปลั๊กอิน เลือก จัดการแอปรุ่นเดิม เพื่อเปิดหน้า แอป ที่ยังคงเก็บไว้

  3. เลือก ไดเรกทอรี

  4. ค้นหา GitHub Enterprise

  5. เลือกเทมเพลตแอป GitHub Enterprise แล้วเริ่มตั้งค่า

  6. ป้อนชื่อแอปและคำอธิบายให้ชัดเจน เช่น GitHub Enterprise หรือ GitHub Enterprise - ทีมวิศวกรรม

  7. ป้อนชื่อโฮสต์ GitHub Enterprise เช่น github.example.com

  8. คัดลอก URL เรียกกลับที่แสดงใน ChatGPT เปิดแท็บนี้ค้างไว้

  9. คัดลอกข้อมูลลับเว็บฮุกที่สร้างขึ้น หากมีแสดงระหว่างการตั้งค่า

ตัวอย่าง URL เรียกกลับ: https://chatgpt.com/connector/oauth/<callback_id>

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

สร้าง GitHub App ใน GitHub Enterprise

  1. เปิดโฮสต์ GitHub Enterprise ของคุณ เช่น https://github.example.com

  2. ไปที่องค์กรหรือบัญชีที่ควรเป็นเจ้าของแอป

  3. เปิด การตั้งค่า > การตั้งค่านักพัฒนา > GitHub Apps

  4. เลือก GitHub App ใหม่

  5. ป้อนชื่อแอปให้ชัดเจน เช่น ตัวเชื่อมต่อ GitHub Enterprise สำหรับ ChatGPT

  6. ป้อน URL หน้าแรก หากไม่มีหน้าภายในเฉพาะสำหรับแอป ให้ใช้ URL องค์กรใน GitHub Enterprise

  7. ในช่อง URL เรียกกลับ ให้วาง URL เรียกกลับที่คัดลอกจาก ChatGPT โดยไม่แก้ไข

  8. เปิดใช้ตัวเลือกให้โทเค็นการอนุญาตของผู้ใช้หมดอายุไว้ เว้นแต่ทีมรักษาความปลอดภัยของคุณมีเหตุผลเฉพาะที่ต้องเปลี่ยน

  9. เปิดใช้ตัวเลือกขอการอนุญาตจากผู้ใช้ระหว่างการติดตั้ง เพื่อให้ผู้ใช้อนุญาตแอปได้ระหว่างขั้นตอนการติดตั้งหรือการเชื่อมต่อ

  10. ในหัวข้อ GitHub App นี้ติดตั้งได้ที่ใดบ้าง? ให้เลือกตัวเลือกที่จำกัดขอบเขตมากที่สุดและเหมาะกับแผนการเปิดใช้งานของคุณ

  11. สร้าง GitHub App

กำหนดค่าสิทธิ์และเหตุการณ์

เลือกสิทธิ์ขั้นต่ำที่จำเป็นสำหรับการดำเนินการของ ChatGPT ที่คุณวางแผนจะเปิดใช้

สำหรับการค้นหา Repository และการถามตอบแบบอ่านอย่างเดียว ให้เริ่มจากสิทธิ์อ่าน เช่น:

  • เมทาดาทา: อ่านอย่างเดียว GitHub กำหนดให้ GitHub Apps ต้องมีสิทธิ์เข้าถึงเมทาดาทา

  • เนื้อหา: อ่านอย่างเดียว เพื่อเข้าถึงเนื้อหาในไฟล์และ Repository

  • ประเด็นปัญหา: อ่านอย่างเดียว หากจำเป็นต้องค้นหาหรืออ่านประเด็นปัญหา

  • Pull requests: อ่านอย่างเดียว หากจำเป็นต้องค้นหา pull request หรือใช้ข้อมูลประกอบการตรวจทาน

  • การดำเนินการ: อ่านอย่างเดียว หากจำเป็นต้องใช้สถานะการรันเวิร์กโฟลว์ งาน บันทึก หรืออาร์ติแฟกต์

สำหรับเวิร์กโฟลว์ที่เขียนข้อมูล ให้เพิ่มสิทธิ์เขียนเฉพาะส่วนที่จำเป็น เช่น เนื้อหา, Pull requests, ประเด็นปัญหา, การดำเนินการ หรือเวิร์กโฟลว์ กำหนดสิทธิ์ให้แคบที่สุดเท่าที่จะรองรับการดำเนินการของ ChatGPT ที่ต้องการได้

เหตุการณ์เว็บฮุกควรสอดคล้องกับเวิร์กโฟลว์ที่คุณรองรับ เหตุการณ์ที่ใช้กันทั่วไป ได้แก่ การติดตั้ง, Repository ของการติดตั้ง, การพุช, Pull request, ประเด็นปัญหา, ความคิดเห็นในประเด็นปัญหา, การรันเวิร์กโฟลว์ และงานในเวิร์กโฟลว์

สร้างและคัดลอกข้อมูลประจำตัวของ GitHub App

  1. ในการตั้งค่า GitHub App ให้คัดลอก ID ไคลเอนต์

  2. สร้าง ข้อมูลลับไคลเอนต์ แล้วคัดลอกทันที

  3. ในส่วน คีย์ส่วนตัว ให้สร้างคีย์ส่วนตัว

  4. ดาวน์โหลดไฟล์ .pem แล้วเก็บไว้ในที่ปลอดภัย

  5. เปิดไฟล์ .pem บนอุปกรณ์ของคุณ แล้วคัดลอกข้อความ PEM ทั้งหมด รวมถึงบรรทัดเริ่มต้นและสิ้นสุด

คีย์ส่วนตัวเป็นข้อมูลที่ละเอียดอ่อน ดูแลรักษาเช่นเดียวกับข้อมูลประจำตัว หากคีย์รั่วไหล ให้สร้างคีย์ส่วนตัวใหม่ อัปเดตการตั้งค่าแอป ChatGPT แล้วลบคีย์ที่รั่วไหลออกจาก GitHub Enterprise

ตั้งค่าใน ChatGPT ให้เสร็จสมบูรณ์

  1. กลับไปที่แท็บตั้งค่าเทมเพลต ChatGPT

  2. วาง ID ไคลเอนต์ของ GitHub App ลงในช่อง ID ไคลเอนต์ OAuth

  3. วางข้อมูลลับไคลเอนต์ของ GitHub App ลงในช่อง ข้อมูลลับไคลเอนต์ OAuth

  4. คงค่า ขอบเขต ไว้ตามเดิม เว้นแต่องค์กรของคุณจำเป็นต้องเปลี่ยนค่าเริ่มต้นของเทมเพลตโดยเจตนา

  5. ตรวจสอบว่าชื่อโฮสต์ GitHub Enterprise มีเฉพาะชื่อโฮสต์ เช่น github.example.com

  6. วางหรืออัปโหลดคีย์ส่วนตัวของ GitHub App ในรูปแบบ PEM ลงในช่องคีย์ส่วนตัวของ GitHub App

  7. ตรวจสอบว่ามีข้อมูลลับเว็บฮุกที่สร้างขึ้นแล้ว

  8. สร้างแอปฉบับร่าง

  9. เปิดรายละเอียดแอปฉบับร่างที่สร้างขึ้นใน ChatGPT แล้วคัดลอก URL เว็บฮุกที่สร้างขึ้น

URL เว็บฮุกควรมีรูปแบบดังนี้: https://connectors.api.openai.org/connectors/<connector_id>/webhook

ตั้งค่าเว็บฮุกใน GitHub Enterprise ให้เสร็จสมบูรณ์

  1. กลับไปที่การตั้งค่า GitHub App ใน GitHub Enterprise

  2. เปิดการตั้งค่าทั่วไปของ GitHub App

  3. เปิดใช้ตัวเลือกเว็บฮุกที่ใช้งานอยู่ หากยังไม่ได้เปิดใช้

  4. วาง URL เว็บฮุกจาก ChatGPT ลงในช่อง URL เว็บฮุก

  5. วางข้อมูลลับเว็บฮุกจาก ChatGPT ลงในช่องข้อมูลลับเว็บฮุก

  6. เปิดใช้การตรวจสอบ SSL ไว้

  7. ตรวจสอบว่าเหตุการณ์เว็บฮุกที่เลือกติดตามสอดคล้องกับสิทธิ์และการดำเนินการที่คุณเปิดใช้

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

เผยแพร่และจัดการแอปใน ChatGPT

การสร้างแอปฉบับร่างไม่ได้ทำให้สมาชิกใช้งานแอปได้โดยอัตโนมัติ หลังจากตรวจทานฉบับร่างแล้ว:

  1. เผยแพร่แอปฉบับร่าง

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

  3. กำหนดค่า การเข้าถึงของผู้ใช้ สำหรับบทบาทที่ควรใช้แอปนี้

  4. ตรวจทาน การควบคุมการดำเนินการ สำหรับการอ่านและเขียนข้อมูล

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

  6. ให้ผู้ใช้ทดสอบที่ได้รับอนุญาตเปิดแอปใน ChatGPT แล้วตรวจสอบว่ามีแอปปรากฏอยู่

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

ติดตั้งและทดสอบ GitHub App

  1. ใน GitHub Enterprise ให้ติดตั้งแอป GitHub ในองค์กรหรือบัญชี

  2. เลือก Repository ทั้งหมดหรือเฉพาะบางรายการตามนโยบายของเวิร์กสเปซ

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

  4. ให้สิทธิ์แอป GitHub เมื่อมีข้อความแจ้ง

  5. เริ่มจากการอ่านข้อมูลเล็กน้อย เช่น แสดงรายการ Repository ที่เข้าถึงได้ หรือดึง pull request ที่ทราบอยู่แล้ว

  6. หากเปิดใช้การเขียนข้อมูล ให้ทดสอบกับ Repository ที่มีความเสี่ยงต่ำก่อนเปิดใช้งานในวงกว้าง

ชื่อโฮสต์และการทำงานของ OAuth

ChatGPT ใช้ชื่อโฮสต์เพื่อกำหนดปลายทางของ GitHub Enterprise ป้อนเฉพาะชื่อโฮสต์ เช่น github.example.com หรือ octocorp.ghe.com

อย่าป้อนพาธ API พาธ Repository หรือ github.com เว้นแต่จะเป็นโฮสต์ GitHub Enterprise ที่ใช้กับแอปนี้จริงๆ

การแก้ไขปัญหา

  • URI เปลี่ยนเส้นทางไม่ตรงกัน: ตรวจสอบว่า URL เรียกกลับของ GitHub App ตรงกับ URL เรียกกลับที่แสดงใน ChatGPT ทุกตัวอักษร

  • ChatGPT ไม่สามารถสร้างหรือบันทึกแอปฉบับร่างได้: ตรวจสอบว่ากรอกข้อมูลที่จำเป็นครบทุกช่อง ทั้งชื่อโฮสต์ ID ไคลเอนต์ OAuth ข้อมูลลับไคลเอนต์ OAuth คีย์ส่วนตัว และข้อมูลลับเว็บฮุก

  • ยืนยันตัวตนสำเร็จ แต่เรียกใช้ Repository ไม่สำเร็จ: ตรวจสอบว่าติดตั้ง GitHub App แล้วและมีสิทธิ์เข้าถึง Repository นั้น

  • API ส่งคืนรหัส 403 หรือแจ้งว่าสิทธิ์ไม่เพียงพอ: เพิ่มสิทธิ์ที่ขาดให้ GitHub App และให้เจ้าของการติดตั้งอนุมัติสิทธิ์ที่อัปเดตหากมีข้อความแจ้ง

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

  • ส่งเว็บฮุกไม่สำเร็จ: ตรวจสอบว่า URL เว็บฮุกและข้อมูลลับเว็บฮุกตรงกับค่าจาก ChatGPT เปิดใช้การตรวจสอบ SSL ไว้ และตรวจสอบว่าโฮสต์ GitHub Enterprise เชื่อมต่อกับ connectors.api.openai.org ได้

  • ข้อผิดพลาดเกี่ยวกับคีย์ส่วนตัว: ตรวจสอบว่าคัดลอกเนื้อหา PEM มาครบถ้วน รวมถึงบรรทัดเริ่มต้นและสิ้นสุด

เอกสารอ้างอิง

บทความนี้มีประโยชน์หรือไม่