अवलोकन

वर्कस्पेस व्यवस्थापक GitHub से अपनी वर्कस्पेस डायरेक्टरी में प्लगइन मार्केटप्लेस आयात कर सकते हैं. मार्केटप्लेस एक JSON सूची है, जिसमें आयात किए जाने वाले प्लगइन दिए होते हैं. आयात के बाद, दैनिक सिंक रिपॉज़िटरी में हुए बदलावों के अनुसार प्लगइन को अद्यतित रखता है.


मार्केटप्लेस सिंक प्लगइन की सामग्री आयात करता है—यह वर्कस्पेस के सदस्यों के खाते नहीं जोड़ता और न ही प्लगइन में शामिल ऐप का ऐक्सेस देता है.


प्लगइन और उनमें शामिल ऐप के परिचय के लिए देखें: ChatGPT और Codex में प्लगइन.

शुरू करने से पहले

• ऐसा GitHub खाता इस्तेमाल करें जिसके पास मार्केटप्लेस की रिपॉज़िटरी और उसमें संदर्भित हर दूसरी रिपॉज़िटरी को पढ़ने की अनुमति हो. github.com पर सार्वजनिक और निजी रिपॉज़िटरी समर्थित हैं.

• आयात करने वाले खाते को उन रिपॉज़िटरी का ऐक्सेस देने के लिए GitHub संगठन की सभी आवश्यक अनुमोदन प्रक्रियाएँ पूरी करें.

• रिपॉज़िटरी की सामग्री की समीक्षा करें. आयात सभी मान्य प्लगइन को संसाधित करता है. हर प्लगइन के लिए अलग अनुमोदन की ज़रूरत नहीं होती, और भविष्य में होने वाले सिंक नए प्लगइन जोड़ सकते हैं.

नए प्लगइन की शुरुआती स्थापना सेटिंग उपलब्ध होती है और प्रमाणीकरण स्थापना के समय होता है. नए मार्केटप्लेस में स्वचालित दैनिक सिंक सक्षम होता है. आयात के बाद, हर प्लगइन की वर्कस्पेस सेटिंग और आवश्यक ऐप की समीक्षा करें.

मार्केटप्लेस आयात करें

1. व्यवस्थापक कंसोल पर जाएँ, इच्छित ChatGPT वर्कस्पेस चुनें और प्लगइन खोलें. फिर जोड़ें चुनें और मार्केटप्लेस आयात करें चुनें.

2. स्रोत में रिपॉज़िटरी का यूआरएल दर्ज करें, जैसे https://github.com/example/team-plugins. केवल रिपॉज़िटरी का यूआरएल इस्तेमाल करें, किसी शाखा या फ़ोल्डर का यूआरएल नहीं.

3. अगर मार्केटप्लेस किसी उप-डायरेक्टरी में है, तो पथ में वह डायरेक्टरी दर्ज करें. उदाहरण के लिए, team-tools/.agents/plugins/marketplace.json के लिए team-tools दर्ज करें. रिपॉज़िटरी की मूल डायरेक्टरी के लिए पथ खाली छोड़ दें. मैनिफेस्ट फ़ाइल का नाम दर्ज न करें.

4. चाहें तो शाखा, टैग या कमिट दर्ज करें. रिपॉज़िटरी की डिफ़ॉल्ट शाखा इस्तेमाल करने के लिए इसे खाली छोड़ दें. भविष्य के कमिट पाने के लिए शाखा इस्तेमाल करें. किसी निश्चित कमिट को चुनने पर वही संशोधन बना रहता है.

5. मार्केटप्लेस आयात करें चुनें और पूछे जाने पर GitHub ऐक्सेस की अनुमति दें.

6. आयात के नतीजे की समीक्षा करें, फिर हर आयातित प्लगइन को खोलकर उसकी स्थापना नीति और आवश्यक ऐप कॉन्फ़िगर करें.

बहुत बड़े मार्केटप्लेस के शुरुआती आयात में 1 घंटे तक का समय लग सकता है. इसके बाद होने वाले दैनिक सिंक में आम तौर पर कुछ मिनट लगते हैं.

अगर कोई प्लगइन आयात नहीं हो पाता, तो रिपोर्ट में त्रुटि का कारण बताया जाता है. अन्य मान्य प्लगइन फिर भी आयात किए जा सकते हैं.

समर्थित प्रारूप

चुनी गई डायरेक्टरी में कोई समर्थित मैनिफेस्ट होना चाहिए:

• Codex मार्केटप्लेस के लिए .agents/plugins/marketplace.json.

• Claude के साथ संगत मार्केटप्लेस के लिए .claude-plugin/marketplace.json.

• कोई मार्केटप्लेस मैनिफेस्ट मौजूद न होने पर, स्वतंत्र Claude प्लगइन के लिए .claude-plugin/plugin.json.

मार्केटप्लेस की प्रविष्टियों में उसी रिपॉज़िटरी के प्लगइन फ़ोल्डर या समर्थित GitHub रिपॉज़िटरी स्रोतों का संदर्भ दिया जा सकता है. वर्कस्पेस आयात अन्य Git होस्ट और npm जैसे पैकेज-रजिस्ट्री स्रोतों का समर्थन नहीं करता.

समर्थित प्रारूपों, JSON उदाहरणों और स्रोत फ़ील्ड के लिए देखें: प्लगइन प्रबंधन.

वर्कस्पेस ऐक्सेस कॉन्फ़िगर करें

GitHub प्लगइन की सामग्री उपलब्ध कराता है, जबकि वर्कस्पेस की सेटिंग स्थापना और प्रमाणीकरण को नियंत्रित करती हैं. आयात और सिंक से रिपॉज़िटरी के नीति मान, जैसे AVAILABLE या ON_USE, लागू नहीं होते. अपने वर्कस्पेस के हर प्लगइन के लिए ये सेटिंग कॉन्फ़िगर करें.


हर पात्र भूमिका के लिए उपलब्ध या स्थापित चुनने के लिए स्थापना नीति इस्तेमाल करें. आवश्यक ऐप भी सक्षम होने चाहिए. साथ ही, सदस्यों के पास जुड़ी हुई सेवा का ऐक्सेस होना चाहिए और उन्हें सभी आवश्यक प्रमाणीकरण पूरे करने होंगे.


प्लगइन का अपडेट सिंक करने या किसी मौजूदा प्लगइन का प्रबंधन GitHub को सौंपने पर उसकी वर्कस्पेस नीतियाँ बरकरार रहती हैं. प्लगइन आयात करने से ऐप का ऐक्सेस नहीं मिलता और न ही सदस्यों के खाते जुड़ते हैं.


वर्कस्पेस में नेविगेशन, ऐप ऐक्सेस और वर्कस्पेस नियंत्रणों के लिए देखें: प्लगइन और ऐप के लिए व्यवस्थापक नियंत्रण, सुरक्षा और अनुपालन.

प्लगइन को अद्यतित रखें

नए मार्केटप्लेस रोज़ाना अपडेट की जाँच करते हैं. स्वचालित सिंक की प्रतीक्षा किए बिना अपडेट का अनुरोध करने के लिए:

1. व्यवस्थापक कंसोल पर जाएँ, इच्छित ChatGPT वर्कस्पेस चुनें और प्लगइन खोलें.

2. मार्केटप्लेस खोलें और संबंधित मार्केटप्लेस चुनें.

3. अभी सिंक करें चुनें.

सिंक से मार्केटप्लेस की नई प्रविष्टियाँ जोड़ी जा सकती हैं और मौजूदा प्लगइन अपडेट किए जा सकते हैं. रिपॉज़िटरी के बदलावों को मर्ज करने से पहले उनकी समीक्षा करें, क्योंकि स्वचालित सिंक दोबारा आयात की प्रक्रिया किए बिना नए प्लगइन आयात कर सकता है.

सिंक के नतीजों की समीक्षा करें

सिंक के बाद, उसकी स्थिति और सहेजी गई रिपोर्ट की समीक्षा करें. पूरा हुआ — N त्रुटियाँ का मतलब है कि सिंक पूरा हो गया, लेकिन कुछ प्लगइन संसाधित नहीं किए जा सके.


अगर किसी मौजूदा प्लगइन का अपडेट अमान्य है, तो उसका पिछला कार्यशील संस्करण बरकरार रखा जाता है. अन्य मान्य अपडेट फिर भी पूरे हो सकते हैं. रिपोर्ट में बताई गई समस्या को GitHub में ठीक करें, फिर दोबारा कोशिश करने के लिए अभी सिंक करें चुनें.


अगर आपके व्यवस्थापक दृश्य में अलग से आयात किए गए किसी प्लगइन के लिए रीफ़्रेश करें दिखता है, तो उस प्लगइन को रीफ़्रेश करने के लिए इसका इस्तेमाल करें. प्लगइन सूची रीफ़्रेश करें केवल दिखाई गई सूची को दोबारा लोड करता है; यह GitHub से सिंक नहीं करता.

हटाने और मिटाने का असर समझें

रिपॉज़िटरी से कोई प्रविष्टि हटाने पर वर्कस्पेस में उसकी आयातित प्रति नहीं मिटती. प्लगइन पर अब स्रोत में मौजूद नहीं है का चिह्न लग जाता है.


ChatGPT में मार्केटप्लेस मिटाने पर उससे आयात किए गए सभी प्लगइन मिट जाते हैं. GitHub से दोबारा जुड़ने या स्वामित्व बदलने के लिए मार्केटप्लेस न मिटाएँ.

GitHub से दोबारा जुड़ें या उसका ऐक्सेस बदलें

मार्केटप्लेस सिंक उसे आयात करने वाले व्यवस्थापक के GitHub कनेक्शन का इस्तेमाल करता है. उस खाते के पास मार्केटप्लेस की रिपॉज़िटरी और उसमें संदर्भित सभी रिपॉज़िटरी का ऐक्सेस बना रहना चाहिए.

मूल खाते को दोबारा जोड़ें

1. पुष्टि करें कि आयात के लिए इस्तेमाल किए गए GitHub खाते के पास अब भी सभी आवश्यक रिपॉज़िटरी का ऐक्सेस है.

2. मार्केटप्लेस को मूल रूप से आयात करने वाले व्यवस्थापक से कहें कि वे ChatGPT में GitHub प्लगइन खोलें और अपना खाता दोबारा जोड़ें.

नए व्यवस्थापक को सौंपें

नए वर्कस्पेस व्यवस्थापक अपने GitHub कनेक्शन का इस्तेमाल करके वही मार्केटप्लेस आयात कर सकते हैं:

1. व्यवस्थापक कंसोल पर जाएँ, इच्छित ChatGPT वर्कस्पेस चुनें और प्लगइन खोलें. फिर जोड़ें > मार्केटप्लेस आयात करें चुनें.

2. स्रोत, पथ और शाखा, टैग या कमिट में वही मान दर्ज करें जो मौजूदा मार्केटप्लेस के लिए इस्तेमाल किए गए थे.

3. मार्केटप्लेस आयात करें चुनें और पूछे जाने पर GitHub ऐक्सेस की अनुमति दें.

भविष्य में होने वाले सिंक नए व्यवस्थापक के GitHub कनेक्शन का इस्तेमाल करेंगे. नए व्यवस्थापक के खाते के पास मार्केटप्लेस की रिपॉज़िटरी और उसमें संदर्भित हर रिपॉज़िटरी को पढ़ने की अनुमति होनी चाहिए.

किसी मौजूदा प्लगइन का प्रबंधन GitHub को सौंपें

आप मार्केटप्लेस के ज़रिए वर्कस्पेस के ऐसे मौजूदा प्लगइन का प्रबंधन कर सकते हैं जिसे आर्काइव के रूप में अपलोड किया गया था या जिसका प्रबंधन अभी किसी GitHub स्रोत से नहीं हो रहा है. मौजूदा प्लगइन उसी वर्कस्पेस में होना चाहिए और उसका नाम भी वही होना चाहिए. किसी दूसरे GitHub स्रोत से प्रबंधित प्लगइन का नियंत्रण इस तरह नहीं लिया जा सकता.


अपने मार्केटप्लेस में मौजूदा प्लगइन की पहचान देने के लिए:

1. व्यवस्थापक कंसोल पर जाएँ, इच्छित ChatGPT वर्कस्पेस चुनें और प्लगइन खोलें. प्लगइन खोलें.

2. उसके यूआरएल में /admin/plugins/ के बाद दी गई प्लगइन आईडी कॉपी करें.

3. मार्केटप्लेस की plugins सरणी में संबंधित प्रविष्टि के name और source के साथ उस आईडी को pluginId के रूप में जोड़ें. इसे प्लगइन की plugin.json फ़ाइल में न जोड़ें.

प्लगइन की आईडी, साझाकरण सेटिंग और वर्कस्पेस नीतियाँ बरकरार रहती हैं. भविष्य के अपडेट के लिए GitHub स्रोत बन जाता है, इसलिए बाद में आर्काइव अपलोड करके इसे बदला नहीं जा सकता.


स्थानांतरण के उदाहरण और आवश्यकताओं के लिए देखें: प्लगइन प्रबंधन.

किसी मौजूदा ऐप का संदर्भ दें

प्लगइन की मूल डायरेक्टरी में मौजूद .app.json में किसी मौजूदा ऐप का संदर्भ दिया जा सकता है. फ़ाइल के नाम की शुरुआत में बिंदु ज़रूर लगाएँ और प्लगइन आईडी के बजाय ऐप की आईडी इस्तेमाल करें. नेटिव प्लगइन के लिए, .codex-plugin/plugin.json में apps फ़ील्ड का मान ./.app.json पर सेट करें.


यह संदर्भ न तो कोई ऐप बनाता है और न ही अतिरिक्त अनुमतियाँ देता है. ऐप के मौजूदा वर्कस्पेस ऐक्सेस, प्रमाणीकरण, कार्रवाई नियंत्रण और जुड़ी हुई सेवा की अनुमतियाँ लागू रहती हैं.


JSON प्रारूप के लिए देखें: प्लगइन प्रबंधन.

केवल डेस्कटॉप लेबल का मतलब समझें

केवल डेस्कटॉप के रूप में चिह्नित प्लगइन वेब पर ChatGPT में नहीं चल सकता. आयातित प्लगइन को यह लेबल तब मिल सकता है जब वे MCP सर्वर घोषित करते हैं, जैसे mcp.json या .mcp.json में, भले ही सर्वर किसी दूरस्थ HTTPS यूआरएल का इस्तेमाल करता हो.


सिर्फ़ .app.json का संदर्भ जोड़ने से केवल डेस्कटॉप लेबल नहीं हटता. संदर्भित हर ऐप सदस्य की भूमिका के लिए उपलब्ध होना चाहिए, और उसके ऐक्सेस व प्रमाणीकरण की सामान्य आवश्यकताएँ लागू रहती हैं.