Sử dụng hướng dẫn này nếu bạn là quản trị viên không gian làm việc ChatGPT đang thiết lập mẫu ứng dụng Snowflake cho tổ chức của mình. Mẫu không phải là ứng dụng cuối cùng mà thành viên sử dụng. Đó là một luồng thiết lập tạo ứng dụng nháp riêng cho không gian làm việc sau khi bạn cung cấp cấu hình Snowflake bắt buộc.
Đối với Snowflake, hầu hết quá trình thiết lập diễn ra trong Snowflake. Bạn tạo một máy chủ MCP do Snowflake quản lý, cấp quyền truy cập của vai trò phù hợp vào máy chủ MCP và các đối tượng bên dưới, rồi nhập URL máy chủ MCP được quản lý hoặc các trường thành phần của URL đó trong luồng thiết lập mẫu ChatGPT. Sau khi ChatGPT tạo ứng dụng nháp, bạn có thể phát hành và quản lý ứng dụng đó như các ứng dụng không gian làm việc khác.
Bạn đang thiết lập gì
Bạn đang tạo một ứng dụng Snowflake riêng cho không gian làm việc trong ChatGPT. Ứng dụng kết nối với một máy chủ MCP do Snowflake quản lý, nơi xác định:
Những hành động mà ChatGPT có thể dùng, được gọi là công cụ.
Những dữ liệu hoặc đối tượng Snowflake mà các công cụ đó có thể truy cập.
Vai trò Snowflake mà người dùng nên dùng để ủy quyền.
Cơ sở dữ liệu, lược đồ và tên máy chủ MCP của Snowflake dùng để xác định điểm cuối trình kết nối.
ChatGPT chỉ có thể phát hiện và dùng các công cụ do máy chủ MCP cung cấp và được vai trò Snowflake mà người dùng ủy quyền cho phép.
Trước khi bắt đầu
Bạn cần:
Quyền truy cập quản trị viên hoặc chủ sở hữu không gian làm việc ChatGPT.
Quyền truy cập Snowflake có thể tạo đối tượng máy chủ MCP và cấp quyền.
Cơ sở dữ liệu và lược đồ Snowflake nơi máy chủ MCP sẽ tồn tại.
Quyết định về những gì ChatGPT được phép làm, chẳng hạn như Cortex Search, Cortex Analyst, SQL chỉ đọc hoặc một thủ tục hay hàm cụ thể.
Một vai trò Snowflake có đặc quyền tối thiểu mà người dùng sẽ dùng khi ủy quyền cho ứng dụng.
Tiền tố máy chủ tài khoản Snowflake, bao gồm mọi hậu tố vùng hoặc đám mây.
Giá trị cần chuẩn bị
Tiền tố máy chủ Snowflake: mọi thứ đứng trước .snowflakecomputing.com trong URL tài khoản Snowflake.
Cơ sở dữ liệu: cơ sở dữ liệu chứa máy chủ MCP.
Lược đồ: lược đồ chứa máy chủ MCP.
Tên máy chủ MCP: tên đối tượng máy chủ MCP của Snowflake.
URL đầy đủ của máy chủ MCP được quản lý, nếu màn hình thiết lập ChatGPT yêu cầu URL.
Vai trò Snowflake: vai trò mà người dùng nên dùng khi ủy quyền cho ứng dụng.
Danh sách công cụ: các đối tượng và hành động Snowflake mà bạn muốn ChatGPT dùng.
Quyết định ChatGPT có thể làm gì
Chỉ chọn các chức năng bạn muốn cung cấp. Các tùy chọn phổ biến gồm:
Tìm kiếm bằng Cortex Search để tìm câu trả lời trong dữ liệu hoặc nội dung Snowflake đã lập chỉ mục.
Hỏi đáp với Cortex Analyst thông qua một chế độ xem ngữ nghĩa đã được phê duyệt.
SQL chỉ đọc để truy cập truy vấn có kiểm soát.
Một Tác nhân Snowflake, thủ tục được lưu trữ hoặc UDF cho các quy trình công việc cụ thể.
Nếu bạn bật SQL, hãy giữ ở chế độ chỉ đọc trừ khi tổ chức của bạn đã xem xét và phê duyệt quyền ghi.
Tạo máy chủ MCP Snowflake
Trong Snowflake, hãy đăng nhập bằng vai trò có thể tạo máy chủ MCP và cấp quyền truy cập. Mở một trang tính trong cơ sở dữ liệu và lược đồ nơi máy chủ MCP cần được tạo.
Tạo máy chủ MCP chỉ liệt kê các công cụ mà ChatGPT nên dùng. Thay tên đối tượng bằng cơ sở dữ liệu, lược đồ, dịch vụ, chế độ xem, warehouse và tên máy chủ Snowflake của riêng bạn.
Ví dụ:
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" $$;
Tên công cụ nên ổn định và mang tính mô tả để ChatGPT có thể chọn đúng công cụ. Việc tạo máy chủ MCP không tự động cấp quyền truy cập vào các đối tượng Snowflake bên dưới.
Cấp đúng quyền Snowflake
Chọn vai trò Snowflake mà người dùng sẽ dùng để ủy quyền, rồi cấp cho vai trò đó quyền truy cập vào cơ sở dữ liệu, lược đồ, máy chủ MCP và mọi đối tượng bên dưới mà các công cụ sử dụng.
Ví dụ:
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;
Nếu máy chủ MCP cung cấp chế độ xem ngữ nghĩa, UDF, thủ tục được lưu trữ hoặc Cortex Agent, hãy cấp cả các quyền cần thiết cho những đối tượng đó.
Xác minh Snowflake đã sẵn sàng
Chạy:
SHOW MCP SERVERS IN SCHEMA CHATGPT_APPS.TOOLS;
Sau đó chạy:
DESCRIBE MCP SERVER CHATGPT_APPS.TOOLS.CHATGPT_SNOWFLAKE_MCP;
Xác nhận:
Máy chủ tồn tại trong cơ sở dữ liệu và lược đồ mong đợi.
Danh sách công cụ đúng như bạn dự định.
Mỗi mã định danh công cụ trỏ đến đúng đối tượng Snowflake.
Vai trò kết nối có USAGE trên máy chủ MCP.
Vai trò kết nối có các quyền cần thiết trên từng đối tượng bên dưới.
Bắt đầu thiết lập mẫu trong ChatGPT
Trong ChatGPT, chuyển sang không gian làm việc nơi ứng dụng cần khả dụng.
Mở Cài đặt không gian làm việc > Ứng dụng.
Chọn Thư mục.
Tìm kiếm Snowflake.
Chọn mẫu ứng dụng Snowflake và bắt đầu thiết lập.
Nhập tên và mô tả ứng dụng rõ ràng, chẳng hạn như Snowflake hoặc Snowflake - Analytics.
Nhập chi tiết máy chủ MCP được quản lý mà luồng thiết lập yêu cầu.
Nếu màn hình thiết lập yêu cầu URL đầy đủ của máy chủ MCP được quản lý, hãy dùng định dạng này:
https://<snowflake_host_prefix>.snowflakecomputing.com/api/v2/databases/{database}/schemas/{schema}/mcp-servers/{server}
Nếu màn hình thiết lập yêu cầu các trường riêng, hãy dùng cùng các giá trị từ URL đó:
Tiền tố máy chủ Snowflake.
Cơ sở dữ liệu.
Lược đồ.
Tên máy chủ MCP.
Tạo và phát hành ứng dụng nháp
Lưu thiết lập mẫu Snowflake trong ChatGPT.
Tạo ứng dụng nháp.
Xem lại chi tiết ứng dụng nháp, cài đặt xác thực và các hành động có sẵn.
Phát hành ứng dụng nháp khi đã sẵn sàng.
Xác nhận ứng dụng xuất hiện trong Cài đặt không gian làm việc > Ứng dụng > Đã bật.
Cấu hình Quyền truy cập của người dùng cho các vai trò cần dùng ứng dụng.
Xem lại Kiểm soát hành động cho các công cụ được cung cấp.
Xem lại Quyền ứng dụng để chọn thời điểm ChatGPT hỏi thành viên trước khi dùng ứng dụng.
Các quyền ứng dụng này áp dụng cho cuộc trò chuyện ChatGPT. Tác nhân trong không gian làm việc dùng các chế độ kiểm soát theo từng tác nhân do người tạo tác nhân đặt để xác định những hành động ứng dụng nào khả dụng và khi nào người dùng cuối được yêu cầu phê duyệt chúng. Để biết hành vi của tác nhân, xem: Tác nhân trong không gian làm việc ChatGPT cho Enterprise và Business.
Kiểm thử ứng dụng
Bắt đầu luồng kết nối từ ChatGPT với tư cách người dùng thử nghiệm được phép.
Đăng nhập vào Snowflake và chọn vai trò dự định nếu được nhắc.
Xác nhận rằng ChatGPT phát hiện các công cụ mong đợi từ máy chủ MCP.
Trước tiên, chạy một hành động đọc rủi ro thấp, chẳng hạn như tìm kiếm hoặc truy vấn chỉ đọc trên dữ liệu đã được phê duyệt.
Xác nhận quyền Snowflake ngăn truy cập bên ngoài vai trò và đối tượng đã được phê duyệt.
URL máy chủ MCP và hành vi OAuth
ChatGPT kết nối với URL đầy đủ của máy chủ MCP do Snowflake quản lý. ChatGPT dùng tiền tố máy chủ Snowflake từ URL đó để phân giải các điểm cuối OAuth của Snowflake.
Không dán URL Snowsight, chỉ URL gốc của tài khoản Snowflake hoặc bất kỳ URL nào có thêm phân đoạn đường dẫn. URL MCP phải bao gồm cơ sở dữ liệu, lược đồ và đường dẫn máy chủ MCP, đồng thời phải khớp chính xác với các đối tượng Snowflake của bạn.
Khắc phục sự cố
Không tìm thấy máy chủ MCP: kiểm tra lại URL đầy đủ của máy chủ MCP hoặc các trường riêng về tiền tố máy chủ, cơ sở dữ liệu, lược đồ và máy chủ.
Không có công cụ nào xuất hiện trong ChatGPT: xác nhận thông số kỹ thuật của máy chủ MCP có bao gồm công cụ và vai trò có USAGE trên máy chủ MCP.
Một công cụ xuất hiện nhưng không hoạt động khi dùng: xác nhận vai trò có đúng quyền trên đối tượng Snowflake bên dưới.
Công cụ SQL không hoạt động: xác nhận tên warehouse là chính xác, warehouse khả dụng, vai trò có USAGE trên đó và read_only là true nếu bạn dự định chỉ cho phép truy cập chỉ đọc.
Ủy quyền không thành công: xác nhận người dùng có thể đăng nhập vào Snowflake và dùng vai trò dự định.
Sự cố kết nối tên máy chủ: dùng đúng tiền tố máy chủ Snowflake. Tên máy chủ Snowflake có dấu gạch dưới có thể gây sự cố; nên dùng dấu gạch nối.