Folosiți acest ghid dacă sunteți administrator al unui spațiu de lucru ChatGPT și configurați șablonul aplicației Snowflake pentru organizația dvs. Un șablon nu este aplicația finală pe care o folosesc membrii. Este un flux de configurare care creează o aplicație ciornă specifică spațiului de lucru după ce furnizați configurația Snowflake necesară.
Pentru Snowflake, cea mai mare parte a configurării are loc în Snowflake. Creați un server MCP gestionat de Snowflake, acordați rolului potrivit acces la serverul MCP și la obiectele sale subiacente, apoi introduceți URL-ul serverului MCP gestionat sau câmpurile sale componente în fluxul de configurare a șablonului ChatGPT. După ce ChatGPT creează aplicația ciornă, o puteți publica și gestiona ca pe alte aplicații ale spațiului de lucru.
Ce configurați
Creați o aplicație Snowflake specifică spațiului de lucru în ChatGPT. Aplicația se conectează la un server MCP gestionat de Snowflake care definește:
Ce acțiuni poate folosi ChatGPT, numite instrumente.
Ce date sau obiecte Snowflake pot accesa acele instrumente.
Cu ce rol Snowflake ar trebui să se autorizeze utilizatorii.
Ce bază de date, schemă și nume de server MCP Snowflake identifică punctul final al conectorului.
ChatGPT poate descoperi și folosi doar instrumentele expuse de serverul MCP și permise de rolul Snowflake cu care se autorizează utilizatorul.
Înainte de a începe
Aveți nevoie de:
Acces de administrator sau proprietar al spațiului de lucru ChatGPT.
Acces Snowflake care poate crea obiecte de server MCP și acorda permisiuni.
Baza de date și schema Snowflake în care va exista serverul MCP.
O decizie privind ce ar trebui să i se permită ChatGPT să facă, cum ar fi Cortex Search, Cortex Analyst, SQL doar în citire sau o procedură ori funcție specifică.
Un rol Snowflake cu privilegii minime pe care utilizatorii îl vor folosi la autorizarea aplicației.
Prefixul gazdei contului Snowflake, inclusiv orice sufix de regiune sau cloud.
Valori de pregătit
Prefixul gazdei Snowflake: tot ce apare înainte de .snowflakecomputing.com în URL-ul contului Snowflake.
Bază de date: baza de date care conține serverul MCP.
Schemă: schema care conține serverul MCP.
Numele serverului MCP: numele obiectului serverului MCP Snowflake.
URL-ul complet al serverului MCP gestionat, dacă ecranul de configurare ChatGPT solicită un URL.
Rol Snowflake: rolul pe care utilizatorii ar trebui să îl folosească la autorizarea aplicației.
Lista de instrumente: obiectele și acțiunile Snowflake pe care doriți să le folosească ChatGPT.
Decideți ce poate face ChatGPT
Alegeți doar capacitățile pe care doriți să le expuneți. Opțiunile comune includ:
Căutare cu Cortex Search pentru a găsi răspunsuri în date sau conținut Snowflake indexate.
Întrebări și răspunsuri cu Cortex Analyst printr-o vizualizare semantică aprobată.
SQL doar în citire pentru acces controlat la interogări.
Un agent Snowflake, o procedură stocată sau un UDF pentru fluxuri de lucru specifice.
Dacă activați SQL, păstrați-l doar în citire, cu excepția cazului în care organizația dvs. a revizuit și aprobat accesul la scriere.
Creați serverul MCP Snowflake
În Snowflake, conectați-vă cu un rol care poate crea serverul MCP și acorda acces. Deschideți o foaie de lucru în baza de date și schema în care ar trebui creat serverul MCP.
Creați un server MCP care listează doar instrumentele pe care ar trebui să le folosească ChatGPT. Înlocuiți numele obiectelor cu propria bază de date, schemă, servicii, vizualizări, depozit și nume de server Snowflake.
Exemplu:
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" $$;
Numele instrumentelor ar trebui să fie stabile și descriptive, astfel încât ChatGPT să poată alege instrumentul potrivit. Crearea serverului MCP nu acordă automat acces la obiectele Snowflake subiacente.
Acordați permisiunile Snowflake potrivite
Alegeți rolul Snowflake cu care utilizatorii se vor autoriza, apoi acordați acelui rol acces la baza de date, schemă, serverul MCP și fiecare obiect subiacent folosit de instrumente.
Exemplu:
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;
Dacă serverul MCP expune o vizualizare semantică, un UDF, o procedură stocată sau un agent Cortex, acordați și permisiunile necesare pentru acele obiecte.
Verificați dacă Snowflake este gata
Rulați:
SHOW MCP SERVERS IN SCHEMA CHATGPT_APPS.TOOLS;
Apoi rulați:
DESCRIBE MCP SERVER CHATGPT_APPS.TOOLS.CHATGPT_SNOWFLAKE_MCP;
Confirmați:
Serverul există în baza de date și schema așteptate.
Lista de instrumente este cea intenționată.
Fiecare identificator de instrument indică obiectul Snowflake potrivit.
Rolul de conectare are USAGE pe serverul MCP.
Rolul de conectare are permisiunile necesare pentru fiecare obiect subiacent.
Începeți configurarea șablonului în ChatGPT
În ChatGPT, comutați la spațiul de lucru în care aplicația ar trebui să fie disponibilă.
Deschideți Setările spațiului de lucru > Aplicații.
Selectați Director.
Căutați Snowflake.
Selectați șablonul aplicației Snowflake și începeți configurarea.
Introduceți un nume și o descriere clare pentru aplicație, cum ar fi Snowflake sau Snowflake - Analytics.
Introduceți detaliile serverului MCP gestionat solicitate de fluxul de configurare.
Dacă ecranul de configurare solicită URL-ul complet al serverului MCP gestionat, folosiți acest format:
https://<snowflake_host_prefix>.snowflakecomputing.com/api/v2/databases/{database}/schemas/{schema}/mcp-servers/{server}
Dacă ecranul de configurare solicită câmpuri separate, folosiți aceleași valori din acel URL:
Prefixul gazdei Snowflake.
Bază de date.
Schemă.
Numele serverului MCP.
Creați și publicați aplicația ciornă
Salvați configurarea șablonului Snowflake în ChatGPT.
Creați aplicația ciornă.
Revizuiți detaliile aplicației ciornă, setările de autentificare și acțiunile disponibile.
Publicați aplicația ciornă când este gata.
Confirmați că aplicația apare în Setările spațiului de lucru > Aplicații > Activate.
Configurați Accesul utilizatorilor pentru rolurile care ar trebui să o folosească.
Revizuiți Controlul acțiunilor pentru instrumentele expuse.
Revizuiți Permisiunile aplicației pentru a alege când ChatGPT le cere membrilor înainte de a folosi aplicația.
Aceste permisiuni ale aplicației se aplică conversațiilor ChatGPT. Agenții spațiului de lucru folosesc controale per agent setate de creatorul agentului pentru a determina ce acțiuni ale aplicației sunt disponibile și când li se cere utilizatorilor finali să le aprobe. Pentru comportamentul agenților, consultați: Agenții spațiului de lucru ChatGPT pentru Enterprise și Business.
Testați aplicația
Porniți fluxul de conectare din ChatGPT ca utilizator de test permis.
Conectați-vă la Snowflake și selectați rolul dorit dacă vi se solicită.
Confirmați că ChatGPT descoperă instrumentele așteptate de la serverul MCP.
Rulați mai întâi o acțiune de citire cu risc scăzut, cum ar fi o căutare sau o interogare doar în citire asupra datelor aprobate.
Confirmați că permisiunile Snowflake previn accesul în afara rolului și obiectelor aprobate.
URL-ul serverului MCP și comportamentul OAuth
ChatGPT se conectează la URL-ul complet al serverului MCP gestionat de Snowflake. ChatGPT folosește prefixul gazdei Snowflake din acel URL pentru a rezolva punctele finale OAuth Snowflake.
Nu lipiți un URL Snowsight, URL-ul rădăcină al contului Snowflake ca atare sau orice URL cu segmente de cale suplimentare. URL-ul MCP trebuie să includă baza de date, schema și calea serverului MCP și trebuie să corespundă exact obiectelor dvs. Snowflake.
Depanare
Server MCP negăsit: verificați din nou URL-ul complet al serverului MCP sau câmpurile separate pentru prefixul gazdei, baza de date, schemă și server.
Nu apar instrumente în ChatGPT: confirmați că specificația serverului MCP include instrumente și că rolul are USAGE pe serverul MCP.
Un instrument apare, dar eșuează când este folosit: confirmați că rolul are permisiunea potrivită pe obiectul Snowflake subiacent.
Instrumentul SQL eșuează: confirmați că numele depozitului este corect, depozitul este disponibil, rolul are USAGE pe acesta și read_only este true dacă ați intenționat acces doar în citire.
Autorizarea eșuează: confirmați că utilizatorul se poate conecta la Snowflake și poate folosi rolul dorit.
Problemă de conexiune la numele gazdei: folosiți prefixul corect al gazdei Snowflake. Numele de gazdă Snowflake cu caractere de subliniere pot cauza probleme; preferați cratimele.