Използвайте това ръководство, ако сте администратор на работно пространство в ChatGPT и настройвате шаблона за приложение Snowflake за вашата организация. Шаблонът не е крайното приложение, което членовете използват. Това е поток за настройка, който създава чернова на приложение, специфична за работното пространство, след като предоставите нужната конфигурация на Snowflake.
За Snowflake по-голямата част от настройката се извършва в Snowflake. Създавате управляван от Snowflake MCP сървър, предоставяте на правилната роля достъп до MCP сървъра и основните му обекти, след което въвеждате URL адреса на управлявания MCP сървър или съставните му полета в потока за настройка на шаблона в ChatGPT. След като ChatGPT създаде черновата на приложението, можете да я публикувате и управлявате като други приложения в работното пространство.
Какво настройвате
Създавате специфично за работното пространство приложение Snowflake в ChatGPT. Приложението се свързва с управляван от Snowflake MCP сървър, който определя:
Кои действия може да използва ChatGPT, наричани инструменти.
До кои данни или обекти на Snowflake могат да имат достъп тези инструменти.
С коя роля в Snowflake потребителите трябва да се упълномощават.
Коя база данни, схема и име на MCP сървър в Snowflake идентифицират крайната точка на конектора.
ChatGPT може да открива и използва само инструментите, изложени от MCP сървъра и разрешени от ролята в Snowflake, с която потребителят се упълномощава.
Преди да започнете
Необходими са ви:
Достъп като администратор или собственик на работно пространство в ChatGPT.
Достъп до Snowflake, който позволява създаване на обекти на MCP сървър и предоставяне на разрешения.
Базата данни и схемата в Snowflake, където ще се намира MCP сървърът.
Решение какво трябва да бъде разрешено на ChatGPT да прави, като Cortex Search, Cortex Analyst, SQL само за четене или конкретна процедура или функция.
Роля в Snowflake с минимални привилегии, която потребителите ще използват при упълномощаване на приложението.
Префиксът на хоста на акаунта в Snowflake, включително евентуален суфикс за регион или облак.
Стойности за подготовка
Префикс на хоста на Snowflake: всичко преди .snowflakecomputing.com в URL адреса на акаунта в Snowflake.
База данни: базата данни, съдържаща MCP сървъра.
Схема: схемата, съдържаща MCP сървъра.
Име на MCP сървъра: името на обекта MCP сървър в Snowflake.
Пълният URL адрес на управлявания MCP сървър, ако екранът за настройка на ChatGPT поиска URL адрес.
Роля в Snowflake: ролята, която потребителите трябва да използват при упълномощаване на приложението.
Списък с инструменти: обектите и действията на Snowflake, които искате ChatGPT да използва.
Решете какво може да прави ChatGPT
Изберете само възможностите, които искате да изложите. Често срещаните опции включват:
Търсене с Cortex Search за намиране на отговори в индексирани данни или съдържание на Snowflake.
Въпроси и отговори с Cortex Analyst чрез одобрен семантичен изглед.
SQL само за четене за контролиран достъп до заявки.
Агент на Snowflake, съхранена процедура или UDF за конкретни работни потоци.
Ако активирате SQL, оставете го само за четене, освен ако организацията ви не е прегледала и одобрила достъп за запис.
Създаване на MCP сървъра Snowflake
В Snowflake влезте с роля, която може да създаде MCP сървъра и да предостави достъп. Отворете работен лист в базата данни и схемата, където трябва да се създаде MCP сървърът.
Създайте MCP сървър, който изброява само инструментите, които ChatGPT трябва да използва. Заменете имената на обектите със собствените си имена на база данни, схема, услуги, изгледи, склад и сървър в Snowflake.
Пример:
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" $$;
Имената на инструментите трябва да са стабилни и описателни, за да може ChatGPT да избере правилния инструмент. Създаването на MCP сървъра не предоставя автоматично достъп до основните обекти на Snowflake.
Предоставяне на правилните разрешения в Snowflake
Изберете ролята в Snowflake, с която потребителите ще се упълномощават, след което предоставете на тази роля достъп до базата данни, схемата, MCP сървъра и всеки основен обект, използван от инструментите.
Пример:
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;
Ако MCP сървърът излага семантичен изглед, UDF, съхранена процедура или Cortex Агент, предоставете и необходимите разрешения за тези обекти.
Проверете дали Snowflake е готов
Изпълнете:
SHOW MCP SERVERS IN SCHEMA CHATGPT_APPS.TOOLS;
След това изпълнете:
DESCRIBE MCP SERVER CHATGPT_APPS.TOOLS.CHATGPT_SNOWFLAKE_MCP;
Потвърдете:
Сървърът съществува в очакваните база данни и схема.
Списъкът с инструменти е такъв, какъвто сте възнамерявали.
Всеки идентификатор на инструмент сочи към правилния обект на Snowflake.
Свързващата роля има USAGE върху MCP сървъра.
Свързващата роля има необходимите разрешения върху всеки основен обект.
Стартиране на настройката на шаблона в ChatGPT
В ChatGPT превключете към работното пространство, където приложението трябва да бъде налично.
Отворете Настройки на работното пространство > Приложения.
Изберете Директория.
Потърсете Snowflake.
Изберете шаблона за приложение Snowflake и започнете настройката.
Въведете ясно име и описание на приложението, като Snowflake или Snowflake - Analytics.
Въведете данните за управлявания MCP сървър, изискани от потока за настройка.
Ако екранът за настройка поиска пълния URL адрес на управлявания MCP сървър, използвайте този формат:
https://<snowflake_host_prefix>.snowflakecomputing.com/api/v2/databases/{database}/schemas/{schema}/mcp-servers/{server}
Ако екранът за настройка поиска отделни полета, използвайте същите стойности от този URL адрес:
Префикс на хоста на Snowflake.
База данни.
Схема.
Име на MCP сървъра.
Създаване и публикуване на черновата на приложението
Запазете настройката на шаблона Snowflake в ChatGPT.
Създайте черновата на приложението.
Прегледайте подробностите за черновата на приложението, настройките за удостоверяване и наличните действия.
Публикувайте черновата на приложението, когато е готова.
Потвърдете, че приложението се показва в Настройки на работното пространство > Приложения > Активирани.
Конфигурирайте Потребителски достъп за ролите, които трябва да го използват.
Прегледайте Контрол на действията за изложените инструменти.
Прегледайте Разрешения за приложението, за да изберете кога ChatGPT да пита членовете, преди да използва приложението.
Тези разрешения за приложението се прилагат към разговорите в ChatGPT. Агентите на работното пространство използват контроли за всеки Агент, зададени от създателя на Агента, за да определят кои действия на приложението са налични и кога крайните потребители трябва да ги одобрят. За поведението на Агентите вижте: Агенти на работното пространство в ChatGPT за Enterprise и Business.
Тестване на приложението
Стартирайте потока за свързване от ChatGPT като разрешен тестов потребител.
Влезте в Snowflake и изберете предвидената роля, ако бъдете подканени.
Потвърдете, че ChatGPT открива очакваните инструменти от MCP сървъра.
Първо изпълнете действие за четене с нисък риск, като търсене или заявка само за четене към одобрени данни.
Потвърдете, че разрешенията в Snowflake предотвратяват достъп извън одобрената роля и обекти.
URL адрес на MCP сървъра и поведение на OAuth
ChatGPT се свързва с пълния URL адрес на управлявания от Snowflake MCP сървър. ChatGPT използва префикса на хоста на Snowflake от този URL адрес, за да определи крайните точки на Snowflake OAuth.
Не поставяйте URL адрес на Snowsight, само основния URL адрес на акаунта в Snowflake или URL адрес с допълнителни сегменти в пътя. MCP URL адресът трябва да включва пътя към базата данни, схемата и MCP сървъра и трябва точно да съвпада с вашите обекти в Snowflake.
Отстраняване на неизправности
MCP сървърът не е намерен: проверете отново пълния URL адрес на MCP сървъра или отделните полета за префикс на хоста, база данни, схема и сървър.
В ChatGPT не се показват инструменти: потвърдете, че спецификацията на MCP сървъра включва инструменти и че ролята има USAGE върху MCP сървъра.
Инструмент се показва, но не работи при използване: потвърдете, че ролята има правилното разрешение върху основния обект на Snowflake.
SQL инструментът не работи: потвърдете, че името на склада е правилно, складът е наличен, ролята има USAGE върху него и read_only е true, ако сте възнамерявали достъп само за четене.
Упълномощаването е неуспешно: потвърдете, че потребителят може да влезе в Snowflake и да използва предвидената роля.
Проблем с връзката към името на хоста: използвайте правилния префикс на хоста на Snowflake. Имената на хостове в Snowflake с долни черти могат да причинят проблеми; предпочитайте тирета.