Käytä tätä opasta, jos olet ChatGPT-työtilan ylläpitäjä ja otat Snowflake-sovellusmallia käyttöön organisaatiollesi. Malli ei ole jäsenten käyttämä lopullinen sovellus. Se on määrityskulku, joka luo työtilakohtaisen sovellusluonnoksen, kun olet antanut tarvittavat Snowflake-määritykset.
Snowflakessa suurin osa määrityksistä tehdään Snowflakessa. Luo Snowflaken hallinnoima MCP-palvelin, myönnä oikealle roolille pääsy MCP-palvelimeen ja sen taustalla oleviin objekteihin ja syötä sitten hallinnoidun MCP-palvelimen URL-osoite tai sen osakentät ChatGPT-mallin määrityskulussa. Kun ChatGPT on luonut sovellusluonnoksen, voit julkaista sen ja hallita sitä kuten muita työtilan sovelluksia.
Mitä olet määrittämässä
Olet luomassa työtilakohtaista Snowflake-sovellusta ChatGPT:ssä. Sovellus muodostaa yhteyden Snowflaken hallinnoimaan MCP-palvelimeen, joka määrittää:
Mitä toimintoja ChatGPT voi käyttää; niitä kutsutaan työkaluiksi.
Mihin Snowflake-tietoihin tai -objekteihin nämä työkalut voivat päästä.
Millä Snowflake-roolilla käyttäjien tulee valtuuttaa käyttö.
Mikä Snowflake-tietokanta, skeema ja MCP-palvelimen nimi yksilöivät yhdistimen endpointin.
ChatGPT voi löytää ja käyttää vain työkaluja, jotka MCP-palvelin tuo saataville ja jotka käyttäjän valtuuttama Snowflake-rooli sallii.
Ennen kuin aloitat
Tarvitset:
ChatGPT-työtilan ylläpitäjän tai omistajan käyttöoikeudet.
Snowflake-käyttöoikeudet, joilla voi luoda MCP-palvelinobjekteja ja myöntää käyttöoikeuksia.
Snowflake-tietokanta ja -skeema, joihin MCP-palvelin sijoitetaan.
Päätöksen siitä, mitä ChatGPT:n tulee voida tehdä, kuten Cortex Search, Cortex Analyst, vain luku -SQL tai tietty proseduuri tai funktio.
Vähimpien oikeuksien Snowflake-rooli, jota käyttäjät käyttävät sovelluksen valtuuttamiseen.
Snowflake-tilin isäntäprefiksi, mukaan lukien mahdollinen alue- tai pilvipääte.
Valmisteltavat arvot
Snowflake-isäntäprefiksi: kaikki ennen merkkijonoa .snowflakecomputing.com Snowflake-tilin URL-osoitteessa.
Tietokanta: tietokanta, joka sisältää MCP-palvelimen.
Skeema: skeema, joka sisältää MCP-palvelimen.
MCP-palvelimen nimi: Snowflake MCP -palvelinobjektin nimi.
Täysi hallinnoidun MCP-palvelimen URL-osoite, jos ChatGPT:n määritysnäyttö pyytää URL-osoitetta.
Snowflake-rooli: rooli, jota käyttäjien tulee käyttää sovelluksen valtuuttamiseen.
Työkaluluettelo: Snowflake-objektit ja -toiminnot, joita haluat ChatGPT:n käyttävän.
Päätä, mitä ChatGPT voi tehdä
Valitse vain ominaisuudet, jotka haluat tuoda saataville. Yleisiä vaihtoehtoja ovat:
Haku Cortex Searchilla vastausten löytämiseksi indeksoiduista Snowflake-tiedoista tai -sisällöstä.
Kysymykset ja vastaukset Cortex Analystilla hyväksytyn semanttisen näkymän kautta.
Vain luku -SQL hallittua kyselykäyttöä varten.
Snowflake Agent, tallennettu proseduuri tai UDF tiettyihin työnkulkuihin.
Jos otat SQL:n käyttöön, pidä se vain luku -tilassa, ellei organisaatiosi ole tarkistanut ja hyväksynyt kirjoitusoikeutta.
Luo Snowflake MCP -palvelin
Kirjaudu Snowflakeen roolilla, joka voi luoda MCP-palvelimen ja myöntää käyttöoikeuksia. Avaa laskentataulukko tietokannassa ja skeemassa, joihin MCP-palvelin tulee luoda.
Luo MCP-palvelin, joka luettelee vain työkalut, joita ChatGPT:n tulee käyttää. Korvaa objektien nimet omilla Snowflake-tietokannan, skeeman, palvelujen, näkymien, varaston ja palvelimen nimillä.
Esimerkki:
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" $$;
Työkalujen nimien tulisi olla vakaita ja kuvaavia, jotta ChatGPT voi valita oikean työkalun. MCP-palvelimen luominen ei myönnä automaattisesti pääsyä taustalla oleviin Snowflake-objekteihin.
Myönnä oikeat Snowflake-käyttöoikeudet
Valitse Snowflake-rooli, jolla käyttäjät valtuuttavat käytön, ja myönnä sitten roolille pääsy tietokantaan, skeemaan, MCP-palvelimeen ja jokaiseen työkalujen käyttämään taustalla olevaan objektiin.
Esimerkki:
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;
Jos MCP-palvelin tuo saataville semanttisen näkymän, UDF:n, tallennetun proseduurin tai Cortex Agentin, myönnä tarvittavat käyttöoikeudet myös näille objekteille.
Varmista, että Snowflake on valmis
Suorita:
SHOW MCP SERVERS IN SCHEMA CHATGPT_APPS.TOOLS;
Suorita sitten:
DESCRIBE MCP SERVER CHATGPT_APPS.TOOLS.CHATGPT_SNOWFLAKE_MCP;
Varmista:
Palvelin on odotetussa tietokannassa ja skeemassa.
Työkaluluettelo on haluamasi.
Jokainen työkalun tunniste osoittaa oikeaan Snowflake-objektiin.
Yhdistävällä roolilla on USAGE-oikeus MCP-palvelimeen.
Yhdistävällä roolilla on tarvittavat käyttöoikeudet jokaiseen taustalla olevaan objektiin.
Aloita mallin määritys ChatGPT:ssä
Vaihda ChatGPT:ssä työtilaan, jossa sovelluksen tulee olla saatavilla.
Avaa Työtilan asetukset > Sovellukset.
Valitse Hakemisto.
Etsi Snowflake.
Valitse Snowflake-sovellusmalli ja aloita määritys.
Anna selkeä sovelluksen nimi ja kuvaus, kuten Snowflake tai Snowflake – Analytiikka.
Anna määrityskulun pyytämät hallinnoidun MCP-palvelimen tiedot.
Jos määritysnäyttö pyytää hallinnoidun MCP-palvelimen täyttä URL-osoitetta, käytä tätä muotoa:
https://<snowflake_host_prefix>.snowflakecomputing.com/api/v2/databases/{database}/schemas/{schema}/mcp-servers/{server}
Jos määritysnäyttö pyytää erillisiä kenttiä, käytä samoja arvoja kyseisestä URL-osoitteesta:
Snowflake-isäntäprefiksi.
Tietokanta.
Skeema.
MCP-palvelimen nimi.
Luo ja julkaise sovellusluonnos
Tallenna Snowflake-mallin määritys ChatGPT:ssä.
Luo sovellusluonnos.
Tarkista sovellusluonnoksen tiedot, todennusasetukset ja käytettävissä olevat toiminnot.
Julkaise sovellusluonnos, kun se on valmis.
Varmista, että sovellus näkyy kohdassa Työtilan asetukset > Sovellukset > Käytössä.
Määritä Käyttäjien käyttöoikeus rooleille, joiden tulee käyttää sitä.
Tarkista saataville tuotujen työkalujen Toimintojen hallinta.
Valitse Sovelluksen käyttöoikeudet -kohdassa, milloin ChatGPT pyytää jäseniltä vahvistusta ennen sovelluksen käyttöä.
Nämä sovelluksen käyttöoikeudet koskevat ChatGPT-keskusteluja. Työtilan agentit käyttävät agenttikohtaisia hallintatoimintoja, jotka agentin rakentaja määrittää sen perusteella, mitkä sovellustoiminnot ovat käytettävissä ja milloin loppukäyttäjiä pyydetään hyväksymään ne. Lisätietoja agentin toiminnasta: ChatGPT Workspace Agents Enterprise- ja Business-palveluille.
Testaa sovellus
Aloita yhdistämiskulku ChatGPT:stä sallittuna testikäyttäjänä.
Kirjaudu Snowflakeen ja valitse tarkoitettu rooli, jos sitä pyydetään.
Varmista, että ChatGPT löytää odotetut työkalut MCP-palvelimelta.
Suorita ensin vähäriskinen lukutoiminto, kuten haku tai vain luku -kysely hyväksyttyihin tietoihin.
Varmista, että Snowflake-käyttöoikeudet estävät pääsyn hyväksytyn roolin ja objektien ulkopuolelle.
MCP-palvelimen URL-osoite ja OAuth-toiminta
ChatGPT muodostaa yhteyden täyteen Snowflaken hallinnoiman MCP-palvelimen URL-osoitteeseen. ChatGPT käyttää kyseisen URL-osoitteen Snowflake-isäntäprefiksiä Snowflake OAuth -endpointien selvittämiseen.
Älä liitä Snowsight-URL-osoitetta, Snowflake-tilin juuren URL-osoitetta sellaisenaan tai mitään URL-osoitetta, jossa on ylimääräisiä polkusegmenttejä. MCP-URL-osoitteessa on oltava tietokannan, skeeman ja MCP-palvelimen polku, ja sen on vastattava Snowflake-objektejasi tarkasti.
Vianmääritys
MCP-palvelinta ei löydy: tarkista uudelleen koko MCP-palvelimen URL-osoite tai erilliset isäntäprefiksin, tietokannan, skeeman ja palvelimen kentät.
Työkaluja ei näy ChatGPT:ssä: varmista, että MCP-palvelimen määritys sisältää työkaluja ja että roolilla on USAGE-oikeus MCP-palvelimeen.
Työkalu näkyy, mutta sen käyttö epäonnistuu: varmista, että roolilla on oikea käyttöoikeus taustalla olevaan Snowflake-objektiin.
SQL-työkalu epäonnistuu: varmista, että varaston nimi on oikea, varasto on käytettävissä, roolilla on siihen USAGE-oikeus ja read_only on true, jos tarkoitit vain luku -käyttöoikeutta.
Valtuutus epäonnistuu: varmista, että käyttäjä voi kirjautua Snowflakeen ja käyttää tarkoitettua roolia.
Isäntänimen yhteysongelma: käytä oikeaa Snowflake-isäntäprefiksiä. Alaviivoja sisältävät Snowflake-isäntänimet voivat aiheuttaa ongelmia; suosi yhdysmerkkejä.