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

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

警告備註請注意，使用 OpenAI 平台需要您與 OpenAI 簽訂商業關係。雖然您在免費試用版可以使用的資料配額可能可讓您完成這些練習，但重要的是，請記住，完成練習將需要您從 OpenAI 取用一些資料量。

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

此範例使用 OpenAI Chat Completions API 連接器設定。

## 開始之前

### 考慮事項

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

[速率限制](https://platform.openai.com/docs/guides/rate-limits)

### 準備

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

* 建立 OpenAI 平台帳戶

* 取得 OpenAI API 金鑰

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

* 為此範例建立個別連線 (OpenAI\_Example\_InteractiveApp)

如需完整詳細資訊，請參閱：[開始使用 OpenAI 平台](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/ac-openai-overview.htm#Getting) 和 [建立連線](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/ac-openai-tutorial.htm#Create)。

## 下載並上傳應用程式

在此下載範例應用程式：

[OpenAI 演示應用程式 - 投訴分析和處理](https://help.qlik.com/zh-TW/cloud-services/tutorials/TutorialExampleOpenAIConnector.zip)

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

互動式 Qlik Sense 應用程式在回應投訴和技術問題時可使用生成式 AI

互動式 Qlik Sense 應用程式在回應投訴和技術問題時可使用生成式 AI

互動式 Qlik SenseQlik Sense 應用程式在回應投訴和技術問題時可使用生成式 AI ![互動式 Qlik Sense 應用程式可使用 OpenAI 以與應用程式資料互動。](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Resources/Images/ui_gen_openai_interactive_app.png)

### 應用程式中有什麼？

應用程式包含小型內嵌資料集，內含客戶在網站上對於提供各種產品之公司的留言。留言已在應用程式開發前手動審閱，以確保其不包含任何 PII 或其他敏感資訊。

我們將會根據我們在應用程式中選取的客戶留言使用 OpenAI 產生樣本回應和嚴重度分析。

資訊備註由 OpenAI 提供的回應無法用來完全取代回應獨特客戶疑慮的行為，但可能有助於產生從哪裡開始處理問題的想法。

## 圖表運算式練習

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

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

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

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

### 範例 1

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

請執行下列動作：

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

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

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

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

   ```
   if( count(distinct [ComplaintText]) = 1, endpoints.ScriptAggrStr('{"RequestType":"endpoint", "endpoint":{"connectionname":"OpenAI_Example_InteractiveApp","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 圖表現在計算對於所選投訴的回應。

Example 1 工作表醒目提示所選客戶投訴，以及 OpenAI 對於如何處理留言的建議

Example 1 工作表醒目提示所選客戶投訴，以及 OpenAI 對於如何處理留言的建議

Example 1Example 1 工作表醒目提示所選客戶投訴，以及 OpenAI 對於如何處理留言的建議 ![互動式 Qlik Sense 應用程式可使用 OpenAI 以與應用程式資料互動。](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Resources/Images/ui_gen_openai_example1_w_selection.png)

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

資訊備註當您準備好移至 Example 2 時，將 `//` 新增回您在上面取消註解的運算式。這可防止運算式在您使用第二個工作表時受到評估。

### 範例 2

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

請執行下列動作：

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

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

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

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

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

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

6. 退出編輯模式。

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

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

Example 2 工作表醒目提示所選客戶投訴，以及 OpenAI 的投訴嚴重度印象

Example 2 工作表醒目提示所選客戶投訴，以及 OpenAI 的投訴嚴重度印象

Example 2Example 2 工作表醒目提示所選客戶投訴，以及 OpenAI 的投訴嚴重度印象 ![互動式 Qlik Sense 應用程式可使用 OpenAI 以與應用程式資料互動。](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Resources/Images/ui_gen_openai_example2_w_selection.png)

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

## 瞭解更多資訊

* [伺服器端延伸語法](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/sse-syntax.htm)