आढावा

वर्कस्पेस प्रशासक GitHub वरून त्यांच्या वर्कस्पेस निर्देशिकेत प्लगइन मार्केटप्लेस आयात करू शकतात. मार्केटप्लेस ही आयात करायच्या प्लगइनची यादी असलेली JSON सूची आहे. आयात केल्यानंतर, दररोजच्या समक्रमणामुळे रिपॉझिटरीतील बदलांनुसार प्लगइन अद्ययावत राहतात.


मार्केटप्लेसच्या समक्रमणातून प्लगइनमधील सामग्री आयात केली जाते - वर्कस्पेस सदस्यांची खाती जोडली जात नाहीत किंवा प्लगइनमध्ये समाविष्ट असलेल्या ॲपचा वापर करण्याची परवानगी दिली जात नाही.


प्लगइन आणि त्यामध्ये समाविष्ट असलेल्या ॲपची ओळख करून घेण्यासाठी, पाहा: ChatGPT आणि Codex मधील प्लगइन.

सुरुवात करण्यापूर्वी

• मार्केटप्लेस रिपॉझिटरी आणि त्यात संदर्भ दिलेल्या इतर प्रत्येक रिपॉझिटरीतील सामग्री वाचण्याची परवानगी असलेले GitHub खाते वापरा. github.com वरील सार्वजनिक आणि खाजगी रिपॉझिटरींना समर्थन आहे.

• आयात करणाऱ्या खात्याला त्या रिपॉझिटरींचा प्रवेश मिळण्यासाठी GitHub संस्थेच्या मंजुरीची आवश्यकता असल्यास, ती प्रक्रिया पूर्ण करा.

• रिपॉझिटरीतील सामग्री तपासा. आयात करताना प्रत्येक प्लगइनसाठी स्वतंत्र मंजुरी न घेता सर्व वैध प्लगइनवर प्रक्रिया केली जाते आणि पुढील समक्रमणांमधून नवीन प्लगइन जोडले जाऊ शकतात.

नवीन प्लगइनसाठी सुरुवातीला स्थापना धोरण उपलब्ध असते आणि स्थापनेच्या वेळी प्रमाणीकरण केले जाते. नवीन मार्केटप्लेससाठी स्वयंचलित दैनंदिन समक्रमण सक्षम असते. आयात केल्यानंतर प्रत्येक प्लगइनच्या वर्कस्पेस सेटिंग्ज आणि आवश्यक ॲप तपासा.

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

1. प्रशासक कन्सोलवर जा, हवा असलेला ChatGPT वर्कस्पेस निवडा आणि प्लगइन उघडा. त्यानंतर जोडा निवडा आणि मार्केटप्लेस आयात करा हा पर्याय निवडा.

2. स्रोतमध्ये रिपॉझिटरीचा URL टाका, जसे की https://github.com/example/team-plugins. शाखेचा किंवा फोल्डरचा URL न वापरता, फक्त रिपॉझिटरीचा URL वापरा.

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. त्याच्या URL मधील /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 URL वापरत असला तरीही.


केवळ .app.json संदर्भ जोडल्याने फक्त डेस्कटॉपसाठी हे लेबल काढले जात नाही. संदर्भ दिलेले कोणतेही ॲप सदस्याच्या भूमिकेसाठी उपलब्ध असणे तरीही आवश्यक आहे आणि त्याच्या प्रवेश व प्रमाणीकरणाच्या नेहमीच्या अटी लागू होतात.