यदि आप ChatGPT वर्कस्पेस के एडमिन हैं या ChatGPT Plus या ChatGPT Pro उपयोगकर्ता हैं और अपने संगठन के Databricks OAuth क्लाइंट के साथ Databricks Genie कनेक्टर सेट अप कर रहे हैं, तो इस गाइड का उपयोग करें.
Databricks के लिए अधिकांश सेटअप Databricks अकाउंट कंसोल में होता है. आप कस्टम OAuth ऐप कनेक्शन बनाते हैं, ChatGPT कॉलबैक URL पंजीकृत करते हैं, जनरेट किए गए क्लाइंट क्रेडेंशियल कॉपी करते हैं और फिर वे मान ChatGPT कनेक्टर सेटअप प्रक्रिया में दर्ज करते हैं.
आप क्या सेट अप कर रहे हैं
आप अपने ChatGPT खाते या वर्कस्पेस के लिए Databricks ऐप कनेक्शन बना रहे हैं. यह कनेक्शन इनका उपयोग करता है:
आपके Databricks अकाउंट कंसोल में बनाया गया Databricks OAuth ऐप कनेक्शन.
Databricks OAuth क्लाइंट ID और क्लाइंट सीक्रेट.
ChatGPT से कॉपी किया गया हूबहू कॉलबैक URL.
उन कनेक्टर क्षमताओं से मेल खाने वाले Databricks स्कोप जिन्हें आप चालू करना चाहते हैं.
ChatGPT सेटअप प्रक्रिया में मांगी गई Databricks प्रदाता की जानकारी, जैसे वर्कस्पेस होस्ट, अकाउंट होस्ट, अकाउंट ID या वेयरहाउस.
शुरू करने से पहले
आपको ये चाहिए:
ChatGPT वर्कस्पेस के एडमिन या मालिक की एक्सेस अथवा ChatGPT Plus या ChatGPT Pro खाता.
Databricks अकाउंट एडमिन की एक्सेस. कुछ कामों के लिए वर्कस्पेस एडमिन की एक्सेस पर्याप्त हो सकती है, लेकिन कस्टम ऐप कनेक्शन Databricks अकाउंट कंसोल से कॉन्फ़िगर किए जाते हैं.
अलग टैब में खुला हुआ Databricks अकाउंट कंसोल.
ChatGPT में खुली हुई Databricks Genie कनेक्शन स्क्रीन, ताकि आप हूबहू कॉलबैक URL कॉपी कर सकें.
यह निर्णय कि ऐप को सामान्य Databricks API एक्सेस चाहिए या केवल Databricks SQL एक्सेस.
Databricks क्लाइंट सीक्रेट को संभालने के लिए सुरक्षित स्थान.
यदि आपका Databricks खाता या वर्कस्पेस IP एक्सेस सूची, संदर्भ-आधारित इनग्रेस नियंत्रण, फ़ायरवॉल या किसी अन्य नेटवर्क नीति के ज़रिए एक्सेस सीमित करता है, तो ऐसे Databricks एडमिन की मदद लें जो मौजूदा ChatGPT कनेक्टर के एग्रेस IP दायरों को अनुमति दे सके.
ध्यान दें: आपको ChatGPT में दिखाया गया हूबहू कॉलबैक URL कॉपी करना होगा.
तैयार रखने वाले मान
कॉलबैक URL: इसे ChatGPT कनेक्टर सेटअप प्रक्रिया से कॉपी करें.
Databricks OAuth क्लाइंट ID.
Databricks OAuth क्लाइंट सीक्रेट.
Databricks एक्सेस स्कोप, जैसे सभी API या SQL.
ChatGPT सेटअप प्रक्रिया में मांगे गए Databricks वर्कस्पेस या खाते के फ़ील्ड.
ChatGPT में ऐप सेटअप शुरू करें
ChatGPT में उस खाते या वर्कस्पेस पर जाएं जहां ऐप उपलब्ध होना चाहिए.
वर्कस्पेस एडमिन या मालिक के रूप में वर्कस्पेस सेटिंग > प्लगइन पर जाएं.
निर्देशिका में Databricks Genie चुनें.
ऐप कनेक्शन जोड़ें चुनें.
Databricks Genie कनेक्ट करें डायलॉग में OAuth क्लाइंट अनुभाग ढूंढें.
ChatGPT से मिला कॉलबैक URL. यह डायलॉग खुला रखें.
कॉलबैक URL का उदाहरण:
https://chatgpt.com/connector/oauth/<callback_id>
कॉलबैक ID न हटाएं, अंत में स्लैश न जोड़ें और इसे किसी सामान्य ChatGPT URL से न बदलें. Databricks में पंजीकृत URL, ChatGPT में दिखाए गए कॉलबैक URL से हूबहू मेल खाना चाहिए.
Databricks में OAuth ऐप कनेक्शन बनाएं
अपने Databricks खाते का Databricks अकाउंट कंसोल खोलें.
बाएं साइडबार में सेटिंग खोलें.
ऐप कनेक्शन टैब खोलें.
कनेक्शन जोड़ें चुनें.
ऐप का नाम दर्ज करें, जैसे ChatGPT Databricks कनेक्टर.
रीडायरेक्ट URL में ChatGPT से कॉपी किया गया हूबहू कॉलबैक URL चिपकाएं.
एक्सेस स्कोप के अंतर्गत ऐप के लिए ज़रूरी स्कोप चुनें.
SQL के अलावा अन्य Databricks API की ज़रूरत वाले सामान्य Databricks ऐप के लिए सभी API का उपयोग करें.
केवल Databricks SQL API तक सीमित ऐप के लिए SQL का उपयोग करें.
सुनिश्चित करें कि बाद में ChatGPT में सूचीबद्ध होने वाला हर स्कोप इस Databricks OAuth ऐप पर चालू है. UI में बनाए गए ऐप के लिए Databricks अपने-आप openid, email, profile और offline_access की अनुमति देता है.
यदि आपके संगठन की कोई विशिष्ट नीति न हो, तो टोकन TTL को Databricks के डिफ़ॉल्ट मानों पर रहने दें: एक्सेस टोकन के लिए 60 मिनट और रीफ़्रेश टोकन के लिए 10080 मिनट.
क्लाइंट सीक्रेट जनरेट करें चालू करें. इस प्रक्रिया के लिए ChatGPT को गोपनीय OAuth क्लाइंट चाहिए.
कनेक्शन बनाएं.
Databricks से क्रेडेंशियल कॉपी करें
कनेक्शन बन गया डायलॉग में क्लाइंट ID कॉपी करें.
क्लाइंट सीक्रेट तुरंत कॉपी करके सुरक्षित रूप से संग्रहीत करें.
यदि आपने सीक्रेट कॉपी करने से पहले डायलॉग बंद कर दिया है, तो OAuth ऐप क्रेडेंशियल बनाएं या रोटेट करें और नए सीक्रेट का उपयोग करें.
Databricks सीक्रेट केवल एक बार दिखाता है. इसे क्रेडेंशियल की तरह सुरक्षित रखें और स्क्रीनशॉट, टिकट, टिप्पणी या चैट में शामिल न करें.
ChatGPT में सेटअप पूरा करें
Databricks Genie कनेक्ट करें डायलॉग पर वापस जाएं.
OAuth क्लाइंट ID में Databricks क्लाइंट ID दर्ज करें.
OAuth क्लाइंट सीक्रेट में Databricks क्लाइंट सीक्रेट दर्ज करें.
सामान्य API एक्सेस के लिए स्कोप (वैकल्पिक) में all-apis और offline_access रहने दें.
हर पंक्ति में एक स्कोप दर्ज करें या स्कोप को कॉमा से अलग करें. ChatGPT में सूचीबद्ध हर स्कोप Databricks OAuth ऐप पर चालू होना चाहिए.
वर्कस्पेस होस्टनेम (ज़रूरी) में https:// या URL पाथ शामिल किए बिना मान दर्ज करें. सेटअप प्रक्रिया में दिखाए गए Databricks प्रदाता के अन्य सभी ज़रूरी फ़ील्ड भरें.
जारी रखें चुनें.
ChatGPT ठीक वही स्कोप मांगता है जो स्कोप (वैकल्पिक) में दर्ज किए गए हैं. यह अपने-आप व्यापक टेम्पलेट स्कोप नहीं जोड़ता.
कनेक्ट करके जांचें
कनेक्टर की जानकारी, कार्रवाइयों और प्रमाणीकरण सेटिंग की समीक्षा करें.
यदि आप वर्कस्पेस एडमिन हैं, तो वर्कस्पेस के लिए कनेक्टर चालू करें और वर्कस्पेस नीति के अनुसार तय करें कि इसका उपयोग कौन कर सकता है.
अनुमति प्राप्त परीक्षण उपयोगकर्ता के रूप में ChatGPT से कनेक्शन प्रक्रिया शुरू करें और फिर Databricks में साइन इन करें.
पुष्टि करें कि ब्राउज़र में अपेक्षित Databricks खाता या वर्कस्पेस खुलता है.
मांगे गए स्कोप की समीक्षा करें और फिर अधिकृत करें चुनें.
पुष्टि करें कि ब्राउज़र ChatGPT पर वापस आता है और कनेक्टर कनेक्टेड दिखाई देता है.
पहले कम जोखिम वाली रीड कार्रवाई चलाएं, जैसे मौजूदा उपयोगकर्ता की जानकारी पाना या किसी स्वीकृत Databricks SQL संसाधन पर क्वेरी करना.
यदि राइट कार्रवाइयां चालू हैं, तो व्यापक रूप से उपलब्ध कराने से पहले कम जोखिम वाली Databricks कार्यप्रणाली से परीक्षण करें.
वर्कस्पेस सेटअप के लिए अनुमति प्राप्त किसी गैर-एडमिन सदस्य से कनेक्ट करने और कम जोखिम वाला परीक्षण दोहराने को कहें.
एक्सेस प्रबंधित करें
एक्सेस नियंत्रण में Databricks और ChatGPT दोनों की भूमिका होती है.
ChatGPT में वर्कस्पेस एडमिन तय करते हैं कि ऐप उपलब्ध होगा या नहीं और सदस्य उसका उपयोग कैसे कर सकते हैं. इनके लिए Databricks ऐप एडमिन नियंत्रणों (वर्कस्पेस सेटिंग > ऐप) की समीक्षा करें:
कौन-सी वर्कस्पेस भूमिकाएं कनेक्टर का उपयोग कर सकती हैं, यह कॉन्फ़िगर करने के लिए उपयोगकर्ता एक्सेस.
कौन-सी Databricks कार्रवाइयां चालू होंगी, यह कॉन्फ़िगर करने के लिए कार्रवाई नियंत्रण.
कनेक्टर का उपयोग करने से पहले ChatGPT सदस्यों से कब पूछेगा, यह कॉन्फ़िगर करने के लिए ऐप अनुमतियां.
ये ऐप अनुमतियां ChatGPT वार्तालापों पर लागू होती हैं. वर्कस्पेस एजेंट, एजेंट के निर्माता द्वारा तय किए गए प्रति-एजेंट नियंत्रणों से निर्धारित करते हैं कि कौन-सी ऐप कार्रवाइयां उपलब्ध होंगी और अंतिम उपयोगकर्ताओं से उन्हें स्वीकृत करने के लिए कब पूछा जाएगा. एजेंट के व्यवहार के बारे में जानने के लिए देखें: Enterprise और Business के लिए ChatGPT वर्कस्पेस एजेंट.
Databricks में एडमिन प्रबंधित करते हैं कि कौन-से उपयोगकर्ता OAuth ऐप को अधिकृत कर सकते हैं और वे किन Databricks संसाधनों को एक्सेस कर सकते हैं. ChatGPT में ऐप चालू होने के बाद भी प्रदाता की अनुमतियां लागू रहती हैं.
Databricks कनेक्टर सेटअप की समस्याएं हल करना
रीडायरेक्ट URI मेल नहीं खाता: पुष्टि करें कि Databricks का रीडायरेक्ट URL मान ChatGPT में दिखाए गए कॉलबैक URL से हूबहू मेल खाता है, जिसमें उसका पाथ और कॉलबैक ID भी शामिल है. कॉलबैक ID न हटाएं, अंत में स्लैश न जोड़ें और इसकी जगह कोई दूसरा ChatGPT रीडायरेक्ट URL न डालें.
सीक्रेट मौजूद नहीं है: Databricks सीक्रेट केवल एक बार दिखाए जाते हैं. यदि क्लाइंट सीक्रेट कॉपी नहीं किया गया था, तो नया सीक्रेट जनरेट करें.
OAuth ऐप तुरंत उपलब्ध नहीं है: Databricks के अनुसार OAuth ऐप्लिकेशन के अपडेट को संसाधित होने में 30 मिनट तक लग सकते हैं.
स्कोप अपर्याप्त है या मेल नहीं खाता: ChatGPT के स्कोप (वैकल्पिक) की तुलना Databricks OAuth ऐप के एक्सेस स्कोप से करें. ChatGPT द्वारा मांगा गया हर स्कोप वहां चालू होना चाहिए. गैर-SQL API के लिए पुष्टि करें कि Databricks में all-apis चालू है और ChatGPT की स्कोप सूची में बना हुआ है.
SQL कार्रवाइयां विफल होती हैं: SQL स्कोप, वेयरहाउस कॉन्फ़िगरेशन और Databricks अनुमतियों की पुष्टि करें.
गलत ChatGPT वर्कस्पेस: कनेक्टर उसी ChatGPT वर्कस्पेस में बनाकर चालू करें जहां उपयोगकर्ता उसे कनेक्ट करेंगे.
गलत Databricks खाता या वर्कस्पेस: वर्कस्पेस होस्टनेम (ज़रूरी) मान की पुष्टि करें, फिर साइन-इन प्रक्रिया दोहराएं और जांचें कि Databricks में अपेक्षित खाता या वर्कस्पेस खुलता है.
उपयोगकर्ता कनेक्ट नहीं कर सकते: पुष्टि करें कि उपयोगकर्ता के पास Databricks एक्सेस है और उसे OAuth ऐप अधिकृत करने की अनुमति है. यह भी पुष्टि करें कि उपयोगकर्ता का ChatGPT उपयोगकर्ता एक्सेस कनेक्टर को अनुमति देता है.
Databricks नेटवर्क नीति कनेक्टर को रोकती है: यदि Databricks केवल विशिष्ट स्रोत IP को अनुमति देता है, तो Databricks एडमिन को संबंधित खाते या वर्कस्पेस की IP एक्सेस सूचियां, संदर्भ-आधारित इनग्रेस नियंत्रण, फ़ायरवॉल या ग्राहक द्वारा नियंत्रित अन्य नेटवर्क नियम अपडेट करने होंगे.
मौजूदा ChatGPT कनेक्टर एग्रेस IP दायरों से आने वाले कनेक्शन की अनुमति दें.
इस अनुमति-सूची को Databricks या ग्राहक द्वारा नियंत्रित नेटवर्क स्तर पर कॉन्फ़िगर करें. यह ChatGPT वर्कस्पेस की IP अनुमति-सूची से अलग है.
प्रकाशित दायरे बदल सकते हैं. जहां संभव हो, JSON से अपडेट को स्वचालित करें.
नेटवर्क अवरोध से बचने के लिए क्लाइंट सीक्रेट रोटेट न करें और OAuth स्कोप न बदलें. पहले पुष्टि करें कि क्या Databricks कनेक्टर के स्रोत IP को अस्वीकार कर रहा है.