ChatGPT में Snowflake ऐप टेम्पलेट सेट अप करें

अगर आप ChatGPT वर्कस्पेस के व्यवस्थापक या ChatGPT Plus या Pro उपयोगकर्ता हैं और स्नोफ़्लेक द्वारा प्रबंधित एमसीपी सर्वर के ज़रिए ChatGPT को स्नोफ़्लेक से जोड़ना चाहते हैं, तो इस गाइड का उपयोग करें.

ज़्यादातर सेटअप स्नोफ़्लेक में किया जाता है. स्नोफ़्लेक तैयार होने के बाद, ChatGPT में स्नोफ़्लेक टेम्प्लेट का कनेक्शन पूरा करें, फिर उस टेम्प्लेट का उपयोग करने वाला स्नोफ़्लेक प्लगइन सक्षम करें.

• अंतर्निहित OAuth: जब यह आपके स्नोफ़्लेक खाते और ChatGPT में उपलब्ध हो, तो स्नोफ़्लेक व्यवस्थापक द्वारा सक्षम किए गए ChatGPT पार्टनर ऐप्लिकेशन का उपयोग करें. स्नोफ़्लेक में साइन इन करें. अगर आपके संगठन का SSO कॉन्फ़िगर किया गया है, तो उसका उपयोग करें. आपको ChatGPT में क्लाइंट आईडी या क्लाइंट सीक्रेट दर्ज करने की ज़रूरत नहीं है. नीचे दिए गए “अंतर्निहित OAuth” अनुभाग के निर्देशों का पालन करें.

• कस्टम OAuth क्लाइंट: अगर आपके संगठन को अपने OAuth क्लाइंट की ज़रूरत है या अंतर्निहित OAuth उपलब्ध नहीं है, तो यह तरीका अपनाएँ. नीचे दिए गए “कस्टम OAuth क्लाइंट” अनुभाग के निर्देशों का पालन करें.

OAuth के दोनों तरीकों के लिए नीचे बताए गए साझा एमसीपी सर्वर सेटअप, संबंधित ऑब्जेक्ट की अनुमतियों और नेटवर्क ऐक्सेस की ज़रूरत होती है. OAuth कॉन्फ़िगर करने से पहले, “ChatGPT में स्नोफ़्लेक सर्वर का विवरण दर्ज करें” अनुभाग तक के साझा सेटअप चरण पूरे करें.

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

आप स्नोफ़्लेक द्वारा प्रबंधित एक एमसीपी सर्वर बना रहे हैं, जो ChatGPT के लिए कनेक्टर एंडपॉइंट के तौर पर काम करता है. एमसीपी सर्वर तय करता है:

• ChatGPT किन कार्रवाइयों का उपयोग कर सकता है.

• वे टूल स्नोफ़्लेक के किस डेटा या किन ऑब्जेक्ट को ऐक्सेस कर सकते हैं.

• हर उपयोगकर्ता किस स्नोफ़्लेक भूमिका से प्राधिकरण देता है.

• कौन-से स्नोफ़्लेक डेटाबेस, स्कीमा और एमसीपी सर्वर का नाम एंडपॉइंट की पहचान करते हैं.

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

• स्नोफ़्लेक होस्ट प्रीफ़िक्स.

• डेटाबेस.

• स्कीमा.

• एमसीपी सर्वर का नाम.

ChatGPT केवल उन्हीं टूल का पता लगा सकता है और उनका उपयोग कर सकता है जिन्हें एमसीपी सर्वर उपलब्ध कराता है और जिनकी अनुमति उस स्नोफ़्लेक भूमिका को है जिससे उपयोगकर्ता प्राधिकरण देता है.

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

आपको चाहिए:

• ChatGPT वर्कस्पेस में व्यवस्थापक या स्वामी का ऐक्सेस, या ChatGPT Plus या Pro का ऐक्सेस.

• स्नोफ़्लेक का ऐसा ऐक्सेस जिससे एमसीपी सर्वर ऑब्जेक्ट बनाए जा सकें और अनुमतियाँ दी जा सकें.

• वह स्नोफ़्लेक डेटाबेस और स्कीमा जिसमें एमसीपी सर्वर रहेगा.

• यह निर्णय कि ChatGPT को क्या करने की अनुमति दी जाए, जैसे कॉर्टेक्स सर्च, कॉर्टेक्स एनालिस्ट, केवल पढ़ने वाले एसक्यूएल या किसी विशिष्ट प्रोसीजर या फ़ंक्शन का उपयोग.

• केवल न्यूनतम आवश्यक विशेषाधिकारों वाली स्नोफ़्लेक भूमिका, जिसका उपयोग उपयोगकर्ता ऐप को अधिकृत करते समय करेंगे.

• स्नोफ़्लेक खाते का होस्ट प्रीफ़िक्स, जिसमें क्षेत्र या क्लाउड का कोई भी सफ़िक्स शामिल हो.

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

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

• स्नोफ़्लेक होस्ट प्रीफ़िक्स: स्नोफ़्लेक खाते के यूआरएल में .snowflakecomputing.com से पहले का पूरा हिस्सा.

• डेटाबेस: वह डेटाबेस जिसमें एमसीपी सर्वर है.

• स्कीमा: वह स्कीमा जिसमें एमसीपी सर्वर है.

• एमसीपी सर्वर का नाम: स्नोफ़्लेक एमसीपी सर्वर ऑब्जेक्ट का नाम.

• प्रबंधित एमसीपी सर्वर का पूरा यूआरएल, अगर ChatGPT की सेटअप स्क्रीन यूआरएल माँगती है.

• स्नोफ़्लेक भूमिका: वह भूमिका जिसका उपयोग उपयोगकर्ताओं को ऐप को अधिकृत करते समय करना चाहिए.

• टूल की सूची: वे स्नोफ़्लेक ऑब्जेक्ट और कार्रवाइयाँ जिनका आप ChatGPT से उपयोग करवाना चाहते हैं.

तय करें कि ChatGPT क्या कर सकता है

केवल वे क्षमताएँ चुनें जिन्हें आप उपलब्ध कराना चाहते हैं. आम विकल्पों में शामिल हैं:

• इंडेक्स किए गए स्नोफ़्लेक डेटा या सामग्री में जवाब ढूँढ़ने के लिए कॉर्टेक्स सर्च से खोज करना.

• स्वीकृत सिमैंटिक व्यू के ज़रिए कॉर्टेक्स एनालिस्ट से सवाल-जवाब करना.

• क्वेरी ऐक्सेस को नियंत्रित रखने के लिए केवल पढ़ने वाला एसक्यूएल.

• किसी विशिष्ट कार्यप्रवाह के लिए स्नोफ़्लेक एजेंट, संग्रहीत प्रोसीजर या यूडीएफ़.

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

स्नोफ़्लेक वर्कशीट खोलें

1. स्नोफ़्लेक ऐप में साइन इन करें.

2. ऐसी भूमिका पर स्विच करें जिसे एमसीपी सर्वर बनाने और ऐक्सेस देने की अनुमति हो.

3. वर्कस्पेस पर जाएँ.

   

4. एसक्यूएल फ़ाइल वाला एक वर्कस्पेस बनाएँ.

   

5. वर्कस्पेस का संदर्भ उस डेटाबेस और स्कीमा पर सेट करें जहाँ एमसीपी सर्वर बनाया जाएगा.

   

स्नोफ़्लेक एमसीपी सर्वर बनाएँ

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

नीचे दिए गए उदाहरण जैसा एक स्टेटमेंट चलाएँ. इन नामों की जगह अपने स्नोफ़्लेक डेटाबेस, स्कीमा, सेवाओं, व्यू, वेयरहाउस और सर्वर के नाम डालें.

CREATE MCP SERVER CHATGPT_SNOWFLAKE_MCP
FROM SPECIFICATION $$
tools:
- name: "support-search"
type: "CORTEX_SEARCH_SERVICE_QUERY"
identifier: "CHATGPT_APPS.TOOLS.SUPPORT_SEARCH_SERVICE"
title: "Support Search"
description: "Search support content for relevant customer issues."
- name: "revenue-analyst"
type: "CORTEX_ANALYST_MESSAGE"
identifier: "CHATGPT_APPS.TOOLS.REVENUE_SEMANTIC_VIEW"
title: "Revenue Analyst"
description: "Answer revenue questions using the approved semantic view."
- name: "sql-readonly"
type: "SYSTEM_EXECUTE_SQL"
title: "Read-only SQL"
description: "Run read-only SQL queries against approved Snowflake data."
config:
read_only: true
query_timeout: 600
warehouse: "CHATGPT_WH"
$$;

इस स्टेटमेंट में टूल के नाम और स्नोफ़्लेक ऑब्जेक्ट उदाहरण के तौर पर दिए गए हैं:

• support-search निर्दिष्ट कॉर्टेक्स सर्च सेवा उपलब्ध कराता है.

• revenue-analyst निर्दिष्ट सिमैंटिक व्यू उपलब्ध कराता है. ज़रूरत के अनुसार अन्य व्यू के लिए टूल जोड़ें.

• sql-readonly निर्दिष्ट वेयरहाउस के साथ केवल पढ़ने के लिए एसक्यूएल उपलब्ध कराता है.

टूल के लिए ऐसे नाम रखें जो उनके काम का वर्णन करें और बार-बार न बदलें, ताकि ChatGPT सही टूल चुन सके. एमसीपी सर्वर बनाने से उससे जुड़े स्नोफ़्लेक ऑब्जेक्ट का ऐक्सेस अपने-आप नहीं मिलता.

विनिर्देश के अतिरिक्त विकल्पों के लिए देखें: स्नोफ़्लेक द्वारा प्रबंधित एमसीपी सर्वर बनाएँ.

स्नोफ़्लेक में सही अनुमतियाँ दें

वह स्नोफ़्लेक भूमिका चुनें जिससे उपयोगकर्ता प्राधिकरण देंगे, फिर उस भूमिका को इनका ऐक्सेस दें:

1. डेटाबेस और स्कीमा.

2. एमसीपी सर्वर.

3. टूल द्वारा उपयोग किया जाने वाला हर संबंधित ऑब्जेक्ट, जैसे खोज सेवा, सिमैंटिक व्यू या वेयरहाउस.

उदाहरण:

GRANT USAGE ON DATABASE CHATGPT_APPS TO ROLE CHATGPT_CONNECTOR_ROLE;
GRANT USAGE ON SCHEMA CHATGPT_APPS.TOOLS TO ROLE CHATGPT_CONNECTOR_ROLE;
GRANT USAGE ON MCP SERVER CHATGPT_APPS.TOOLS.CHATGPT_SNOWFLAKE_MCP TO ROLE CHATGPT_CONNECTOR_ROLE;

GRANT USAGE ON CORTEX SEARCH SERVICE CHATGPT_APPS.TOOLS.SUPPORT_SEARCH_SERVICE TO ROLE CHATGPT_CONNECTOR_ROLE;
GRANT SELECT ON SEMANTIC VIEW CHATGPT_APPS.TOOLS.REVENUE_SEMANTIC_VIEW TO ROLE CHATGPT_CONNECTOR_ROLE;
GRANT USAGE ON WAREHOUSE CHATGPT_WH TO ROLE CHATGPT_CONNECTOR_ROLE;

अगर एमसीपी सर्वर कोई यूडीएफ़, संग्रहीत प्रोसीजर या कॉर्टेक्स एजेंट उपलब्ध कराता है, तो उस ऑब्जेक्ट के लिए भी आवश्यक अनुमतियाँ दें.

जाँचें कि स्नोफ़्लेक तैयार है

चलाएँ:

SHOW MCP SERVERS IN SCHEMA CHATGPT_APPS.TOOLS;

फिर चलाएँ:

DESCRIBE MCP SERVER CHATGPT_APPS.TOOLS.CHATGPT_SNOWFLAKE_MCP;

पुष्टि करें कि:

• सर्वर अपेक्षित डेटाबेस और स्कीमा में मौजूद है.

• टूल की सूची वही है जो आप चाहते थे.

• हर टूल का identifier सही स्नोफ़्लेक ऑब्जेक्ट को इंगित करता है.

• कनेक्ट करने वाली भूमिका के पास एमसीपी सर्वर पर USAGE अनुमति है.

• कनेक्ट करने वाली भूमिका के पास हर संबंधित ऑब्जेक्ट पर आवश्यक अनुमतियाँ हैं.

ChatGPT में स्नोफ़्लेक सर्वर का विवरण दर्ज करें

वर्कस्पेस सेटअप के लिए, admin.openai.com खोलें, इच्छित ChatGPT वर्कस्पेस चुनें और प्लगइन खोलें. वर्कस्पेस में नेविगेशन और पुराने ऐप के ऐक्सेस के लिए, प्लगइन और ऐप के लिए व्यवस्थापक नियंत्रण, सुरक्षा और अनुपालन देखें.

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

2. व्यक्तिगत सेटअप के लिए सेटिंग > प्लगइन पर जाएँ. वर्कस्पेस सेटअप के लिए, वर्कस्पेस व्यवस्थापक के तौर पर व्यवस्थापक कंसोल > प्लगइन पर जाएँ.

3. स्नोफ़्लेक खोजें.

4. स्नोफ़्लेक - आधिकारिक टेम्प्लेट सक्षम करें.

5. स्नोफ़्लेक - आधिकारिक टेम्प्लेट खोलें, कनेक्शन के लिए एक स्पष्ट नाम दर्ज करें और कनेक्ट करें चुनें.

6. प्रबंधित एमसीपी सर्वर का पूरा यूआरएल दर्ज करें:

https://<snowflake_host_prefix>.snowflakecomputing.com/api/v2/databases/{database}/schemas/{schema}/mcp-servers/{server}

उदाहरण:

https://myorg-myaccount.azure.snowflakecomputing.com/api/v2/databases/CHATGPT_APPS/schemas/TOOLS/mcp-servers/CHATGPT_SNOWFLAKE_MCP

अगर सेटअप स्क्रीन पर स्नोफ़्लेक कॉन्फ़िगरेशन अलग-अलग फ़ील्ड में दिखता है, तो यूआरएल में दिए गए उन्हीं मानों का उपयोग करें:

स्नोफ़्लेक होस्ट प्रीफ़िक्स

अपने स्नोफ़्लेक खाते के यूआरएल में .snowflakecomputing.com से पहले के पूरे हिस्से का उपयोग करें, जिसमें क्षेत्र या क्लाउड का कोई भी सफ़िक्स शामिल हो.

उदाहरण के लिए, अगर खाते का यूआरएल इससे शुरू होता है:

https://myorg-myaccount.azure.snowflakecomputing.com

तो होस्ट प्रीफ़िक्स है:

myorg-myaccount.azure

डेटाबेस

वह डेटाबेस दर्ज करें जिसमें एमसीपी सर्वर है, जैसे:

CHATGPT_APPS

स्कीमा

वह स्कीमा दर्ज करें जिसमें एमसीपी सर्वर है, जैसे:

TOOLS

एमसीपी सर्वर का नाम

स्नोफ़्लेक एमसीपी सर्वर ऑब्जेक्ट का नाम दर्ज करें, जैसे:

CHATGPT_SNOWFLAKE_MCP

OAuth कॉन्फ़िगर करें

OAuth का वह तरीका चुनें जो आपके खाते के लिए उपलब्ध हो और आपके संगठन की ज़रूरतें पूरी करता हो. दोनों तरीकों में ऊपर दिए गए साझा एमसीपी सर्वर सेटअप और नीचे दिए गए कनेक्शन परीक्षणों तथा ऐक्सेस नियंत्रणों का उपयोग होता है.

OAuth के किसी भी तरीके में, जब आप session:role:all का उपयोग करते हैं, तो स्नोफ़्लेक हर उपयोगकर्ता की डिफ़ॉल्ट भूमिका का उपयोग करता है. अगर OAuth एकीकरण की भूमिका अनुमति-सूची कॉन्फ़िगर की गई है, तो डिफ़ॉल्ट भूमिका उसमें अनुमत होनी चाहिए और उसे ब्लॉक नहीं किया गया होना चाहिए. कोई दूसरी स्वीकृत भूमिका होने पर भी वह अपने-आप नहीं चुनी जाती.

अंतर्निहित OAuth

आगे बढ़ने से पहले, ऊपर दिए गए साझा अनुभागों के चरण पूरे करें: एमसीपी सर्वर बनाएँ, अनुमतियाँ दें, सर्वर की जाँच करें और उसका विवरण ChatGPT में दर्ज करें. अगर आप सीधे इस अनुभाग पर आए हैं, तब भी यह ज़रूरी है.

यह तरीका तभी अपनाएँ जब आपके स्नोफ़्लेक खाते के लिए ChatGPT पार्टनर ऐप्लिकेशन उपलब्ध हो और ChatGPT सेटअप संवाद में अंतर्निहित OAuth उपलब्ध हो.

1. स्नोफ़्लेक व्यवस्थापक से उसी स्नोफ़्लेक खाते में ChatGPT पार्टनर एकीकरण सक्षम करने के लिए कहें जो एमसीपी सर्वर होस्ट करता है. पहले से सक्षम किसी मौजूदा ChatGPT पार्टनर एकीकरण का दोबारा उपयोग करें.

2. ChatGPT सेटअप संवाद में अंतर्निहित OAuth का उपयोग करें. आपको क्लाइंट आईडी या क्लाइंट सीक्रेट दर्ज करने या कॉलबैक यूआरएल पंजीकृत करने की ज़रूरत नहीं है.

3. साइन इन करने, सहमति देने और ऐक्सेस कॉन्फ़िगर करने के लिए नीचे दिए गए “स्नोफ़्लेक से कनेक्ट करें और उसका प्रबंधन करें” अनुभाग के चरण पूरे करें. फिर “ऐप का परीक्षण करें” अनुभाग के चरण पूरे करें, जिसमें अनुमत गैर-व्यवस्थापक सदस्यों के साथ परीक्षण भी शामिल हैं.

ऊपर बताई गई डिफ़ॉल्ट भूमिका, अनुमति-सूची और ब्लॉक की गई भूमिकाओं से जुड़ी कार्यप्रणाली इस तरीके पर भी लागू होती है.

कस्टम OAuth क्लाइंट

आगे बढ़ने से पहले, ऊपर दिए गए साझा अनुभागों के चरण पूरे करें: एमसीपी सर्वर बनाएँ, अनुमतियाँ दें, सर्वर की जाँच करें और उसका विवरण ChatGPT में दर्ज करें. अगर आप सीधे इस अनुभाग पर आए हैं, तब भी यह ज़रूरी है.

कस्टम OAuth क्लाइंट के लिए, आपको स्नोफ़्लेक से क्लाइंट आईडी और क्लाइंट सीक्रेट चाहिए. ऊपर बताई गई डिफ़ॉल्ट भूमिका, अनुमति-सूची और ब्लॉक की गई भूमिकाओं से जुड़ी कार्यप्रणाली इस तरीके पर भी लागू होती है.

1. ChatGPT सेटअप संवाद में, उन्नत OAuth सेटिंग > उपयोगकर्ता-निर्धारित OAuth क्लाइंट चुनें और ChatGPT में दिखाया गया कॉलबैक यूआरएल हूबहू कॉपी करें.

2. कस्टम OAuth सुरक्षा एकीकरण बनाएँ, जिसमें OAUTH_CLIENT_TYPE = 'CONFIDENTIAL' हो और OAUTH_REDIRECT_URI हूबहू उसी कॉलबैक यूआरएल पर सेट हो.

3. स्नोफ़्लेक में नीचे दिया गया स्टेटमेंट चलाएँ. एकीकरण का नाम अंग्रेज़ी के बड़े अक्षरों में लिखें:

   SELECT SYSTEM$SHOW_OAUTH_CLIENT_SECRETS('YOUR_INTEGRATION_NAME');

4. जेएसओएन परिणाम से oauth_client_id को ChatGPT में OAuth क्लाइंट आईडी में और oauth_client_secret को OAuth क्लाइंट सीक्रेट में पेस्ट करें.

5. टोकन एंडपॉइंट प्रमाणीकरण विधि को client_secret_basic पर सेट करें.

कस्टम क्लाइंट के क्रेडेंशियल दर्ज करने के बाद, नीचे दिए गए “स्नोफ़्लेक से कनेक्ट करें और उसका प्रबंधन करें” और “ऐप का परीक्षण करें” अनुभागों के चरण पूरे करें.

स्नोफ़्लेक से कनेक्ट करें और उसका प्रबंधन करें

1. OAuth के किसी भी तरीके के लिए, उसी ChatGPT सेटअप संवाद में जारी रखें चुनें, स्नोफ़्लेक में साइन इन करें और कनेक्शन को अधिकृत करें. अगर आपके संगठन का SSO कॉन्फ़िगर किया गया है, तो आप उसका उपयोग कर सकते हैं.

2. वर्कस्पेस सेटअप के लिए, उन सदस्यों के लिए प्लगइन इंस्टॉलेशन नीति और भूमिका या समूह के आधार पर ऐक्सेस कॉन्फ़िगर करें जिन्हें इसका उपयोग करना चाहिए. जाँचें कि स्नोफ़्लेक और स्नोफ़्लेक - आधिकारिक टेम्प्लेट, दोनों सक्षम हैं.

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

4. उपलब्ध कराए गए टूल के लिए कार्रवाई नियंत्रण की समीक्षा करना वर्कस्पेस व्यवस्थापकों की ज़िम्मेदारी है.

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

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

ऐप का परीक्षण करें

1. एक चैट खोलें, स्नोफ़्लेक चुनें और कनेक्शन का परीक्षण करें.

2. पुष्टि करें कि ChatGPT आपके कॉन्फ़िगर किए गए टूल का पता लगा पा रहा है.

3. पहले कम जोखिम वाली पढ़ने की कोई कार्रवाई चलाएँ, जैसे स्वीकृत डेटा पर खोज या केवल पढ़ने वाली क्वेरी.

4. पुष्टि करें कि स्नोफ़्लेक की अनुमतियाँ ऐक्सेस को स्वीकृत भूमिका और ऑब्जेक्ट तक ही सीमित रखती हैं.

5. वर्कस्पेस सेटअप के लिए, ऐसे अनुमत गैर-व्यवस्थापक सदस्यों के साथ परीक्षण करें जिनकी डिफ़ॉल्ट स्नोफ़्लेक भूमिकाएँ अलग-अलग हों. व्यवस्थापक का सफलतापूर्वक कनेक्ट हो जाना यह पुष्टि नहीं करता कि हर सदस्य कनेक्ट कर सकता है.

वर्कस्पेस व्यवस्थापकों के लिए, केवल स्नोफ़्लेक सक्षम करना पर्याप्त नहीं है. अगर स्नोफ़्लेक - आधिकारिक टेम्प्लेट को सक्षम और कनेक्ट नहीं किया गया है, तो सदस्यों को प्लगइन अक्षम दिख सकता है.

एमसीपी सर्वर यूआरएल और OAuth की कार्यप्रणाली

ChatGPT, स्नोफ़्लेक द्वारा प्रबंधित एमसीपी सर्वर के पूरे यूआरएल से कनेक्ट होता है:

https://<snowflake_host_prefix>.snowflakecomputing.com/api/v2/databases/{database}/schemas/{schema}/mcp-servers/{server}

ChatGPT उस यूआरएल के स्नोफ़्लेक होस्ट प्रीफ़िक्स का उपयोग करके इन स्नोफ़्लेक OAuth एंडपॉइंट के पते निर्धारित करता है:

• प्राधिकरण: https://<snowflake_host_prefix>.snowflakecomputing.com/oauth/authorize

• टोकन: https://<snowflake_host_prefix>.snowflakecomputing.com/oauth/token-request

स्नोसाइट का यूआरएल, केवल स्नोफ़्लेक खाते का मूल यूआरएल या अतिरिक्त पाथ खंडों वाला यूआरएल पेस्ट न करें. एमसीपी यूआरएल में /api/v2/databases/{database}/schemas/{schema}/mcp-servers/{server} शामिल होना चाहिए और यह आपके स्नोफ़्लेक ऑब्जेक्ट से हूबहू मेल खाना चाहिए.

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

स्नोफ़्लेक व्यवस्थापक के लिए सक्षम है, लेकिन सदस्य के लिए अक्षम है

• पुष्टि करें कि व्यवस्थापक कंसोल > प्लगइन में स्नोफ़्लेक और स्नोफ़्लेक - आधिकारिक टेम्प्लेट, दोनों सक्षम हैं.

• स्नोफ़्लेक - आधिकारिक टेम्प्लेट खोलें और उसकी कनेक्ट करें प्रक्रिया पूरी करें. टेम्प्लेट को कनेक्ट किए बिना सिर्फ़ सक्षम करना पर्याप्त नहीं है.

• स्नोफ़्लेक खोलें और पुष्टि करें कि टेम्प्लेट उसके आवश्यक ऐप के तौर पर दिख रहा है.

• पुष्टि करें कि प्लगइन इंस्टॉलेशन नीति प्रभावित सदस्य की भूमिका या समूह को अनुमति देती है.

एमसीपी सर्वर नहीं मिला

• एमसीपी सर्वर के पूरे यूआरएल की दोबारा जाँच करें, या अगर आपकी सेटअप स्क्रीन टेम्प्लेट के चार फ़ील्ड माँगती है, तो उनकी जाँच करें.

• पुष्टि करें कि एमसीपी सर्वर ठीक उसी डेटाबेस और स्कीमा में मौजूद है.

ChatGPT में कोई टूल नहीं दिखता

• पुष्टि करें कि एमसीपी सर्वर के विनिर्देश में टूल शामिल हैं.

• पुष्टि करें कि भूमिका के पास एमसीपी सर्वर पर USAGE अनुमति है.

टूल दिखता है, लेकिन उपयोग करने पर विफल हो जाता है

• पुष्टि करें कि भूमिका के पास संबंधित स्नोफ़्लेक ऑब्जेक्ट, जैसे खोज सेवा, सिमैंटिक व्यू, वेयरहाउस, प्रोसीजर या यूडीएफ़ पर आवश्यक अनुमति है.

एसक्यूएल टूल विफल हो रहा है

• पुष्टि करें कि वेयरहाउस का नाम सही है और वेयरहाउस चल रहा है.

• पुष्टि करें कि भूमिका के पास वेयरहाउस पर USAGE अनुमति है.

• अगर आप केवल पढ़ने का ऐक्सेस देना चाहते थे, तो पुष्टि करें कि read_only: true सेट है.

अनुरोधित भूमिका ALL को स्पष्ट रूप से ब्लॉक किया गया है

अपने स्नोफ़्लेक व्यवस्थापक से अपनी डिफ़ॉल्ट भूमिका की तुलना OAuth एकीकरण की अनुमत और ब्लॉक की गई भूमिकाओं से करने को कहें. कोई दूसरी अनुमत भूमिका होने पर भी वह अपने-आप नहीं चुनी जाती. अगर उचित हो, तो डिफ़ॉल्ट भूमिका बदलकर कोई स्वीकृत भूमिका सेट करें और फिर से कनेक्ट करें. डिफ़ॉल्ट भूमिका बदलने से ChatGPT के बाहर आपके स्नोफ़्लेक सत्र भी प्रभावित होते हैं.

प्राधिकरण विफल हो रहा है

• पुष्टि करें कि उपयोगकर्ता स्नोफ़्लेक में साइन इन कर सकता है.

• session:role:all का उपयोग करते समय, पुष्टि करें कि OAuth एकीकरण उपयोगकर्ता की डिफ़ॉल्ट भूमिका की अनुमति देता है.

• पुष्टि करें कि सेटअप में स्नोफ़्लेक द्वारा प्रबंधित एमसीपी की OAuth प्रक्रिया का उपयोग हो रहा है.

• अगर आप कस्टम OAuth क्लाइंट का उपयोग करते हैं, तो पुष्टि करें कि क्लाइंट आईडी और क्लाइंट सीक्रेट स्नोफ़्लेक OAuth एकीकरण से मेल खाते हैं और उसका रीडायरेक्ट यूआरआई, ChatGPT में दिखाए गए कॉलबैक यूआरएल से हूबहू मेल खाता है.

  अगर आप अंतर्निहित OAuth का उपयोग करते हैं, तो स्नोफ़्लेक व्यवस्थापक से जाँचने के लिए कहें कि एमसीपी सर्वर होस्ट करने वाले खाते में ChatGPT पार्टनर एकीकरण उपलब्ध और सक्षम है.

स्नोफ़्लेक की नेटवर्क नीति या आईपी अनुमति-सूची कनेक्टर को ब्लॉक कर रही है

• स्नोफ़्लेक व्यवस्थापक से स्नोफ़्लेक की नेटवर्क नीति या ऐक्सेस नियम अपडेट करने के लिए कहें.

• मौजूदा ChatGPT कनेक्टर की आउटबाउंड आईपी रेंज से आने वाले कनेक्शन की अनुमति दें.

• यह अनुमति-सूची स्नोफ़्लेक में कॉन्फ़िगर करें. यह ChatGPT वर्कस्पेस की आईपी अनुमति-सूची से अलग है.

• जहाँ संभव हो, प्रकाशित जेएसओएन से अपडेट अपने-आप होने की व्यवस्था करें, क्योंकि रेंज बदल सकती हैं.

होस्टनाम से जुड़ी कनेक्शन समस्या

सही स्नोफ़्लेक होस्ट प्रीफ़िक्स का उपयोग करें. अंडरस्कोर वाले स्नोफ़्लेक होस्टनाम से समस्याएँ हो सकती हैं; हाइफ़न का उपयोग करना बेहतर है.

संदर्भ

• स्नोफ़्लेक द्वारा प्रबंधित एमसीपी सर्वर

• CREATE MCP SERVER

• DESCRIBE MCP SERVER

• SHOW MCP SERVERS