Gunakan panduan ini jika anda pentadbir ruang kerja ChatGPT yang menyediakan templat aplikasi Snowflake untuk organisasi anda. Templat bukan aplikasi akhir yang digunakan oleh ahli. Templat ialah aliran persediaan yang mencipta draf aplikasi khusus ruang kerja selepas anda memberikan konfigurasi Snowflake yang diperlukan.
Untuk Snowflake, kebanyakan persediaan dilakukan dalam Snowflake. Anda mencipta pelayan MCP yang diurus oleh Snowflake, memberikan akses peranan yang betul kepada pelayan MCP dan objek asasnya, kemudian memasukkan URL pelayan MCP terurus atau medan komponennya dalam aliran persediaan templat ChatGPT. Selepas ChatGPT mencipta draf aplikasi, anda boleh menerbitkan dan mengurusnya seperti aplikasi ruang kerja yang lain.
Perkara yang anda sediakan
Anda sedang mencipta aplikasi Snowflake khusus ruang kerja dalam ChatGPT. Aplikasi ini menyambung kepada pelayan MCP yang diurus oleh Snowflake yang mentakrifkan:
Tindakan yang boleh digunakan oleh ChatGPT, dipanggil alat.
Data atau objek Snowflake yang boleh diakses oleh alat tersebut.
Peranan Snowflake yang harus digunakan oleh pengguna untuk membuat kebenaran.
Pangkalan data, skema dan nama pelayan MCP Snowflake yang mengenal pasti titik akhir penyambung.
ChatGPT hanya boleh menemui dan menggunakan alat yang didedahkan oleh pelayan MCP serta dibenarkan oleh peranan Snowflake yang digunakan oleh pengguna untuk membuat kebenaran.
Sebelum anda bermula
Anda memerlukan:
Akses pentadbir atau pemilik ruang kerja ChatGPT.
Akses Snowflake yang boleh mencipta objek pelayan MCP dan memberikan keizinan.
Pangkalan data dan skema Snowflake tempat pelayan MCP akan ditempatkan.
Keputusan tentang perkara yang harus dibenarkan untuk dilakukan oleh ChatGPT, seperti Cortex Search, Cortex Analyst, SQL baca sahaja, atau prosedur atau fungsi tertentu.
Peranan Snowflake dengan keistimewaan minimum yang akan digunakan oleh pengguna semasa membuat kebenaran aplikasi.
Awalan hos akaun Snowflake, termasuk sebarang akhiran rantau atau awan.
Nilai yang perlu disediakan
Awalan hos Snowflake: semua yang berada sebelum .snowflakecomputing.com dalam URL akaun Snowflake.
Pangkalan data: pangkalan data yang mengandungi pelayan MCP.
Skema: skema yang mengandungi pelayan MCP.
Nama pelayan MCP: nama objek pelayan MCP Snowflake.
URL penuh pelayan MCP terurus, jika skrin persediaan ChatGPT meminta URL.
Peranan Snowflake: peranan yang harus digunakan oleh pengguna semasa membuat kebenaran aplikasi.
Senarai alat: objek dan tindakan Snowflake yang anda mahu ChatGPT gunakan.
Tentukan perkara yang boleh dilakukan oleh ChatGPT
Pilih hanya keupayaan yang anda mahu dedahkan. Pilihan biasa termasuk:
Carian dengan Cortex Search untuk mencari jawapan dalam data atau kandungan Snowflake yang diindeks.
Soal jawab dengan Cortex Analyst melalui paparan semantik yang diluluskan.
SQL baca sahaja untuk akses pertanyaan terkawal.
Snowflake Agent, prosedur tersimpan atau UDF untuk aliran kerja tertentu.
Jika anda mendayakan SQL, kekalkannya baca sahaja melainkan organisasi anda telah menyemak dan meluluskan akses tulis.
Cipta pelayan MCP Snowflake
Dalam Snowflake, log masuk dengan peranan yang boleh mencipta pelayan MCP dan memberikan akses. Buka lembaran kerja dalam pangkalan data dan skema tempat pelayan MCP harus dicipta.
Cipta pelayan MCP yang hanya menyenaraikan alat yang harus digunakan oleh ChatGPT. Gantikan nama objek dengan pangkalan data, skema, perkhidmatan, paparan, gudang dan nama pelayan Snowflake anda sendiri.
Contoh:
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" $$;
Nama alat harus stabil dan deskriptif supaya ChatGPT boleh memilih alat yang betul. Mencipta pelayan MCP tidak memberikan akses secara automatik kepada objek Snowflake asas.
Berikan keizinan Snowflake yang betul
Pilih peranan Snowflake yang akan digunakan oleh pengguna untuk membuat kebenaran, kemudian berikan peranan itu akses kepada pangkalan data, skema, pelayan MCP dan setiap objek asas yang digunakan oleh alat.
Contoh:
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;
Jika pelayan MCP mendedahkan paparan semantik, UDF, prosedur tersimpan atau Cortex Agent, berikan juga keizinan yang diperlukan untuk objek tersebut.
Sahkan Snowflake sudah sedia
Jalankan:
SHOW MCP SERVERS IN SCHEMA CHATGPT_APPS.TOOLS;
Kemudian jalankan:
DESCRIBE MCP SERVER CHATGPT_APPS.TOOLS.CHATGPT_SNOWFLAKE_MCP;
Sahkan:
Pelayan wujud dalam pangkalan data dan skema yang dijangka.
Senarai alat adalah seperti yang anda maksudkan.
Setiap pengecam alat menunjuk kepada objek Snowflake yang betul.
Peranan penyambung mempunyai USAGE pada pelayan MCP.
Peranan penyambung mempunyai keizinan yang diperlukan pada setiap objek asas.
Mulakan persediaan templat dalam ChatGPT
Dalam ChatGPT, tukar kepada ruang kerja tempat aplikasi harus tersedia.
Buka Tetapan ruang kerja > Aplikasi.
Pilih Direktori.
Cari Snowflake.
Pilih templat aplikasi Snowflake dan mulakan persediaan.
Masukkan nama dan perihalan aplikasi yang jelas, seperti Snowflake atau Snowflake - Analytics.
Masukkan butiran pelayan MCP terurus yang diminta oleh aliran persediaan.
Jika skrin persediaan meminta URL penuh pelayan MCP terurus, gunakan format ini:
https://<snowflake_host_prefix>.snowflakecomputing.com/api/v2/databases/{database}/schemas/{schema}/mcp-servers/{server}
Jika skrin persediaan meminta medan berasingan, gunakan nilai yang sama daripada URL itu:
Awalan hos Snowflake.
Pangkalan data.
Skema.
Nama pelayan MCP.
Cipta dan terbitkan draf aplikasi
Simpan persediaan templat Snowflake dalam ChatGPT.
Cipta draf aplikasi.
Semak butiran draf aplikasi, tetapan pengesahan dan tindakan yang tersedia.
Terbitkan draf aplikasi apabila sudah bersedia.
Sahkan aplikasi muncul dalam Tetapan ruang kerja > Aplikasi > Didayakan.
Konfigurasikan Akses pengguna untuk peranan yang harus menggunakannya.
Semak Kawalan tindakan untuk alat yang didedahkan.
Semak Keizinan aplikasi untuk memilih bila ChatGPT meminta ahli sebelum menggunakan aplikasi.
Keizinan aplikasi ini digunakan pada perbualan ChatGPT. Workspace Agents menggunakan kawalan bagi setiap ejen yang ditetapkan oleh pembina ejen untuk menentukan tindakan aplikasi yang tersedia dan bila pengguna akhir diminta meluluskannya. Untuk tingkah laku ejen, lihat: ChatGPT Workspace Agents untuk Enterprise dan Business.
Uji aplikasi
Mulakan aliran sambungan daripada ChatGPT sebagai pengguna ujian yang dibenarkan.
Log masuk ke Snowflake dan pilih peranan yang dimaksudkan jika digesa.
Sahkan bahawa ChatGPT menemui alat yang dijangka daripada pelayan MCP.
Jalankan tindakan baca berisiko rendah dahulu, seperti carian atau pertanyaan baca sahaja terhadap data yang diluluskan.
Sahkan keizinan Snowflake menghalang akses di luar peranan dan objek yang diluluskan.
URL pelayan MCP dan tingkah laku OAuth
ChatGPT menyambung kepada URL penuh pelayan MCP yang diurus oleh Snowflake. ChatGPT menggunakan awalan hos Snowflake daripada URL itu untuk menyelesaikan titik akhir OAuth Snowflake.
Jangan tampal URL Snowsight, URL akar akaun Snowflake sahaja, atau mana-mana URL dengan segmen laluan tambahan. URL MCP mesti menyertakan pangkalan data, skema dan laluan pelayan MCP serta mesti sepadan tepat dengan objek Snowflake anda.
Penyelesaian masalah
Pelayan MCP tidak ditemui: semak semula URL penuh pelayan MCP atau medan berasingan untuk awalan hos, pangkalan data, skema dan pelayan.
Tiada alat muncul dalam ChatGPT: sahkan spesifikasi pelayan MCP menyertakan alat dan peranan mempunyai USAGE pada pelayan MCP.
Alat muncul tetapi gagal apabila digunakan: sahkan peranan mempunyai keizinan yang betul pada objek Snowflake asas.
Alat SQL gagal: sahkan nama gudang betul, gudang tersedia, peranan mempunyai USAGE padanya, dan read_only ialah true jika anda mahukan akses baca sahaja.
Kebenaran gagal: sahkan pengguna boleh log masuk ke Snowflake dan menggunakan peranan yang dimaksudkan.
Isu sambungan nama hos: gunakan awalan hos Snowflake yang betul. Nama hos Snowflake dengan garis bawah boleh menyebabkan isu; lebih baik gunakan tanda sempang.