OpenAI 接続の作成
OpenAI プラットフォームと通信するには、OpenAI 分析ソースへの接続を作成します。
OpenAI と通信するには、OpenAI 分析ソースへの接続を作成します。Analytics アクティビティ センター、データ ロード エディター、または スクリプト の [作成] ページで接続を作成します。
これらの接続から受信したデータはロード スクリプトやチャートの数式で使用でき、Qlik Sense 分析アプリを強化します。
構成と構成可能な設定
OpenAI 分析接続を以下のいずれかの設定で設定します。その他の構成可能な設定は、使用する構成に応じて異なります。
OpenAI Completions API (GPT-3) - 行
この構成では、データの各行が質問として完了 API に送信されます (パフォーマンスを向上させるため、少量のバッチで送信されます)。各回答は、入力と同じ行数のテーブルにテキストとして保管されます。
この構成は、ロード スクリプトとチャートの数式の両方で使用できます。
この構成で使用される API に関する OpenAI のドキュメントについては、「Completions」を参照してください。
| 項目 | 説明 |
|---|---|
| 構成の選択 | [構成] で、OpenAI Completions API (GPT-3) - 行を選択します。 |
| 承認 | OpenAI API キーを入力します。詳細については、「OpenAI API キーの生成」を参照してください。 |
| OpenAI リクエスト |
|
| 関連付け |
[関連項目] を指定します。一意の識別子を含む入力データ テーブルの項目。 キーを使用してソース 項目 テーブルに関連付けるために戻された結果テーブルのエンドポイント要求を行う場合は、この項目をソース データに含める必要があります。指定された項目がレスポンスの項目として返され、応答値をデータ モデルのソース データに関連付けることができます。これは、ソース データから、またはテーブルのロード プロセスの一部として、一意の ID を持つ任意の項目です。 |
| 名前 | 接続の名前。名前を入力しないと既定名が使用されます。 |
OpenAI Completions API (GPT-3) - JSON テーブル
この構成は、各行ごとにリクエストを送信しますが、ここでの回答はデータの JSON リストであると期待されます。コネクタは、JSON テーブルを、Qlik データ モデルのデータのテーブルに変換します。OpenAI の回答の性質上、実験的なものとして扱う必要があります。
この構成は、データを合成するためにロード スクリプトで使用できます。チャートの数式では使用できません。質問の方法によっては、必ずしも有効な JSON を返すとは限りません。
| 項目 | 説明 |
|---|---|
| 構成の選択 | [構成] で、OpenAI Completions API (GPT-3) - JSON テーブルを選択します。 |
| 承認 | OpenAI API キーを入力します。詳細については、「OpenAI API キーの生成」を参照してください。 |
| OpenAI リクエスト |
|
| 関連付け |
[関連項目] を指定します。一意の識別子を含む入力データ テーブルの項目。 キーを使用してソース 項目 テーブルに関連付けるために戻された結果テーブルのエンドポイント要求を行う場合は、この項目をソース データに含める必要があります。指定された項目がレスポンスの項目として返され、応答値をデータ モデルのソース データに関連付けることができます。これは、ソース データから、またはテーブルのロード プロセスの一部として、一意の ID を持つ任意の項目です。 |
| 名前 | 接続の名前。名前を入力しないと既定名が使用されます。 |
OpenAI Chat Completions API (GPT-3.5、GPT-4) - 行
この構成は、OpenAI Completions API (GPT-3) - 行の構成と同様の方法で機能しますが、データの各行をリクエストとして OpenAI Chat Completions API に送信します。この場合、リクエストは「ユーザー」メッセージ ロールで作成され、Qlik からの各データ行は別のリクエストとして送信されます。
この構成は、ロード スクリプトとチャートの数式の両方で使用できます。
この構成で使用される API に関する OpenAI のドキュメントについては、「Chat」を参照してください。
| 項目 | 説明 |
|---|---|
| 構成の選択 | [構成] で、OpenAI Completions API (GPT-3.5、GPT-4) - 行を選択します。 |
| 承認 | OpenAI API キーを入力します。詳細については、「OpenAI API キーの生成」を参照してください。 |
| OpenAI リクエスト |
|
| 関連付け |
[関連項目] を指定します。一意の識別子を含む入力データ テーブルの項目。 キーを使用してソース 項目 テーブルに関連付けるために戻された結果テーブルのエンドポイント要求を行う場合は、この項目をソース データに含める必要があります。指定された項目がレスポンスの項目として返され、応答値をデータ モデルのソース データに関連付けることができます。これは、ソース データから、またはテーブルのロード プロセスの一部として、一意の ID を持つ任意の項目です。 |
| 名前 | 接続の名前。名前を入力しないと既定名が使用されます。 |
OpenAI Embeddings
この構成では、入力テキストの行が OpenAI Embeddings API に送信されます。OpenAI は、各入力の個別のベクトル表現を返します。このベクトル表現は、機械学習モデルによって消費できる形式です。
この構成で使用される API に関する OpenAI のドキュメントについては、「Embeddings」を参照してください。
| 項目 | 説明 |
|---|---|
| 構成の選択 | [構成] で、OpenAI Embeddings を選択します。 |
| 承認 | OpenAI API キーを入力します。詳細については、「OpenAI API キーの生成」を参照してください。 |
| OpenAI リクエスト |
|
| 関連付け |
[関連項目] を指定します。一意の識別子を含む入力データ テーブルの項目。 キーを使用してソース 項目 テーブルに関連付けるために戻された結果テーブルのエンドポイント要求を行う場合は、この項目をソース データに含める必要があります。指定された項目がレスポンスの項目として返され、応答値をデータ モデルのソース データに関連付けることができます。これは、ソース データから、またはテーブルのロード プロセスの一部として、一意の ID を持つ任意の項目です。 |
| 名前 | 接続の名前。名前を入力しないと既定名が使用されます。 |
接続の作成
分析コネクタへの接続は、Analytics アクティビティ センター、既存のアプリの データ ロード エディター、または既存のスクリプトの スクリプト から作成できます。次の手順に従って、接続を作成します。
次の手順を実行します。
-
新しい Qlik Sense アプリまたはスクリプトを作成します。データ ロード エディター または スクリプト を開きます。
-
[接続の新規作成] をクリックします。
-
[スペース] で、接続が配置されるスペースを選択します。
-
[分析ソース] で、[OpenAI] をクリックします。
-
必要な [構成] を選択します。使用可能な各オプションの詳細については、「構成と構成可能な設定」を参照してください。
-
OpenAI API キーを入力します。詳細については、「OpenAI API キーの生成」を参照してください。
-
[OpenAI モデル] で、使用する OpenAI モデルを選択します。
-
必要に応じて、他のデフォルト パラメータ値を調整します。これらのパラメータは、OpenAI の API ドキュメントに記載されています。詳細については、「Chat」、「Completions」、「Embeddings」を参照してください。
パラメーターの詳細については、「構成と構成可能な設定」を参照してください。
情報メモ接続をニーズに合わせて適切に機能させるためには、ほとんどの場合、[最大トークン] パラメータの値を変更する必要があります。このパラメータは、生成される応答のサイズを制御します。 -
[作成] をクリックします。
データ接続はアプリが作成されたスペースに保存されるため、他の Qlik Sense アプリおよびスクリプトで再利用できます。これは、データ ロード エディター または スクリプト のデータ接続にもリストされます。
接続を作成したら、接続を使用して、リクエストと接続に対するプラットフォームの応答を含むデータをロードできます。さらに、チャートの数式にも使用できます。詳しくは「OpenAI 接続からのデータの選択とロード」と「ビジュアライゼーション数式での OpenAI 接続の使用」を参照してください。
詳細な例
OpenAI 分析コネクタの使い方の詳細な例については、「チュートリアル – Qlik Cloud での OpenAI 分析コネクタの使用 」を参照してください。