अवलोकन

अगर आप ChatGPT वर्कस्पेस के व्यवस्थापक हैं और अपने संगठन के लिए गिटहब एंटरप्राइज़ ऐप टेम्पलेट सेट अप कर रहे हैं, तो इस गाइड का उपयोग करें. टेम्पलेट वह अंतिम ऐप नहीं है जिसका सदस्य उपयोग करते हैं. यह एक सेटअप प्रक्रिया है, जो आपके द्वारा गिटहब एंटरप्राइज़ का ज़रूरी कॉन्फ़िगरेशन दिए जाने पर वर्कस्पेस के लिए एक विशिष्ट ड्राफ़्ट ऐप बनाती है.

गिटहब एंटरप्राइज़ के लिए सेटअप, ChatGPT को आपके संगठन के गिटहब एंटरप्राइज़ होस्ट से जोड़ता है. आप एक गिटहब ऐप बनाते हैं, ChatGPT कॉलबैक यूआरएल पंजीकृत करते हैं, क्रेडेंशियल जनरेट करते हैं, फिर इन मानों को ChatGPT की टेम्पलेट सेटअप प्रक्रिया में पेस्ट करते हैं. ChatGPT के ड्राफ़्ट ऐप बना देने के बाद, आप उसे प्रकाशित कर सकते हैं और वर्कस्पेस के अन्य ऐप्स की तरह प्रबंधित कर सकते हैं.

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

आप क्या सेट अप कर रहे हैं

आप ChatGPT में अपने वर्कस्पेस के लिए एक विशिष्ट गिटहब एंटरप्राइज़ ऐप बना रहे हैं. यह ऐप इनका उपयोग करता है:

• आपके गिटहब एंटरप्राइज़ होस्ट पर पंजीकृत एक गिटहब ऐप.

• उपयोगकर्ता के OAuth प्राधिकरण के लिए गिटहब ऐप की क्लाइंट आईडी और क्लाइंट सीक्रेट.

• गिटहब ऐप की निजी कुंजी, ताकि ChatGPT रिपॉज़िटरी से जुड़े कामों के लिए इंस्टॉलेशन टोकन जनरेट कर सके.

• एक वेबहुक सीक्रेट और वेबहुक यूआरएल, ताकि गिटहब एंटरप्राइज़ इंस्टॉलेशन और रिपॉज़िटरी इवेंट वापस ChatGPT को भेज सके.

• आपके गिटहब एंटरप्राइज़ का होस्टनाम, जैसे github.example.com.

गिटहब ऐप बनाएँ, न कि अलग से गिटहब OAuth ऐप. ChatGPT टेम्पलेट सेटअप के लिए गिटहब ऐप के क्रेडेंशियल, एक निजी कुंजी और वेबहुक सेटिंग्स ज़रूरी हैं.

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

आपको चाहिए:

• ChatGPT वर्कस्पेस के व्यवस्थापक या मालिक का ऐक्सेस.

• गिटहब एंटरप्राइज़ के व्यवस्थापक या संगठन के मालिक का ऐक्सेस, जिससे गिटहब ऐप्स बनाए और इंस्टॉल किए जा सकें.

• केवल गिटहब एंटरप्राइज़ का होस्टनाम, जिसमें https:// या कोई पाथ न हो.

• इस बारे में निर्णय कि ChatGPT को रिपॉज़िटरी से जुड़ी कौन-सी कार्रवाइयाँ उपलब्ध करानी चाहिए, जैसे बिना बदलाव किए रिपॉज़िटरी खोजना, pull request कार्यप्रवाह, इश्यू कार्यप्रवाह, फ़ाइल संपादन, गिटहब ऐक्शन्स या व्यापक Codex कार्यप्रवाह.

• गिटहब ऐप की निजी कुंजी और क्लाइंट सीक्रेट सँभालने के लिए एक सुरक्षित जगह.

ChatGPT और गिटहब एंटरप्राइज़ को अलग-अलग टैब में खुला रखें. कॉलबैक यूआरएल अपनी ओर से न बनाएँ. ChatGPT में दिखाया गया कॉलबैक यूआरएल ज्यों का त्यों कॉपी करें.

तैयार रखने वाले मान

• गिटहब एंटरप्राइज़ होस्टनाम: उदाहरण के लिए, github.example.com.

• कॉलबैक यूआरएल: इसे ChatGPT की टेम्पलेट सेटअप प्रक्रिया से कॉपी करें.

• गिटहब ऐप की क्लाइंट आईडी.

• गिटहब ऐप का क्लाइंट सीक्रेट.

• गिटहब ऐप की निजी कुंजी का पीईएम.

• ChatGPT द्वारा जनरेट किया गया वेबहुक सीक्रेट.

• ChatGPT में ड्राफ़्ट ऐप बनाने के बाद जनरेट किया गया वेबहुक यूआरएल.

ChatGPT में टेम्पलेट सेटअप शुरू करें

1. ChatGPT में उस वर्कस्पेस पर जाएँ जहाँ ऐप उपलब्ध होना चाहिए.

2. वर्कस्पेस सेटिंग्स > ऐप्स खोलें. आप व्यवस्थापक कंसोल पर जाकर, इच्छित ChatGPT वर्कस्पेस चुनकर प्लगइन भी खोल सकते हैं. पुराने ऐप्स पेज को खोलने के लिए पुराने ऐप्स प्रबंधित करें चुनें.

3. निर्देशिका चुनें.

4. गिटहब एंटरप्राइज़ खोजें.

5. गिटहब एंटरप्राइज़ ऐप टेम्पलेट चुनें और सेटअप शुरू करें.

6. ऐप के लिए स्पष्ट नाम और विवरण दर्ज करें, जैसे गिटहब एंटरप्राइज़ या गिटहब एंटरप्राइज़ - इंजीनियरिंग.

7. गिटहब एंटरप्राइज़ का होस्टनाम दर्ज करें, जैसे github.example.com.

8. ChatGPT में दिखाया गया कॉलबैक यूआरएल कॉपी करें. इस टैब को खुला रखें.

9. अगर सेटअप के दौरान जनरेट किया गया वेबहुक सीक्रेट दिखे, तो उसे कॉपी करें.

कॉलबैक यूआरएल का उदाहरण: https://chatgpt.com/connector/oauth/<callback_id>

कॉलबैक आईडी न हटाएँ, अंत में स्लैश न जोड़ें और इसे किसी सामान्य ChatGPT यूआरएल से न बदलें.

गिटहब एंटरप्राइज़ में गिटहब ऐप बनाएँ

1. अपना गिटहब एंटरप्राइज़ होस्ट खोलें, जैसे https://github.example.com.

2. उस संगठन या खाते पर जाएँ जिसके पास ऐप का स्वामित्व होना चाहिए.

3. सेटिंग्स > डेवलपर सेटिंग्स > गिटहब ऐप्स खोलें.

4. नया गिटहब ऐप चुनें.

5. ऐप के लिए स्पष्ट नाम दर्ज करें, जैसे ChatGPT गिटहब एंटरप्राइज़ कनेक्टर.

6. मुखपृष्ठ का यूआरएल दर्ज करें. अगर इसके लिए कोई अलग आंतरिक पेज नहीं है, तो गिटहब एंटरप्राइज़ संगठन के यूआरएल का उपयोग करें.

7. कॉलबैक यूआरएल में, ChatGPT से कॉपी किया गया कॉलबैक यूआरएल ज्यों का त्यों पेस्ट करें.

8. “उपयोगकर्ता प्राधिकरण टोकन की समय-सीमा समाप्त करें” विकल्प चालू रखें, जब तक आपकी सुरक्षा टीम के पास इसे बदलने की कोई खास वजह न हो.

9. “इंस्टॉलेशन के दौरान उपयोगकर्ता प्राधिकरण का अनुरोध करें” विकल्प चालू करें, ताकि उपयोगकर्ता इंस्टॉल या कनेक्ट करने की प्रक्रिया के दौरान ऐप को प्राधिकृत कर सकें.

10. “यह गिटहब ऐप कहाँ इंस्टॉल किया जा सकता है?” के तहत, ऐप उपलब्ध कराने की आपकी योजना के अनुरूप सबसे सीमित विकल्प चुनें.

11. गिटहब ऐप बनाएँ.

अनुमतियाँ और इवेंट कॉन्फ़िगर करें

ChatGPT में जिन कार्रवाइयों को आप चालू करना चाहते हैं, उनके लिए ज़रूरी न्यूनतम अनुमतियाँ चुनें.

बिना बदलाव किए रिपॉज़िटरी खोजने और सवाल-जवाब के लिए, केवल पढ़ने की अनुमतियों से शुरू करें, जैसे:

• मेटाडेटा: केवल पढ़ने की अनुमति. गिटहब ऐप्स के लिए गिटहब को मेटाडेटा की अनुमति चाहिए.

• सामग्री: फ़ाइल और रिपॉज़िटरी की सामग्री तक पहुँच के लिए, केवल पढ़ने की अनुमति.

• इश्यू: अगर इश्यू खोजना या पढ़ना ज़रूरी हो, तो केवल पढ़ने की अनुमति.

• pull request: अगर pull request खोजना हो या समीक्षा के लिए संदर्भ चाहिए, तो केवल पढ़ने की अनुमति.

• कार्रवाइयाँ: अगर कार्यप्रवाह के निष्पादन की स्थिति, जॉब, लॉग या आर्टिफ़ैक्ट चाहिए, तो केवल पढ़ने की अनुमति.

लिखने वाले कार्यप्रवाहों के लिए, केवल ज़रूरत वाली जगहों पर लिखने की अनुमतियाँ जोड़ें, जैसे सामग्री, pull request, इश्यू, कार्रवाइयाँ या कार्यप्रवाह. ChatGPT की इच्छित कार्रवाइयों के लिए जितनी अनुमतियाँ ज़रूरी हों, केवल उतनी ही दें.

वेबहुक इवेंट उन कार्यप्रवाहों से मेल खाने चाहिए जिन्हें आप उपलब्ध कराते हैं. आम इवेंट में इंस्टॉलेशन, इंस्टॉलेशन रिपॉज़िटरी, पुश, pull request, इश्यू, इश्यू पर टिप्पणी, कार्यप्रवाह का निष्पादन और कार्यप्रवाह जॉब शामिल हैं.

गिटहब ऐप के क्रेडेंशियल जनरेट करें और कॉपी करें

1. गिटहब ऐप की सेटिंग्स में क्लाइंट आईडी कॉपी करें.

2. एक क्लाइंट सीक्रेट जनरेट करें और उसे तुरंत कॉपी करें.

3. निजी कुंजियाँ के तहत एक निजी कुंजी जनरेट करें.

4. .pem फ़ाइल डाउनलोड करें और उसे सुरक्षित रखें.

5. अपने डिवाइस पर .pem फ़ाइल खोलें और शुरुआत व अंत की पंक्तियों सहित पूरा पीईएम टेक्स्ट कॉपी करें.

निजी कुंजी संवेदनशील जानकारी है. इसे क्रेडेंशियल की तरह सुरक्षित रखें. अगर यह उजागर हो जाए, तो नई निजी कुंजी जनरेट करें, ChatGPT ऐप का सेटअप अपडेट करें और गिटहब एंटरप्राइज़ में उजागर हुई कुंजी हटा दें.

ChatGPT में सेटअप पूरा करें

1. ChatGPT के टेम्पलेट सेटअप टैब पर वापस जाएँ.

2. गिटहब ऐप की क्लाइंट आईडी को OAuth क्लाइंट आईडी में पेस्ट करें.

3. गिटहब ऐप का क्लाइंट सीक्रेट OAuth क्लाइंट सीक्रेट में पेस्ट करें.

4. कार्यक्षेत्र में बदलाव न करें, जब तक आपके संगठन को किसी खास ज़रूरत के लिए टेम्पलेट की डिफ़ॉल्ट सेटिंग्स न बदलनी हों.

5. पुष्टि करें कि गिटहब एंटरप्राइज़ के होस्टनाम में केवल होस्टनाम ही है, जैसे github.example.com.

6. गिटहब ऐप की निजी कुंजी का पीईएम, गिटहब ऐप निजी कुंजी फ़ील्ड में पेस्ट या अपलोड करें.

7. पुष्टि करें कि जनरेट किया गया वेबहुक सीक्रेट मौजूद है.

8. ड्राफ़्ट ऐप बनाएँ.

9. ChatGPT में बनाए गए ड्राफ़्ट ऐप का विवरण खोलें और जनरेट किया गया वेबहुक यूआरएल कॉपी करें.

वेबहुक यूआरएल इस तरह का होना चाहिए: https://connectors.api.openai.org/connectors/<connector_id>/webhook

गिटहब एंटरप्राइज़ में वेबहुक सेटअप पूरा करें

1. गिटहब एंटरप्राइज़ में गिटहब ऐप की सेटिंग्स पर वापस जाएँ.

2. गिटहब ऐप की सामान्य सेटिंग्स खोलें.

3. अगर सक्रिय वेबहुक पहले से चालू नहीं हैं, तो उन्हें चालू करें.

4. ChatGPT का वेबहुक यूआरएल, वेबहुक यूआरएल फ़ील्ड में पेस्ट करें.

5. ChatGPT का वेबहुक सीक्रेट, वेबहुक सीक्रेट फ़ील्ड में पेस्ट करें.

6. एसएसएल सत्यापन चालू रखें.

7. पुष्टि करें कि सब्सक्राइब किए गए वेबहुक इवेंट, आपके द्वारा चालू की गई अनुमतियों और कार्रवाइयों से मेल खाते हैं.

8. बदलाव सहेजें.

ChatGPT में ऐप प्रकाशित और प्रबंधित करें

ड्राफ़्ट ऐप बनाने से वह अपने-आप सदस्यों के लिए उपलब्ध नहीं हो जाता. ड्राफ़्ट की समीक्षा करने के बाद:

1. ड्राफ़्ट ऐप प्रकाशित करें.

2. वर्कस्पेस सेटिंग्स में ऐप्स पेज खोलें, चालू खोलें और पुष्टि करें कि ऐप दिख रहा है. आप व्यवस्थापक कंसोल > प्लगइन में पुराने ऐप्स प्रबंधित करें विकल्प से भी ऐप्स पेज खोल सकते हैं.

3. जिन भूमिकाओं को इसका उपयोग करना चाहिए, उनके लिए उपयोगकर्ता ऐक्सेस कॉन्फ़िगर करें.

4. पढ़ने और लिखने की कार्रवाइयों के लिए कार्रवाई नियंत्रण की समीक्षा करें.

5. ऐप अनुमतियों की समीक्षा करके चुनें कि ऐप का उपयोग करने से पहले ChatGPT कब सदस्यों से पूछे.

6. अनुमति प्राप्त किसी परीक्षण उपयोगकर्ता से ChatGPT में ऐप्स खोलकर यह पुष्टि करने को कहें कि ऐप दिख रहा है.

ये ऐप अनुमतियाँ ChatGPT की बातचीत पर लागू होती हैं. वर्कस्पेस एजेंट यह तय करने के लिए प्रत्येक एजेंट के निर्माता द्वारा तय किए गए नियंत्रणों का उपयोग करते हैं कि ऐप की कौन-सी कार्रवाइयाँ उपलब्ध होंगी और अंतिम उपयोगकर्ताओं से उन्हें मंज़ूर करने के लिए कब पूछा जाएगा. एजेंट के व्यवहार के बारे में जानने के लिए देखें: एंटरप्राइज़ और बिज़नेस के लिए ChatGPT वर्कस्पेस एजेंट.

गिटहब ऐप इंस्टॉल करें और उसका परीक्षण करें

1. गिटहब एंटरप्राइज़ में संगठन या खाते पर गिटहब ऐप इंस्टॉल करें.

2. वर्कस्पेस की नीति के अनुसार सभी रिपॉज़िटरी या चुनिंदा रिपॉज़िटरी चुनें.

3. अनुमति प्राप्त उपयोगकर्ता के तौर पर ChatGPT से कनेक्ट करने की प्रक्रिया शुरू करें.

4. पूछे जाने पर गिटहब ऐप को प्राधिकृत करें.

5. पहले पढ़ने की कोई छोटी कार्रवाई करें, जैसे ऐक्सेस वाली रिपॉज़िटरी की सूची बनाना या कोई ज्ञात pull request प्राप्त करना.

6. अगर लिखने की कार्रवाइयाँ चालू हैं, तो व्यापक रूप से उपलब्ध कराने से पहले कम जोखिम वाली किसी रिपॉज़िटरी पर परीक्षण करें.

होस्टनाम और OAuth का व्यवहार

ChatGPT होस्टनाम के आधार पर गिटहब एंटरप्राइज़ के एंडपॉइंट तय करता है. केवल होस्ट दर्ज करें, जैसे github.example.com या octocorp.ghe.com.

एपीआई पाथ या रिपॉज़िटरी पाथ दर्ज न करें. github.com भी तभी दर्ज करें जब वही इस ऐप का सटीक गिटहब एंटरप्राइज़ होस्ट हो.

समस्या निवारण

• रीडायरेक्ट यूआरआई मेल नहीं खाता: पुष्टि करें कि गिटहब ऐप का कॉलबैक यूआरएल, ChatGPT में दिखाए गए कॉलबैक यूआरएल से पूरी तरह मेल खाता है.

• ChatGPT ड्राफ़्ट ऐप बना या सहेज नहीं पा रहा है: पुष्टि करें कि होस्टनाम, OAuth क्लाइंट आईडी, OAuth क्लाइंट सीक्रेट, निजी कुंजी और वेबहुक सीक्रेट सहित सभी ज़रूरी फ़ील्ड भरे गए हैं.

• प्रमाणीकरण सफल होता है, लेकिन रिपॉज़िटरी कॉल विफल होती हैं: पुष्टि करें कि गिटहब ऐप इंस्टॉल है और उसे रिपॉज़िटरी का ऐक्सेस है.

• एपीआई से 403 या अपर्याप्त अनुमतियों का जवाब मिलता है: गिटहब ऐप की छूटी हुई अनुमति जोड़ें और अगर कहा जाए, तो इंस्टॉलेशन के मालिक से अपडेट की गई अनुमतियाँ मंज़ूर करवाएँ.

• कोई रिपॉज़िटरी नहीं दिखती: पुष्टि करें कि ऐप इंस्टॉलेशन में अपेक्षित रिपॉज़िटरी शामिल हैं और ChatGPT में प्राधिकरण देने वाले उपयोगकर्ता को उनका ऐक्सेस है.

• वेबहुक डिलीवरी विफल होती है: पुष्टि करें कि वेबहुक यूआरएल और वेबहुक सीक्रेट, ChatGPT से मिले मानों से मेल खाते हैं. एसएसएल सत्यापन चालू रखें और सुनिश्चित करें कि गिटहब एंटरप्राइज़ होस्ट connectors.api.openai.org तक पहुँच सकता है.

• निजी कुंजी से जुड़ी त्रुटियाँ: पुष्टि करें कि शुरुआत और अंत की पंक्तियों सहित पूरा पीईएम कॉपी किया गया था.

संदर्भ

• गिटहब दस्तावेज़: गिटहब ऐप पंजीकृत करना

• गिटहब दस्तावेज़: उपयोगकर्ता प्राधिकरण कॉलबैक यूआरएल के बारे में

• गिटहब दस्तावेज़: गिटहब ऐप के लिए अनुमतियाँ चुनना

• गिटहब दस्तावेज़: गिटहब ऐप्स के साथ वेबहुक का उपयोग करना

• गिटहब दस्तावेज़: गिटहब ऐप्स की निजी कुंजियाँ प्रबंधित करना