Օգտագործեք այս ուղեցույցը, եթե ChatGPT աշխատատարածքի ադմին եք և կարգավորում եք Snowflake հավելվածի ձևանմուշը ձեր կազմակերպության համար: Ձևանմուշը վերջնական հավելվածը չէ, որը անդամներն օգտագործում են: Դա կարգավորման ընթացք է, որը ստեղծում է աշխատատարածքին հատուկ սևագիր հավելված՝ անհրաժեշտ Snowflake կարգավորումը տրամադրելուց հետո:

Snowflake-ի դեպքում կարգավորման մեծ մասը կատարվում է Snowflake-ում: Դուք ստեղծում եք Snowflake-ի կառավարվող MCP սերվեր, տրամադրում եք ճիշտ դերի հասանելիություն MCP սերվերին և դրա հիմքում ընկած օբյեկտներին, ապա մուտքագրում եք կառավարվող MCP սերվերի URL-ը կամ դրա բաղադրիչ դաշտերը ChatGPT-ի ձևանմուշի կարգավորման ընթացքում: Երբ ChatGPT-ն ստեղծի սևագիր հավելվածը, կարող եք հրապարակել այն և կառավարել ինչպես աշխատատարածքի մյուս հավելվածները:

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

Դուք ստեղծում եք աշխատատարածքին հատուկ Snowflake հավելված ChatGPT-ում: Հավելվածը միանում է Snowflake-ի կառավարվող MCP սերվերին, որը սահմանում է՝

• Որ գործողությունները կարող է օգտագործել ChatGPT-ն, որոնք կոչվում են գործիքներ:

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

• Snowflake-ի որ դերով պետք է օգտատերերը լիազորեն մուտքը:

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

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

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

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

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

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

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

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

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

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

Պատրաստվելիք արժեքներ

• 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 ագենտ, պահված ընթացակարգ կամ UDF՝ կոնկրետ աշխատանքային ընթացքերի համար:

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

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

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

Ստեղծեք MCP սերվեր, որը թվարկում է միայն այն գործիքները, որոնք ChatGPT-ն պետք է օգտագործի: Օբյեկտների անունները փոխարինեք ձեր սեփական 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: "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"
$$;

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

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

Ընտրեք Snowflake դերը, որով օգտատերերը լիազորում կկատարեն, ապա այդ դերին տրամադրեք հասանելիություն տվյալների բազային, սխեմային, MCP սերվերին և գործիքների օգտագործած յուրաքանչյուր հիմքային օբյեկտին:

Օրինակ՝

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 USAGE ON WAREHOUSE CHATGPT_WH TO ROLE CHATGPT_CONNECTOR_ROLE;

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

Ստուգեք, որ Snowflake-ը պատրաստ է

Գործարկեք՝

SHOW MCP SERVERS IN SCHEMA CHATGPT_APPS.TOOLS;

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

DESCRIBE MCP SERVER CHATGPT_APPS.TOOLS.CHATGPT_SNOWFLAKE_MCP;

Հաստատեք՝

• Սերվերը գոյություն ունի ակնկալվող տվյալների բազայում և սխեմայում:

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

• Յուրաքանչյուր գործիքի նույնացուցիչը մատնանշում է Snowflake-ի ճիշտ օբյեկտը:

• Միացնող դերը ունի USAGE MCP սերվերի վրա:

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

Սկսեք ձևանմուշի կարգավորումը ChatGPT-ում

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

2. Բացեք Աշխատատարածքի կարգավորումներ > Հավելվածներ:

3. Ընտրեք Գրացուցակ:

4. Որոնեք Snowflake:

5. Ընտրեք Snowflake հավելվածի ձևանմուշը և սկսեք կարգավորումը:

6. Մուտքագրեք հստակ հավելվածի անուն և նկարագրություն, օրինակ՝ Snowflake կամ Snowflake - Analytics:

7. Մուտքագրեք կարգավորման ընթացքի պահանջած կառավարվող MCP սերվերի տվյալները:

Եթե կարգավորման էկրանը պահանջում է կառավարվող MCP սերվերի ամբողջական URL-ը, օգտագործեք այս ձևաչափը՝

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

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

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

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

• Սխեմա:

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

Ստեղծեք և հրապարակեք սևագիր հավելվածը

1. Պահեք Snowflake ձևանմուշի կարգավորումը ChatGPT-ում:

2. Ստեղծեք սևագիր հավելվածը:

3. Վերանայեք սևագիր հավելվածի տվյալները, նույնականացման կարգավորումները և հասանելի գործողությունները:

4. Հրապարակեք սևագիր հավելվածը, երբ պատրաստ լինի:

5. Հաստատեք, որ հավելվածը հայտնվում է Աշխատատարածքի կարգավորումներ > Հավելվածներ > Միացված բաժնում:

6. Կարգավորեք Օգտատիրոջ հասանելիություն այն դերերի համար, որոնք պետք է օգտագործեն այն:

7. Վերանայեք Գործողությունների վերահսկում ցուցադրված գործիքների համար:

8. Վերանայեք Հավելվածի թույլտվություններ՝ ընտրելու, թե երբ է ChatGPT-ն հարցնում անդամներին հավելվածն օգտագործելուց առաջ:

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

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

1. Սկսեք միացման ընթացքը ChatGPT-ից՝ որպես թույլատրված փորձարկող օգտատեր:

2. Մուտք գործեք Snowflake և ընտրեք նախատեսված դերը, եթե հուշում հայտնվի:

3. Հաստատեք, որ ChatGPT-ն հայտնաբերում է MCP սերվերից ակնկալվող գործիքները:

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

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

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

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

Մի տեղադրեք Snowsight URL, Snowflake հաշվի արմատային URL-ն առանձին կամ որևէ URL՝ լրացուցիչ ուղու հատվածներով: MCP URL-ը պետք է ներառի տվյալների բազայի, սխեմայի և MCP սերվերի ուղին և պետք է ճշգրտորեն համապատասխանի ձեր Snowflake օբյեկտներին:

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

• MCP սերվերը չի գտնվել. կրկին ստուգեք MCP սերվերի ամբողջական URL-ը կամ առանձին հոսթի նախածանցը, տվյալների բազան, սխեման և սերվերի դաշտերը:

• ChatGPT-ում գործիքներ չեն հայտնվում. հաստատեք, որ MCP սերվերի սպեցիֆիկացիան ներառում է գործիքներ, և դերը ունի USAGE MCP սերվերի վրա:

• Գործիքը երևում է, բայց օգտագործելիս ձախողվում է. հաստատեք, որ դերն ունի ճիշտ թույլտվություն հիմքում ընկած Snowflake օբյեկտի վրա:

• SQL գործիքը ձախողվում է. հաստատեք, որ պահեստի անունը ճիշտ է, պահեստը հասանելի է, դերը ունի USAGE դրա վրա, և read_only-ը true է, եթե նախատեսել եք միայն կարդալու հասանելիություն:

• Լիազորումը ձախողվում է. հաստատեք, որ օգտատերը կարող է մուտք գործել Snowflake և օգտագործել նախատեսված դերը:

• Հոսթի անվան միացման խնդիր. օգտագործեք Snowflake-ի ճիշտ հոսթի նախածանցը: Ընդգծումներով Snowflake հոսթանունները կարող են խնդիրներ առաջացնել. նախընտրեք գծիկները: