Feu servir aquesta guia si sou administrador d’un espai de treball de ChatGPT i configureu la plantilla d’aplicació Snowflake per a la vostra organització. Una plantilla no és l’aplicació final que fan servir els membres. És un flux de configuració que crea un esborrany d’aplicació específic de l’espai de treball després que proporcioneu la configuració de Snowflake necessària.
En el cas de Snowflake, la major part de la configuració es fa a Snowflake. Creeu un servidor MCP gestionat per Snowflake, concediu al rol adequat accés al servidor MCP i als objectes subjacents, i després introduïu l’URL del servidor MCP gestionat o els seus camps de components al flux de configuració de la plantilla de ChatGPT. Després que ChatGPT creï l’esborrany de l’aplicació, podeu publicar-la i gestionar-la com altres aplicacions de l’espai de treball.
Què esteu configurant
Esteu creant una aplicació Snowflake específica de l’espai de treball a ChatGPT. L’aplicació es connecta a un servidor MCP gestionat per Snowflake que defineix:
Quines accions pot fer servir ChatGPT, anomenades eines.
A quines dades o objectes de Snowflake poden accedir aquestes eines.
Amb quin rol de Snowflake s’han d’autoritzar els usuaris.
Quina base de dades, esquema i nom de servidor MCP de Snowflake identifiquen el punt final del connector.
ChatGPT només pot descobrir i fer servir les eines exposades pel servidor MCP i permeses pel rol de Snowflake amb què s’autoritza l’usuari.
Abans de començar
Necessiteu:
Accés d’administrador o propietari de l’espai de treball de ChatGPT.
Accés a Snowflake que pugui crear objectes de servidor MCP i concedir permisos.
La base de dades i l’esquema de Snowflake on residirà el servidor MCP.
Una decisió sobre què s’ha de permetre fer a ChatGPT, com ara Cortex Search, Cortex Analyst, SQL només de lectura o un procediment o una funció específics.
Un rol de Snowflake amb privilegis mínims que els usuaris faran servir en autoritzar l’aplicació.
El prefix de host del compte de Snowflake, inclòs qualsevol sufix de regió o núvol.
Valors que cal preparar
Prefix de host de Snowflake: tot el que hi ha abans de .snowflakecomputing.com a l’URL del compte de Snowflake.
Base de dades: la base de dades que conté el servidor MCP.
Esquema: l’esquema que conté el servidor MCP.
Nom del servidor MCP: el nom de l’objecte de servidor MCP de Snowflake.
URL completa del servidor MCP gestionat, si la pantalla de configuració de ChatGPT demana un URL.
Rol de Snowflake: el rol que els usuaris han de fer servir en autoritzar l’aplicació.
Llista d’eines: els objectes i les accions de Snowflake que voleu que ChatGPT faci servir.
Decidiu què pot fer ChatGPT
Trieu només les capacitats que voleu exposar. Les opcions habituals inclouen:
Cerca amb Cortex Search per trobar respostes en dades o contingut indexats de Snowflake.
Preguntes i respostes amb Cortex Analyst mitjançant una vista semàntica aprovada.
SQL només de lectura per a l’accés controlat a consultes.
Un Agent de Snowflake, un procediment emmagatzemat o una UDF per a fluxos de treball específics.
Si activeu SQL, manteniu-lo només de lectura tret que la vostra organització hagi revisat i aprovat l’accés d’escriptura.
Crear el servidor MCP de Snowflake
A Snowflake, inicieu la sessió amb un rol que pugui crear el servidor MCP i concedir-hi accés. Obriu un full de treball a la base de dades i l’esquema on s’ha de crear el servidor MCP.
Creeu un servidor MCP que enumeri només les eines que ChatGPT ha de fer servir. Substituïu els noms d’objecte pels de la vostra base de dades, esquema, serveis, vistes, magatzem i nom de servidor de Snowflake.
Exemple:
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" $$;
Els noms de les eines han de ser estables i descriptius perquè ChatGPT pugui triar l’eina adequada. Crear el servidor MCP no concedeix accés automàticament als objectes subjacents de Snowflake.
Concedir els permisos adequats de Snowflake
Trieu el rol de Snowflake amb què s’autoritzaran els usuaris i, després, concediu a aquest rol accés a la base de dades, l’esquema, el servidor MCP i tots els objectes subjacents que facin servir les eines.
Exemple:
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;
Si el servidor MCP exposa una vista semàntica, una UDF, un procediment emmagatzemat o un Agent de Cortex, concediu també els permisos necessaris per a aquests objectes.
Verificar que Snowflake està a punt
Executeu:
SHOW MCP SERVERS IN SCHEMA CHATGPT_APPS.TOOLS;
Després executeu:
DESCRIBE MCP SERVER CHATGPT_APPS.TOOLS.CHATGPT_SNOWFLAKE_MCP;
Confirmeu:
El servidor existeix a la base de dades i l’esquema previstos.
La llista d’eines és la que volíeu.
Cada identificador d’eina apunta a l’objecte de Snowflake adequat.
El rol de connexió té USAGE al servidor MCP.
El rol de connexió té els permisos necessaris sobre cada objecte subjacent.
Iniciar la configuració de la plantilla a ChatGPT
A ChatGPT, canvieu a l’espai de treball on l’aplicació ha d’estar disponible.
Obriu Configuració de l’espai de treball > Aplicacions.
Seleccioneu Directori.
Cerqueu Snowflake.
Seleccioneu la plantilla d’aplicació Snowflake i inicieu la configuració.
Introduïu un nom i una descripció clars per a l’aplicació, com ara Snowflake o Snowflake - Analytics.
Introduïu els detalls del servidor MCP gestionat que demani el flux de configuració.
Si la pantalla de configuració demana l’URL completa del servidor MCP gestionat, feu servir aquest format:
https://<snowflake_host_prefix>.snowflakecomputing.com/api/v2/databases/{database}/schemas/{schema}/mcp-servers/{server}
Si la pantalla de configuració demana camps separats, feu servir els mateixos valors d’aquest URL:
Prefix de host de Snowflake.
Base de dades.
Esquema.
Nom del servidor MCP.
Crear i publicar l’esborrany de l’aplicació
Deseu la configuració de la plantilla Snowflake a ChatGPT.
Creeu l’esborrany de l’aplicació.
Reviseu els detalls de l’esborrany de l’aplicació, la configuració d’autenticació i les accions disponibles.
Publiqueu l’esborrany de l’aplicació quan estigui a punt.
Confirmeu que l’aplicació apareix a Configuració de l’espai de treball > Aplicacions > Activades.
Configureu Accés d’usuari per als rols que l’han de fer servir.
Reviseu Control d’accions per a les eines exposades.
Reviseu Permisos de l’aplicació per triar quan ChatGPT demana als membres abans d’utilitzar l’aplicació.
Aquests permisos de l’aplicació s’apliquen a les converses de ChatGPT. Els Agents de l’espai de treball fan servir controls per agent definits pel creador de l’agent per determinar quines accions de l’aplicació estan disponibles i quan es demana als usuaris finals que les aprovin. Per al comportament dels agents, vegeu: Agents de l’espai de treball de ChatGPT per a Enterprise i Business.
Provar l’aplicació
Inicieu el flux de connexió des de ChatGPT com a usuari de prova permès.
Inicieu la sessió a Snowflake i seleccioneu el rol previst si se us demana.
Confirmeu que ChatGPT descobreix les eines esperades del servidor MCP.
Executeu primer una acció de lectura de baix risc, com ara una cerca o una consulta només de lectura sobre dades aprovades.
Confirmeu que els permisos de Snowflake impedeixen l’accés fora del rol i els objectes aprovats.
URL del servidor MCP i comportament d’OAuth
ChatGPT es connecta a l’URL completa del servidor MCP gestionat per Snowflake. ChatGPT fa servir el prefix de host de Snowflake d’aquest URL per resoldre els punts finals d’OAuth de Snowflake.
No enganxeu un URL de Snowsight, l’URL arrel del compte de Snowflake tot sol ni cap URL amb segments de camí addicionals. L’URL de MCP ha d’incloure la ruta de la base de dades, l’esquema i el servidor MCP, i ha de coincidir exactament amb els vostres objectes de Snowflake.
Resolució de problemes
No s’ha trobat el servidor MCP: torneu a comprovar l’URL completa del servidor MCP o els camps separats de prefix de host, base de dades, esquema i servidor.
No apareix cap eina a ChatGPT: confirmeu que l’especificació del servidor MCP inclou eines i que el rol té USAGE al servidor MCP.
Apareix una eina però falla quan s’utilitza: confirmeu que el rol té el permís adequat sobre l’objecte subjacent de Snowflake.
L’eina SQL falla: confirmeu que el nom del magatzem és correcte, que el magatzem està disponible, que el rol hi té USAGE i que read_only és true si volíeu accés només de lectura.
L’autorització falla: confirmeu que l’usuari pot iniciar la sessió a Snowflake i fer servir el rol previst.
Problema de connexió del nom de host: feu servir el prefix de host de Snowflake correcte. Els noms de host de Snowflake amb guions baixos poden causar problemes; és preferible fer servir guions.