Konfiguroni modelin e aplikacionit Snowflake në ChatGPT

Mësoni si administratorët e hapësirës së punës të ChatGPT dhe përdoruesit e ChatGPT Plus ose Pro mund ta lidhin ChatGPT me një server MCP të menaxhuar nga Snowflake.

Përdoreni këtë udhëzues nëse jeni administrator i një hapësire pune në ChatGPT ose përdorues i ChatGPT Plus apo Pro dhe dëshironi ta lidhni ChatGPT me Snowflake përmes një serveri MCP të menaxhuar nga Snowflake.

Pjesa më e madhe e konfigurimit bëhet në Snowflake. Pasi Snowflake të jetë gati, përfundoni lidhjen e shabllonit Snowflake në ChatGPT, pastaj aktivizoni shtesën Snowflake që përdor atë shabllon.

OAuth i integruar: Kur është i disponueshëm për llogarinë tuaj Snowflake dhe në ChatGPT, përdorni aplikacionin partner ChatGPT të aktivizuar nga një administrator i Snowflake. Hyni në Snowflake duke përdorur SSO të organizatës suaj, nëse është konfiguruar. Nuk keni nevojë të futni ID-në apo sekretin e klientit në ChatGPT. Ndiqni seksionin OAuth i integruar më poshtë.
Klient OAuth i personalizuar: Përdoreni këtë mënyrë nëse organizata juaj kërkon klientin e vet OAuth ose nëse OAuth i integruar nuk është i disponueshëm. Ndiqni seksionin Klient OAuth i personalizuar më poshtë.

Të dyja mënyrat e OAuth kërkojnë konfigurimin e përbashkët të serverit MCP, lejet për objektet që ai përdor dhe qasjen në rrjet, siç përshkruhen më poshtë. Përpara se të konfiguroni OAuth, përfundoni konfigurimin e përbashkët deri te seksioni Futni të dhënat e serverit Snowflake në ChatGPT, përfshirë edhe atë.

Çfarë po konfiguroni

Po krijoni një server MCP të menaxhuar nga Snowflake, i cili shërben si pikë fundore e lidhësit për ChatGPT. Serveri MCP përcakton:

Cilat veprime mund të përdorë ChatGPT.
Në cilat të dhëna ose objekte të Snowflake mund të kenë qasje këto mjete.
Me cilin rol në Snowflake jep autorizimin secili përdorues.
Cila bazë të dhënash, skemë dhe cili emër serveri MCP në Snowflake identifikojnë pikën fundore.

Më pas konfiguroni Snowflake - Shablloni zyrtar në ChatGPT me URL-në e plotë të serverit MCP të menaxhuar. Ekrani i konfigurimit të shabllonit mund ta paraqesë URL-në në katër fusha të veçanta:

Prefiksi i pritësit Snowflake.
Baza e të dhënave.
Skema.
Emri i serverit MCP.

ChatGPT mund të zbulojë dhe të përdorë vetëm mjetet që ofron serveri MCP dhe që lejohen nga roli në Snowflake me të cilin përdoruesi jep autorizimin.

Përpara se të filloni

Ju nevojiten:

Qasje si administrator ose pronar i hapësirës së punës në ChatGPT, ose qasje në ChatGPT Plus apo Pro.
Qasje në Snowflake që lejon krijimin e objekteve të serverit MCP dhe dhënien e lejeve.
Baza e të dhënave dhe skema në Snowflake ku do të vendoset serveri MCP.
Një vendim se çfarë duhet t'i lejohet ChatGPT të bëjë, si p.sh. të përdorë Cortex Search, Cortex Analyst, SQL vetëm për lexim ose një procedurë a funksion të caktuar.
Një rol në Snowflake me privilegjet minimale të nevojshme, të cilin përdoruesit do ta përdorin kur të autorizojnë aplikacionin.
Prefiksi i pritësit të llogarisë Snowflake, përfshirë çdo prapashtesë të rajonit ose të resë kompjuterike.

Nëse llogaria juaj Snowflake e kufizon qasjen përmes një politike rrjeti ose liste të IP-ve të lejuara, kërkojini një administratori të Snowflake të lejojë lidhjet hyrëse nga intervalet aktuale të IP-ve dalëse të lidhësve të ChatGPT. Lista është dinamike dhe duhet mbajtur e përditësuar.

Vlerat që duhen përgatitur

Prefiksi i pritësit Snowflake: gjithçka përpara .snowflakecomputing.com në URL-në e llogarisë Snowflake.
Baza e të dhënave: baza e të dhënave që përmban serverin MCP.
Skema: skema që përmban serverin MCP.
Emri i serverit MCP: emri i objektit të serverit MCP në Snowflake.
URL-ja e plotë e serverit MCP të menaxhuar, nëse ekrani i konfigurimit të ChatGPT kërkon një URL.
Roli në Snowflake: roli që përdoruesit duhet të përdorin kur autorizojnë aplikacionin.
Lista e mjeteve: objektet dhe veprimet në Snowflake që dëshironi të përdorë ChatGPT.

Vendosni se çfarë mund të bëjë ChatGPT

Zgjidhni vetëm aftësitë që dëshironi të vini në dispozicion. Opsionet e zakonshme përfshijnë:

Kërkim me Cortex Search për të gjetur përgjigje në të dhënat ose përmbajtjen e indeksuar në Snowflake.
Pyetje dhe përgjigje me Cortex Analyst përmes një pamjeje semantike të miratuar.
SQL vetëm për lexim, për qasje të kontrolluar përmes kërkesave.
Një agjent Snowflake, procedurë e ruajtur ose UDF për një rrjedhë pune të caktuar.

Nëse aktivizoni SQL, mbajeni vetëm për lexim, përveç rastit kur organizata juaj ka shqyrtuar dhe miratuar qasjen për shkrim.

Hapni një fletë pune në Snowflake

Hyni në aplikacionin Snowflake.
Kaloni te një rol që mund të krijojë serverin MCP dhe të japë qasje.
Shkoni te Hapësirat e punës.
Krijoni një hapësirë pune me një skedar SQL.
Caktoni si kontekst të hapësirës së punës bazën e të dhënave dhe skemën ku do të krijohet serveri MCP.

Krijoni serverin MCP në Snowflake

Në Snowflake, hyni me një rol që mund të krijojë serverin MCP dhe të japë qasje. Hapni një fletë pune në bazën e të dhënave dhe skemën ku duhet të krijohet serveri MCP.

Ekzekutoni një komandë si në shembullin e mëposhtëm. Zëvendësoni emrat me emrat tuaj të bazës së të dhënave, skemës, shërbimeve, pamjeve, magazinës virtuale dhe serverit në 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: "revenue-analyst"
type: "CORTEX_ANALYST_MESSAGE"
identifier: "CHATGPT_APPS.TOOLS.REVENUE_SEMANTIC_VIEW"
title: "Revenue Analyst"
description: "Answer revenue questions using the approved semantic view."
- 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"
$$;

Snowflake result confirming that the MCP server was successfully created.

Emrat e mjeteve dhe objektet e Snowflake në këtë komandë janë shembuj:

support-search vë në dispozicion shërbimin e përcaktuar Cortex Search.
revenue-analyst vë në dispozicion pamjen semantike të përcaktuar. Shtoni mjete për pamje të tjera sipas nevojës.
sql-readonly vë në dispozicion SQL vetëm për lexim me magazinën virtuale të përcaktuar.

Përdorni emra të qëndrueshëm dhe përshkrues për mjetet, që ChatGPT të mund të zgjedhë mjetin e duhur. Krijimi i serverit MCP nuk jep automatikisht qasje në objektet e Snowflake që ai përdor.

Për opsione të tjera të specifikimit, shihni: Krijoni një server MCP të menaxhuar nga Snowflake.

Jepni lejet e duhura në Snowflake

Zgjidhni rolin në Snowflake me të cilin përdoruesit do të japin autorizimin, pastaj jepini atij roli qasje në:

Bazën e të dhënave dhe skemën.
Serverin MCP.
Çdo objekt që përdoret nga mjetet, si një shërbim kërkimi, pamje semantike ose magazinë virtuale.

Shembull:

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 SELECT ON SEMANTIC VIEW CHATGPT_APPS.TOOLS.REVENUE_SEMANTIC_VIEW TO ROLE CHATGPT_CONNECTOR_ROLE;
GRANT USAGE ON WAREHOUSE CHATGPT_WH TO ROLE CHATGPT_CONNECTOR_ROLE;

Nëse serveri MCP vë në dispozicion një UDF, procedurë të ruajtur ose Cortex Agent, jepni lejet e nevojshme edhe për atë objekt.

Verifikoni që Snowflake është gati

Ekzekutoni:

SHOW MCP SERVERS IN SCHEMA CHATGPT_APPS.TOOLS;

Pastaj ekzekutoni:

DESCRIBE MCP SERVER CHATGPT_APPS.TOOLS.CHATGPT_SNOWFLAKE_MCP;

Konfirmoni që:

Serveri ekziston në bazën e të dhënave dhe skemën e parashikuar.
Lista e mjeteve është ajo që synonit.
Vlera identifier e çdo mjeti i referohet objektit të duhur në Snowflake.
Roli që përdoret për lidhjen ka lejen USAGE në serverin MCP.
Roli që përdoret për lidhjen ka lejet e nevojshme për çdo objekt që përdorin mjetet.

Futni të dhënat e serverit Snowflake në ChatGPT

Në ChatGPT, kaloni te llogaria ose hapësira e punës ku duhet të jetë i disponueshëm aplikacioni.
Shkoni te Cilësimet > Shtesat për konfigurim personal ose, si administrator i hapësirës së punës, te Cilësimet e hapësirës së punës > Shtesat për konfigurimin e hapësirës së punës.
Kërkoni Snowflake.
Aktivizoni Snowflake - Shablloni zyrtar.
Hapni Snowflake - Shablloni zyrtar, futni një emër të qartë për lidhjen dhe zgjidhni Lidhu.
Futni URL-në e plotë të serverit MCP të menaxhuar:

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

Shembull:

https://myorg-myaccount.azure.snowflakecomputing.com/api/v2/databases/CHATGPT_APPS/schemas/TOOLS/mcp-servers/CHATGPT_SNOWFLAKE_MCP

ChatGPT Snowflake Template connection form with name, managed MCP server URL, and OAuth settings.

Nëse ekrani i konfigurimit e paraqet konfigurimin e Snowflake në fusha të veçanta, përdorni të njëjtat vlera nga URL-ja:

Prefiksi i pritësit Snowflake

Përdorni gjithçka përpara .snowflakecomputing.com në URL-në e llogarisë suaj Snowflake, përfshirë çdo prapashtesë të rajonit ose të resë kompjuterike.

Për shembull, nëse URL-ja e llogarisë fillon me:

https://myorg-myaccount.azure.snowflakecomputing.com

Prefiksi i pritësit është:

myorg-myaccount.azure

Baza e të dhënave

Futni bazën e të dhënave që përmban serverin MCP, si p.sh.:

CHATGPT_APPS

Skema

Futni skemën që përmban serverin MCP, si p.sh.:

TOOLS

Emri i serverit MCP

Futni emrin e objektit të serverit MCP në Snowflake, si p.sh.:

CHATGPT_SNOWFLAKE_MCP

Konfiguroni OAuth

Zgjidhni mënyrën e OAuth që është e disponueshme për llogarinë tuaj dhe plotëson kërkesat e organizatës suaj. Të dyja mënyrat përdorin konfigurimin e përbashkët të serverit MCP më sipër, si dhe testet e lidhjes dhe kontrollet e qasjes më poshtë.

Për të dyja mënyrat e OAuth, kur përdorni session:role:all, Snowflake përdor rolin e parazgjedhur të secilit përdorues. Roli i parazgjedhur duhet të lejohet nga lista e roleve të lejuara të integrimit OAuth, nëse ajo është konfiguruar, dhe nuk duhet të jetë i bllokuar. Nëse keni një rol tjetër të miratuar, ai nuk zgjidhet automatikisht.

OAuth i integruar

Përpara se të vazhdoni, përfundoni seksionet e përbashkëta më sipër për të krijuar serverin MCP, për të dhënë lejet, për të verifikuar serverin dhe për të futur të dhënat e tij në ChatGPT. Kjo kërkohet edhe nëse keni ardhur drejtpërdrejt te ky seksion.

Përdoreni këtë mënyrë vetëm kur aplikacioni partner ChatGPT është i disponueshëm për llogarinë tuaj Snowflake dhe OAuth i integruar është i disponueshëm në dritaren e konfigurimit të ChatGPT.

Kërkojini një administratori të Snowflake të aktivizojë integrimin partner ChatGPT në të njëjtën llogari Snowflake ku ndodhet serveri MCP. Ripërdorni një integrim partner ekzistues të ChatGPT që është i aktivizuar.
Në dritaren e konfigurimit të ChatGPT, përdorni OAuth të integruar. Nuk keni nevojë të futni ID-në apo sekretin e klientit ose të regjistroni një URL kthimi.
Vazhdoni me seksionin Lidhni dhe menaxhoni Snowflake më poshtë për të hyrë, për të dhënë pëlqimin dhe për të konfiguruar qasjen. Pastaj përfundoni seksionin Testoni aplikacionin, përfshirë testet me anëtarë të lejuar që nuk janë administratorë.

Mënyra e funksionimit të rolit të parazgjedhur, listës së roleve të lejuara dhe roleve të bllokuara, e përshkruar më sipër, vlen edhe për këtë mënyrë.

Klient OAuth i personalizuar

Për një klient OAuth të personalizuar, ju nevojiten një ID klienti dhe një sekret klienti nga Snowflake. Mënyra e funksionimit të rolit të parazgjedhur, listës së roleve të lejuara dhe roleve të bllokuara, e përshkruar më sipër, vlen edhe për këtë mënyrë.

Në dritaren e konfigurimit të ChatGPT, zgjidhni Cilësimet e avancuara të OAuth > Klient OAuth i përcaktuar nga përdoruesi dhe kopjoni saktësisht URL-në e kthimit që shfaqet në ChatGPT.
Krijoni një integrim sigurie OAuth të personalizuar me OAUTH_CLIENT_TYPE = 'CONFIDENTIAL' dhe caktoni si vlerë të OAUTH_REDIRECT_URI pikërisht atë URL kthimi.
Ekzekutoni komandën e mëposhtme në Snowflake, duke përdorur emrin e integrimit me shkronja të mëdha:
SELECT SYSTEM$SHOW_OAUTH_CLIENT_SECRETS('YOUR_INTEGRATION_NAME');
Nga rezultati JSON, ngjitni oauth_client_id te ID-ja e klientit OAuth dhe oauth_client_secret te Sekreti i klientit OAuth në ChatGPT.
Caktoni Metodën e autentikimit të pikës fundore të tokenit në client_secret_basic.

Pasi të futni kredencialet e klientit të personalizuar, vazhdoni me seksionet Lidhni dhe menaxhoni Snowflake dhe Testoni aplikacionin më poshtë.

Lidhni dhe menaxhoni Snowflake

Për të dyja mënyrat e OAuth, në të njëjtën dritare konfigurimi të ChatGPT, zgjidhni Vazhdo, hyni në Snowflake dhe autorizoni lidhjen. Mund të përdorni SSO të organizatës suaj, nëse është konfiguruar.
Për konfigurimin e një hapësire pune, konfiguroni politikën e instalimit të shtesës dhe qasjen sipas rolit ose grupit për anëtarët që duhet ta përdorin. Verifikoni që janë aktivizuar si Snowflake, ashtu edhe Snowflake - Shablloni zyrtar.
Administratorët e hapësirës së punës janë përgjegjës për konfigurimin e Qasjes së përdoruesve për rolet që duhet të përdorin Snowflake.
Administratorët e hapësirës së punës janë përgjegjës për shqyrtimin e Kontrollit të veprimeve për mjetet e vëna në dispozicion.
Administratorët e hapësirës së punës janë përgjegjës për shqyrtimin e Lejeve të aplikacionit për të zgjedhur se kur ChatGPT u kërkon miratim anëtarëve përpara se të përdorë aplikacionin.

Këto leje të aplikacionit vlejnë për bisedat në ChatGPT. Agjentët e hapësirës së punës përdorin kontrolle të veçanta për çdo agjent, të vendosura nga krijuesi i tij, për të përcaktuar cilat veprime të aplikacionit janë të disponueshme dhe kur përdoruesve fundorë u kërkohet t'i miratojnë ato. Për mënyrën si funksionojnë agjentët, shihni: Agjentët e hapësirës së punës në ChatGPT për Enterprise dhe Business.

Testoni aplikacionin

Hapni një bisedë, zgjidhni Snowflake dhe testoni lidhjen.
Konfirmoni që ChatGPT zbulon mjetet që keni konfiguruar.
Fillimisht kryeni një veprim leximi me rrezik të ulët, si një kërkim ose një kërkesë vetëm për lexim mbi të dhëna të miratuara.
Konfirmoni që lejet në Snowflake parandalojnë qasjen përtej rolit dhe objekteve të miratuara.
Për konfigurimin e një hapësire pune, testoni me anëtarë të lejuar që nuk janë administratorë dhe që kanë role të ndryshme të parazgjedhura në Snowflake. Një lidhje e suksesshme e administratorit nuk konfirmon që çdo anëtar mund të lidhet.

Për administratorët e hapësirës së punës, nuk mjafton të aktivizojnë vetëm Snowflake. Nëse Snowflake - Shablloni zyrtar nuk është aktivizuar dhe lidhur, shtesa mund t'u shfaqet anëtarëve si e çaktivizuar.

URL-ja e serverit MCP dhe funksionimi i OAuth

ChatGPT lidhet me URL-në e plotë të serverit MCP të menaxhuar nga Snowflake:

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

ChatGPT përdor prefiksin e pritësit Snowflake nga ajo URL për të përcaktuar këto pika fundore OAuth të Snowflake:

Autorizimi: https://<snowflake_host_prefix>.snowflakecomputing.com/oauth/authorize
Tokeni: https://<snowflake_host_prefix>.snowflakecomputing.com/oauth/token-request

Mos ngjitni një URL të Snowsight, vetëm URL-në bazë të llogarisë Snowflake ose një URL me segmente shtesë në shteg. URL-ja e MCP duhet të përfshijë /api/v2/databases/{database}/schemas/{schema}/mcp-servers/{server} dhe të përputhet saktësisht me objektet tuaja në Snowflake.

Zgjidhja e problemeve

Snowflake është i aktivizuar për një administrator, por i çaktivizuar për një anëtar

Konfirmoni që si Snowflake, ashtu edhe Snowflake - Shablloni zyrtar janë aktivizuar te Cilësimet e hapësirës së punës > Shtesat.
Hapni Snowflake - Shablloni zyrtar dhe përfundoni procesin Lidhu. Aktivizimi i shabllonit pa e lidhur atë nuk mjafton.
Hapni Snowflake dhe konfirmoni që shablloni shfaqet si aplikacion i domosdoshëm për të.
Konfirmoni që roli ose grupi i anëtarit që has problemin lejohet nga politika e instalimit të shtesës.

Serveri MCP nuk u gjet

Kontrolloni sërish URL-në e plotë të serverit MCP ose katër fushat e shabllonit, nëse ekrani i konfigurimit i kërkon ato.
Konfirmoni që serveri MCP ekziston pikërisht në atë bazë të dhënash dhe skemë.

Në ChatGPT nuk shfaqet asnjë mjet

Konfirmoni që specifikimi i serverit MCP përfshin mjete.
Konfirmoni që roli ka lejen USAGE në serverin MCP.

Një mjet shfaqet, por nuk funksionon kur përdoret

Konfirmoni që roli ka lejen e nevojshme për objektin e Snowflake që përdor mjeti, si shërbimi i kërkimit, pamja semantike, magazina virtuale, procedura ose UDF-ja.

Mjeti SQL nuk funksionon

Konfirmoni që emri i magazinës virtuale është i saktë dhe që ajo është në punë.
Konfirmoni që roli ka lejen USAGE në magazinën virtuale.
Konfirmoni që është caktuar read_only: true, nëse synonit qasje vetëm për lexim.

Roli i kërkuar ALL është bllokuar shprehimisht

Kërkojini administratorit tuaj të Snowflake të krahasojë rolin tuaj të parazgjedhur me rolet e lejuara dhe të bllokuara të integrimit OAuth. Nëse keni një rol tjetër të lejuar, ai nuk zgjidhet automatikisht. Nëse është e përshtatshme, ndryshoni rolin e parazgjedhur në një rol të miratuar dhe lidhuni sërish. Ndryshimi i rolit tuaj të parazgjedhur ndikon edhe në seancat tuaja në Snowflake jashtë ChatGPT.

Autorizimi dështon

Konfirmoni që përdoruesi mund të hyjë në Snowflake.
Kur përdorni session:role:all, konfirmoni që roli i parazgjedhur i përdoruesit lejohet nga integrimi OAuth.
Konfirmoni që konfigurimi përdor procesin OAuth për MCP të menaxhuar nga Snowflake.
Nëse përdorni një klient OAuth të personalizuar, konfirmoni që ID-ja e klientit dhe Sekreti i klientit përputhen me integrimin OAuth të Snowflake dhe që URI-ja e ridrejtimit e tij përputhet saktësisht me URL-në e kthimit që shfaqet në ChatGPT.
Nëse përdorni OAuth të integruar, kërkojini një administratori të Snowflake të kontrollojë që integrimi partner ChatGPT është i disponueshëm dhe i aktivizuar në llogarinë ku ndodhet serveri MCP.

Politika e rrjetit ose lista e IP-ve të lejuara në Snowflake bllokon lidhësin

Kërkojini një administratori të Snowflake të përditësojë politikën e rrjetit ose rregullat e qasjes në Snowflake.
Lejoni lidhjet hyrëse nga intervalet aktuale të IP-ve dalëse të lidhësve të ChatGPT.
Konfiguroni këtë listë lejimi në Snowflake. Ajo është e veçantë nga lista e IP-ve të lejuara të hapësirës së punës në ChatGPT.
Automatizoni përditësimet nga JSON-i i publikuar kur është e mundur, sepse intervalet mund të ndryshojnë.

Problem lidhjeje me emrin e pritësit

Përdorni prefiksin e saktë të pritësit Snowflake. Emrat e pritësve Snowflake me nënvija mund të shkaktojnë probleme; parapëlqeni vizat.