OpenAI
Šo lapu tulkoja mašīntulks. Skatīt oriģinālo rakstu angļu valodā.

Snowflake lietotnes veidnes iestatīšana ChatGPT

Uzziniet, kā darbvietas administratori var konfigurēt Snowflake lietotnes veidni ChatGPT, izmantojot Snowflake pārvaldītu MCP serveri.

Atjaunināts: 6 days ago

Izmantojiet šo ceļvedi, ja esat ChatGPT darbvietas administrators un iestatāt Snowflake lietotnes veidni savai organizācijai. Veidne nav galīgā lietotne, ko izmanto dalībnieki. Tā ir iestatīšanas plūsma, kas pēc nepieciešamās Snowflake konfigurācijas norādīšanas izveido darbvietai specifisku lietotnes melnrakstu.

Snowflake gadījumā lielākā daļa iestatīšanas notiek Snowflake vidē. Jūs izveidojat Snowflake pārvaldītu MCP serveri, piešķirat pareizajai lomai piekļuvi MCP serverim un tā pamatā esošajiem objektiem, pēc tam ChatGPT veidnes iestatīšanas plūsmā ievadāt pārvaldītā MCP servera URL vai tā komponentu laukus. Kad ChatGPT izveido lietotnes melnrakstu, varat to publicēt un pārvaldīt tāpat kā citas darbvietas lietotnes.

Ko jūs iestatāt

Jūs izveidojat darbvietai specifisku Snowflake lietotni ChatGPT. Lietotne izveido savienojumu ar Snowflake pārvaldītu MCP serveri, kas definē:

  • Kuras darbības ChatGPT var izmantot — tās sauc par rīkiem.

  • Kuriem Snowflake datiem vai objektiem šie rīki var piekļūt.

  • Ar kuru Snowflake lomu lietotājiem jāautorizējas.

  • Kura Snowflake datubāze, shēma un MCP servera nosaukums identificē savienotāja galapunktu.

ChatGPT var atklāt un izmantot tikai tos rīkus, ko atklāj MCP serveris un atļauj Snowflake loma, ar kuru lietotājs autorizējas.

Pirms sākat

Jums ir nepieciešams:

  • ChatGPT darbvietas administratora vai īpašnieka piekļuve.

  • Snowflake piekļuve, kas ļauj izveidot MCP servera objektus un piešķirt atļaujas.

  • Snowflake datubāze un shēma, kurā atradīsies MCP serveris.

  • Lēmums par to, ko ChatGPT drīkstēs darīt, piemēram, Cortex Search, Cortex Analyst, tikai lasāms SQL vai konkrēta procedūra vai funkcija.

  • Minimālo privilēģiju Snowflake loma, ko lietotāji izmantos, autorizējot lietotni.

  • Snowflake konta resursdatora prefikss, tostarp jebkurš reģiona vai mākoņa sufikss.

Sagatavojamās vērtības

  • Snowflake resursdatora prefikss: viss, kas Snowflake konta URL atrodas pirms .snowflakecomputing.com.

  • Datubāze: datubāze, kurā atrodas MCP serveris.

  • Shēma: shēma, kurā atrodas MCP serveris.

  • MCP servera nosaukums: Snowflake MCP servera objekta nosaukums.

  • Pilns pārvaldītā MCP servera URL, ja ChatGPT iestatīšanas ekrānā tiek prasīts URL.

  • Snowflake loma: loma, kas lietotājiem jāizmanto, autorizējot lietotni.

  • Rīku saraksts: Snowflake objekti un darbības, ko vēlaties ļaut izmantot ChatGPT.

Izlemiet, ko ChatGPT var darīt

Izvēlieties tikai tās iespējas, kuras vēlaties atklāt. Biežākās opcijas ietver:

  • Meklēšanu ar Cortex Search, lai atrastu atbildes indeksētos Snowflake datos vai saturā.

  • Jautājumus un atbildes ar Cortex Analyst, izmantojot apstiprinātu semantisko skatu.

  • Tikai lasāmu SQL kontrolētai vaicājumu piekļuvei.

  • Snowflake aģentu, glabātu procedūru vai UDF konkrētām darbplūsmām.

Ja iespējojat SQL, atstājiet to tikai lasāmu, ja vien jūsu organizācija nav pārskatījusi un apstiprinājusi rakstīšanas piekļuvi.

Izveidojiet Snowflake MCP serveri

Snowflake pierakstieties ar lomu, kas var izveidot MCP serveri un piešķirt piekļuvi. Atveriet darblapu datubāzē un shēmā, kur jāizveido MCP serveris.

Izveidojiet MCP serveri, kurā uzskaitīti tikai tie rīki, kas ChatGPT jāizmanto. Aizstājiet objektu nosaukumus ar savas Snowflake datubāzes, shēmas, pakalpojumu, skatu, noliktavas un servera nosaukumiem.

Piemērs:

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

Rīku nosaukumiem jābūt stabiliem un aprakstošiem, lai ChatGPT varētu izvēlēties pareizo rīku. MCP servera izveide automātiski nepiešķir piekļuvi pamatā esošajiem Snowflake objektiem.

Piešķiriet pareizās Snowflake atļaujas

Izvēlieties Snowflake lomu, ar kuru lietotāji autorizēsies, pēc tam piešķiriet šai lomai piekļuvi datubāzei, shēmai, MCP serverim un katram pamatā esošajam objektam, ko izmanto rīki.

Piemērs:

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;

Ja MCP serveris atklāj semantisko skatu, UDF, glabātu procedūru vai Cortex Agent, piešķiriet nepieciešamās atļaujas arī šiem objektiem.

Pārbaudiet, vai Snowflake ir gatavs

Palaidiet:

SHOW MCP SERVERS IN SCHEMA CHATGPT_APPS.TOOLS;

Pēc tam palaidiet:

DESCRIBE MCP SERVER CHATGPT_APPS.TOOLS.CHATGPT_SNOWFLAKE_MCP;

Apstipriniet:

  • Serveris pastāv paredzētajā datubāzē un shēmā.

  • Rīku saraksts atbilst jūsu iecerei.

  • Katrs rīka identifikators norāda uz pareizo Snowflake objektu.

  • Savienojošajai lomai ir USAGE piekļuve MCP serverim.

  • Savienojošajai lomai ir nepieciešamās atļaujas katram pamatā esošajam objektam.

Sāciet veidnes iestatīšanu ChatGPT

  1. ChatGPT pārslēdzieties uz darbvietu, kurā lietotnei jābūt pieejamai.

  2. Atveriet Darbvietas iestatījumi > Lietotnes.

  3. Atlasiet Direktorijs.

  4. Meklējiet Snowflake.

  5. Atlasiet Snowflake lietotnes veidni un sāciet iestatīšanu.

  6. Ievadiet skaidru lietotnes nosaukumu un aprakstu, piemēram, Snowflake vai Snowflake - Analytics.

  7. Ievadiet pārvaldītā MCP servera informāciju, ko pieprasa iestatīšanas plūsma.

Ja iestatīšanas ekrānā tiek prasīts pilns pārvaldītā MCP servera URL, izmantojiet šo formātu:

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

Ja iestatīšanas ekrānā tiek prasīti atsevišķi lauki, izmantojiet tās pašas vērtības no šī URL:

  • Snowflake resursdatora prefikss.

  • Datubāze.

  • Shēma.

  • MCP servera nosaukums.

Izveidojiet un publicējiet lietotnes melnrakstu

  1. Saglabājiet Snowflake veidnes iestatījumus ChatGPT.

  2. Izveidojiet lietotnes melnrakstu.

  3. Pārskatiet lietotnes melnraksta informāciju, autentifikācijas iestatījumus un pieejamās darbības.

  4. Publicējiet lietotnes melnrakstu, kad tas ir gatavs.

  5. Apstipriniet, ka lietotne parādās sadaļā Darbvietas iestatījumi > Lietotnes > Iespējots.

  6. Konfigurējiet Lietotāju piekļuve lomām, kurām tā jāizmanto.

  7. Pārskatiet atklāto rīku sadaļu Darbību kontrole.

  8. Pārskatiet Lietotnes atļaujas, lai izvēlētos, kad ChatGPT jautā dalībniekiem pirms lietotnes izmantošanas.

Šīs lietotnes atļaujas attiecas uz ChatGPT sarunām. Darbvietas aģenti izmanto katram aģentam noteiktas vadīklas, ko iestata aģenta veidotājs, lai noteiktu, kuras lietotnes darbības ir pieejamas un kad galalietotājiem tiek lūgts tās apstiprināt. Par aģentu darbību skatiet: ChatGPT darbvietas aģenti Enterprise un Business versijai.

Testējiet lietotni

  1. Sāciet savienošanas plūsmu no ChatGPT kā atļauts testa lietotājs.

  2. Pierakstieties Snowflake un, ja tiek prasīts, atlasiet paredzēto lomu.

  3. Apstipriniet, ka ChatGPT atklāj gaidītos rīkus no MCP servera.

  4. Vispirms palaidiet zema riska lasīšanas darbību, piemēram, meklēšanu vai tikai lasāmu vaicājumu apstiprinātajos datos.

  5. Apstipriniet, ka Snowflake atļaujas neļauj piekļūt ārpus apstiprinātās lomas un objektiem.

MCP servera URL un OAuth darbība

ChatGPT izveido savienojumu ar pilno Snowflake pārvaldītā MCP servera URL. ChatGPT izmanto Snowflake resursdatora prefiksu no šī URL, lai atrisinātu Snowflake OAuth galapunktus.

Neielīmējiet Snowsight URL, tikai Snowflake konta saknes URL vai jebkuru URL ar papildu ceļa segmentiem. MCP URL ir jāiekļauj datubāze, shēma un MCP servera ceļš, un tam precīzi jāatbilst jūsu Snowflake objektiem.

Problēmu novēršana

  • MCP serveris nav atrasts: vēlreiz pārbaudiet pilno MCP servera URL vai atsevišķos resursdatora prefiksa, datubāzes, shēmas un servera laukus.

  • ChatGPT neparādās neviens rīks: apstipriniet, ka MCP servera specifikācijā ir iekļauti rīki un lomai ir USAGE piekļuve MCP serverim.

  • Rīks parādās, bet lietošanas laikā neizdodas: apstipriniet, ka lomai ir pareizā atļauja pamatā esošajam Snowflake objektam.

  • SQL rīks neizdodas: apstipriniet, ka noliktavas nosaukums ir pareizs, noliktava ir pieejama, lomai ir USAGE piekļuve tai un read_only ir true, ja paredzējāt tikai lasāmu piekļuvi.

  • Autorizācija neizdodas: apstipriniet, ka lietotājs var pierakstīties Snowflake un izmantot paredzēto lomu.

  • Resursdatora nosaukuma savienojuma problēma: izmantojiet pareizo Snowflake resursdatora prefiksu. Snowflake resursdatoru nosaukumi ar pasvītrām var radīt problēmas; dodiet priekšroku defisēm.

Vai šis raksts bija noderīgs?