اگر مدیر فضای کاری ChatGPT هستید و قالب برنامه Snowflake را برای سازمان خود راهاندازی میکنید، از این راهنما استفاده کنید. قالب، برنامه نهاییای نیست که اعضا استفاده میکنند. این یک جریان راهاندازی است که پس از ارائه پیکربندی لازم Snowflake، یک برنامه پیشنویس مخصوص فضای کاری ایجاد میکند.
برای Snowflake، بیشتر مراحل راهاندازی در Snowflake انجام میشود. شما یک سرور MCP مدیریتشده توسط Snowflake ایجاد میکنید، به نقش مناسب برای سرور MCP و اشیای زیربنایی آن دسترسی میدهید، سپس URL سرور MCP مدیریتشده یا فیلدهای مؤلفه آن را در جریان راهاندازی قالب ChatGPT وارد میکنید. پس از اینکه ChatGPT برنامه پیشنویس را ایجاد کرد، میتوانید آن را منتشر کنید و مانند سایر برنامههای فضای کاری مدیریت کنید.
چیزی که در حال راهاندازی آن هستید
شما در ChatGPT یک برنامه Snowflake مخصوص فضای کاری ایجاد میکنید. این برنامه به یک سرور MCP مدیریتشده توسط Snowflake وصل میشود که موارد زیر را تعریف میکند:
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 اشاره میکند.
نقش اتصالدهنده روی سرور MCP دارای USAGE است.
نقش اتصالدهنده مجوزهای لازم را روی هر شیء زیربنایی دارد.
شروع راهاندازی قالب در 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 کامل سرور MCP مدیریتشده توسط Snowflake وصل میشود. ChatGPT از پیشوند میزبان Snowflake در آن URL برای حل نقاط پایان OAuth در Snowflake استفاده میکند.
URL مربوط به Snowsight، URL ریشه حساب Snowflake بهتنهایی، یا هر URL دارای بخشهای مسیر اضافی را جایگذاری نکنید. URL سرور MCP باید شامل مسیر پایگاه داده، الگو و سرور MCP باشد و دقیقاً با اشیای Snowflake شما مطابقت داشته باشد.
عیبیابی
سرور MCP پیدا نشد: URL کامل سرور MCP یا فیلدهای جداگانه پیشوند میزبان، پایگاه داده، الگو و سرور را دوباره بررسی کنید.
هیچ ابزاری در ChatGPT ظاهر نمیشود: تأیید کنید مشخصات سرور MCP شامل ابزارها است و نقش روی سرور MCP دارای USAGE است.
ابزاری ظاهر میشود اما هنگام استفاده شکست میخورد: تأیید کنید نقش روی شیء زیربنایی Snowflake مجوز درست را دارد.
ابزار SQL شکست میخورد: تأیید کنید نام انبار درست است، انبار در دسترس است، نقش روی آن دارای USAGE است و اگر دسترسی فقط خواندنی مد نظر شما بوده، read_only برابر true است.
مجوزدهی شکست میخورد: تأیید کنید کاربر میتواند وارد Snowflake شود و از نقش مورد نظر استفاده کند.
مشکل اتصال نام میزبان: از پیشوند میزبان درست Snowflake استفاده کنید. نامهای میزبان Snowflake که زیرخط دارند میتوانند مشکل ایجاد کنند؛ خط تیره را ترجیح دهید.