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