# OpenAI 分析コネクタ - インタラクティブな例

この例では、事前構成されたアプリケーションを Qlik Cloud にインポートして、OpenAI のデータの使用を制御するためのチャートの数式を作成する方法と、ユーザーがアプリケーションを選択したときに応答を生成する方法を学習できます。

警告メモOpenAI プラットフォームを使用するには、OpenAI と商業的関係を持つ必要がありますのでご注意ください。無料トライアルで使用できるデータの割り当てでこれらの演習を完了できる場合もありますが、演習を完了するには OpenAI データのある程度の消費が必要となりますのでご了承ください。

この例は、Qlik Cloud の分析コネクタの基本を理解していることを前提としています。主な概念の詳細については、以前のチュートリアルの例や、その他の OpenAI コネクタのドキュメントを参照してください。

この例では、コネクタの OpenAI Chat Completions API 構成を使用します。

## 始める前に:

### 考慮事項

OpenAI は、API の使用にレート制限を適用します。つまり、使用するコネクタ構成と OpenAI モデルによっては、特定の時間間隔 (例: 1 分) 内に実行できるリクエストの回数が制限される可能性があります。このため、各チャートの数式は使用が必要になるまでコメント アウトされており、一度に評価できるのは 1 つのチャートの数式のみです。詳細については、レート制限に関する OpenAI のドキュメントを参照してください。

[レート制限](https://platform.openai.com/docs/guides/rate-limits)

### 準備

この例を完了する前に、次のステップを完了する必要があります。

* OpenAI プラットフォーム アカウントを作成する

* OpenAI API キーを取得する

* 分析接続機能を有効にする Qlik Cloud

* この例では別の接続を作成します (OpenAI\_Example\_InteractiveApp)

詳細については、次を参照してください。[OpenAI プラットフォームを使い始める](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/ac-openai-overview.htm#Getting) および [接続の作成](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/ac-openai-tutorial.htm#Create)。

## アプリケーションをダウンロードおよびアップロードする

サンプルアプリケーションは、こちらからダウンロードしてください。

[OpenAI デモ アプリ - 苦情の分析と処理](https://help.qlik.com/ja-JP/cloud-services/tutorials/TutorialExampleOpenAIConnector.zip)

アプリケーションを 分析 アクティビティ センターにアップロードします。

苦情や技術的な問題への応答に生成 AI を使用するためのインタラクティブな Qlik Sense アプリケーション

苦情や技術的な問題への応答に生成 AI を使用するためのインタラクティブな Qlik Sense アプリケーション

苦情や技術的な問題への応答に生成 AI を使用するためのインタラクティブな Qlik SenseQlik Sense アプリケーション ![OpenAI を使用してアプリ データを操作するためのインタラクティブ Qlik Sense アプリ。](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Resources/Images/ui_gen_openai_interactive_app.png)

### アプリケーションには何が含まれていますか?

このアプリケーションには、さまざまな製品を提供する企業のウェブサイト上の顧客のコメントを含む小さなインライン データセットが含まれています。コメントはアプリケーション開発前に手動で確認され、個人情報やその他の機密情報が含まれていないことが確認されています。

OpenAI を使用して、アプリケーションで選択した顧客のコメントに基づいてサンプル応答と重大度分析を生成します。

情報メモOpenAI によって提供される応答は、顧客固有の懸念に応答する行動に完全に置き換えるために使用されるものではありませんが、問題にどこから対処すればよいかのアイデアを生み出すのに役立つ可能性があります。

## チャートの数式の演習

アプリケーションをアップロードした後、アプリを開き、必要に応じてシートの編集を有効にします。シートをプライベートにする必要がある場合があります。

サンプル シートでは、サーバー サイド エクステンション構文を使用して、チャートの数式で分析コネクタを使用します。チャートの数式は、データ モデルに表示される ComplaintText および ProductDescription という項目を参照します。

これらの演習の目的は、チャートがデータ モデル内の項目を参照するインタラクティブな設定で if ステートメントを使用して、チャートの計算頻度を制御する方法を示すことです。この場合、チャートは 1 つの項目で 1 つの選択が行われた場合にのみ計算されるため、OpenAI から発生するコストを削減できます。

これらの例は、一度に 1 つのチャートの数式のみを評価できるように設定されています。これは、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 の提案 ![OpenAI を使用してアプリ データを操作するためのインタラクティブ Qlik Sense アプリ。](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Resources/Images/ui_gen_openai_example1_w_selection.png)

選択をクリアして、別の苦情を選択してください。チャートは、新しい選択に対する OpenAI の応答で更新されます。

情報メモ Example 2 に移行する準備ができたら、上でコメント解除した数式に `//` を追加します。こうすることで、2 番目のシートを使用するときに数式が評価されなくなります。

### 例 2

2 番目のシートの Example 2 には、Example 1 と同様のチャートが含まれています。OpenAI オブジェクトは、ユーザーが選択したコメントの一般的な印象分析を提供するように構成されています。これにより、苦情の深刻さに関する一般的な詳細が提供され、フィードバックの優先順位や対処の開始方法を特定するのに役立つ場合があります。

次の手順を実行します。

1. まだ追加していない場合は、Example 1 シートの OpenAI オブジェクトの数式に `//` を追加してください。

2. 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 の印象 ![OpenAI を使用してアプリ データを操作するためのインタラクティブ Qlik Sense アプリ。](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Resources/Images/ui_gen_openai_example2_w_selection.png)

選択をクリアして、別の苦情を選択してください。チャートは、新しい選択に対する OpenAI の応答で更新されます。

## 詳細を見る

* [サーバーサイド拡張構文](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/sse-syntax.htm)