ภาพรวม

เทมเพลตแอปเป็นแนวทางการตั้งค่าสำหรับเวิร์กสเปซที่มีการจัดการซึ่งต้องการแอปหรือคอนเน็กเตอร์ ChatGPT เวอร์ชันเฉพาะเวิร์กสเปซ ผู้ดูแลระบบและเจ้าของเวิร์กสเปซจะพบเทมเพลตใน Workspace settings > Apps > Directory เพิ่มการกำหนดค่าเฉพาะองค์กร และสร้างแอปฉบับร่างเพื่อรอการตรวจสอบ เทมเพลตแอปที่มีการจัดการจะไม่ปรากฏในเวิร์กสเปซส่วนตัว

เทมเพลตมีประโยชน์เมื่อ OpenAI สามารถจัดเตรียมลักษณะการทำงานทั่วไปของแอปได้ แต่แต่ละเวิร์กสเปซต้องระบุการกำหนดค่าเฉพาะผู้ให้บริการเอง การกำหนดค่านั้นอาจรวมถึงชื่อเทนแนนต์หรือโฮสต์ ข้อมูลรับรอง OAuth client, URL สำหรับ callback, ขอบเขต, รายละเอียด webhook, URL ของเซิร์ฟเวอร์ MCP ที่มีการจัดการ หรือการตั้งค่าอื่นๆ ของผู้ให้บริการ ทั้งนี้ขึ้นอยู่กับเทมเพลต ตัวอย่างเช่น เทมเพลต GitHub Enterprise อาจสร้างคอนเน็กเตอร์เฉพาะเวิร์กสเปซที่ Codex ใช้เพื่อเข้าถึงโฮสต์ GitHub Enterprise ขององค์กรนั้น

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


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

ใช้บทความนี้สำหรับขั้นตอนการทำงานทั่วไปของเทมเพลต สำหรับการตั้งค่าเฉพาะผู้ให้บริการ โปรดดู:

• GitHub Enterprise

• Snowflake

• Databricks

เทมเพลตมีประโยชน์เมื่อรูปแบบแอปเดียวกันใช้ได้กับหลายองค์กร แต่แต่ละองค์กรต้องมีการกำหนดค่าของตนเอง

ตัวอย่างทั่วไป ได้แก่:

• URL ของผู้ให้บริการมีชื่อโฮสต์ของเทนแนนต์ บัญชี องค์กร หรือเวิร์กสเปซของบริษัท

• องค์กรต้องนำ OAuth client หรือข้อมูลรับรองของผู้ให้บริการมาใช้เอง

• ผู้ให้บริการต้องการการตั้งค่า URL สำหรับ callback ที่เฉพาะเจาะจงสำหรับลูกค้า

• แอปควรใช้รูปแบบการใช้งานเดียวกัน ขณะที่แต่ละเวิร์กสเปซควบคุมการเข้าถึง การดำเนินการ และการตั้งค่าความปลอดภัยแยกกัน

เทมเพลตแตกต่างจากแอปทั่วไปอย่างไร

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

ขั้นตอนทั่วไปคือ:

• ผู้ดูแลระบบค้นหาเทมเพลตใน Workspace settings > Apps > Directory

• ผู้ดูแลระบบป้อนการกำหนดค่าเฉพาะเวิร์กสเปซที่จำเป็น

• ChatGPT สร้างแอปฉบับร่างสำหรับเวิร์กสเปซ

• ผู้ดูแลระบบตรวจสอบและเผยแพร่ฉบับร่าง

• ผู้ดูแลระบบกำหนดค่าการเข้าถึงและการตั้งค่าการดำเนินการสำหรับแอปที่เผยแพร่แล้ว

สมาชิกใช้แอปของเวิร์กสเปซที่เผยแพร่แล้ว ไม่ใช่เทมเพลตเดิม

ค้นหาและตั้งค่าเทมเพลตแอป

• เปิด Workspace settings > Apps

• เลือก Directory

• ค้นหาผู้ให้บริการหรือชื่อแอป

• มองหารายการที่ทำเครื่องหมายว่าเป็นเทมเพลต

• เลือก Enable เพื่อเริ่มขั้นตอนการตั้งค่า

ขั้นตอนการตั้งค่าจะขอรายละเอียดที่จำเป็นสำหรับการสร้างแอปเฉพาะเวิร์กสเปซ ฟิลด์ที่ต้องกรอกจะแตกต่างกันไปตามเทมเพลต

ตัวอย่างเช่น เทมเพลต GitHub Enterprise อาจขอรายละเอียด เช่น:

• ชื่อและคำอธิบายของแอป

• ชื่อโฮสต์ GitHub Enterprise

• การกำหนดค่า URL สำหรับ callback

• OAuth client ID และ client secret

• คีย์ส่วนตัวของ GitHub App

• ขอบเขตที่ขอ

• รายละเอียดการตั้งค่า webhook

ตรวจสอบแต่ละฟิลด์อย่างรอบคอบก่อนสร้างฉบับร่าง หากองค์กรของคุณจัดการ OAuth หรือข้อมูลรับรองของผู้ให้บริการแบบรวมศูนย์ ให้ประสานงานกับทีมที่เป็นเจ้าของข้อมูลรับรองเหล่านั้น

ดูคำแนะนำเฉพาะแอป:GitHub,Snowflake และDatabricks

การตั้งค่า OAuth client

บางเทมเพลตกำหนดให้องค์กรของคุณนำ OAuth client มาใช้เอง เมื่อจำเป็นต้องทำเช่นนี้ ให้สร้างหรือกำหนดค่าแอป OAuth ในคอนโซลผู้ดูแลระบบของผู้ให้บริการภายนอก จากนั้นคัดลอก URL สำหรับ callback จาก ChatGPT ไปยังการตั้งค่า URL สำหรับ redirect หรือ callback ของผู้ให้บริการ

ป้อน OAuth client ID และ secret ใน ChatGPT หลังจากยืนยันแล้วเท่านั้นว่าการกำหนดค่าของผู้ให้บริการตรงกับคำแนะนำการตั้งค่าเทมเพลต

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

สร้างฉบับร่าง

หลังจากป้อนข้อมูลที่จำเป็นแล้ว ให้เลือก Create draft

การสร้างฉบับร่างไม่ได้ทำให้แอปพร้อมใช้งานสำหรับสมาชิกโดยอัตโนมัติ ตรวจสอบฉบับร่าง เผยแพร่ และกำหนดค่าการเข้าถึงกับการตั้งค่าการดำเนินการก่อนขอให้สมาชิกใช้งาน

เผยแพร่และจัดการแอปที่ได้

หลังจากเผยแพร่แล้ว ให้จัดการแอปเฉพาะเวิร์กสเปซจาก Workspace settings > Apps > Enabled

รายการตรวจสอบที่แนะนำหลังเผยแพร่:

• ยืนยันว่าแอปปรากฏใน Enabled apps

• ตั้งค่า User access สำหรับบทบาทที่ควรใช้แอป

• ตรวจสอบ Action control สำหรับการดำเนินการอ่านและเขียน

• ตรวจสอบ App permissions เพื่อเลือกว่า ChatGPT จะถามสมาชิกก่อนใช้แอปเมื่อใด

• ขอให้ผู้ใช้ทดสอบที่ได้รับอนุญาตเปิด Apps ใน ChatGPT และยืนยันว่าแอปปรากฏ

• หากแอปต้องมีการตรวจสอบสิทธิ์กับผู้ให้บริการ ให้ผู้ใช้ทดสอบเชื่อมต่อบัญชีผู้ให้บริการของตน

• เรียกใช้พรอมต์ทดสอบที่มีความเสี่ยงต่ำเพื่อยืนยันว่าแอปทำงานตามที่คาดไว้

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

หากเทมเพลตใช้ได้เพียงครั้งเดียว

บางเทมเพลตอาจสร้างแอปได้เพียงหนึ่งแอปต่อเวิร์กสเปซ หากใช้เทมเพลตไปแล้ว ปุ่ม Enable อาจไม่พร้อมใช้งาน ในกรณีนั้น ให้จัดการฉบับร่างหรือแอปที่เผยแพร่แล้วที่มีอยู่แทนการสร้างแอปใหม่จากเทมเพลตเดียวกัน

สิ่งที่สมาชิกเห็น

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

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

ตรวจสอบว่า:

• เผยแพร่แอปแล้ว

• เปิดใช้งานแอปสำหรับเวิร์กสเปซแล้ว

• บทบาทในเวิร์กสเปซของสมาชิกมีสิทธิ์เข้าถึง

• สมาชิกอยู่ในเวิร์กสเปซที่ถูกต้อง

• สมาชิกมีสิทธิ์ที่จำเป็นในผู้ให้บริการภายนอก

แอปที่เผยแพร่แล้วจะแสดงใน Workspace settings > Apps > Enabled หากแอปเป็นส่วนหนึ่งของปลั๊กอิน แอปอาจแสดงเป็นแอปที่จำเป็นหรือไม่บังคับในหน้ารายละเอียดของปลั๊กอินด้วย

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

หากตั้งค่าไม่สำเร็จหรือแอปไม่ปรากฏ ให้ยืนยันรายการต่อไปนี้:

• ชื่อโฮสต์ของเทนแนนต์ บัญชี หรือเวิร์กสเปซถูกต้อง

• คัดลอก URL สำหรับ callback ลงในการกำหนดค่าของผู้ให้บริการอย่างถูกต้องทุกตัวอักษรแล้ว

• OAuth client ID และ client secret ถูกต้อง

• ขอบเขตที่ขอตรงกับสิ่งที่แอป OAuth ของผู้ให้บริการอนุญาต

• สร้างฉบับร่างแล้ว

• เผยแพร่ฉบับร่างแล้ว

• การเข้าถึงตามบทบาทอนุญาตให้ผู้ใช้ทดสอบเห็นแอป

• สิทธิ์ฝั่งผู้ให้บริการอนุญาตข้อมูลหรือการดำเนินการที่กำลังทดสอบ

หมายเหตุด้านความปลอดภัย

• ถือว่า OAuth client secrets และข้อมูลรับรองของผู้ให้บริการเป็นข้อมูลละเอียดอ่อน

• ตรวจสอบขอบเขตที่ขอก่อนสร้างฉบับร่าง

• ใช้ Action control หลังเผยแพร่เพื่อจำกัดสิ่งที่แอปทำได้

• ใช้ App permissions เพื่อกำหนดว่า ChatGPT จะถามสมาชิกก่อนใช้แอปเมื่อใด

• โปรดทราบว่าสิทธิ์ของผู้ให้บริการยังคงมีผลหลังจากเปิดใช้งานแอปใน ChatGPT แล้ว