メイン コンテンツをスキップする 補完的コンテンツへスキップ

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 からの各データ行は別のリクエストとして送信されます。

情報メモ複数の行を 1 件のチャット コンテクストとして送信することはできません。すべての質問を 1 行のリクエストに入れる必要があります。

この構成は、ロード スクリプトとチャートの数式の両方で使用できます。

接続の作成

Azure OpenAI 分析コネクタへの接続は、Analytics アクティビティ センターの [作成] ページから、または既に作成したアプリのデータ ロード エディターから作成できます。次の手順に従って、接続を作成します。

パラメーター値の設定方法については、「Azure OpenAI Service REST API リファレンス」を参照してください。

  1. 新しい Qlik Sense アプリまたはスクリプトを作成して、データ ロード エディター または スクリプト を開きます。

  2. [接続の新規作成] をクリックします。

  3. [スペース] で、接続が配置されるスペースを選択します。

  4. [分析ソース] で、[Azure OpenAI] をクリックします。

  5. 必要な [構成] を選択します。使用可能な各オプションの詳細については、利用可能なコネクタ構成 を参照してください。

  6. Azure OpenAI API キーを入力します。

  7. Azure API バージョン を入力します。この項目には、現在の既定がすでに入力されています。
  8. 必要に応じて、他のデフォルト パラメータ値を調整します。

    パラメータの詳細説明については、「構成可能な設定」を参照してください:。

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

データ接続はアプリが作成されたスペースに保存されるため、他の Qlik Sense アプリまたはスクリプトで再利用できます。

接続を作成したら、それを使って OpenAI に送信するデータをロードします。さらに、チャートの数式にも使用できます。詳細については、「Azure OpenAI 接続からのデータの選択とロード」および「ビジュアライゼーション数式での Azure OpenAI 接続の使用」を参照してください。

構成可能な設定

次のテーブルの設定は、接続ダイアログで構成できます。

接続ダイアログで設定可能な設定
項目 説明
構成の選択 [構成] で、コネクタの構成を選択します。詳細については、「利用可能なコネクタ構成」を参照してください。
承認 Azure OpenAI API キーを入力します。詳細については、「Azure OpenAI Service REST API リファレンス」を参照してください。
Azure OpenAI リクエスト
  • Azure リソース名: Microsoft Azure で設定したリソース プロジェクト。

    Azure 展開名: 選択した OpenAI モデルに対して設定した、特定の展開。

  • Azure API バージョン: Azure の API バージョン。現在の既定値があらかじめ入力されています。

OpenAI リクエスト
  • 温度: 使用するサンプル温度。

  • トークンの最大数: このパラメータは、生成されるトークンの最大数を調整します。言い換えると、生成される応答のサイズを制御します。接続をニーズに合わせて適切に機能させるためには、ほとんどの場合、デフォルト値を変更する必要があります。

  • トップ P: 核のサンプリングを調整します。これは、[温度] サンプルの代替値として変更できます。

  • 頻度ペナルティ: 既存のトークンから逐語的に繰り返される新しいトークンにペナルティを課す頻度。

  • プレゼンス ペナルティ: 新しいトークンが導入される時点まで、そのトークンがすでにテキストに含まれている場合に、モデルがペナルティを課す度合い。

  • ユーザー: エンドユーザー ID。ポリシー違反を監視するのに役立ちます。

関連付け

[関連項目] を指定します。一意の識別子を含む入力データ テーブルの項目。

キーを使用してソース 項目 テーブルに関連付けるために戻された結果テーブルのエンドポイント要求を行う場合は、この項目をソース データに含める必要があります。指定された項目がレスポンスの項目として返され、応答値をデータ モデルのソース データに関連付けることができます。これは、ソース データから、またはテーブルのロード プロセスの一部として、一意の ID を持つ任意の項目です。

名前 接続の名前。名前を入力しないと既定名が使用されます。

このページは役に立ちましたか?

このページまたはコンテンツに、タイポ、ステップの省略、技術的エラーなどの問題が見つかった場合は、お知らせください。改善に役立たせていただきます。