OpenAI 分析連接器 – 互動式範例

此範例可讓您將預先設定的應用程式匯入 Qlik Cloud 中，在此您可以學習如何建立圖表運算式，以控制 OpenAI 資料的使用情況，並在使用者進行應用程式選取時產生回應。

在此範例中，假設您對 Qlik Cloud 分析連接器有基本程度的理解。如需釐清任何關鍵概念，請參閱之前的教學課程範例和其餘的 OpenAI 連接器文件。

此範例使用連接器的「OpenAI 聊天完成 API (GPT-3.5、GPT-4) - 列」設定。

開始之前

考慮事項

OpenAI 對 API 的使用套用速率限制。這表示，根據連接器設定和您使用的 OpenAI 模型，可能會限制您在特定時間間隔內 (例如一分鐘) 可以做出的請求數量。基於此原因，已註解每個圖表運算式，直到您需要使用為止，且一次只能評估一個圖表運算式。請參閱 OpenAI 關於速率限制的文件，瞭解更多資訊。

速率限制

準備

您需要先完成下列步驟，才能完成此範例：

• 建立 OpenAI 平台帳戶

• 取得 OpenAI API 金鑰

• 啟用分析連線功能於 Qlik Cloud

• 為此範例建立獨立連線 (Interactive_Chat_Completions_GPT_3.5_4_Rows)

如需完整詳細資訊，請參閱：開始使用 OpenAI 平台 和 建立連線。

下載並上傳應用程式

在此下載範例應用程式：

OpenAI 演示應用程式 - 投訴分析和處理

將應用程式上傳至 分析 活動中心。

應用程式中有什麼？

應用程式包含小型內嵌資料集，內含客戶在網站上對於提供各種產品之公司的留言。我們將會根據我們在應用程式中選取的客戶留言使用 OpenAI 產生樣本回應和嚴重度分析。

圖表運算式練習

上傳應用程式之後，如有需要，開啟並啟用工作表編輯。您可能需要將工作表設為私人。

範例工作表使用伺服器端延伸語法，以在圖表運算式中使用分析連接器。圖表運算式參考稱為 ComplaintText 和 ProductDescription 的欄位，這顯示在資料模型中。

這些練習的目標是顯示，在圖表參考資料模型中欄位的互動式背景下，您可以如何使用 if 陳述式，以控制計算圖表的頻率。這會降低 OpenAI 導致的費用，因為在此情況下，只會在選取單一欄位中的單一選項時計算圖表。

在這些範例的設定下，一次只會評估一個圖表運算式。這是由於可能適用於 OpenAI 服務的可能速率限制，防止同時評估多個圖表運算式。

範例 1

第一個工作表 Example 1 包含圖表的基本版面配置，顯示一連串客戶投訴的指標。來源資料包括個別客戶投訴，以及他們投訴的產品類型等維度，和滿分 5 分的嚴重度評分。有圖表物件可顯示表格中的所選投訴，並顯示 OpenAI 對於客戶服務部門如何協助客戶處理問題的回應。

請執行下列動作：

1. 開啟第一個工作表 Example 1。

2. 在進階選項編輯模式中，選取標題為 OpenAI Possible Starting Points 的黃色文字與影像圖表。

3. 在屬性面板中，在資料之下，按一下運算式之下的  ，以開啟運算式編輯器。

4. 從運算式開頭移除 //。這會取消運算式的註解，以便評估運算式。運算式現在應為：

   if( count(distinct [ComplaintText]) = 1, endpoints.ScriptAggrStr('{"RequestType":"endpoint", "endpoint":{"connectionname":"Interactive_Chat_Completions_GPT_3.5_4_Rows","column":"choices.message.content"}}', 'draft generic starting points for ways a customer can fix an issue reported with '& [ProductDescription]))
                   

5. 退出編輯模式。

6. 在標題為 Complaints - Reference Table 的表格中，在 ComplaintText 欄中選取單一儲存格值。

OpenAI 圖表現在計算對於所選投訴的回應。

清除選項並嘗試選取另一個投訴。圖表將會透過 OpenAI 對於新選項的回應重新整理。

範例 2

第二個工作表 Example 2 包含與 Example 1 類似的圖表。OpenAI 物件現在設定為提供使用者所選留言的一般印象分析。這提供關於投訴嚴重度的一般詳細資訊，在識別如何排列優先順序或開始處理意見回饋時可能很實用。

請執行下列動作：

1. 若您尚未準備好這麼做，為 Example 1 工作表的 OpenAI 物件將 // 新增回運算式。

2. 開啟第二個工作表 Example 2。

3. 在進階選項編輯模式中，選取標題為 OpenAI Initial Impression 的黃色文字與影像圖表。

4. 在屬性面板中，在資料之下，按一下運算式之下的  ，以開啟運算式編輯器。

5. 從運算式開頭移除 //。這會取消運算式的註解，以便評估運算式。運算式現在應為：

   if( count(distinct [ComplaintText]) = 1, endpoints.ScriptAggrStr('{"RequestType":"endpoint", "endpoint":{"connectionname":"Interactive_Chat_Completions_GPT_3.5_4_Rows","column":"choices.message.content"}}', 'provide a short description of how severe the following customer complaint is: ' & [ComplaintText]))

6. 退出編輯模式。

7. 在標題為 Complaints - Reference Table 的表格中，在 ComplaintText 欄中選取單一儲存格值。

OpenAI 圖表現在計算對於所選投訴的回應。

清除選項並嘗試選取另一個投訴。圖表將會透過 OpenAI 對於新選項的回應重新整理。