ओवरव्यू.
इस गाइड का उपयोग करें अगर आप ChatGPT वर्कस्पेस एडमिन हैं और अपने संगठन के लिए GitHub Enterprise ऐप टेम्पलेट सेट कर रहे हैं. टेम्पलेट वह अंतिम ऐप नहीं है जिसे सदस्य उपयोग करते हैं. यह एक सेटअप फ़्लो है जो आवश्यक GitHub Enterprise कॉन्फ़िगरेशन देने के बाद वर्कस्पेस-विशिष्ट ड्राफ़्ट ऐप बनाता है.
GitHub Enterprise के लिए, सेटअप ChatGPT को आपके संगठन के GitHub Enterprise होस्ट से जोड़ता है. आप GitHub App बनाते हैं, ChatGPT कॉलबैक URL रजिस्टर करते हैं, क्रेडेंशियल जनरेट करते हैं, फिर उन मानों को ChatGPT टेम्पलेट सेटअप फ़्लो में पेस्ट करते हैं. ChatGPT द्वारा ड्राफ़्ट ऐप बनाने के बाद, आप इसे प्रकाशित कर सकते हैं और अन्य वर्कस्पेस ऐप्स की तरह प्रबंधित कर सकते हैं.
आप क्या सेट कर रहे हैं.
आप ChatGPT में वर्कस्पेस-विशिष्ट GitHub Enterprise ऐप बना रहे हैं. ऐप उपयोग करता है:
आपके GitHub Enterprise होस्ट पर रजिस्टर किया गया GitHub App.
उपयोगकर्ता OAuth प्राधिकरण के लिए GitHub App क्लाइंट ID और क्लाइंट सीक्रेट.
GitHub App निजी कुंजी, ताकि ChatGPT रिपॉज़िटरी संचालन के लिए इंस्टॉलेशन टोकन बना सके.
वेबहुक सीक्रेट और वेबहुक URL, ताकि GitHub Enterprise इंस्टॉलेशन और रिपॉज़िटरी इवेंट ChatGPT को वापस भेज सके.
आपका GitHub Enterprise होस्टनाम, जैसे
github.example.com.
स्टैंडअलोन GitHub OAuth App नहीं, बल्कि GitHub App बनाएं. ChatGPT टेम्पलेट सेटअप के लिए GitHub App क्रेडेंशियल, निजी कुंजी और वेबहुक सेटिंग्स की आवश्यकता होती है.
शुरू करने से पहले.
आपको चाहिए:
ChatGPT वर्कस्पेस एडमिन या स्वामी एक्सेस.
GitHub Enterprise एडमिन या संगठन-स्वामी एक्सेस, जो GitHub Apps बना और इंस्टॉल कर सके.
केवल GitHub Enterprise होस्टनाम, बिना
https://या पाथ के.यह निर्णय कि ChatGPT किन रिपॉज़िटरी क्रियाओं का समर्थन करे, जैसे रीड-ओनली रिपॉज़िटरी खोज, पुल रिक्वेस्ट वर्कफ़्लो, इश्यू वर्कफ़्लो, फ़ाइल संपादन, GitHub Actions या व्यापक Codex वर्कफ़्लो.
GitHub App निजी कुंजी और क्लाइंट सीक्रेट संभालने के लिए सुरक्षित स्थान.
ChatGPT और GitHub Enterprise को अलग-अलग टैब में खुला रखें. कॉलबैक URL खुद न बनाएं. ChatGPT में दिखाया गया सटीक कॉलबैक URL कॉपी करें.
तैयार करने के लिए मान.
GitHub Enterprise होस्टनाम: उदाहरण के लिए,
github.example.com.कॉलबैक URL: इसे ChatGPT टेम्पलेट सेटअप फ़्लो से कॉपी करें.
GitHub App क्लाइंट ID.
GitHub App क्लाइंट सीक्रेट.
GitHub App निजी कुंजी PEM.
ChatGPT द्वारा जनरेट किया गया वेबहुक सीक्रेट.
ChatGPT में ड्राफ़्ट ऐप बनने के बाद जनरेट किया गया वेबहुक URL.
ChatGPT में टेम्पलेट सेटअप शुरू करें.
ChatGPT में उस वर्कस्पेस पर स्विच करें जहां ऐप उपलब्ध होना चाहिए.
वर्कस्पेस सेटिंग्स > ऐप्स खोलें.
डायरेक्टरी चुनें.
GitHub Enterprise खोजें.
GitHub Enterprise ऐप टेम्पलेट चुनें और सेटअप शुरू करें.
ऐप का स्पष्ट नाम और विवरण डालें, जैसे GitHub Enterprise या GitHub Enterprise - Engineering.
GitHub Enterprise होस्टनाम डालें, जैसे
github.example.com.ChatGPT में दिखाया गया कॉलबैक URL कॉपी करें. इस टैब को खुला रखें.
अगर सेटअप के दौरान जनरेट किया गया वेबहुक सीक्रेट दिखे, तो उसे कॉपी करें.
उदाहरण कॉलबैक URL: https://chatgpt.com/connector/oauth/<callback_id>
कॉलबैक ID न हटाएं, अंत में स्लैश न जोड़ें, या इसे किसी सामान्य ChatGPT URL से न बदलें.
GitHub Enterprise में GitHub App बनाएं.
अपना GitHub Enterprise होस्ट खोलें, जैसे
https://github.example.com.उस संगठन या खाते पर जाएं जिसका ऐप पर स्वामित्व होना चाहिए.
Settings > Developer settings > GitHub Apps खोलें.
New GitHub App चुनें.
ऐप का स्पष्ट नाम डालें, जैसे ChatGPT GitHub Enterprise Connector.
होमपेज URL डालें. अगर कोई समर्पित आंतरिक पेज नहीं है, तो GitHub Enterprise संगठन URL का उपयोग करें.
Callback URL में, ChatGPT से कॉपी किया गया सटीक कॉलबैक URL पेस्ट करें.
Expire user authorization tokens को सक्षम रखें, जब तक आपकी सुरक्षा टीम के पास इसे बदलने का कोई खास कारण न हो.
Request user authorization during installation सक्षम करें, ताकि उपयोगकर्ता इंस्टॉल या कनेक्ट फ़्लो के दौरान ऐप को अधिकृत कर सकें.
Where can this GitHub App be installed? के अंतर्गत., अपने रोलआउट के लिए सबसे सीमित उपयुक्त विकल्प चुनें.
GitHub App बनाएं.
अनुमतियां और इवेंट कॉन्फ़िगर करें.
उन ChatGPT क्रियाओं के लिए आवश्यक न्यूनतम अनुमतियां चुनें जिन्हें आप सक्षम करने की योजना बना रहे हैं.
रीड-ओनली रिपॉज़िटरी खोज और सवाल-जवाब के लिए, इन जैसी पढ़ने की अनुमतियों से शुरू करें:
Metadata: रीड-ओनली. GitHub को GitHub Apps के लिए मेटाडेटा की आवश्यकता होती है.
Contents: फ़ाइल और रिपॉज़िटरी सामग्री एक्सेस के लिए रीड-ओनली.
Issues: रीड-ओनली, अगर इश्यू खोज या इश्यू पढ़ना आवश्यक है.
Pull requests: रीड-ओनली, अगर पुल रिक्वेस्ट खोज या समीक्षा संदर्भ आवश्यक है.
Actions: रीड-ओनली, अगर वर्कफ़्लो रन स्थिति, जॉब, लॉग या आर्टिफ़ैक्ट आवश्यक हैं.
राइट वर्कफ़्लो के लिए, केवल जहां आवश्यक हो वहां लिखने की अनुमतियां जोड़ें, जैसे Contents, Pull requests, Issues, Actions या Workflows. ऐसी सबसे सीमित अनुमतियां उपयोग करें जो इच्छित ChatGPT क्रियाओं का समर्थन करें.
वेबहुक इवेंट आपके समर्थित वर्कफ़्लो से मेल खाने चाहिए. सामान्य इवेंट में Installation, Installation repositories, Push, Pull request, Issues, Issue comment, Workflow run और Workflow job शामिल हैं.
GitHub App क्रेडेंशियल जनरेट और कॉपी करें.
GitHub App सेटिंग्स में, Client ID कॉपी करें.
Client secret जनरेट करें और तुरंत कॉपी करें.
Private keys के अंतर्गत, एक निजी कुंजी जनरेट करें.
.pem फ़ाइल डाउनलोड करें और उसे सुरक्षित रूप से स्टोर करें.
.pem फ़ाइल को स्थानीय रूप से खोलें और begin और end लाइनों सहित पूरा PEM टेक्स्ट कॉपी करें.
निजी कुंजी संवेदनशील है. इसे क्रेडेंशियल की तरह संभालें. अगर यह उजागर हो जाए, तो नई निजी कुंजी जनरेट करें, ChatGPT ऐप सेटअप अपडेट करें, और GitHub Enterprise में समझौता हुई कुंजी हटाएं.
ChatGPT में सेटअप पूरा करें.
ChatGPT टेम्पलेट सेटअप टैब पर वापस जाएं.
GitHub App Client ID को OAuth client ID में पेस्ट करें.
GitHub App Client secret को OAuth client secret में पेस्ट करें.
Scopes को अपरिवर्तित छोड़ें, जब तक आपका संगठन जानबूझकर टेम्पलेट डिफ़ॉल्ट को ओवरराइड नहीं करना चाहता.
पुष्टि करें कि GitHub Enterprise होस्टनाम केवल होस्टनाम है, जैसे
github.example.com.GitHub App निजी कुंजी PEM को GitHub App private key में पेस्ट या अपलोड करें.
पुष्टि करें कि जनरेट किया गया वेबहुक सीक्रेट मौजूद है.
ड्राफ़्ट ऐप बनाएं.
ChatGPT में बनाए गए ड्राफ़्ट ऐप का विवरण खोलें और जनरेट किया गया वेबहुक URL कॉपी करें.
वेबहुक URL ऐसा दिखना चाहिए: https://connectors.api.openai.org/connectors/<connector_id>/webhook
GitHub Enterprise में वेबहुक सेटअप पूरा करें.
GitHub Enterprise में GitHub App सेटिंग्स पर वापस जाएं.
GitHub App की सामान्य सेटिंग्स खोलें.
अगर Active webhooks पहले से सक्षम नहीं हैं, तो उन्हें सक्षम करें.
ChatGPT वेबहुक URL को Webhook URL में पेस्ट करें.
ChatGPT वेबहुक सीक्रेट को Webhook secret में पेस्ट करें.
SSL सत्यापन सक्षम रखें.
पुष्टि करें कि सब्सक्राइब किए गए वेबहुक इवेंट आपकी सक्षम की गई अनुमतियों और क्रियाओं से मेल खाते हैं.
बदलाव सहेजें.
ChatGPT में ऐप प्रकाशित और प्रबंधित करें.
ड्राफ़्ट ऐप बनाना उसे सदस्यों के लिए अपने-आप उपलब्ध नहीं करता. ड्राफ़्ट की समीक्षा करने के बाद:
ड्राफ़्ट ऐप प्रकाशित करें.
पुष्टि करें कि ऐप वर्कस्पेस सेटिंग्स > ऐप्स > सक्षम में दिखाई देता है.
वे भूमिकाएं जिनके लिए इसका उपयोग होना चाहिए, उनके लिए उपयोगकर्ता एक्सेस कॉन्फ़िगर करें.
पढ़ने और लिखने की क्रियाओं के लिए क्रिया नियंत्रण की समीक्षा करें.
ऐप का उपयोग करने से पहले ChatGPT सदस्यों से कब पूछे, यह चुनने के लिए ऐप अनुमतियां की समीक्षा करें.
किसी अनुमत परीक्षण उपयोगकर्ता से ChatGPT में ऐप्स खोलने और ऐप दिखाई देने की पुष्टि करने को कहें.
ये ऐप अनुमतियां ChatGPT वार्तालापों पर लागू होती हैं. वर्कस्पेस एजेंट, एजेंट के बिल्डर द्वारा सेट किए गए प्रति-एजेंट नियंत्रणों का उपयोग करते हैं, ताकि यह तय हो सके कि कौन-सी ऐप क्रियाएं उपलब्ध हैं और अंतिम उपयोगकर्ताओं से उन्हें मंज़ूर करने के लिए कब पूछा जाता है. एजेंट व्यवहार के लिए, देखें: Enterprise और Business के लिए ChatGPT वर्कस्पेस एजेंट.
GitHub App इंस्टॉल और परीक्षण करें.
GitHub Enterprise में, संगठन या खाते पर GitHub ऐप इंस्टॉल करें.
वर्कस्पेस नीति के अनुसार सभी रिपॉज़िटरी या चयनित रिपॉज़िटरी चुनें.
अनुमत उपयोगकर्ता के रूप में ChatGPT से कनेक्ट फ़्लो शुरू करें.
प्रॉम्प्ट मिलने पर GitHub ऐप को अधिकृत करें.
पहले कोई छोटी पढ़ने की क्रिया चलाएं, जैसे एक्सेस योग्य रिपॉज़िटरी की सूची बनाना या कोई ज्ञात पुल रिक्वेस्ट लाना.
अगर लिखने की क्रियाएं सक्षम हैं, तो व्यापक रोलआउट से पहले कम जोखिम वाली रिपॉज़िटरी के साथ परीक्षण करें.
होस्टनाम और OAuth व्यवहार.
ChatGPT GitHub Enterprise एंडपॉइंट निकालने के लिए होस्टनाम का उपयोग करता है. केवल होस्ट डालें, जैसे github.example.com या octocorp.ghe.com.
API पाथ, रिपॉज़िटरी पाथ या github.com न डालें, जब तक कि यही इस ऐप का सटीक GitHub Enterprise होस्ट न हो.
समस्या निवारण.
Redirect URI mismatch: पुष्टि करें कि GitHub App कॉलबैक URL, ChatGPT में दिखाए गए कॉलबैक URL से बिल्कुल मेल खाता है.
ChatGPT ड्राफ़्ट ऐप बना या सहेज नहीं सकता: पुष्टि करें कि होस्टनाम, OAuth client ID, OAuth client secret, निजी कुंजी और वेबहुक सीक्रेट सहित सभी आवश्यक फ़ील्ड मौजूद हैं.
प्रमाणीकरण सफल है लेकिन रिपॉज़िटरी कॉल विफल हैं: पुष्टि करें कि GitHub App इंस्टॉल है और उसे रिपॉज़िटरी का एक्सेस है.
API 403 या अपर्याप्त अनुमतियां लौटाता है: छूटी हुई GitHub App अनुमति जोड़ें और अगर प्रॉम्प्ट मिले, तो इंस्टॉलेशन स्वामी से अपडेट की गई अनुमतियां मंज़ूर कराएं.
कोई रिपॉज़िटरी दिखाई नहीं देती: पुष्टि करें कि ऐप इंस्टॉलेशन में अपेक्षित रिपॉज़िटरी शामिल हैं और ChatGPT में अधिकृत करने वाले उपयोगकर्ता को उनका एक्सेस है.
वेबहुक डिलीवरी विफल होती हैं: पुष्टि करें कि वेबहुक URL और वेबहुक सीक्रेट ChatGPT के मानों से मेल खाते हैं, SSL सत्यापन सक्षम रखें, और सुनिश्चित करें कि GitHub Enterprise होस्ट
connectors.api.openai.orgतक पहुंच सकता है.निजी कुंजी त्रुटियां: पुष्टि करें कि begin और end लाइनों सहित पूरा PEM कंटेंट कॉपी किया गया था.
