Nastavitev predloge aplikacije Snowflake v ChatGPT

Ta vodnik je namenjen skrbnikom delovnega prostora ChatGPT in uporabnikom paketov ChatGPT Plus ali Pro, ki želijo ChatGPT povezati s platformo Snowflake prek strežnika MCP, ki ga upravlja Snowflake.

Večina nastavitev se izvede v platformi Snowflake. Ko je Snowflake pripravljen, v ChatGPT dokončajte povezavo prek predloge Snowflake, nato pa omogočite dodatek Snowflake, ki uporablja to predlogo.

• Vgrajeni OAuth: Če je na voljo za vaš račun Snowflake in v ChatGPT, uporabite partnersko aplikacijo ChatGPT, ki jo je omogočil skrbnik platforme Snowflake. Prijavite se v Snowflake. Če je v vaši organizaciji nastavljen SSO, ga uporabite. V ChatGPT vam ni treba vnesti ID-ja ali skrivnosti odjemalca. Sledite spodnjemu razdelku Vgrajeni OAuth.

• Lastni odjemalec OAuth: To možnost uporabite, če vaša organizacija zahteva lastnega odjemalca OAuth ali če vgrajeni OAuth ni na voljo. Sledite spodnjemu razdelku Lastni odjemalec OAuth.

Obe možnosti OAuth zahtevata spodaj opisano skupno nastavitev strežnika MCP, dovoljenja za objekte, ki jih uporablja, in omrežni dostop. Preden nastavite OAuth, opravite skupne korake nastavitve do vključno razdelka Vnesite podatke strežnika Snowflake v ChatGPT.

Kaj nastavljate

Ustvarjate strežnik MCP, ki ga upravlja Snowflake in deluje kot končna točka povezovalnika za ChatGPT. Strežnik MCP določa:

• Katera dejanja lahko uporablja ChatGPT.

• Do katerih podatkov ali objektov Snowflake lahko dostopajo ta orodja.

• S katero vlogo Snowflake posamezni uporabnik izvede avtorizacijo.

• Katera podatkovna zbirka, shema in ime strežnika MCP v platformi Snowflake določajo končno točko.

Nato v ChatGPT nastavite Snowflake – uradna predloga s celotnim URL-jem upravljanega strežnika MCP. Zaslon za nastavitev predloge lahko URL prikaže v štirih ločenih poljih:

• Predpona gostitelja Snowflake.

• Podatkovna zbirka.

• Shema.

• Ime strežnika MCP.

ChatGPT lahko odkrije in uporablja samo orodja, ki jih daje na voljo strežnik MCP in jih dovoljuje vloga Snowflake, s katero uporabnik izvede avtorizacijo.

Preden začnete

Potrebujete:

• Dostop skrbnika ali lastnika delovnega prostora ChatGPT oziroma dostop do paketa ChatGPT Plus ali Pro.

• Dostop do platforme Snowflake, ki omogoča ustvarjanje objektov strežnika MCP in dodeljevanje dovoljenj.

• Podatkovno zbirko in shemo v platformi Snowflake, kjer bo strežnik MCP.

• Odločitev o tem, kaj bo ChatGPT smel uporabljati, na primer Cortex Search, Cortex Analyst, SQL samo za branje ali določeno proceduro ali funkcijo.

• Vlogo Snowflake z najmanjšimi potrebnimi pravicami, ki jo bodo uporabniki uporabljali pri avtorizaciji aplikacije.

• Predpono gostitelja računa Snowflake, vključno z morebitno pripono regije ali oblaka.

Če vaš račun Snowflake omejuje dostop z omrežnim pravilnikom ali seznamom dovoljenih naslovov IP, prosite skrbnika platforme Snowflake, naj dovoli dohodne povezave s trenutnih obsegov izhodnih naslovov IP povezovalnikov ChatGPT. Seznam se spreminja, zato ga je treba redno posodabljati.

Vrednosti, ki jih pripravite

• Predpona gostitelja Snowflake: vse pred .snowflakecomputing.com v URL-ju računa Snowflake.

• Podatkovna zbirka: podatkovna zbirka, ki vsebuje strežnik MCP.

• Shema: shema, ki vsebuje strežnik MCP.

• Ime strežnika MCP: ime objekta strežnika MCP v platformi Snowflake.

• Celoten URL upravljanega strežnika MCP, če zaslon za nastavitev v ChatGPT zahteva URL.

• Vloga Snowflake: vloga, ki naj jo uporabniki uporabljajo pri avtorizaciji aplikacije.

• Seznam orodij: objekti in dejanja Snowflake, ki naj jih uporablja ChatGPT.

Določite, kaj lahko počne ChatGPT

Izberite samo zmožnosti, ki jih želite dati na voljo. Pogoste možnosti so:

• Iskanje s storitvijo Cortex Search za iskanje odgovorov v indeksiranih podatkih ali vsebini platforme Snowflake.

• Odgovarjanje na vprašanja s storitvijo Cortex Analyst prek odobrenega semantičnega pogleda.

• SQL samo za branje za nadzorovan dostop prek poizvedb.

• Agent Snowflake, shranjena procedura ali uporabniško določena funkcija (UDF) za določen potek dela.

Če omogočite SQL, ga omejite na branje, razen če je vaša organizacija pregledala in odobrila dostop za pisanje.

Odprite delovni list v platformi Snowflake

1. Prijavite se v aplikacijo Snowflake.

2. Preklopite na vlogo, ki omogoča ustvarjanje strežnika MCP in dodeljevanje dostopa.

3. Odprite Delovne prostore.

   

4. Ustvarite delovni prostor z datoteko SQL.

   

5. Kontekst delovnega prostora nastavite na podatkovno zbirko in shemo, kjer bo ustvarjen strežnik MCP.

   

Ustvarite strežnik MCP v platformi Snowflake

V Snowflake se prijavite z vlogo, ki omogoča ustvarjanje strežnika MCP in dodeljevanje dostopa. Odprite delovni list v podatkovni zbirki in shemi, kjer želite ustvariti strežnik MCP.

Izvedite stavek, kot je prikazan v naslednjem primeru. Imena nadomestite z imeni svoje podatkovne zbirke, sheme, storitev, pogledov, skladišča in strežnika v platformi 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"
$$;

Imena orodij in objekti Snowflake v tem stavku so primeri:

• support-search omogoča dostop do navedene storitve Cortex Search.

• revenue-analyst omogoča dostop do navedenega semantičnega pogleda. Po potrebi dodajte orodja za druge poglede.

• sql-readonly omogoča poizvedbe SQL samo za branje z uporabo navedenega skladišča.

Uporabljajte stalna in opisna imena orodij, da bo ChatGPT lahko izbral pravo orodje. Z ustvarjanjem strežnika MCP se dostop do objektov Snowflake, ki jih uporablja, ne dodeli samodejno.

Za dodatne možnosti specifikacije glejte: Ustvarjanje strežnika MCP, ki ga upravlja Snowflake.

Dodelite ustrezna dovoljenja v platformi Snowflake

Izberite vlogo Snowflake, s katero bodo uporabniki izvajali avtorizacijo, nato pa ji dodelite dostop do:

1. Podatkovne zbirke in sheme.

2. Strežnika MCP.

3. Vsakega objekta, ki ga uporabljajo orodja, na primer iskalne storitve, semantičnega pogleda ali skladišča.

Primer:

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;

Če strežnik MCP omogoča dostop do funkcije UDF, shranjene procedure ali agenta Cortex, dodelite zahtevana dovoljenja tudi za ta objekt.

Preverite, ali je Snowflake pripravljen

Izvedite:

SHOW MCP SERVERS IN SCHEMA CHATGPT_APPS.TOOLS;

Nato izvedite:

DESCRIBE MCP SERVER CHATGPT_APPS.TOOLS.CHATGPT_SNOWFLAKE_MCP;

Preverite naslednje:

• Strežnik obstaja v pričakovani podatkovni zbirki in shemi.

• Seznam orodij ustreza vašim nameram.

• Vrednost identifier vsakega orodja kaže na pravi objekt Snowflake.

• Vloga, s katero se vzpostavlja povezava, ima dovoljenje USAGE za strežnik MCP.

• Vloga, s katero se vzpostavlja povezava, ima potrebna dovoljenja za vsak objekt, ki ga orodja uporabljajo.

Vnesite podatke strežnika Snowflake v ChatGPT

Za nastavitev v delovnem prostoru odprite admin.openai.com, izberite želeni delovni prostor ChatGPT in odprite Dodatke. Za krmarjenje po delovnem prostoru in dostop do starejših aplikacij glejte Skrbniški nadzor, varnost in skladnost za dodatke in aplikacije.

1. V ChatGPT preklopite na račun ali delovni prostor, v katerem naj bo aplikacija na voljo.

2. Za osebno nastavitev odprite Nastavitve > Dodatki, za nastavitev v delovnem prostoru pa kot skrbnik delovnega prostora odprite Skrbniška konzola > Dodatki.

3. Poiščite Snowflake.

4. Omogočite Snowflake – uradna predloga.

5. Odprite Snowflake – uradna predloga, vnesite jasno ime povezave in izberite Poveži.

6. Vnesite celoten URL upravljanega strežnika MCP:

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

Primer:

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

Če zaslon za nastavitev prikazuje konfiguracijo Snowflake v ločenih poljih, uporabite iste vrednosti kot v URL-ju:

Predpona gostitelja Snowflake

Uporabite vse pred .snowflakecomputing.com v URL-ju svojega računa Snowflake, vključno z morebitno pripono regije ali oblaka.

Če se URL računa na primer začne z:

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

Je predpona gostitelja:

myorg-myaccount.azure

Podatkovna zbirka

Vnesite podatkovno zbirko, ki vsebuje strežnik MCP, na primer:

CHATGPT_APPS

Shema

Vnesite shemo, ki vsebuje strežnik MCP, na primer:

TOOLS

Ime strežnika MCP

Vnesite ime objekta strežnika MCP v platformi Snowflake, na primer:

CHATGPT_SNOWFLAKE_MCP

Nastavite OAuth

Izberite možnost OAuth, ki je na voljo za vaš račun in izpolnjuje zahteve vaše organizacije. Obe možnosti uporabljata zgornjo skupno nastavitev strežnika MCP ter spodnje preizkuse povezave in nastavitve nadzora dostopa.

Pri obeh možnostih OAuth Snowflake ob uporabi session:role:all uporabi privzeto vlogo posameznega uporabnika. Privzeta vloga mora biti na seznamu dovoljenih vlog integracije OAuth, če je ta nastavljen, in ne sme biti blokirana. Če imate drugo odobreno vlogo, se ta ne izbere samodejno.

Vgrajeni OAuth

Pred nadaljevanjem opravite korake v zgornjih skupnih razdelkih: ustvarite strežnik MCP, dodelite dovoljenja, preverite strežnik in vnesite njegove podatke v ChatGPT. To je obvezno, tudi če ste prišli neposredno v ta razdelek.

To možnost uporabite le, če je partnerska aplikacija ChatGPT na voljo za vaš račun Snowflake in je vgrajeni OAuth na voljo v pogovornem oknu za nastavitev v ChatGPT.

1. Prosite skrbnika platforme Snowflake, naj omogoči partnersko integracijo ChatGPT v istem računu Snowflake, ki gosti strežnik MCP. Znova uporabite obstoječo omogočeno partnersko integracijo ChatGPT.

2. V pogovornem oknu za nastavitev v ChatGPT uporabite vgrajeni OAuth. Ni vam treba vnesti ID-ja ali skrivnosti odjemalca ali registrirati URL-ja za povratni klic.

3. Nadaljujte s spodnjim razdelkom Povežite in upravljajte Snowflake, da se prijavite, podate soglasje in nastavite dostop. Nato opravite korake v razdelku Preizkusite aplikacijo, vključno s preizkusi s člani, ki imajo dovoljen dostop in nimajo skrbniških pravic.

Zgoraj opisano delovanje privzete vloge, seznama dovoljenih vlog in blokiranih vlog velja tudi za to možnost.

Lastni odjemalec OAuth

Pred nadaljevanjem opravite korake v zgornjih skupnih razdelkih: ustvarite strežnik MCP, dodelite dovoljenja, preverite strežnik in vnesite njegove podatke v ChatGPT. To je obvezno, tudi če ste prišli neposredno v ta razdelek.

Za lastnega odjemalca OAuth potrebujete ID in skrivnost odjemalca iz platforme Snowflake. Zgoraj opisano delovanje privzete vloge, seznama dovoljenih vlog in blokiranih vlog velja tudi za to možnost.

1. V pogovornem oknu za nastavitev v ChatGPT izberite Napredne nastavitve OAuth > Uporabniško določeni odjemalec OAuth in natančno kopirajte URL za povratni klic, prikazan v ChatGPT.

2. Ustvarite lastno varnostno integracijo OAuth z nastavitvijo OAUTH_CLIENT_TYPE = 'CONFIDENTIAL' in vrednostjo OAUTH_REDIRECT_URI, nastavljeno na natanko ta URL za povratni klic.

3. V platformi Snowflake izvedite naslednji stavek, pri čemer ime integracije napišite z velikimi črkami:

   SELECT SYSTEM$SHOW_OAUTH_CLIENT_SECRETS('YOUR_INTEGRATION_NAME');

4. Iz rezultata JSON prilepite vrednost oauth_client_id v polje ID odjemalca OAuth in vrednost oauth_client_secret v polje Skrivnost odjemalca OAuth v ChatGPT.

5. Način preverjanja pristnosti za končno točko žetona nastavite na client_secret_basic.

Ko vnesete poverilnice lastnega odjemalca, nadaljujte s spodnjima razdelkoma Povežite in upravljajte Snowflake ter Preizkusite aplikacijo.

Povežite in upravljajte Snowflake

1. Pri obeh možnostih OAuth v istem pogovornem oknu za nastavitev v ChatGPT izberite Nadaljuj, se prijavite v Snowflake in odobrite povezavo. Če je v vaši organizaciji nastavljen SSO, ga lahko uporabite.

2. Za nastavitev v delovnem prostoru nastavite pravilnik o nameščanju dodatkov in dostop po vlogah ali skupinah za člane, ki naj ga uporabljajo. Preverite, ali sta omogočena tako Snowflake kot Snowflake – uradna predloga.

3. Skrbniki delovnega prostora so odgovorni za nastavitev Uporabniškega dostopa za vloge, ki naj uporabljajo Snowflake.

4. Skrbniki delovnega prostora so odgovorni za pregled Nadzora dejanj za orodja, ki so na voljo.

5. Skrbniki delovnega prostora so odgovorni za pregled Dovoljenj aplikacije, kjer določijo, kdaj ChatGPT pred uporabo aplikacije člane vpraša za dovoljenje.

Ta dovoljenja aplikacije veljajo za pogovore v ChatGPT. Agenti delovnega prostora uporabljajo nastavitve nadzora za posameznega agenta, ki jih določi njegov ustvarjalec. Te določajo, katera dejanja aplikacije so na voljo in kdaj morajo končni uporabniki potrditi njihovo izvedbo. Za delovanje agentov glejte: Agenti delovnega prostora ChatGPT za paketa Enterprise in Business.

Preizkusite aplikacijo

1. Odprite klepet, izberite Snowflake in preizkusite povezavo.

2. Preverite, ali ChatGPT odkrije orodja, ki ste jih nastavili.

3. Najprej izvedite dejanje branja z majhnim tveganjem, na primer iskanje ali poizvedbo samo za branje po odobrenih podatkih.

4. Preverite, ali dovoljenja v platformi Snowflake preprečujejo dostop zunaj odobrene vloge in objektov.

5. Pri nastavitvi v delovnem prostoru izvedite preizkuse s člani, ki imajo dovoljen dostop, nimajo skrbniških pravic in imajo različne privzete vloge Snowflake. Uspešna povezava skrbnika ne potrjuje, da se lahko poveže vsak član.

Za skrbnike delovnega prostora ne zadostuje, da omogočijo samo Snowflake. Če Snowflake – uradna predloga ni omogočena in povezana, je lahko dodatek članom prikazan kot onemogočen.

URL strežnika MCP in delovanje OAuth

ChatGPT se poveže s celotnim URL-jem strežnika MCP, ki ga upravlja Snowflake:

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

ChatGPT iz predpone gostitelja Snowflake v tem URL-ju določi naslednji končni točki OAuth v platformi Snowflake:

• Avtorizacija: https://<snowflake_host_prefix>.snowflakecomputing.com/oauth/authorize

• Žeton: https://<snowflake_host_prefix>.snowflakecomputing.com/oauth/token-request

Ne prilepite URL-ja Snowsight, zgolj korenskega URL-ja računa Snowflake ali URL-ja z dodatnimi deli poti. URL strežnika MCP mora vključevati /api/v2/databases/{database}/schemas/{schema}/mcp-servers/{server} in se natančno ujemati z vašimi objekti Snowflake.

Odpravljanje težav

Snowflake je omogočen za skrbnika, za člana pa onemogočen

• Preverite, ali sta v razdelku Skrbniška konzola > Dodatki omogočena tako Snowflake kot Snowflake – uradna predloga.

• Odprite Snowflake – uradna predloga in dokončajte postopek Poveži. Samo omogočanje predloge brez vzpostavljene povezave ne zadostuje.

• Odprite Snowflake in preverite, ali je predloga prikazana kot njegova zahtevana aplikacija.

• Preverite, ali pravilnik o nameščanju dodatkov dovoljuje vlogo ali skupino člana, ki ima težave.

Strežnika MCP ni mogoče najti

• Znova preverite celoten URL strežnika MCP oziroma štiri polja predloge, če jih zaslon za nastavitev zahteva.

• Preverite, ali strežnik MCP obstaja prav v tej podatkovni zbirki in shemi.

V ChatGPT ni prikazanih orodij

• Preverite, ali specifikacija strežnika MCP vključuje orodja.

• Preverite, ali ima vloga dovoljenje USAGE za strežnik MCP.

Orodje je prikazano, vendar ob uporabi ne deluje

• Preverite, ali ima vloga zahtevano dovoljenje za objekt Snowflake, ki ga orodje uporablja, na primer iskalno storitev, semantični pogled, skladišče, proceduro ali UDF.

Orodje SQL ne deluje

• Preverite, ali je ime skladišča pravilno in ali skladišče deluje.

• Preverite, ali ima vloga dovoljenje USAGE za skladišče.

• Če ste želeli dostop samo za branje, preverite, ali je nastavljeno read_only: true.

Zahtevana vloga ALL je izrecno blokirana

Prosite skrbnika platforme Snowflake, naj vašo privzeto vlogo primerja z dovoljenimi in blokiranimi vlogami integracije OAuth. Če imate drugo dovoljeno vlogo, se ta ne izbere samodejno. Če je to ustrezno, privzeto vlogo spremenite v odobreno vlogo in znova vzpostavite povezavo. Sprememba privzete vloge vpliva tudi na vaše seje Snowflake zunaj ChatGPT.

Avtorizacija ne uspe

• Preverite, ali se uporabnik lahko prijavi v Snowflake.

• Če uporabljate session:role:all, preverite, ali integracija OAuth dovoljuje uporabnikovo privzeto vlogo.

• Preverite, ali nastavitev uporablja potek OAuth za MCP, ki ga upravlja Snowflake.

• Če uporabljate lastnega odjemalca OAuth, preverite, ali se ID odjemalca in Skrivnost odjemalca ujemata z integracijo OAuth v platformi Snowflake ter ali se njen preusmeritveni URI natančno ujema z URL-jem za povratni klic, prikazanim v ChatGPT.

  Če uporabljate vgrajeni OAuth, prosite skrbnika platforme Snowflake, naj preveri, ali je partnerska integracija ChatGPT na voljo in omogočena v računu, ki gosti strežnik MCP.

Omrežni pravilnik ali seznam dovoljenih naslovov IP v platformi Snowflake blokira povezovalnik

• Prosite skrbnika platforme Snowflake, naj posodobi omrežni pravilnik ali pravila dostopa v platformi Snowflake.

• Dovolite dohodne povezave s trenutnih obsegov izhodnih naslovov IP povezovalnikov ChatGPT.

• Ta seznam dovoljenih naslovov nastavite v platformi Snowflake. Ločen je od seznama dovoljenih naslovov IP delovnega prostora ChatGPT.

• Če je mogoče, avtomatizirajte posodabljanje na podlagi objavljene datoteke JSON, saj se obsegi lahko spremenijo.

Težava pri povezovanju zaradi imena gostitelja

Uporabite pravilno predpono gostitelja Snowflake. Imena gostiteljev Snowflake s podčrtaji lahko povzročajo težave; raje uporabite vezaje.

Viri

• Strežnik MCP, ki ga upravlja Snowflake

• CREATE MCP SERVER

• DESCRIBE MCP SERVER

• SHOW MCP SERVERS