ใช้คู่มือนี้หากคุณเป็นผู้ดูแลเวิร์กสเปซ ChatGPT ที่กำลังตั้งค่าเทมเพลตแอป Snowflake สำหรับองค์กรของคุณ เทมเพลตไม่ใช่แอปสุดท้ายที่สมาชิกใช้งาน แต่เป็นโฟลว์การตั้งค่าที่สร้างแอปฉบับร่างเฉพาะเวิร์กสเปซหลังจากที่คุณระบุการกำหนดค่า Snowflake ที่จำเป็นแล้ว

สำหรับ Snowflake การตั้งค่าส่วนใหญ่จะเกิดขึ้นใน Snowflake คุณสร้างเซิร์ฟเวอร์ MCP ที่ Snowflake จัดการ ให้สิทธิ์การเข้าถึงแก่บทบาทที่เหมาะสมไปยังเซิร์ฟเวอร์ MCP และออบเจ็กต์พื้นฐานของเซิร์ฟเวอร์นั้น จากนั้นป้อน URL ของเซิร์ฟเวอร์ MCP ที่จัดการหรือฟิลด์องค์ประกอบของ URL นั้นในโฟลว์การตั้งค่าเทมเพลต ChatGPT หลังจาก ChatGPT สร้างแอปฉบับร่างแล้ว คุณสามารถเผยแพร่และจัดการแอปนั้นได้เหมือนกับแอปเวิร์กสเปซอื่นๆ

สิ่งที่คุณกำลังตั้งค่า

คุณกำลังสร้างแอป Snowflake เฉพาะเวิร์กสเปซใน ChatGPT แอปจะเชื่อมต่อกับเซิร์ฟเวอร์ MCP ที่ Snowflake จัดการ ซึ่งกำหนดสิ่งต่อไปนี้:

• การดำเนินการที่ ChatGPT สามารถใช้ได้ ซึ่งเรียกว่าเครื่องมือ

• ข้อมูลหรือออบเจ็กต์ Snowflake ที่เครื่องมือเหล่านั้นสามารถเข้าถึงได้

• บทบาท Snowflake ที่ผู้ใช้ควรใช้ในการให้สิทธิ์

• ฐานข้อมูล Snowflake, Schema และชื่อเซิร์ฟเวอร์ MCP ที่ระบุ endpoint ของตัวเชื่อมต่อ

ChatGPT สามารถค้นพบและใช้ได้เฉพาะเครื่องมือที่เซิร์ฟเวอร์ MCP เปิดเผยและบทบาท Snowflake ที่ผู้ใช้ให้สิทธิ์อนุญาตไว้เท่านั้น

ก่อนเริ่มต้น

คุณต้องมี:

• สิทธิ์ผู้ดูแลหรือเจ้าของเวิร์กสเปซ ChatGPT

• สิทธิ์เข้าถึง Snowflake ที่สามารถสร้างออบเจ็กต์เซิร์ฟเวอร์ MCP และให้สิทธิ์ได้

• ฐานข้อมูลและ Schema ของ Snowflake ที่เซิร์ฟเวอร์ MCP จะอยู่

• การตัดสินใจว่า ChatGPT ควรได้รับอนุญาตให้ทำอะไรได้บ้าง เช่น Cortex Search, Cortex Analyst, SQL แบบอ่านอย่างเดียว หรือขั้นตอนหรือฟังก์ชันเฉพาะ

• บทบาท Snowflake แบบสิทธิ์น้อยที่สุดที่ผู้ใช้จะใช้เมื่อให้สิทธิ์แอป

• คำนำหน้าโฮสต์ของบัญชี Snowflake รวมถึงส่วนต่อท้ายของภูมิภาคหรือคลาวด์ใดๆ

ค่าที่ต้องเตรียม

• คำนำหน้าโฮสต์ Snowflake: ทุกอย่างที่อยู่ก่อน .snowflakecomputing.com ใน URL บัญชี Snowflake

• ฐานข้อมูล: ฐานข้อมูลที่มีเซิร์ฟเวอร์ MCP

• Schema: Schema ที่มีเซิร์ฟเวอร์ MCP

• ชื่อเซิร์ฟเวอร์ MCP: ชื่อออบเจ็กต์เซิร์ฟเวอร์ MCP ของ Snowflake

• URL แบบเต็มของเซิร์ฟเวอร์ MCP ที่จัดการ หากหน้าจอตั้งค่า ChatGPT ขอ URL

• บทบาท Snowflake: บทบาทที่ผู้ใช้ควรใช้เมื่อให้สิทธิ์แอป

• รายการเครื่องมือ: ออบเจ็กต์และการดำเนินการของ Snowflake ที่คุณต้องการให้ ChatGPT ใช้

ตัดสินใจว่า ChatGPT ทำอะไรได้บ้าง

เลือกเฉพาะความสามารถที่คุณต้องการเปิดเผย ตัวเลือกทั่วไปได้แก่:

• ค้นหาด้วย Cortex Search เพื่อหาคำตอบในข้อมูลหรือเนื้อหา Snowflake ที่ทำดัชนีไว้

• ถาม-ตอบด้วย Cortex Analyst ผ่านมุมมองเชิงความหมายที่ได้รับอนุมัติ

• SQL แบบอ่านอย่างเดียวสำหรับการเข้าถึงคำค้นหาที่ควบคุมได้

• Snowflake Agent, stored procedure หรือ UDF สำหรับเวิร์กโฟลว์เฉพาะ

หากคุณเปิดใช้ SQL ให้คงไว้เป็นแบบอ่านอย่างเดียว เว้นแต่องค์กรของคุณได้ตรวจสอบและอนุมัติสิทธิ์การเขียนแล้ว

สร้างเซิร์ฟเวอร์ MCP ของ Snowflake

ใน Snowflake ให้ลงชื่อเข้าใช้ด้วยบทบาทที่สามารถสร้างเซิร์ฟเวอร์ MCP และให้สิทธิ์การเข้าถึงได้ เปิดเวิร์กชีตในฐานข้อมูลและ Schema ที่ควรสร้างเซิร์ฟเวอร์ MCP

สร้างเซิร์ฟเวอร์ MCP ที่แสดงเฉพาะเครื่องมือที่ ChatGPT ควรใช้ แทนที่ชื่อออบเจ็กต์ด้วยชื่อฐานข้อมูล, Schema, บริการ, มุมมอง, คลังสินค้า และเซิร์ฟเวอร์ 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 ที่ผู้ใช้จะใช้ในการให้สิทธิ์ จากนั้นให้บทบาทนั้นเข้าถึงฐานข้อมูล, Schema, เซิร์ฟเวอร์ 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 เปิดเผย semantic view, UDF, stored procedure หรือ Cortex Agent ให้ให้สิทธิ์ที่จำเป็นสำหรับออบเจ็กต์เหล่านั้นด้วย

ตรวจสอบว่า Snowflake พร้อมใช้งาน

เรียกใช้:

SHOW MCP SERVERS IN SCHEMA CHATGPT_APPS.TOOLS;

จากนั้นเรียกใช้:

DESCRIBE MCP SERVER CHATGPT_APPS.TOOLS.CHATGPT_SNOWFLAKE_MCP;

ยืนยัน:

• เซิร์ฟเวอร์มีอยู่ในฐานข้อมูลและ Schema ที่คาดไว้

• รายการเครื่องมือเป็นไปตามที่คุณต้องการ

• ตัวระบุเครื่องมือแต่ละรายการชี้ไปยังออบเจ็กต์ Snowflake ที่ถูกต้อง

• บทบาทที่เชื่อมต่อมี USAGE บนเซิร์ฟเวอร์ MCP

• บทบาทที่เชื่อมต่อมีสิทธิ์ที่จำเป็นบนออบเจ็กต์พื้นฐานแต่ละรายการ

เริ่มตั้งค่าเทมเพลตใน ChatGPT

1. ใน ChatGPT ให้สลับไปยังเวิร์กสเปซที่ควรมีแอปให้ใช้งาน

2. เปิด การตั้งค่าเวิร์กสเปซ > แอป

3. เลือก ไดเรกทอรี

4. ค้นหา Snowflake

5. เลือกเทมเพลตแอป Snowflake และเริ่มการตั้งค่า

6. ป้อนชื่อและคำอธิบายแอปที่ชัดเจน เช่น Snowflake หรือ Snowflake - Analytics

7. ป้อนรายละเอียดเซิร์ฟเวอร์ MCP ที่จัดการซึ่งโฟลว์การตั้งค่าขอ

หากหน้าจอตั้งค่าขอ URL แบบเต็มของเซิร์ฟเวอร์ MCP ที่จัดการ ให้ใช้รูปแบบนี้:

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

หากหน้าจอตั้งค่าขอฟิลด์แยกต่างหาก ให้ใช้ค่าเดียวกันจาก URL นั้น:

• คำนำหน้าโฮสต์ Snowflake

• ฐานข้อมูล

• Schema

• ชื่อเซิร์ฟเวอร์ MCP

สร้างและเผยแพร่แอปฉบับร่าง

1. บันทึกการตั้งค่าเทมเพลต Snowflake ใน ChatGPT

2. สร้างแอปฉบับร่าง

3. ตรวจสอบรายละเอียดแอปฉบับร่าง การตั้งค่าการยืนยันตัวตน และการดำเนินการที่มีอยู่

4. เผยแพร่แอปฉบับร่างเมื่อพร้อม

5. ยืนยันว่าแอปปรากฏใน การตั้งค่าเวิร์กสเปซ > แอป > เปิดใช้งานแล้ว

6. กำหนดค่า การเข้าถึงของผู้ใช้ สำหรับบทบาทที่ควรใช้แอปนี้

7. ตรวจสอบ การควบคุมการดำเนินการ สำหรับเครื่องมือที่เปิดเผย

8. ตรวจสอบ สิทธิ์ของแอป เพื่อเลือกช่วงเวลาที่ ChatGPT จะถามสมาชิกก่อนใช้แอป

สิทธิ์ของแอปเหล่านี้มีผลกับการสนทนาใน ChatGPT เอเจนต์ของเวิร์กสเปซใช้การควบคุมรายเอเจนต์ที่ผู้สร้างเอเจนต์ตั้งไว้ เพื่อกำหนดว่าการดำเนินการของแอปใดบ้างที่พร้อมใช้งาน และเมื่อใดที่ผู้ใช้ปลายทางจะถูกขอให้อนุมัติ สำหรับพฤติกรรมของเอเจนต์ โปรดดู: ChatGPT Workspace Agents สำหรับ Enterprise และ Business

ทดสอบแอป

1. เริ่มโฟลว์การเชื่อมต่อจาก ChatGPT ในฐานะผู้ใช้ทดสอบที่ได้รับอนุญาต

2. ลงชื่อเข้าใช้ Snowflake และเลือกบทบาทที่ต้องการหากมีข้อความแจ้ง

3. ยืนยันว่า ChatGPT ค้นพบเครื่องมือที่คาดไว้จากเซิร์ฟเวอร์ MCP

4. เริ่มด้วยการดำเนินการอ่านที่มีความเสี่ยงต่ำ เช่น การค้นหาหรือคำค้นหาแบบอ่านอย่างเดียวกับข้อมูลที่ได้รับอนุมัติ

5. ยืนยันว่าสิทธิ์ของ Snowflake ป้องกันการเข้าถึงนอกบทบาทและออบเจ็กต์ที่ได้รับอนุมัติ

URL ของเซิร์ฟเวอร์ MCP และลักษณะการทำงานของ OAuth

ChatGPT เชื่อมต่อกับ URL แบบเต็มของเซิร์ฟเวอร์ MCP ที่ Snowflake จัดการ ChatGPT ใช้คำนำหน้าโฮสต์ Snowflake จาก URL นั้นเพื่อระบุ endpoint ของ Snowflake OAuth

อย่าวาง URL ของ Snowsight, URL รากของบัญชี Snowflake เพียงอย่างเดียว หรือ URL ใดๆ ที่มีเซกเมนต์พาธเพิ่มเติม URL ของ MCP ต้องมีพาธของฐานข้อมูล, Schema และเซิร์ฟเวอร์ MCP และต้องตรงกับออบเจ็กต์ Snowflake ของคุณทุกประการ

การแก้ไขปัญหา

• ไม่พบเซิร์ฟเวอร์ MCP: ตรวจสอบ URL แบบเต็มของเซิร์ฟเวอร์ MCP อีกครั้ง หรือฟิลด์คำนำหน้าโฮสต์ ฐานข้อมูล Schema และเซิร์ฟเวอร์ที่แยกกัน

• ไม่มีเครื่องมือปรากฏใน ChatGPT: ยืนยันว่า spec ของเซิร์ฟเวอร์ MCP มีเครื่องมือ และบทบาทมี USAGE บนเซิร์ฟเวอร์ MCP

• เครื่องมือปรากฏแต่ล้มเหลวเมื่อใช้งาน: ยืนยันว่าบทบาทมีสิทธิ์ที่ถูกต้องบนออบเจ็กต์ Snowflake พื้นฐาน

• เครื่องมือ SQL ล้มเหลว: ยืนยันว่าชื่อคลังสินค้าถูกต้อง คลังสินค้าพร้อมใช้งาน บทบาทมี USAGE บนคลังสินค้านั้น และ read_only เป็น true หากคุณตั้งใจให้เข้าถึงแบบอ่านอย่างเดียว

• การให้สิทธิ์ล้มเหลว: ยืนยันว่าผู้ใช้สามารถลงชื่อเข้าใช้ Snowflake และใช้บทบาทที่ต้องการได้

• ปัญหาการเชื่อมต่อชื่อโฮสต์: ใช้คำนำหน้าโฮสต์ Snowflake ที่ถูกต้อง ชื่อโฮสต์ Snowflake ที่มีขีดล่างอาจทำให้เกิดปัญหาได้ ควรใช้ขีดกลางแทน