ภาพรวม

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


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


สำหรับข้อมูลเบื้องต้นเกี่ยวกับปลั๊กอินและแอปที่รวมอยู่ โปรดดู: ปลั๊กอินใน ChatGPT และ Codex

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

• ใช้บัญชี GitHub ที่มีสิทธิ์อ่าน Repository ของมาร์เก็ตเพลสและ Repository อื่นทั้งหมดที่มาร์เก็ตเพลสอ้างอิง รองรับ Repository ทั้งแบบสาธารณะและแบบส่วนตัวบน github.com

• ดำเนินการขออนุมัติจากองค์กรบน GitHub ตามที่กำหนดให้ครบถ้วน เพื่อให้บัญชีที่ใช้ในการนำเข้าเข้าถึง Repository เหล่านั้นได้

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

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

นำเข้ามาร์เก็ตเพลส

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

2. ในช่อง แหล่งที่มา ให้ป้อน URL ของ Repository เช่น https://github.com/example/team-plugins ใช้เฉพาะ URL ของ Repository ไม่ใช่ URL ของบรานช์หรือโฟลเดอร์

3. หากมาร์เก็ตเพลสอยู่ในไดเรกทอรีย่อย ให้ป้อนไดเรกทอรีนั้นในช่อง พาธ ตัวอย่างเช่น ป้อน team-tools สำหรับ team-tools/.agents/plugins/marketplace.json เว้นช่อง พาธ ว่างไว้หากใช้ไดเรกทอรีรากของ Repository อย่าป้อนชื่อไฟล์ manifest

4. คุณสามารถป้อน บรานช์ แท็ก หรือคอมมิต ได้หากต้องการ เว้นว่างไว้เพื่อใช้บรานช์เริ่มต้นของ Repository ใช้บรานช์เพื่อรับคอมมิตในอนาคต หากระบุคอมมิตแบบเจาะจง ระบบจะคงอยู่ที่เวอร์ชันนั้น

5. เลือก นำเข้ามาร์เก็ตเพลส แล้วอนุญาตการเข้าถึง GitHub เมื่อระบบแจ้ง

6. ตรวจสอบ ผลการนำเข้า จากนั้นเปิดปลั๊กอินที่นำเข้าแต่ละรายการเพื่อตั้งค่านโยบายการติดตั้งและแอปที่จำเป็น

การนำเข้าครั้งแรกอาจใช้เวลาถึง 1 ชั่วโมงสำหรับมาร์เก็ตเพลสที่มีขนาดใหญ่มาก การซิงค์รายวันหลังจากนั้นมักใช้เวลาเพียงไม่กี่นาที

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

รูปแบบที่รองรับ

ไดเรกทอรีที่เลือกต้องมีไฟล์ manifest ที่รองรับ:

• .agents/plugins/marketplace.json สำหรับมาร์เก็ตเพลส Codex

• .claude-plugin/marketplace.json สำหรับมาร์เก็ตเพลสที่เข้ากันได้กับ Claude

• .claude-plugin/plugin.json สำหรับปลั๊กอิน Claude แบบสแตนด์อโลนในกรณีที่ไม่มีไฟล์ manifest ของมาร์เก็ตเพลส

รายการในมาร์เก็ตเพลสสามารถอ้างอิงโฟลเดอร์ปลั๊กอินใน Repository เดียวกัน หรือแหล่งที่มาจาก Repository บน GitHub ที่รองรับได้ การนำเข้าในเวิร์กสเปซไม่รองรับโฮสต์ Git อื่นๆ และแหล่งที่มาจากรีจิสทรีแพ็กเกจ เช่น npm

สำหรับรูปแบบที่รองรับ ตัวอย่าง JSON และฟิลด์แหล่งที่มา โปรดดู: การจัดการปลั๊กอิน

ตั้งค่าการเข้าถึงในเวิร์กสเปซ

GitHub เป็นแหล่งเนื้อหาปลั๊กอิน ส่วนการตั้งค่าเวิร์กสเปซจะควบคุมการติดตั้งและการยืนยันตัวตน การนำเข้าและการซิงค์จะไม่นำค่านโยบายใน Repository เช่น AVAILABLE หรือ ON_USE มาใช้ กำหนดการตั้งค่าเหล่านี้ให้กับปลั๊กอินแต่ละรายการในเวิร์กสเปซของคุณ


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


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


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

อัปเดตปลั๊กอินให้เป็นปัจจุบัน

มาร์เก็ตเพลสใหม่จะตรวจสอบการอัปเดตทุกวัน หากต้องการขออัปเดตโดยไม่รอการซิงค์อัตโนมัติ:

1. ไปที่คอนโซลผู้ดูแลระบบ เลือกเวิร์กสเปซ ChatGPT ที่ต้องการ แล้วเปิด ปลั๊กอิน

2. เปิด มาร์เก็ตเพลส แล้วเลือกมาร์เก็ตเพลสที่ต้องการ

3. เลือก ซิงค์ตอนนี้

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

ตรวจสอบผลการซิงค์

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


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


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

ทำความเข้าใจการนำออกและการลบ

การนำรายการออกจาก Repository จะไม่ลบสำเนาที่นำเข้าไว้ในเวิร์กสเปซ ปลั๊กอินจะแสดงสถานะ ไม่มีอยู่ในแหล่งที่มาแล้ว


การลบมาร์เก็ตเพลสใน ChatGPT จะลบปลั๊กอินทั้งหมดที่นำเข้าจากมาร์เก็ตเพลสนั้น อย่าลบมาร์เก็ตเพลสเพื่อเชื่อมต่อ GitHub ใหม่หรือเปลี่ยนเจ้าของ

เชื่อมต่อใหม่หรือเปลี่ยนการเข้าถึง GitHub

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

เชื่อมต่อบัญชีเดิมอีกครั้ง

1. ตรวจสอบให้แน่ใจว่าบัญชี GitHub ที่ใช้ในการนำเข้ายังคงมีสิทธิ์เข้าถึง Repository ที่จำเป็นทั้งหมด

2. ขอให้ผู้ดูแลระบบที่นำเข้ามาร์เก็ตเพลสตั้งแต่แรกเปิดปลั๊กอิน GitHub ใน ChatGPT แล้วเชื่อมต่อบัญชีของตนอีกครั้ง

โอนให้ผู้ดูแลระบบคนใหม่

ผู้ดูแลเวิร์กสเปซคนใหม่สามารถนำเข้ามาร์เก็ตเพลสเดิมโดยใช้การเชื่อมต่อ GitHub ของตนเองได้:

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

2. ป้อนค่า แหล่งที่มา, พาธ และ บรานช์ แท็ก หรือคอมมิต ให้ตรงกับค่าที่ใช้กับมาร์เก็ตเพลสเดิม

3. เลือก นำเข้ามาร์เก็ตเพลส แล้วอนุญาตการเข้าถึง GitHub เมื่อระบบแจ้ง

การซิงค์ในอนาคตจะใช้การเชื่อมต่อ GitHub ของผู้ดูแลระบบคนใหม่ บัญชีของผู้ดูแลระบบคนใหม่ต้องมีสิทธิ์อ่าน Repository ของมาร์เก็ตเพลสและ Repository ทั้งหมดที่มาร์เก็ตเพลสอ้างอิง

ย้ายปลั๊กอินที่มีอยู่ไปจัดการผ่าน GitHub

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


หากต้องการระบุปลั๊กอินที่มีอยู่ในมาร์เก็ตเพลสของคุณ:

1. ไปที่คอนโซลผู้ดูแลระบบ เลือกเวิร์กสเปซ ChatGPT ที่ต้องการ แล้วเปิด ปลั๊กอิน เปิดปลั๊กอิน

2. คัดลอก ID ของปลั๊กอินที่อยู่หลัง /admin/plugins/ ใน URL ของปลั๊กอิน

3. เพิ่ม ID นั้นเป็นค่า pluginId คู่กับ name และ source ในรายการที่ตรงกันของอาร์เรย์ plugins ในมาร์เก็ตเพลส อย่าเพิ่ม ID นี้ลงในไฟล์ plugin.json ของปลั๊กอิน

ปลั๊กอินจะยังคงใช้ ID การแชร์ และนโยบายเวิร์กสเปซเดิม GitHub จะกลายเป็นแหล่งที่มาของการอัปเดตในอนาคต จึงไม่สามารถอัปโหลดไฟล์เก็บถาวรมาแทนที่ปลั๊กอินนี้ในภายหลังได้


สำหรับตัวอย่างการย้ายและข้อกำหนด โปรดดู: การจัดการปลั๊กอิน

อ้างอิงแอปที่มีอยู่

ปลั๊กอินสามารถอ้างอิงแอปที่มีอยู่ใน .app.json ที่ไดเรกทอรีรากของปลั๊กอินได้ ชื่อไฟล์ต้องมีจุดนำหน้า และให้ใช้ ID ของแอป ไม่ใช่ ID ของปลั๊กอิน สำหรับปลั๊กอินแบบเนทีฟ ให้ตั้งค่าฟิลด์ apps ใน .codex-plugin/plugin.json เป็น ./.app.json


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


สำหรับรูปแบบ JSON โปรดดู: การจัดการปลั๊กอิน

ทำความเข้าใจป้ายกำกับเฉพาะเดสก์ท็อป

ปลั๊กอินที่มีป้ายกำกับ เฉพาะเดสก์ท็อป จะไม่สามารถทำงานใน ChatGPT บนเว็บได้ ปลั๊กอินที่นำเข้าอาจได้รับป้ายกำกับนี้เมื่อมีการประกาศเซิร์ฟเวอร์ MCP เช่น ใน mcp.json หรือ .mcp.json แม้ว่าเซิร์ฟเวอร์จะใช้ URL แบบ HTTPS ระยะไกลก็ตาม


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