Setja upp Snowflake-forritssniðmátið í ChatGPT

Þessar leiðbeiningar eru fyrir stjórnendur ChatGPT-vinnusvæða og notendur ChatGPT Plus eða Pro sem vilja tengja ChatGPT við Snowflake í gegnum MCP-þjón sem Snowflake stýrir.

Uppsetningin fer að mestu fram í Snowflake. Þegar Snowflake er tilbúið skaltu ljúka við að tengja Snowflake-sniðmátið í ChatGPT og virkja síðan Snowflake-viðbótina sem notar það.

• Innbyggt OAuth: Notaðu samstarfsforrit ChatGPT sem stjórnandi Snowflake hefur virkjað, ef það er í boði fyrir Snowflake-reikninginn þinn og í ChatGPT. Skráðu þig inn í Snowflake með SSO-vefslóð fyrirtækisins ef hún hefur verið stillt. Þú þarft ekki að slá inn auðkenni biðlara eða leynilykil biðlara í ChatGPT. Fylgdu kaflanum „Innbyggt OAuth“ hér að neðan.

• Sérsniðinn OAuth-biðlari: Veldu þessa leið ef fyrirtækið þitt krefst eigin OAuth-biðlara eða innbyggt OAuth er ekki í boði. Fylgdu kaflanum „Sérsniðinn OAuth-biðlari“ hér að neðan.

Báðar OAuth-leiðirnar krefjast sameiginlegu uppsetningarinnar á MCP-þjóninum, heimilda fyrir undirliggjandi hluti og netaðgangs sem lýst er hér að neðan. Ljúktu sameiginlegu uppsetningunni til og með kaflanum „Sláðu inn upplýsingar um Snowflake-þjóninn í ChatGPT“ áður en þú stillir OAuth.

Það sem þú ert að setja upp

Þú ert að búa til MCP-þjón sem Snowflake stýrir og þjónar sem endapunktur tengilsins fyrir ChatGPT. MCP-þjónninn skilgreinir:

• Hvaða aðgerðir ChatGPT getur notað.

• Hvaða gögnum eða hlutum í Snowflake þessi verkfæri hafa aðgang að.

• Hvaða Snowflake-hlutverk hver notandi notar við heimildarveitingu.

• Hvaða Snowflake-gagnagrunnur, skema og heiti MCP-þjóns auðkenna endapunktinn.

Síðan stillirðu Snowflake – opinbert sniðmát í ChatGPT með fullri vefslóð MCP-þjónsins sem Snowflake stýrir. Uppsetningarskjár sniðmátsins kann að sýna vefslóðina sem fjóra aðskilda reiti:

• Forskeyti Snowflake-hýsilheitis.

• Gagnagrunnur.

• Skema.

• Heiti MCP-þjóns.

ChatGPT getur aðeins fundið og notað verkfæri sem MCP-þjónninn gerir aðgengileg og Snowflake-hlutverkið sem notandinn notar við heimildarveitingu leyfir.

Áður en þú byrjar

Þú þarft:

• Stjórnanda- eða eigandaaðgang að ChatGPT-vinnusvæði, eða aðgang að ChatGPT Plus eða Pro.

• Aðgang að Snowflake sem heimilar stofnun MCP-þjónshluta og veitingu heimilda.

• Snowflake-gagnagrunninn og skemað þar sem MCP-þjónninn verður staðsettur.

• Ákvörðun um hvað ChatGPT má gera, til dæmis nota Cortex Search, Cortex Analyst, SQL í lesham eða tiltekna stefju eða fall.

• Snowflake-hlutverk með lágmarksheimildum sem notendur nota þegar þeir veita forritinu heimild.

• Forskeyti hýsilheitis Snowflake-reikningsins, ásamt viðskeyti fyrir svæði eða ský ef við á.

Ef aðgangur að Snowflake-reikningnum þínum er takmarkaður með netstefnu eða lista yfir leyfðar IP-tölur skaltu biðja stjórnanda Snowflake að leyfa innkomandi tengingar frá núverandi IP-tölubilum fyrir útleiðarumferð ChatGPT-tengla. Listinn breytist og þarf að halda honum uppfærðum.

Gildi sem þarf að hafa tilbúin

• Forskeyti Snowflake-hýsilheitis: allt á undan .snowflakecomputing.com í vefslóð Snowflake-reikningsins.

• Gagnagrunnur: gagnagrunnurinn sem inniheldur MCP-þjóninn.

• Skema: skemað sem inniheldur MCP-þjóninn.

• Heiti MCP-þjóns: heiti MCP-þjónshlutarins í Snowflake.

• Full vefslóð MCP-þjónsins sem Snowflake stýrir, ef uppsetningarskjár ChatGPT biður um vefslóð.

• Snowflake-hlutverk: hlutverkið sem notendur eiga að nota þegar þeir veita forritinu heimild.

• Verkfæralisti: Snowflake-hlutirnir og aðgerðirnar sem þú vilt að ChatGPT noti.

Ákveddu hvað ChatGPT má gera

Veldu aðeins þá eiginleika sem þú vilt gera aðgengilega. Algengir valkostir eru:

• Leit með Cortex Search til að finna svör í Snowflake-gögnum eða efni sem hefur verið skráð í leitarvísi.

• Spurningar og svör með Cortex Analyst í gegnum samþykkta merkingarsýn.

• SQL í lesham fyrir stýrðan fyrirspurnaaðgang.

• Snowflake Agent, geymd stefja eða notandaskilgreint fall (UDF) fyrir tiltekið verkferli.

Ef þú virkjar SQL skaltu halda því í lesham nema fyrirtækið þitt hafi yfirfarið og samþykkt skrifaðgang.

Opnaðu vinnublað í Snowflake

1. Skráðu þig inn í Snowflake-forritið.

2. Skiptu yfir í hlutverk sem getur búið til MCP-þjóninn og veitt aðgang.

3. Farðu í Vinnusvæði.

   

4. Búðu til vinnusvæði með SQL-skrá.

   

5. Stilltu vinnusvæðið þannig að það noti gagnagrunninn og skemað þar sem MCP-þjónninn verður búinn til.

   

Búðu til Snowflake MCP-þjóninn

Skráðu þig inn í Snowflake með hlutverki sem getur búið til MCP-þjóninn og veitt aðgang. Opnaðu vinnublað í gagnagrunninum og skemanu þar sem á að búa til MCP-þjóninn.

Keyrðu skipun á borð við eftirfarandi dæmi. Skiptu heitunum út fyrir heiti þíns eigin Snowflake-gagnagrunns, skema, þjónusta, sýna, vinnsluþyrpingar og þjóns.

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

Heiti verkfæra og Snowflake-hlutir í þessari skipun eru dæmi:

• support-search gerir tilgreinda Cortex Search-þjónustu aðgengilega.

• revenue-analyst gerir tilgreinda merkingarsýn aðgengilega. Bættu við verkfærum fyrir aðrar sýnir eftir þörfum.

• sql-readonly veitir aðgang að SQL í lesham með tilgreindri vinnsluþyrpingu.

Notaðu stöðug, lýsandi verkfæraheiti svo ChatGPT geti valið rétt verkfæri. Stofnun MCP-þjónsins veitir ekki sjálfkrafa aðgang að undirliggjandi Snowflake-hlutum.

Sjá fleiri valkosti fyrir skilgreininguna í: Búa til MCP-þjón sem Snowflake stýrir.

Veittu réttar heimildir í Snowflake

Veldu Snowflake-hlutverkið sem notendur munu nota við heimildarveitingu og veittu því síðan aðgang að:

1. Gagnagrunninum og skemanu.

2. MCP-þjóninum.

3. Öllum undirliggjandi hlutum sem verkfærin nota, svo sem leitarþjónustu, merkingarsýn eða vinnsluþyrpingu.

Dæmi:

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;

Ef MCP-þjónninn gerir UDF, geymda stefju eða Cortex Agent aðgengilegt skaltu einnig veita nauðsynlegar heimildir fyrir þann hlut.

Gakktu úr skugga um að Snowflake sé tilbúið

Keyrðu:

SHOW MCP SERVERS IN SCHEMA CHATGPT_APPS.TOOLS;

Keyrðu síðan:

DESCRIBE MCP SERVER CHATGPT_APPS.TOOLS.CHATGPT_SNOWFLAKE_MCP;

Gakktu úr skugga um að:

• Þjónninn sé til í réttum gagnagrunni og skema.

• Verkfæralistinn sé eins og þú ætlaðir.

• identifier hvers verkfæris vísi á réttan Snowflake-hlut.

• Hlutverkið sem notað er við tengingu hafi USAGE-heimild á MCP-þjóninum.

• Hlutverkið sem notað er við tengingu hafi nauðsynlegar heimildir fyrir hvern undirliggjandi hlut.

Sláðu inn upplýsingar um Snowflake-þjóninn í ChatGPT

1. Í ChatGPT skaltu skipta yfir á reikninginn eða vinnusvæðið þar sem forritið á að vera aðgengilegt.

2. Farðu í Stillingar > Viðbætur fyrir persónulega uppsetningu eða í Stillingar vinnusvæðis > Viðbætur sem stjórnandi vinnusvæðis til að setja upp fyrir vinnusvæði.

3. Leitaðu að Snowflake.

4. Virkjaðu Snowflake – opinbert sniðmát.

5. Opnaðu Snowflake – opinbert sniðmát, sláðu inn skýrt heiti fyrir tenginguna og veldu Tengja.

6. Sláðu inn fulla vefslóð MCP-þjónsins sem Snowflake stýrir:

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

Dæmi:

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

Ef uppsetningarskjárinn sýnir Snowflake-stillingarnar sem aðskilda reiti skaltu nota sömu gildi og í vefslóðinni:

Forskeyti Snowflake-hýsilheitis

Notaðu allt á undan .snowflakecomputing.com í vefslóð Snowflake-reikningsins, ásamt viðskeyti fyrir svæði eða ský ef við á.

Ef vefslóð reikningsins byrjar til dæmis á:

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

Er forskeyti hýsilheitisins:

myorg-myaccount.azure

Gagnagrunnur

Sláðu inn gagnagrunninn sem inniheldur MCP-þjóninn, til dæmis:

CHATGPT_APPS

Skema

Sláðu inn skemað sem inniheldur MCP-þjóninn, til dæmis:

TOOLS

Heiti MCP-þjóns

Sláðu inn heiti MCP-þjónshlutarins í Snowflake, til dæmis:

CHATGPT_SNOWFLAKE_MCP

Stilltu OAuth

Veldu OAuth-leiðina sem er í boði fyrir reikninginn þinn og uppfyllir kröfur fyrirtækisins. Báðar leiðirnar nota sameiginlegu uppsetninguna á MCP-þjóninum hér að ofan og tengingarprófin og aðgangsstýringarnar hér að neðan.

Hvor OAuth-leiðin sem er valin notar Snowflake sjálfgefið hlutverk hvers notanda þegar þú notar session:role:all. Sjálfgefna hlutverkið verður að vera á lista OAuth-samþættingarinnar yfir leyfð hlutverk, ef slíkur listi er stilltur, og það má ekki vera á bannlista. Annað samþykkt hlutverk er ekki valið sjálfkrafa þótt notandinn hafi það.

Innbyggt OAuth

Áður en þú heldur áfram skaltu ljúka sameiginlegu köflunum hér að ofan: búa til MCP-þjóninn, veita heimildir, sannreyna þjóninn og slá inn upplýsingar hans í ChatGPT. Þetta er nauðsynlegt þótt þú hafir komið beint í þennan kafla.

Notaðu þessa leið aðeins þegar samstarfsforrit ChatGPT er í boði fyrir Snowflake-reikninginn þinn og innbyggt OAuth er í boði í uppsetningarglugga ChatGPT.

1. Biddu stjórnanda Snowflake að virkja samstarfssamþættingu ChatGPT á sama Snowflake-reikningi og hýsir MCP-þjóninn. Endurnýttu fyrirliggjandi virka samstarfssamþættingu ChatGPT.

2. Notaðu innbyggt OAuth í uppsetningarglugga ChatGPT. Þú þarft ekki að slá inn auðkenni biðlara eða leynilykil biðlara né skrá bakslóð.

3. Haltu áfram í kaflanum „Tengdu og stjórnaðu Snowflake“ hér að neðan til að skrá þig inn, veita samþykki og stilla aðgang. Ljúktu síðan kaflanum „Prófaðu forritið“, þar á meðal prófunum með notendum sem hafa aðgang en eru ekki stjórnendur.

Það sem lýst er hér að ofan um sjálfgefin hlutverk, lista yfir leyfð hlutverk og hlutverk á bannlista gildir einnig um þessa leið.

Sérsniðinn OAuth-biðlari

Áður en þú heldur áfram skaltu ljúka sameiginlegu köflunum hér að ofan: búa til MCP-þjóninn, veita heimildir, sannreyna þjóninn og slá inn upplýsingar hans í ChatGPT. Þetta er nauðsynlegt þótt þú hafir komið beint í þennan kafla.

Fyrir sérsniðinn OAuth-biðlara þarftu auðkenni biðlara og leynilykil biðlara frá Snowflake. Það sem lýst er hér að ofan um sjálfgefin hlutverk, lista yfir leyfð hlutverk og hlutverk á bannlista gildir einnig um þessa leið.

1. Í uppsetningarglugga ChatGPT skaltu velja Ítarlegar OAuth-stillingar > Notandaskilgreindur OAuth-biðlari og afrita nákvæmlega þá bakslóð sem birtist í ChatGPT.

2. Búðu til sérsniðna OAuth-öryggissamþættingu með OAUTH_CLIENT_TYPE = 'CONFIDENTIAL' og stilltu OAUTH_REDIRECT_URI á nákvæmlega þessa bakslóð.

3. Keyrðu eftirfarandi skipun í Snowflake með heiti samþættingarinnar í hástöfum:

   SELECT SYSTEM$SHOW_OAUTH_CLIENT_SECRETS('YOUR_INTEGRATION_NAME');

4. Úr JSON-niðurstöðunni skaltu líma oauth_client_id í Auðkenni OAuth-biðlara og oauth_client_secret í Leynilykill OAuth-biðlara í ChatGPT.

5. Stilltu Auðkenningaraðferð endapunkts fyrir aðgangsteikn á client_secret_basic.

Þegar þú hefur slegið inn auðkenningarupplýsingar sérsniðna biðlarans skaltu halda áfram í köflunum „Tengdu og stjórnaðu Snowflake“ og „Prófaðu forritið“ hér að neðan.

Tengdu og stjórnaðu Snowflake

1. Hvor OAuth-leiðin sem er valin skaltu velja Halda áfram í sama uppsetningarglugga ChatGPT, skrá þig inn í Snowflake og heimila tenginguna. Þú getur notað SSO-vefslóð fyrirtækisins ef hún hefur verið stillt.

2. Ef þú setur upp fyrir vinnusvæði skaltu stilla reglur um uppsetningu viðbóta og aðgang eftir hlutverkum eða hópum fyrir þá notendur sem eiga að nota viðbótina. Gakktu úr skugga um að bæði Snowflake og Snowflake – opinbert sniðmát séu virk.

3. Stjórnendur vinnusvæðis bera ábyrgð á að stilla Notandaaðgang fyrir þau hlutverk sem eiga að nota Snowflake.

4. Stjórnendur vinnusvæðis bera ábyrgð á að yfirfara Aðgerðastýringu fyrir verkfærin sem eru aðgengileg.

5. Stjórnendur vinnusvæðis bera ábyrgð á að yfirfara Forritsheimildir til að velja hvenær ChatGPT biður notendur um leyfi áður en það notar forritið.

Þessar forritsheimildir gilda um ChatGPT-samtöl. Fulltrúar vinnusvæðis nota stýringar fyrir hvern fulltrúa sem sá sem býr hann til stillir. Þær ákvarða hvaða forritsaðgerðir eru í boði og hvenær endanotendur eru beðnir um að samþykkja þær. Um virkni fulltrúa, sjá: Fulltrúar á ChatGPT-vinnusvæðum fyrir Enterprise og Business.

Prófaðu forritið

1. Opnaðu spjall, veldu Snowflake og prófaðu tenginguna.

2. Gakktu úr skugga um að ChatGPT finni verkfærin sem þú stilltir.

3. Keyrðu fyrst lesaðgerð sem felur í sér litla áhættu, svo sem leit eða fyrirspurn í lesham á samþykktum gögnum.

4. Gakktu úr skugga um að Snowflake-heimildir komi í veg fyrir aðgang umfram samþykkt hlutverk og hluti.

5. Ef þú setur upp fyrir vinnusvæði skaltu prófa með notendum sem hafa aðgang en eru ekki stjórnendur og hafa mismunandi sjálfgefin Snowflake-hlutverk. Þótt stjórnandi nái að tengjast staðfestir það ekki að allir notendur geti tengst.

Fyrir stjórnendur vinnusvæðis nægir ekki að virkja aðeins Snowflake. Ef Snowflake – opinbert sniðmát hefur ekki verið virkjað og tengt kann viðbótin að birtast notendum sem óvirk.

Vefslóð MCP-þjóns og virkni OAuth

ChatGPT tengist fullri vefslóð MCP-þjónsins sem Snowflake stýrir:

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

ChatGPT notar forskeyti Snowflake-hýsilheitisins úr þeirri vefslóð til að finna þessa Snowflake OAuth-endapunkta:

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

• Aðgangsteikn: https://<snowflake_host_prefix>.snowflakecomputing.com/oauth/token-request

Ekki líma inn Snowsight-vefslóð, rótarslóð Snowflake-reikningsins eina og sér eða vefslóð með aukalegum slóðarhlutum. MCP-vefslóðin verður að innihalda /api/v2/databases/{database}/schemas/{schema}/mcp-servers/{server} og samsvara Snowflake-hlutunum þínum nákvæmlega.

Úrræðaleit

Snowflake er virkt fyrir stjórnanda en óvirkt fyrir notanda

• Gakktu úr skugga um að bæði Snowflake og Snowflake – opinbert sniðmát séu virk í Stillingar vinnusvæðis > Viðbætur.

• Opnaðu Snowflake – opinbert sniðmát og ljúktu ferlinu undir Tengja. Það nægir ekki að virkja sniðmátið án þess að tengja það.

• Opnaðu Snowflake og gakktu úr skugga um að sniðmátið birtist sem nauðsynlegt forrit fyrir það.

• Gakktu úr skugga um að reglur um uppsetningu viðbóta leyfi hlutverk eða hóp notandans sem á í vandanum.

MCP-þjónn finnst ekki

• Athugaðu aftur fulla vefslóð MCP-þjónsins, eða reitina fjóra í sniðmátinu ef uppsetningarskjárinn biður um þá.

• Gakktu úr skugga um að MCP-þjónninn sé til í nákvæmlega þeim gagnagrunni og því skema.

Engin verkfæri birtast í ChatGPT

• Gakktu úr skugga um að skilgreining MCP-þjónsins innihaldi verkfæri.

• Gakktu úr skugga um að hlutverkið hafi USAGE-heimild á MCP-þjóninum.

Verkfæri birtist en virkar ekki þegar það er notað

• Gakktu úr skugga um að hlutverkið hafi nauðsynlega heimild fyrir undirliggjandi Snowflake-hlut, svo sem leitarþjónustu, merkingarsýn, vinnsluþyrpingu, stefju eða UDF.

SQL-verkfæri virkar ekki

• Gakktu úr skugga um að heiti vinnsluþyrpingarinnar sé rétt og að hún sé í gangi.

• Gakktu úr skugga um að hlutverkið hafi USAGE-heimild á vinnsluþyrpingunni.

• Gakktu úr skugga um að read_only: true sé stillt ef þú ætlaðir aðeins að veita lesaðgang.

Umbeðið hlutverk ALL hefur verið sérstaklega sett á bannlista

Biddu stjórnanda Snowflake að bera sjálfgefna hlutverkið þitt saman við leyfð hlutverk OAuth-samþættingarinnar og hlutverk á bannlista hennar. Annað leyft hlutverk er ekki valið sjálfkrafa þótt þú hafir það. Ef við á skaltu breyta sjálfgefna hlutverkinu í samþykkt hlutverk og tengjast aftur. Breyting á sjálfgefna hlutverkinu hefur einnig áhrif á Snowflake-seturnar þínar utan ChatGPT.

Heimildarveiting mistekst

• Gakktu úr skugga um að notandinn geti skráð sig inn í Snowflake.

• Þegar session:role:all er notað skaltu ganga úr skugga um að OAuth-samþættingin leyfi sjálfgefið hlutverk notandans.

• Gakktu úr skugga um að uppsetningin noti OAuth-ferlið fyrir MCP-þjón sem Snowflake stýrir.

• Ef þú notar sérsniðinn OAuth-biðlara skaltu ganga úr skugga um að Auðkenni biðlara og Leynilykill biðlara samsvari Snowflake OAuth-samþættingunni og að framsendingarslóð hennar sé nákvæmlega sú sama og bakslóðin sem birtist í ChatGPT.

  Ef þú notar innbyggt OAuth skaltu biðja stjórnanda Snowflake að athuga hvort samstarfssamþætting ChatGPT sé í boði og virk á reikningnum sem hýsir MCP-þjóninn.

Netstefna Snowflake eða listi yfir leyfðar IP-tölur hindrar tengilinn

• Biddu stjórnanda Snowflake að uppfæra netstefnu eða aðgangsreglur Snowflake.

• Leyfðu innkomandi tengingar frá núverandi IP-tölubilum fyrir útleiðarumferð ChatGPT-tengla.

• Stilltu þennan lista yfir leyfðar IP-tölur í Snowflake. Hann er aðskilinn frá lista ChatGPT-vinnusvæðisins yfir leyfðar IP-tölur.

• Gerðu uppfærslur úr birta JSON-skjalinu sjálfvirkar þegar hægt er, því tölubilin geta breyst.

Tengingarvandamál vegna hýsilheitis

Notaðu rétt forskeyti Snowflake-hýsilheitis. Snowflake-hýsilheiti með undirstrikum geta valdið vandræðum; notaðu frekar bandstrik.

Tilvísanir

• MCP-þjónn sem Snowflake stýrir

• CREATE MCP SERVER

• DESCRIBE MCP SERVER

• SHOW MCP SERVERS