Thư viện GPT Actions - Snowflake Direct

Giới thiệu

Trang này cung cấp hướng dẫn & chỉ dẫn cho các nhà phát triển xây dựng Hành động GPT cho một ứng dụng cụ thể. Trước khi tiếp tục, hãy đảm bảo rằng bạn đã làm quen với các thông tin sau:

+ Giới thiệu về Hành động GPT

+ Giới thiệu về Thư viện hành động GPT

+ Ví dụ về việc xây dựng một hành động GPT từ đầu

Hành động GPT cụ thể này cung cấp tổng quan về cách kết nối với Snowflake Data Warehouse. Hành động này lấy câu hỏi của người dùng, quét các bảng có liên quan để thu thập lược đồ dữ liệu, sau đó viết truy vấn SQL để trả lời câu hỏi của người dùng.

Xem thêm: mua tài khoản ChatGPT Plus chính hãng giá rẻ 

Lưu ý: Sách hướng dẫn này trả về một câu lệnh SQL ResultSet , thay vì kết quả đầy đủ không bị giới hạn bởi giới hạn tải trọng json/ứng dụng GPT Actions. Đối với trường hợp sử dụng nâng cao và sản xuất, cần có phần mềm trung gian để trả về tệp CSV. Bạn có thể làm theo hướng dẫn trong sách hướng dẫn GPT Actions - Snowflake Middleware để triển khai luồng này thay thế.

Giá trị + Ví dụ về các trường hợp sử dụng kinh doanh

Giá trị: Người dùng hiện có thể tận dụng khả năng ngôn ngữ tự nhiên của tài khoản ChatGPT 4 để kết nối trực tiếp với Kho dữ liệu của Snowflake.

Các trường hợp sử dụng ví dụ:

+ Các nhà khoa học dữ liệu có thể kết nối với các bảng và chạy phân tích dữ liệu bằng cách sử dụng Phân tích dữ liệu của ChatGPT

+ Người dùng dữ liệu công dân có thể đặt những câu hỏi cơ bản về dữ liệu giao dịch của họ

+ Người dùng có thể thấy rõ hơn dữ liệu của họ và các bất thường tiềm ẩn

Thông tin ứng dụng

Liên kết khóa ứng dụng

Hãy xem qua các liên kết sau từ ứng dụng trước khi bạn bắt đầu:

+ Trang web ứng dụng: https://app.snowflake.com/

+ Tài liệu API ứng dụng: https://docs.snowflake.com/en/developer-guide/sql-api/intro

Điều kiện tiên quyết của ứng dụng

Trước khi bắt đầu, hãy đảm bảo bạn thực hiện các bước sau trong môi trường ứng dụng của mình:

+ + Cung cấp kho dữ liệu Snowflake

+ Đảm bảo rằng người dùng xác thực vào Snowflake qua ChatGPT có quyền truy cập vào cơ sở dữ liệu, lược đồ và bảng có vai trò cần thiết

Các bước ChatGPT

Hướng dẫn tùy chỉnh GPT

Sau khi bạn đã tạo GPT tùy chỉnh, hãy sao chép văn bản bên dưới trong bảng Hướng dẫn. Bạn có thắc mắc không? Hãy xem Ví dụ về Bắt đầu để xem bước này hoạt động chi tiết hơn như thế nào.

**Context**: You are an expert at writing Snowflake SQL queries. A user is going to ask you a question.
**Instructions**:
1. No matter the user's question, start by running `runQuery` operation using this query: "SELECT column_name, table_name, data_type, comment FROM `{database}.INFORMATION_SCHEMA.COLUMNS`" -- Assume warehouse = "", database = "", unless the user provides different values
2. Convert the user's question into a SQL statement that leverages the step above and run the `runQuery` operation on that SQL statement to confirm the query works. Add a limit of 100 rows
3. Now remove the limit of 100 rows and return back the query for the user to see
4. Use the role when querying Snowflake
5. Run each step in sequence. Explain what you are doing in a few sentences, run the action, and then explain what you learned. This will help the user understand the reason behind your workflow.
**Additional Notes**: If the user says "Let's get started", explain that the user can provide a project or dataset, along with a question they want answered. If the user has no ideas, suggest that we have a sample flights dataset they can query - ask if they want you to query that

Sơ đồ OpenAPI

Sau khi bạn đã tạo GPT tùy chỉnh, hãy sao chép văn bản bên dưới trong bảng Hành động. Bạn có thắc mắc không? Hãy xem Ví dụ về Bắt đầu để xem bước này hoạt động chi tiết hơn như thế nào.

openapi: 3.1.0
info: title: Snowflake Statements API version: 1.0.0 description: API for executing statements in Snowflake with specific warehouse and role settings.
servers: - url: 'https://...snowflakecomputing.com/api/v2'
paths: /statements: post: summary: Execute a SQL statement in Snowflake description: This endpoint allows users to execute a SQL statement in Snowflake, specifying the warehouse and roles to use. operationId: runQuery tags: - Statements requestBody: required: true content: application/json: schema: type: object properties: warehouse: type: string description: The name of the Snowflake warehouse to use for the statement execution. role: type: string description: The Snowflake role to assume for the statement execution. statement: type: string description: The SQL statement to execute. required: - warehouse - role - statement responses: '200': description: Successful execution of the SQL statement. content: application/json: schema: type: object properties: status: type: string data: type: object additionalProperties: true '400': description: Bad request, e.g., invalid SQL statement or missing parameters. '401': description: Authentication error, invalid API credentials. '500': description: Internal server error.

Hướng dẫn xác thực

Dưới đây là hướng dẫn về cách thiết lập xác thực với ứng dụng của bên thứ 3 này. Bạn có thắc mắc không? Hãy xem Ví dụ về Bắt đầu để xem bước này hoạt động chi tiết hơn.

Các bước hành động trước

Trước khi thiết lập xác thực trong ChatGPT, vui lòng thực hiện các bước sau trong ứng dụng.

+ Xem lại Tổng quan về Snowflake OAuth: https://docs.snowflake.com/en/user-guide/oauth-snowflake-overview

+ Đi đến Phiếu bài tập về bông tuyết

+ Tạo thông tin xác thực OAuth mới thông qua Tích hợp bảo mật - bạn sẽ cần thông tin xác thực mới cho mỗi ứng dụng OAuth/GPT tùy chỉnh vì URI Chuyển hướng Snowflake được ánh xạ 1-1 tới Tích hợp bảo mật

CREATE SECURITY INTEGRATION CHATGPT_INTEGRATION TYPE = OAUTH ENABLED = TRUE OAUTH_CLIENT = CUSTOM OAUTH_CLIENT_TYPE = 'CONFIDENTIAL' OAUTH_REDIRECT_URI = 'https://oauth.pstmn.io/v1/callback' --- // this is a temporary value while testing your integration. You will replace this with the value your GPT provides OAUTH_ISSUE_REFRESH_TOKENS = TRUE OAUTH_REFRESH_TOKEN_VALIDITY = 7776000;

+ Truy xuất ID máy khách OAuth, URL xác thực và URL mã thông báo của bạn

DESCRIBE SECURITY INTEGRATION CHATGPT_INTEGRATION;

Bạn sẽ tìm thấy thông tin cần thiết trong 3 cột sau:

+ Lấy lại Bí mật máy khách OAuth của bạn

Bạn sẽ tìm thấy Bí mật của khách hàng trong OAUTH_CLIENT_SECRET.

Bây giờ bạn đã sẵn sàng để kiểm tra hành động của mình trong Postman. Khi bạn nhận được phản hồi API thành công ở đó, bạn có thể tiếp tục với Hành động GPT của mình.

Trong ChatGPT

Trong ChatGPT, nhấp vào "Xác thực" và chọn "OAuth". Nhập thông tin bên dưới.

+ ID khách hàng: sử dụng ID khách hàng từ các bước trên

+ Bí mật của khách hàng: sử dụng Bí mật của khách hàng từ các bước trên

+ URL ủy quyền: sử dụng Điểm cuối ủy quyền từ các bước trên

+ URL mã thông báo: sử dụng Điểm cuối mã thông báo từ các bước trên

+ Phạm vi: *

+ Mã thông báo: Mặc định (POST)

+ Phạm vi Snowflake truyền vai trò, nhưng bạn sẽ thấy hành động đó cũng chỉ định vai trò là tham số trong runQuery, do đó Phạm vi là không cần thiết. Bạn có thể chọn truyền vai trò trong phạm vi thay vì tham số hành động nếu điều đó có ý nghĩa hơn đối với GPT 4 của bạn.

Các bước sau hành động

Sau khi thiết lập xác thực trong ChatGPT, hãy làm theo các bước dưới đây trong ứng dụng để hoàn tất Hành động.

+ Sao chép URL gọi lại từ Hành động GPT

+ Cập nhật URI chuyển hướng trong Tích hợp bảo mật của bạn thành URL gọi lại được cung cấp trong ChatGPT.

ALTER SECURITY INTEGRATION CHATGPT_INTEGRATION_DEV SET OAUTH_REDIRECT_URI='https://chat.openai.com/aip//oauth/callback';

Câu hỏi thường gặp & Xử lý sự cố

+ Lỗi URL gọi lại: Nếu bạn gặp lỗi URL gọi lại trong ChatGPT, hãy chú ý đến các Bước sau hành động ở trên. Bạn cần thêm URL gọi lại trực tiếp vào Tích hợp bảo mật của mình để hành động xác thực chính xác

+ Sơ đồ gọi sai kho hoặc cơ sở dữ liệu: Nếu ChatGPT 4 gọi sai kho hoặc cơ sở dữ liệu, hãy cân nhắc cập nhật hướng dẫn của bạn để làm rõ hơn (a) kho/cơ sở dữ liệu nào sẽ được gọi hoặc (b) yêu cầu người dùng cung cấp các thông tin chi tiết chính xác đó trước khi chạy truy vấn