Naudokite šį vadovą, jei esate ChatGPT darbo erdvės administratorius, nustatantis Snowflake programos šabloną savo organizacijai. Šablonas nėra galutinė programa, kuria naudojasi nariai. Tai nustatymo eiga, kuri sukuria konkrečiai darbo erdvei skirtą programos juodraštį, kai pateikiate reikiamą Snowflake konfigūraciją.
Naudojant Snowflake, didžioji nustatymo dalis atliekama Snowflake aplinkoje. Sukuriate Snowflake valdomą MCP serverį, suteikiate tinkamam vaidmeniui prieigą prie MCP serverio ir jo bazinių objektų, tada ChatGPT šablono nustatymo eigoje įvedate valdomo MCP serverio URL arba jo komponentų laukus. Kai ChatGPT sukuria programos juodraštį, galite jį paskelbti ir tvarkyti kaip kitas darbo erdvės programas.
Ką nustatote
Kuriate konkrečiai darbo erdvei skirtą Snowflake programą ChatGPT. Programa jungiasi prie Snowflake valdomo MCP serverio, kuris apibrėžia:
Kokius veiksmus ChatGPT gali naudoti; jie vadinami įrankiais.
Kokius Snowflake duomenis ar objektus tie įrankiai gali pasiekti.
Su kokiu Snowflake vaidmeniu naudotojai turėtų autorizuotis.
Kokia Snowflake duomenų bazė, schema ir MCP serverio pavadinimas identifikuoja jungties prieigos tašką.
ChatGPT gali aptikti ir naudoti tik tuos įrankius, kuriuos pateikia MCP serveris ir leidžia Snowflake vaidmuo, su kuriuo autorizuojasi naudotojas.
Prieš pradėdami
Jums reikia:
ChatGPT darbo erdvės administratoriaus arba savininko prieigos.
Snowflake prieigos, leidžiančios kurti MCP serverio objektus ir suteikti leidimus.
Snowflake duomenų bazės ir schemos, kuriose bus MCP serveris.
Sprendimo, ką ChatGPT turėtų būti leidžiama daryti, pvz., naudoti Cortex Search, Cortex Analyst, tik skaitymo SQL arba konkrečią procedūrą ar funkciją.
Mažiausių privilegijų Snowflake vaidmens, kurį naudotojai naudos autorizuodami programą.
Snowflake paskyros pagrindinio kompiuterio prefikso, įskaitant bet kokią regiono ar debesijos priesagą.
Paruoštinos reikšmės
Snowflake pagrindinio kompiuterio prefiksas: viskas, kas Snowflake paskyros URL yra prieš .snowflakecomputing.com.
Duomenų bazė: duomenų bazė, kurioje yra MCP serveris.
Schema: schema, kurioje yra MCP serveris.
MCP serverio pavadinimas: Snowflake MCP serverio objekto pavadinimas.
Visas valdomo MCP serverio URL, jei ChatGPT nustatymo ekrane prašoma URL.
Snowflake vaidmuo: vaidmuo, kurį naudotojai turėtų naudoti autorizuodami programą.
Įrankių sąrašas: Snowflake objektai ir veiksmai, kuriuos norite leisti naudoti ChatGPT.
Nuspręskite, ką ChatGPT gali daryti
Pasirinkite tik tas galimybes, kurias norite atskleisti. Dažnos parinktys:
Paieška naudojant Cortex Search, kad būtų galima rasti atsakymus indeksuotuose Snowflake duomenyse ar turinyje.
Klausimai ir atsakymai naudojant Cortex Analyst per patvirtintą semantinį rodinį.
Tik skaitymo SQL kontroliuojamai užklausų prieigai.
Snowflake agentas, saugoma procedūra arba UDF konkrečioms darbo eigoms.
Jei įgalinate SQL, palikite jį tik skaitymo režimu, nebent jūsų organizacija peržiūrėjo ir patvirtino rašymo prieigą.
Sukurkite Snowflake MCP serverį
Snowflake prisijunkite naudodami vaidmenį, kuris gali sukurti MCP serverį ir suteikti prieigą. Atidarykite darbalapį duomenų bazėje ir schemoje, kurioje turėtų būti sukurtas MCP serveris.
Sukurkite MCP serverį, kuriame išvardyti tik tie įrankiai, kuriuos turėtų naudoti ChatGPT. Pakeiskite objektų pavadinimus savais Snowflake duomenų bazės, schemos, paslaugų, rodinių, sandėlio ir serverio pavadinimais.
Pavyzdys:
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" $$;
Įrankių pavadinimai turėtų būti stabilūs ir aprašomieji, kad ChatGPT galėtų pasirinkti tinkamą įrankį. MCP serverio sukūrimas automatiškai nesuteikia prieigos prie bazinių Snowflake objektų.
Suteikite tinkamus Snowflake leidimus
Pasirinkite Snowflake vaidmenį, su kuriuo autorizuosis naudotojai, tada suteikite tam vaidmeniui prieigą prie duomenų bazės, schemos, MCP serverio ir kiekvieno bazinio objekto, kurį naudoja įrankiai.
Pavyzdys:
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;
Jei MCP serveris atskleidžia semantinį rodinį, UDF, saugomą procedūrą arba Cortex Agent, suteikite reikiamus leidimus ir tiems objektams.
Patikrinkite, ar Snowflake paruošta
Paleiskite:
SHOW MCP SERVERS IN SCHEMA CHATGPT_APPS.TOOLS;
Tada paleiskite:
DESCRIBE MCP SERVER CHATGPT_APPS.TOOLS.CHATGPT_SNOWFLAKE_MCP;
Patvirtinkite:
Serveris yra numatytoje duomenų bazėje ir schemoje.
Įrankių sąrašas atitinka jūsų ketinimus.
Kiekvienas įrankio identifikatorius nurodo tinkamą Snowflake objektą.
Jungimosi vaidmuo turi USAGE teisę MCP serveryje.
Jungimosi vaidmuo turi reikiamus leidimus kiekvienam baziniam objektui.
Pradėkite šablono nustatymą ChatGPT
ChatGPT persijunkite į darbo erdvę, kurioje programa turėtų būti pasiekiama.
Atidarykite Darbo erdvės nustatymai > Programos.
Pasirinkite Katalogas.
Ieškokite Snowflake.
Pasirinkite Snowflake programos šabloną ir pradėkite nustatymą.
Įveskite aiškų programos pavadinimą ir aprašą, pvz., Snowflake arba Snowflake - Analytics.
Įveskite valdomo MCP serverio duomenis, kurių prašo nustatymo eiga.
Jei nustatymo ekrane prašoma viso valdomo MCP serverio URL, naudokite šį formatą:
https://<snowflake_host_prefix>.snowflakecomputing.com/api/v2/databases/{database}/schemas/{schema}/mcp-servers/{server}
Jei nustatymo ekrane prašoma atskirų laukų, naudokite tas pačias reikšmes iš to URL:
Snowflake pagrindinio kompiuterio prefiksas.
Duomenų bazė.
Schema.
MCP serverio pavadinimas.
Sukurkite ir paskelbkite programos juodraštį
Išsaugokite Snowflake šablono nustatymą ChatGPT.
Sukurkite programos juodraštį.
Peržiūrėkite programos juodraščio informaciją, autentifikavimo nustatymus ir galimus veiksmus.
Kai būsite pasirengę, paskelbkite programos juodraštį.
Patvirtinkite, kad programa rodoma skiltyje Darbo erdvės nustatymai > Programos > Įgalinta.
Sukonfigūruokite Naudotojų prieigą vaidmenims, kurie turėtų ją naudoti.
Peržiūrėkite atskleistų įrankių Veiksmų valdymą.
Peržiūrėkite Programos leidimus, kad pasirinktumėte, kada ChatGPT prašo narių leidimo prieš naudodama programą.
Šie programos leidimai taikomi ChatGPT pokalbiams. Darbo erdvės agentai naudoja konkretaus agento valdiklius, kuriuos nustato agento kūrėjas, kad nustatytų, kokie programos veiksmai pasiekiami ir kada galutinių naudotojų prašoma juos patvirtinti. Apie agentų veikimą žr.: ChatGPT darbo erdvės agentai Enterprise ir Business planams.
Išbandykite programą
Pradėkite prisijungimo eigą iš ChatGPT kaip leidžiamas bandomasis naudotojas.
Prisijunkite prie Snowflake ir, jei prašoma, pasirinkite numatytą vaidmenį.
Patvirtinkite, kad ChatGPT aptinka numatytus įrankius iš MCP serverio.
Pirmiausia atlikite mažos rizikos skaitymo veiksmą, pvz., paiešką arba tik skaitymo užklausą patvirtintuose duomenyse.
Patvirtinkite, kad Snowflake leidimai neleidžia prieigos už patvirtinto vaidmens ir objektų ribų.
MCP serverio URL ir OAuth veikimas
ChatGPT jungiasi prie viso Snowflake valdomo MCP serverio URL. ChatGPT naudoja Snowflake pagrindinio kompiuterio prefiksą iš to URL, kad nustatytų Snowflake OAuth prieigos taškus.
Neįklijuokite Snowsight URL, vien tik Snowflake paskyros šakninio URL ar bet kokio URL su papildomais kelio segmentais. MCP URL turi apimti duomenų bazės, schemos ir MCP serverio kelią ir tiksliai atitikti jūsų Snowflake objektus.
Trikčių šalinimas
MCP serveris nerastas: dar kartą patikrinkite visą MCP serverio URL arba atskirus pagrindinio kompiuterio prefikso, duomenų bazės, schemos ir serverio laukus.
ChatGPT nerodomi jokie įrankiai: patvirtinkite, kad MCP serverio specifikacijoje yra įrankių, o vaidmuo turi USAGE teisę MCP serveryje.
Įrankis rodomas, bet naudojant neveikia: patvirtinkite, kad vaidmuo turi tinkamą leidimą baziniam Snowflake objektui.
SQL įrankis neveikia: patvirtinkite, kad sandėlio pavadinimas teisingas, sandėlis pasiekiamas, vaidmuo turi USAGE teisę jam, o read_only yra true, jei ketinote suteikti tik skaitymo prieigą.
Autorizuoti nepavyksta: patvirtinkite, kad naudotojas gali prisijungti prie Snowflake ir naudoti numatytą vaidmenį.
Pagrindinio kompiuterio pavadinimo ryšio problema: naudokite tinkamą Snowflake pagrindinio kompiuterio prefiksą. Snowflake pagrindinių kompiuterių pavadinimai su apatiniais brūkšniais gali kelti problemų; geriau naudokite brūkšnelius.