# チュートリアル – Qlik Cloud での OpenAI 分析コネクタの使用

このチュートリアルでは、OpenAI 分析コネクタを使用して、生成 AI モデルからのコンテキスト深度で Qlik Sense アプリケーションを強化する方法について説明します。

OpenAI の分析接続をデータ モデルに直接統合し、それによって生成されたデータをアプリケーションに事前にロードできます。または、チャートの数式で使用することもできます。このチュートリアルでは、コネクタを使用するための設定方法と、Qlik Cloud でコネクタへの接続を作成する方法について説明します。さらに、機能を Qlik Sense アプリケーションに組み込む方法について、基本的な例を用いて紹介します。

このチュートリアルの例は、Azure OpenAI 分析コネクタの操作にも使用できます。

OpenAI コネクタを使用して分析コンテンツを強化する方法を示すインタラクティブ シート

OpenAI コネクタを使用して分析コンテンツを強化する方法を示すインタラクティブ シート

OpenAIOpenAI コネクタを使用して分析コンテンツを強化する方法を示すインタラクティブ シート ![OpenAI を使用してアプリ データを操作するためのインタラクティブ Qlik Sense アプリ。](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Resources/Images/ui_gen_openai_example1_w_selection.png)

## OpenAI プラットフォーム アカウントと Qlik Cloud 環境の設定

OpenAI 分析コネクタを使用する前に、いくつかのステップを完了する必要があります。このオプションは以下のとおりです:

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

* OpenAI API キーを取得する

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

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

情報メモ代わりに Azure OpenAI 分析コネクタを使用している場合は、Azure OpenAI コネクタのドキュメントに記載されている設定に従ってください。「[Azure OpenAI 接続の作成](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/ac-azure-openai-create.htm)」を参照してください。

## 接続の作成

両方とも OpenAI Chat Completions API 構成を使用して、OpenAI 分析コネクタへの 2 つの接続を作成します。接続を作成したら、ロード スクリプトやチャート オブジェクトを通して、OpenAI プラットフォームを直接操作できます。

接続は次のように使用されます。

* 最初の接続: [例 – OpenAI 分析コネクタのロード スクリプトとチャートの数式を作成する](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/ac-openai-tutorial-example-3.htm) に使用されます。

* 2 番目の接続: [OpenAI 分析コネクタ - インタラクティブな例](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/ac-openai-tutorial-example-interactive.htm) に使用されます。

情報メモ代わりに Azure OpenAI 分析コネクタを使用している場合は、Azure OpenAI コネクタのドキュメントに記載されている設定に従ってください。「[Azure OpenAI 接続の作成](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/ac-azure-openai-create.htm)」を参照してください。

次の手順を実行します。

1. データ ロード エディターまたは 分析 アクティビティ センターの [作成] ページから、OpenAI への 2 つの新しい接続を 1 つずつ作成します。OpenAI コネクタは、データ ロード エディターの分析ソースの下にあります。

2. 使用する [構成] を選択します。このチュートリアルでは、どちらの接続にもOpenAI Chat Completions API 構成を使用します。

3. このチュートリアルの準備セクションで生成した OpenAI API キーを入力して、接続時に自分自身を認証します。

4. ニーズに合わせて既定のパラメータ値を調整します。

   情報メモ接続をニーズに合わせて適切に機能させるためには、ほとんどの場合、[最大トークン] パラメータの値を変更する必要があります。このパラメータは、生成される応答のサイズを制御します。

5. [関連付け項目] を追加して、接続出力をアプリケーションのいずれかのデータ モデルにリンクします。

   * 最初の接続では、 [関連付け項目] として「RowId」を入力します。

   * 2 番目の接続では、 [関連付け項目] を空白のままにします。

6. Name パラメーターには、作成する接続ごとに異なる名前の値を入力します。ロード スクリプトまたはチャートの数式で作業する場合は、これらのパラメータ値を使用する必要があります。

   チュートリアルの例では、次を使用します。

   * [例 – OpenAI 分析コネクタのロード スクリプトとチャートの数式を作成する](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/ac-openai-tutorial-example-3.htm) の例では OpenAI\_Examples\_Intro という名前を使用します。

   * [OpenAI 分析コネクタ - インタラクティブな例](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/ac-openai-tutorial-example-interactive.htm) の例では OpenAI\_Example\_InteractiveApp という名前を使用します。

7. [作成] をクリックします。

## 例

この構成で接続を作成したら、ロード スクリプトやチャートの数式でそれを使って、OpenAI のモデルと通信できます。

これらの例はスタンドアロン型の設計であり、相互に独立して完了することは不可能です。

1. [例 – OpenAI 分析コネクタのロード スクリプトとチャートの数式を作成する](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/ac-openai-tutorial-example-3.htm)
2. [OpenAI 分析コネクタ - インタラクティブな例](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/ac-openai-tutorial-example-interactive.htm)

## 詳細を見る

* [サーバーサイド拡張構文](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/sse-syntax.htm)
* [GetSelectedCount - チャート関数](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/FieldFunctions/getselectedcount.htm)
* [数式での変数の使用](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Variables/work-with-variables.htm)