Kasutage seda juhendit, kui olete ChatGPT tööjaama administraator ja seadistate oma organisatsiooni jaoks Snowflake’i rakenduse malli. Mall ei ole lõplik rakendus, mida liikmed kasutavad. See on seadistusvoog, mis loob pärast nõutava Snowflake’i konfiguratsiooni sisestamist tööjaamapõhise mustandrakenduse.
Snowflake’i puhul toimub suurem osa seadistusest Snowflake’is. Loote Snowflake’i hallatava MCP-serveri, annate õigele rollile juurdepääsu MCP-serverile ja selle alusobjektidele ning sisestate seejärel hallatava MCP-serveri URL-i või selle komponendiväljad ChatGPT malli seadistusvoogu. Kui ChatGPT on mustandrakenduse loonud, saate selle avaldada ja hallata seda nagu teisi tööjaama rakendusi.
Mida te seadistate
Loote ChatGPT-s tööjaamapõhise Snowflake’i rakenduse. Rakendus ühendub Snowflake’i hallatava MCP-serveriga, mis määrab:
Milliseid toiminguid ChatGPT saab kasutada; neid nimetatakse tööriistadeks.
Millistele Snowflake’i andmetele või objektidele need tööriistad juurde pääsevad.
Millise Snowflake’i rolliga kasutajad peaksid autoriseerima.
Millised Snowflake’i andmebaas, skeem ja MCP-serveri nimi tuvastavad konnektori lõpp-punkti.
ChatGPT saab avastada ja kasutada ainult neid tööriistu, mille MCP-server avaldab ja mida lubab Snowflake’i roll, millega kasutaja autoriseerib.
Enne alustamist
Vajate järgmist.
ChatGPT tööjaama administraatori või omaniku juurdepääs.
Snowflake’i juurdepääs, millega saab luua MCP-serveri objekte ja anda õigusi.
Snowflake’i andmebaas ja skeem, kus MCP-server asuma hakkab.
Otsus selle kohta, mida ChatGPT-l peaks olema lubatud teha, näiteks Cortex Search, Cortex Analyst, kirjutuskaitstud SQL või konkreetne protseduur või funktsioon.
Vähimate õigustega Snowflake’i roll, mida kasutajad rakenduse autoriseerimisel kasutavad.
Snowflake’i konto hosti prefiks, sealhulgas piirkonna või pilve sufiks.
Ettevalmistatavad väärtused
Snowflake’i hosti prefiks: kõik, mis on Snowflake’i konto URL-is enne osa .snowflakecomputing.com.
Andmebaas: andmebaas, mis sisaldab MCP-serverit.
Skeem: skeem, mis sisaldab MCP-serverit.
MCP-serveri nimi: Snowflake’i MCP-serveri objekti nimi.
Täielik hallatava MCP-serveri URL, kui ChatGPT seadistuskuva küsib URL-i.
Snowflake’i roll: roll, mida kasutajad peaksid rakenduse autoriseerimisel kasutama.
Tööriistade loend: Snowflake’i objektid ja toimingud, mida soovite, et ChatGPT kasutaks.
Otsustage, mida ChatGPT saab teha
Valige ainult need võimalused, mida soovite avaldada. Levinud valikud on järgmised.
Otsing Cortex Searchiga, et leida vastuseid indekseeritud Snowflake’i andmetest või sisust.
Küsimused ja vastused Cortex Analystiga kinnitatud semantilise vaate kaudu.
Kirjutuskaitstud SQL kontrollitud päringujuurdepääsu jaoks.
Snowflake’i agent, salvestatud protseduur või UDF konkreetsete töövoogude jaoks.
Kui lubate SQL-i, hoidke see kirjutuskaitstuna, välja arvatud juhul, kui teie organisatsioon on kirjutusjuurdepääsu üle vaadanud ja heaks kiitnud.
Snowflake’i MCP-serveri loomine
Logige Snowflake’is sisse rolliga, millega saab luua MCP-serveri ja anda juurdepääsu. Avage tööleht andmebaasis ja skeemis, kuhu MCP-server tuleks luua.
Looge MCP-server, mis loetleb ainult need tööriistad, mida ChatGPT peaks kasutama. Asendage objektide nimed oma Snowflake’i andmebaasi, skeemi, teenuste, vaadete, lao ja serveri nimega.
Näide:
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" $$;
Tööriistade nimed peaksid olema stabiilsed ja kirjeldavad, et ChatGPT saaks valida õige tööriista. MCP-serveri loomine ei anna automaatselt juurdepääsu alusolevatele Snowflake’i objektidele.
Õigete Snowflake’i õiguste andmine
Valige Snowflake’i roll, millega kasutajad autoriseerivad, ja andke sellele rollile juurdepääs andmebaasile, skeemile, MCP-serverile ning igale alusobjektile, mida tööriistad kasutavad.
Näide:
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;
Kui MCP-server avaldab semantilise vaate, UDF-i, salvestatud protseduuri või Cortex Agenti, andke ka nende objektide jaoks vajalikud õigused.
Kontrollige, et Snowflake oleks valmis
Käivitage:
SHOW MCP SERVERS IN SCHEMA CHATGPT_APPS.TOOLS;
Seejärel käivitage:
DESCRIBE MCP SERVER CHATGPT_APPS.TOOLS.CHATGPT_SNOWFLAKE_MCP;
Kinnitage:
Server on oodatud andmebaasis ja skeemis olemas.
Tööriistade loend vastab teie kavatsusele.
Iga tööriista identifikaator osutab õigele Snowflake’i objektile.
Ühendaval rollil on MCP-serveris USAGE.
Ühendaval rollil on iga alusobjekti jaoks vajalikud õigused.
Malli seadistamise alustamine ChatGPT-s
Lülituge ChatGPT-s tööjaamale, kus rakendus peaks saadaval olema.
Avage Tööjaama seaded > Rakendused.
Valige Kataloog.
Otsige Snowflake’i.
Valige Snowflake’i rakenduse mall ja alustage seadistamist.
Sisestage selge rakenduse nimi ja kirjeldus, näiteks Snowflake või Snowflake - Analytics.
Sisestage seadistusvoos küsitud hallatava MCP-serveri üksikasjad.
Kui seadistuskuva küsib täielikku hallatava MCP-serveri URL-i, kasutage seda vormingut:
https://<snowflake_host_prefix>.snowflakecomputing.com/api/v2/databases/{database}/schemas/{schema}/mcp-servers/{server}
Kui seadistuskuva küsib eraldi välju, kasutage samast URL-ist samu väärtusi:
Snowflake’i hosti prefiks.
Andmebaas.
Skeem.
MCP-serveri nimi.
Mustandrakenduse loomine ja avaldamine
Salvestage Snowflake’i malli seadistus ChatGPT-s.
Looge mustandrakendus.
Vaadake üle mustandrakenduse üksikasjad, autentimisseaded ja saadaolevad toimingud.
Avaldage mustandrakendus, kui see on valmis.
Kinnitage, et rakendus kuvatakse jaotises Tööjaama seaded > Rakendused > Lubatud.
Konfigureerige Kasutaja juurdepääs rollide jaoks, mis peaksid seda kasutama.
Vaadake avaldatud tööriistade jaoks üle Toimingute juhtimine.
Vaadake üle Rakenduse õigused, et valida, millal ChatGPT küsib liikmetelt enne rakenduse kasutamist kinnitust.
Need rakenduse õigused kehtivad ChatGPT vestlustele. Tööjaamaagendid kasutavad iga agendi kohta eraldi juhtelemente, mille määrab agendi koostaja, et otsustada, millised rakenduse toimingud on saadaval ja millal lõppkasutajatelt nende kinnitamist küsitakse. Agendi käitumise kohta vt: ChatGPT tööjaamaagendid Enterprise’i ja Businessi jaoks.
Rakenduse testimine
Alustage ChatGPT-st ühendusvoogu lubatud testkasutajana.
Logige Snowflake’i sisse ja valige viiba korral kavandatud roll.
Kinnitage, et ChatGPT leiab MCP-serverist oodatud tööriistad.
Käivitage esmalt madala riskiga lugemistoiming, näiteks otsing või kirjutuskaitstud päring kinnitatud andmete vastu.
Kinnitage, et Snowflake’i õigused takistavad juurdepääsu väljaspool kinnitatud rolli ja objekte.
MCP-serveri URL ja OAutendi käitumine
ChatGPT ühendub täieliku Snowflake’i hallatava MCP-serveri URL-iga. ChatGPT kasutab sellest URL-ist Snowflake’i hosti prefiksit, et lahendada Snowflake’i OAutendi lõpp-punktid.
Ärge kleepige Snowsighti URL-i, Snowflake’i konto juur-URL-i eraldi ega ühtegi lisateelõikudega URL-i. MCP URL peab sisaldama andmebaasi, skeemi ja MCP-serveri teed ning vastama täpselt teie Snowflake’i objektidele.
Tõrkeotsing
MCP-serverit ei leitud: kontrollige uuesti täielikku MCP-serveri URL-i või eraldi hosti prefiksi, andmebaasi, skeemi ja serveri välju.
ChatGPT-s ei kuvata tööriistu: kinnitage, et MCP-serveri spetsifikatsioon sisaldab tööriistu ja rollil on MCP-serveris USAGE.
Tööriist kuvatakse, kuid kasutamisel nurjub: kinnitage, et rollil on alusoleval Snowflake’i objektil õige õigus.
SQL-tööriist nurjub: kinnitage, et lao nimi on õige, ladu on saadaval, rollil on selle jaoks USAGE ja read_only on true, kui kavatsesite anda kirjutuskaitstud juurdepääsu.
Autoriseerimine nurjub: kinnitage, et kasutaja saab Snowflake’i sisse logida ja kasutada kavandatud rolli.
Hostinime ühenduse probleem: kasutage õiget Snowflake’i hosti prefiksit. Alakriipsudega Snowflake’i hostinimed võivad probleeme tekitada; eelistage sidekriipse.