Օգտվեք այս ուղեցույցից, եթե ChatGPT աշխատատարածքի ադմին եք կամ ChatGPT Plus կամ ChatGPT Pro օգտատեր և ցանկանում եք ChatGPT-ն Snowflake-ի կառավարմամբ MCP սերվերի միջոցով միացնել Snowflake-ին։

Կարգավորումների մեծ մասը կատարվում է Snowflake-ում։ Snowflake-ը պատրաստելուց հետո ChatGPT-ում ավարտեք Snowflake ձևանմուշի միացման կարգավորումը, ապա միացրեք այդ ձևանմուշն օգտագործող Snowflake փլագինը։

Ինչ եք կարգավորում

Դուք ստեղծում եք Snowflake-ի կառավարմամբ MCP սերվեր, որը ChatGPT-ի համար ծառայում է որպես կապակցիչի վերջնակետ։ MCP սերվերը սահմանում է՝

• Ինչ գործողություններ կարող է օգտագործել ChatGPT-ն։

• Snowflake-ի ինչ տվյալներ կամ օբյեկտներ են հասանելի այդ գործիքներին։

• Snowflake-ի որ դերով է յուրաքանչյուր օգտատեր թույլատրում մուտքը։

• Snowflake-ի որ տվյալների բազան, սխեման և MCP սերվերի անունն են նույնականացնում վերջնակետը։

Այնուհետև ChatGPT-ում կարգավորում եք Snowflake — պաշտոնական ձևանմուշ-ը՝ նշելով կառավարվող MCP սերվերի ամբողջական URL-ը։ Ձևանմուշի կարգավորման էկրանին URL-ը կարող է ներկայացվել չորս առանձին դաշտով՝

• Snowflake հոսթի նախածանց։

• Տվյալների բազա։

• Սխեմա։

• MCP սերվերի անուն։

ChatGPT-ն կարող է հայտնաբերել և օգտագործել միայն MCP սերվերի տրամադրած և օգտատիրոջ թույլատրած Snowflake դերին հասանելի գործիքները։

Նախքան սկսելը

Ձեզ անհրաժեշտ է՝

• ChatGPT աշխատատարածքի ադմինի կամ սեփականատիրոջ հասանելիություն կամ ChatGPT Plus կամ ChatGPT Pro հասանելիություն։

• Snowflake-ի հասանելիություն, որը թույլ է տալիս ստեղծել MCP սերվերի օբյեկտներ և տրամադրել թույլտվություններ։

• Snowflake-ի տվյալների բազան և սխեման, որտեղ կտեղակայվի MCP սերվերը։

• Որոշում այն մասին, թե ինչ պետք է թույլատրվի ChatGPT-ին անել, օրինակ՝ օգտագործել Cortex Search-ը, Cortex Analyst-ը, միայն ընթերցման SQL կամ որոշակի ընթացակարգ կամ ֆունկցիա։

• Նվազագույն արտոնություններով Snowflake դեր, որն օգտատերերը կօգտագործեն հավելվածը թույլատրելիս։

• Snowflake հաշվի հոսթի նախածանցը՝ ներառյալ տարածաշրջանի կամ ամպային միջավայրի ցանկացած վերջածանց։

Եթե ձեր Snowflake հաշվի հասանելիությունը սահմանափակվում է ցանցային քաղաքականությամբ կամ թույլատրված IP-ների ցանկով, խնդրեք Snowflake-ի ադմինին թույլատրել մուտքային կապերը ChatGPT կապակցիչի ընթացիկ ելքային IP տիրույթներից։ Ցանկը դինամիկ է և պետք է պարբերաբար թարմացվի։

Պատրաստվող արժեքները

• Snowflake հոսթի նախածանց՝ Snowflake հաշվի URL-ում .snowflakecomputing.com-ից առաջ եղած ամբողջ մասը։

• Տվյալների բազա՝ MCP սերվերը պարունակող տվյալների բազան։

• Սխեմա՝ MCP սերվերը պարունակող սխեման։

• MCP սերվերի անուն՝ Snowflake MCP սերվերի օբյեկտի անունը։

• Կառավարվող MCP սերվերի ամբողջական URL-ը, եթե ChatGPT-ի կարգավորման էկրանը URL է պահանջում։

• Snowflake դեր՝ այն դերը, որն օգտատերերը պետք է օգտագործեն հավելվածը թույլատրելիս։

• Գործիքների ցանկ՝ Snowflake-ի օբյեկտներն ու գործողությունները, որոնք ցանկանում եք, որ ChatGPT-ն օգտագործի։

Որոշեք, թե ինչ կարող է անել ChatGPT-ն

Ընտրեք միայն այն հնարավորությունները, որոնք ցանկանում եք հասանելի դարձնել։ Տարածված տարբերակներն են՝

• Որոնում Cortex Search-ի միջոցով՝ ինդեքսավորված Snowflake տվյալներում կամ բովանդակության մեջ պատասխաններ գտնելու համար։

• Հարցուպատասխան Cortex Analyst-ի միջոցով՝ հաստատված իմաստաբանական ներկայացման հիման վրա։

• Միայն ընթերցման SQL՝ հարցումներին վերահսկվող հասանելիության համար։

• Snowflake Agent, պահպանված ընթացակարգ կամ UDF՝ որոշակի աշխատանքային հոսքի համար։

Եթե միացնում եք SQL-ը, թողեք այն միայն ընթերցման ռեժիմում, եթե ձեր կազմակերպությունը չի ուսումնասիրել և հաստատել գրելու հասանելիությունը։

Բացեք Snowflake աշխատանքային թերթ

1. Մուտք գործեք Snowflake հավելված։

2. Անցեք մի դերի, որը կարող է ստեղծել MCP սերվերը և հասանելիություն տրամադրել։

3. Բացեք Աշխատատարածքներ բաժինը։

   

4. Ստեղծեք աշխատատարածք SQL ֆայլով։

   

5. Աշխատատարածքի համատեքստը սահմանեք այն տվյալների բազան և սխեման, որտեղ ստեղծվելու է MCP սերվերը։

   

Ստեղծեք Snowflake MCP սերվերը

Snowflake մուտք գործեք մի դերով, որը կարող է ստեղծել MCP սերվերը և հասանելիություն տրամադրել։ Բացեք աշխատանքային թերթ այն տվյալների բազայում և սխեմայում, որտեղ պետք է ստեղծվի MCP սերվերը։

Գործարկեք հետևյալ օրինակի նման հրահանգ։ Անունները փոխարինեք Snowflake-ի ձեր տվյալների բազայի, սխեմայի, ծառայությունների, ներկայացումների, պահեստի և սերվերի անուններով։

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"
$$;

Այս հրահանգում գործիքների անուններն ու Snowflake օբյեկտներն օրինակներ են՝

• support-search-ը հասանելի է դարձնում նշված Cortex Search ծառայությունը։

• revenue-analyst-ը հասանելի է դարձնում նշված իմաստաբանական ներկայացումը։ Ըստ անհրաժեշտության գործիքներ ավելացրեք այլ ներկայացումների համար։

• sql-readonly-ը նշված պահեստով հասանելի է դարձնում միայն ընթերցման SQL-ը։

Օգտագործեք կայուն և նկարագրական գործիքների անուններ, որպեսզի ChatGPT-ն կարողանա ճիշտ գործիքն ընտրել։ MCP սերվերի ստեղծումն ինքնաբերաբար հասանելիություն չի տրամադրում Snowflake-ի հիմքում ընկած օբյեկտներին։

Հստակեցման լրացուցիչ տարբերակների համար տե՛ս՝ Ստեղծել Snowflake-ի կառավարմամբ MCP սերվեր։

Տրամադրեք Snowflake-ի ճիշտ թույլտվությունները

Ընտրեք Snowflake դերը, որով օգտատերերը կթույլատրեն մուտքը, ապա այդ դերին հասանելիություն տրամադրեք հետևյալին՝

1. Տվյալների բազային և սխեմային։

2. MCP սերվերին։

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;

Եթե MCP սերվերը հասանելի է դարձնում UDF, պահպանված ընթացակարգ կամ Cortex Agent, տրամադրեք նաև այդ օբյեկտի համար պահանջվող թույլտվությունները։

Համոզվեք, որ Snowflake-ը պատրաստ է

Գործարկեք՝

SHOW MCP SERVERS IN SCHEMA CHATGPT_APPS.TOOLS;

Այնուհետև գործարկեք՝

DESCRIBE MCP SERVER CHATGPT_APPS.TOOLS.CHATGPT_SNOWFLAKE_MCP;

Հաստատեք, որ՝

• Սերվերը գտնվում է նախատեսված տվյալների բազայում և սխեմայում։

• Գործիքների ցանկը համապատասխանում է ձեր մտադրությանը։

• Յուրաքանչյուր գործիքի identifier-ը հղվում է Snowflake-ի ճիշտ օբյեկտին։

• Միացման համար օգտագործվող դերը MCP սերվերի նկատմամբ ունի USAGE թույլտվություն։

• Միացման համար օգտագործվող դերն ունի հիմքում ընկած յուրաքանչյուր օբյեկտի համար անհրաժեշտ թույլտվությունները։

ChatGPT-ում մուտքագրեք Snowflake սերվերի տվյալները

1. ChatGPT-ում անցեք այն հաշվին կամ աշխատատարածքին, որտեղ հավելվածը պետք է հասանելի լինի։

2. Բացեք Կարգավորումներ բաժինը։ Ամբողջ աշխատատարածքի համար կարգավորելու նպատակով որպես աշխատատարածքի ադմին բացեք Աշխատատարածքի կարգավորումներ բաժինը։

3. Բացեք Փլագիններ բաժինը։

4. Որոնեք Snowflake։

5. Միացրեք Snowflake — պաշտոնական ձևանմուշ-ը։

6. Բացեք Snowflake — պաշտոնական ձևանմուշ-ը, մուտքագրեք կապի հստակ անուն և ընտրեք Միացնել։

7. Մուտքագրեք կառավարվող MCP սերվերի ամբողջական URL-ը՝

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

Եթե կարգավորման էկրանին Snowflake-ի կազմաձևը ցուցադրվում է առանձին դաշտերով, օգտագործեք URL-ի նույն արժեքները՝

Snowflake հոսթի նախածանց

Օգտագործեք Snowflake հաշվի URL-ում .snowflakecomputing.com-ից առաջ եղած ամբողջ մասը՝ ներառյալ տարածաշրջանի կամ ամպային միջավայրի ցանկացած վերջածանց։

Օրինակ՝ եթե հաշվի URL-ը սկսվում է հետևյալ կերպ՝

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

Հոսթի նախածանցն է՝

myorg-myaccount.azure

Տվյալների բազա

Մուտքագրեք MCP սերվերը պարունակող տվյալների բազան, օրինակ՝

CHATGPT_APPS

Սխեմա

Մուտքագրեք MCP սերվերը պարունակող սխեման, օրինակ՝

TOOLS

MCP սերվերի անուն

Մուտքագրեք Snowflake MCP սերվերի օբյեկտի անունը, օրինակ՝

CHATGPT_SNOWFLAKE_MCP

Կազմաձևեք OAuth հաճախորդը

Միանալու համար ձեզ անհրաժեշտ են Snowflake-ի տրամադրած Client ID-ն և Client Secret-ը։

session:role:all օգտագործելիս Snowflake-ն օգտագործում է յուրաքանչյուր օգտատիրոջ կանխադրված դերը։ Կանխադրված դերը պետք է թույլատրված լինի OAuth ինտեգրման դերերի թույլատրացանկով, եթե այն կազմաձևված է, և չպետք է արգելափակված լինի։ Այլ հաստատված դերի առկայությունն այն ինքնաբերաբար չի ընտրում։

1. ChatGPT-ի կարգավորման պատուհանում բացեք OAuth-ի ընդլայնված կարգավորումներ բաժինը, ընտրեք Օգտատիրոջ սահմանած OAuth հաճախորդ և պատճենեք ChatGPT-ում ցուցադրվող Հետադարձ կանչի URL-ը։

2. Ստեղծեք հատուկ OAuth անվտանգության ինտեգրում՝ OAUTH_CLIENT_TYPE = 'CONFIDENTIAL' արժեքով, իսկ OAUTH_REDIRECT_URI-ի համար սահմանեք հետադարձ կանչի հենց այդ URL-ը։

3. Snowflake-ում գործարկեք հետևյալ հրահանգը՝ ինտեգրման անունը գրելով մեծատառերով՝

   SELECT SYSTEM$SHOW_OAUTH_CLIENT_SECRETS('YOUR_INTEGRATION_NAME');

4. JSON արդյունքից oauth_client_id-ը տեղադրեք ChatGPT-ի OAuth հաճախորդի ID դաշտում, իսկ oauth_client_secret-ը՝ OAuth հաճախորդի գաղտնիք դաշտում։

5. Թոքենի վերջնակետի նույնականացման եղանակ դաշտը սահմանեք որպես client_secret_basic։

Միացեք Snowflake-ին և կառավարեք այն

1. ChatGPT-ի կարգավորման նույն պատուհանում ընտրեք Շարունակել, մուտք գործեք Snowflake և թույլատրեք կապը։

2. Աշխատատարածքի կարգավորման դեպքում կազմաձևեք փլագինի տեղադրման քաղաքականությունը և դերերի կամ խմբերի հասանելիությունը այն անդամների համար, որոնք պետք է օգտագործեն այն։ Համոզվեք, որ միացված են և՛ Snowflake-ը, և՛ Snowflake — պաշտոնական ձևանմուշ-ը։

3. Աշխատատարածքի ադմինները պատասխանատու են Snowflake-ն օգտագործող դերերի համար Օգտատերերի հասանելիություն բաժնի կարգավորման համար։

4. Աշխատատարածքի ադմինները պատասխանատու են հասանելի դարձված գործիքների Գործողությունների վերահսկում բաժնի ստուգման համար։

5. Աշխատատարածքի ադմինները պատասխանատու են Հավելվածի թույլտվություններ բաժինը ստուգելու և որոշելու համար, թե երբ պետք է ChatGPT-ն հավելվածն օգտագործելուց առաջ հարցնի անդամներին։

Հավելվածի այս թույլտվությունները կիրառվում են ChatGPT-ի զրույցների նկատմամբ։ Աշխատատարածքի ագենտներն օգտագործում են յուրաքանչյուր ագենտի համար դրա ստեղծողի սահմանած վերահսկիչները՝ որոշելու, թե հավելվածի որ գործողություններն են հասանելի, և երբ է վերջնական օգտատերերից հաստատում պահանջվում։ Ագենտների վարքագծի մասին տե՛ս՝ ChatGPT աշխատատարածքի ագենտներ Enterprise-ի և Business-ի համար։

Փորձարկեք հավելվածը

1. Բացեք զրույց, ընտրեք Snowflake և փորձարկեք կապը։

2. Համոզվեք, որ ChatGPT-ն հայտնաբերում է ձեր կազմաձևած գործիքները։

3. Նախ կատարեք ցածր ռիսկով ընթերցման գործողություն, օրինակ՝ որոնում կամ միայն ընթերցման հարցում հաստատված տվյալների նկատմամբ։

4. Համոզվեք, որ Snowflake-ի թույլտվությունները կանխում են հաստատված դերից և օբյեկտներից դուրս հասանելիությունը։

5. Աշխատատարածքի կարգավորման դեպքում փորձարկեք թույլատրված, ադմին չհանդիսացող անդամներով, որոնք Snowflake-ում տարբեր կանխադրված դերեր ունեն։ Ադմինի հաջող միացումը չի հաստատում, որ յուրաքանչյուր անդամ կարող է միանալ։

Աշխատատարածքի ադմինների համար միայն Snowflake-ը միացնելը բավարար չէ։ Եթե Snowflake — պաշտոնական ձևանմուշ-ը միացված և կապակցված չէ, փլագինը կարող է անդամներին անջատված երևալ։

MCP սերվերի URL-ը և OAuth-ի վարքագիծը

ChatGPT-ն միանում է Snowflake-ի կառավարմամբ MCP սերվերի ամբողջական URL-ին՝

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

ChatGPT-ն այդ URL-ի Snowflake հոսթի նախածանցն օգտագործում է Snowflake OAuth-ի հետևյալ վերջնակետերը որոշելու համար՝

• Թույլատրում՝ https://<snowflake_host_prefix>.snowflakecomputing.com/oauth/authorize

• Թոքեն՝ https://<snowflake_host_prefix>.snowflakecomputing.com/oauth/token-request

Մի տեղադրեք Snowsight URL, միայն Snowflake հաշվի արմատային URL կամ լրացուցիչ ուղու հատվածներով URL։ MCP URL-ը պետք է ներառի /api/v2/databases/{database}/schemas/{schema}/mcp-servers/{server} և ճշգրտորեն համապատասխանի ձեր Snowflake օբյեկտներին։

Խնդիրների լուծում

Snowflake-ը միացված է ադմինի, բայց անջատված՝ անդամի համար

• Համոզվեք, որ Աշխատատարածքի կարգավորումներ > Փլագիններ բաժնում միացված են և՛ Snowflake-ը, և՛ Snowflake — պաշտոնական ձևանմուշ-ը։

• Բացեք Snowflake — պաշտոնական ձևանմուշ-ը և ավարտեք դրա Միացնել գործընթացը։ Ձևանմուշը առանց կապակցելու միացնելը բավարար չէ։

• Բացեք Snowflake-ը և համոզվեք, որ ձևանմուշը ցուցադրվում է որպես դրա պահանջվող հավելված։

• Համոզվեք, որ փլագինի տեղադրման քաղաքականությունը թույլատրում է խնդրի հանդիպած անդամի դերը կամ խումբը։

MCP սերվերը չի գտնվել

• Կրկին ստուգեք MCP սերվերի ամբողջական URL-ը կամ ձևանմուշի չորս դաշտերը, եթե կարգավորման էկրանն է դրանք պահանջում։

• Համոզվեք, որ MCP սերվերը գոյություն ունի հենց այդ տվյալների բազայում և սխեմայում։

ChatGPT-ում գործիքներ չեն ցուցադրվում

• Համոզվեք, որ MCP սերվերի հստակեցումը գործիքներ է ներառում։

• Համոզվեք, որ դերը MCP սերվերի նկատմամբ ունի USAGE թույլտվություն։

Գործիքը ցուցադրվում է, բայց օգտագործելիս չի աշխատում

• Համոզվեք, որ դերն ունի Snowflake-ի հիմքում ընկած օբյեկտի համար անհրաժեշտ թույլտվությունը, օրինակ՝ որոնման ծառայության, իմաստաբանական ներկայացման, պահեստի, ընթացակարգի կամ UDF-ի համար։

SQL գործիքը չի աշխատում

• Համոզվեք, որ պահեստի անունը ճիշտ է, և պահեստն աշխատում է։

• Համոզվեք, որ դերը պահեստի նկատմամբ ունի USAGE թույլտվություն։

• Եթե նախատեսել եք միայն ընթերցման հասանելիություն, համոզվեք, որ սահմանված է read_only: true։

Հայցված ALL դերը հստակորեն արգելափակված է

Խնդրեք Snowflake-ի ադմինին համեմատել ձեր կանխադրված դերը OAuth ինտեգրման թույլատրված և արգելափակված դերերի հետ։ Այլ թույլատրված դերի առկայությունն այն ինքնաբերաբար չի ընտրում։ Անհրաժեշտության դեպքում կանխադրված դերը փոխեք հաստատված դերով և նորից միացեք։ Կանխադրված դերի փոփոխությունն ազդում է նաև ChatGPT-ից դուրս Snowflake աշխատաշրջանների վրա։

Թույլատրումը ձախողվում է

• Համոզվեք, որ օգտատերը կարող է մուտք գործել Snowflake։

• session:role:all օգտագործելիս համոզվեք, որ OAuth ինտեգրումը թույլատրում է օգտատիրոջ կանխադրված դերը։

• Համոզվեք, որ կարգավորումն օգտագործում է Snowflake-ի կառավարմամբ MCP OAuth գործընթացը։

• Համոզվեք, որ Client ID-ն և Client Secret-ը համապատասխանում են Snowflake OAuth ինտեգրմանը, իսկ դրա վերահղման URI-ն՝ ChatGPT-ում ցուցադրվող Հետադարձ կանչի URL-ին։

Snowflake-ի ցանցային քաղաքականությունը կամ թույլատրված IP-ների ցանկն արգելափակում է կապակցիչը

• Խնդրեք Snowflake-ի ադմինին թարմացնել Snowflake-ի ցանցային քաղաքականությունը կամ հասանելիության կանոնները։

• Թույլատրեք մուտքային կապերը ChatGPT կապակցիչի ընթացիկ ելքային IP տիրույթներից։

• Թույլատրացանկը կազմաձևեք Snowflake-ում։ Այն առանձին է ChatGPT աշխատատարածքի IP թույլատրացանկից։

• Հնարավորության դեպքում ավտոմատացրեք հրապարակված JSON-ից թարմացումները, քանի որ տիրույթները կարող են փոխվել։

Հոսթի անվան հետ կապի խնդիր

Օգտագործեք Snowflake հոսթի ճիշտ նախածանցը։ Ընդգծման նշաններով Snowflake հոսթանունները կարող են խնդիրներ առաջացնել․ նախընտրեք գծիկներ։

Հղումներ

• Snowflake-ի կառավարմամբ MCP սերվեր

• CREATE MCP SERVER

• DESCRIBE MCP SERVER

• SHOW MCP SERVERS