გამოიყენეთ ეს სახელმძღვანელო, თუ ხართ ChatGPT სამუშაო სივრცის ადმინისტრატორი და თქვენი ორგანიზაციისთვის Snowflake აპის შაბლონს აყენებთ. შაბლონი არ არის საბოლოო აპი, რომელსაც წევრები იყენებენ. ეს არის დაყენების პროცესი, რომელიც საჭირო Snowflake კონფიგურაციის მიწოდების შემდეგ სამუშაო სივრცისთვის სპეციფიკურ აპის მონახაზს ქმნის.
Snowflake-ის შემთხვევაში დაყენების უმეტესობა Snowflake-ში ხდება. თქვენ ქმნით Snowflake-ის მიერ მართულ MCP სერვერს, შესაბამის როლს აძლევთ წვდომას MCP სერვერსა და მის საფუძველში არსებულ ობიექტებზე, შემდეგ კი მართული MCP სერვერის URL-ს ან მის კომპონენტურ ველებს ChatGPT შაბლონის დაყენების პროცესში შეიყვანთ. მას შემდეგ, რაც ChatGPT აპის მონახაზს შექმნის, შეგიძლიათ გამოაქვეყნოთ ის და მართოთ, როგორც სამუშაო სივრცის სხვა აპები.
რას აყენებთ
თქვენ ChatGPT-ში ქმნით სამუშაო სივრცისთვის სპეციფიკურ Snowflake აპს. აპი უკავშირდება Snowflake-ის მიერ მართულ MCP სერვერს, რომელიც განსაზღვრავს:
რომელი მოქმედებების გამოყენება შეუძლია ChatGPT-ს; მათ ხელსაწყოები ეწოდება.
Snowflake-ის რომელ მონაცემებსა თუ ობიექტებზე ექნებათ წვდომა ამ ხელსაწყოებს.
Snowflake-ის რომელი როლით უნდა გაიარონ მომხმარებლებმა ავტორიზაცია.
Snowflake-ის რომელი მონაცემთა ბაზა, სქემა და MCP სერვერის სახელი განსაზღვრავს დამაკავშირებლის საბოლოო წერტილს.
ChatGPT-ს შეუძლია მხოლოდ იმ ხელსაწყოების აღმოჩენა და გამოყენება, რომლებიც MCP სერვერმა გამოაჩინა და რომლებიც მომხმარებლის მიერ ავტორიზებული Snowflake როლით არის დაშვებული.
დაწყებამდე
გჭირდებათ:
ChatGPT სამუშაო სივრცის ადმინისტრატორის ან მფლობელის წვდომა.
Snowflake-ზე წვდომა, რომლითაც შესაძლებელია MCP სერვერის ობიექტების შექმნა და ნებართვების მინიჭება.
Snowflake-ის მონაცემთა ბაზა და სქემა, სადაც MCP სერვერი განთავსდება.
გადაწყვეტილება იმის შესახებ, თუ რისი გაკეთების უფლება უნდა ჰქონდეს ChatGPT-ს, მაგალითად Cortex Search, Cortex Analyst, მხოლოდ წაკითხვადი SQL ან კონკრეტული პროცედურა თუ ფუნქცია.
მინიმალური პრივილეგიების მქონე Snowflake როლი, რომელსაც მომხმარებლები აპის ავტორიზაციისას გამოიყენებენ.
Snowflake ანგარიშის ჰოსტის პრეფიქსი, ნებისმიერი რეგიონის ან ღრუბლის სუფიქსის ჩათვლით.
მოსამზადებელი მნიშვნელობები
Snowflake ჰოსტის პრეფიქსი: ყველაფერი, რაც Snowflake ანგარიშის URL-ში .snowflakecomputing.com-მდეა.
მონაცემთა ბაზა: მონაცემთა ბაზა, რომელიც MCP სერვერს შეიცავს.
სქემა: სქემა, რომელიც MCP სერვერს შეიცავს.
MCP სერვერის სახელი: Snowflake MCP სერვერის ობიექტის სახელი.
სრული მართული MCP სერვერის URL, თუ ChatGPT-ის დაყენების ეკრანი URL-ს ითხოვს.
Snowflake როლი: როლი, რომელიც მომხმარებლებმა აპის ავტორიზაციისას უნდა გამოიყენონ.
ხელსაწყოების სია: Snowflake ობიექტები და მოქმედებები, რომელთა გამოყენებაც გსურთ ChatGPT-მ შეძლოს.
გადაწყვიტეთ, რისი გაკეთება შეუძლია ChatGPT-ს
აირჩიეთ მხოლოდ ის შესაძლებლობები, რომელთა გამოჩენაც გსურთ. ხშირი ვარიანტებია:
ძიება Cortex Search-ით, რათა პასუხები ინდექსირებულ Snowflake მონაცემებსა ან კონტენტში მოიძებნოს.
კითხვა-პასუხი Cortex Analyst-ით, დამტკიცებული სემანტიკური ხედის მეშვეობით.
მხოლოდ წაკითხვადი SQL კონტროლირებადი მოთხოვნების წვდომისთვის.
Snowflake Agent, შენახული პროცედურა ან UDF კონკრეტული სამუშაო პროცესებისთვის.
თუ SQL-ს ჩართავთ, დატოვეთ ის მხოლოდ წაკითხვადად, თუ თქვენს ორგანიზაციას ჩაწერის წვდომა არ განუხილავს და დაუმტკიცებია.
Snowflake MCP სერვერის შექმნა
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 Agent-ს, საჭირო ნებართვები ამ ობიექტებისთვისაც მიანიჭეთ.
შეამოწმეთ, რომ Snowflake მზად არის
გაუშვით:
SHOW MCP SERVERS IN SCHEMA CHATGPT_APPS.TOOLS;
შემდეგ გაუშვით:
DESCRIBE MCP SERVER CHATGPT_APPS.TOOLS.CHATGPT_SNOWFLAKE_MCP;
დაადასტურეთ:
სერვერი არსებობს მოსალოდნელ მონაცემთა ბაზასა და სქემაში.
ხელსაწყოების სია ისეთია, როგორიც განიზრახეთ.
თითოეული ხელსაწყოს იდენტიფიკატორი სწორ Snowflake ობიექტზე მიუთითებს.
დამაკავშირებელ როლს MCP სერვერზე USAGE აქვს.
დამაკავშირებელ როლს თითოეულ საფუძველში არსებულ ობიექტზე საჭირო ნებართვები აქვს.
შაბლონის დაყენების დაწყება ChatGPT-ში
ChatGPT-ში გადაერთეთ სამუშაო სივრცეზე, სადაც აპი ხელმისაწვდომი უნდა იყოს.
გახსენით სამუშაო სივრცის პარამეტრები > აპები.
აირჩიეთ Directory.
მოძებნეთ Snowflake.
აირჩიეთ Snowflake აპის შაბლონი და დაიწყეთ დაყენება.
შეიყვანეთ აპის მკაფიო სახელი და აღწერა, მაგალითად Snowflake ან Snowflake - Analytics.
შეიყვანეთ მართული MCP სერვერის დეტალები, რომლებსაც დაყენების პროცესი ითხოვს.
თუ დაყენების ეკრანი სრულ მართული MCP სერვერის URL-ს ითხოვს, გამოიყენეთ ეს ფორმატი:
https://<snowflake_host_prefix>.snowflakecomputing.com/api/v2/databases/{database}/schemas/{schema}/mcp-servers/{server}
თუ დაყენების ეკრანი ცალკეულ ველებს ითხოვს, გამოიყენეთ იგივე მნიშვნელობები ამ URL-დან:
Snowflake ჰოსტის პრეფიქსი.
მონაცემთა ბაზა.
სქემა.
MCP სერვერის სახელი.
აპის მონახაზის შექმნა და გამოქვეყნება
შეინახეთ Snowflake შაბლონის დაყენება ChatGPT-ში.
შექმენით აპის მონახაზი.
გადახედეთ აპის მონახაზის დეტალებს, ავთენტიფიკაციის პარამეტრებსა და ხელმისაწვდომ მოქმედებებს.
როცა მზად იქნება, გამოაქვეყნეთ აპის მონახაზი.
დაადასტურეთ, რომ აპი ჩანს სამუშაო სივრცის პარამეტრები > აპები > ჩართულია-ში.
დააკონფიგურირეთ მომხმარებლის წვდომა იმ როლებისთვის, რომლებმაც ის უნდა გამოიყენონ.
გადახედეთ მოქმედებების კონტროლს გამოჩენილი ხელსაწყოებისთვის.
გადახედეთ აპის ნებართვებს, რათა აირჩიოთ, როდის სთხოვს ChatGPT წევრებს დადასტურებას აპის გამოყენებამდე.
ეს აპის ნებართვები ChatGPT საუბრებზე ვრცელდება. სამუშაო სივრცის აგენტები იყენებენ თითოეული აგენტისთვის განსაზღვრულ კონტროლებს, რომლებსაც აგენტის შემქმნელი აყენებს, რათა განისაზღვროს, რომელი აპის მოქმედებებია ხელმისაწვდომი და როდის სთხოვენ საბოლოო მომხმარებლებს მათ დამტკიცებას. აგენტის ქცევის შესახებ იხილეთ: ChatGPT Workspace Agents for Enterprise and Business.
აპის ტესტირება
დაიწყეთ დაკავშირების პროცესი ChatGPT-დან დაშვებული სატესტო მომხმარებლის სახით.
შედით Snowflake-ში და, მოთხოვნის შემთხვევაში, აირჩიეთ განკუთვნილი როლი.
დაადასტურეთ, რომ ChatGPT MCP სერვერიდან მოსალოდნელ ხელსაწყოებს პოულობს.
პირველ რიგში გაუშვით დაბალი რისკის წაკითხვის მოქმედება, მაგალითად ძიება ან მხოლოდ წაკითხვადი მოთხოვნა დამტკიცებულ მონაცემებზე.
დაადასტურეთ, რომ Snowflake-ის ნებართვები ხელს უშლის წვდომას დამტკიცებული როლისა და ობიექტების ფარგლებს გარეთ.
MCP სერვერის URL და OAuth ქცევა
ChatGPT უკავშირდება სრულ Snowflake-ის მიერ მართულ MCP სერვერის URL-ს. ChatGPT ამ URL-დან Snowflake ჰოსტის პრეფიქსს იყენებს Snowflake OAuth საბოლოო წერტილების მოსაძებნად.
არ ჩასვათ Snowsight URL, მხოლოდ Snowflake ანგარიშის ძირეული URL ან ნებისმიერი URL დამატებითი გზის სეგმენტებით. MCP URL უნდა შეიცავდეს მონაცემთა ბაზის, სქემისა და MCP სერვერის გზას და ზუსტად უნდა ემთხვეოდეს თქვენს Snowflake ობიექტებს.
პრობლემების მოგვარება
MCP სერვერი ვერ მოიძებნა: ხელახლა შეამოწმეთ სრული MCP სერვერის URL ან ცალკეული ჰოსტის პრეფიქსი, მონაცემთა ბაზის, სქემისა და სერვერის ველები.
ChatGPT-ში ხელსაწყოები არ ჩანს: დაადასტურეთ, რომ MCP სერვერის სპეციფიკაცია ხელსაწყოებს შეიცავს და როლს MCP სერვერზე USAGE აქვს.
ხელსაწყო ჩანს, მაგრამ გამოყენებისას შეცდომით სრულდება: დაადასტურეთ, რომ როლს საფუძველში არსებულ Snowflake ობიექტზე სწორი ნებართვა აქვს.
SQL ხელსაწყო შეცდომით სრულდება: დაადასტურეთ, რომ საწყობის სახელი სწორია, საწყობი ხელმისაწვდომია, როლს მასზე USAGE აქვს და read_only არის true, თუ მხოლოდ წაკითხვადი წვდომა გქონდათ განზრახული.
ავტორიზაცია ვერ ხერხდება: დაადასტურეთ, რომ მომხმარებელს შეუძლია Snowflake-ში შესვლა და განკუთვნილი როლის გამოყენება.
ჰოსტის სახელთან დაკავშირების პრობლემა: გამოიყენეთ Snowflake ჰოსტის სწორი პრეფიქსი. ქვედა ტირეების მქონე Snowflake ჰოსტის სახელებმა შეიძლება პრობლემები გამოიწვიოს; უპირატესობა დეფისებს მიანიჭეთ.