# 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 分析コネクタへの接続は、分析 アクティビティ センターの [作成] ページから、または既に作成したアプリケーションのデータ ロード エディターから作成できます。次の手順に従って、接続を作成します。

パラメーター値の設定方法については、「[Azure OpenAI Service REST API リファレンス](https://learn.microsoft.com/en-us/azure/ai-services/openai/reference)」を参照してください。

次の手順を実行します。

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

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

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

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

5. 必要な [構成] を選択します。使用可能な各オプションの詳細については、[利用可能なコネクタ構成](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/ac-azure-openai-create.htm#Availabl) を参照してください。

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

7. Azure API バージョン を入力します。この項目には、現在の既定がすでに入力されています。

8. 必要に応じて、他のデフォルト パラメータ値を調整します。

   パラメータの詳細説明については、「[構成可能な設定](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/ac-azure-openai-create.htm#Configur)」を参照してください:。

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

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

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

接続を作成したら、それを使って Azure OpenAI に送信するデータをロードします。さらに、チャートの数式にも使用できます。詳細については、「[Azure OpenAI 接続からのデータの選択とロード](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/ac-azure-openai-load.htm)」および「[ビジュアライゼーション数式での Azure OpenAI 接続の使用](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/ac-azure-openai-use.htm)」を参照してください。

## 構成可能な設定

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

接続ダイアログで設定可能な設定

| フィールド | 説明 |
| --- | --- |
| 構成の選択 | [構成] で、コネクタの構成を選択します。詳細については、「[利用可能なコネクタ構成](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/ac-azure-openai-create.htm#Availabl)」を参照してください。 |
| 権限 | Azure OpenAI API キーを入力します。詳細については、「[Azure OpenAI Service REST API リファレンス](https://learn.microsoft.com/en-us/azure/ai-services/openai/reference)」を参照してください。 |
| Azure OpenAI リクエスト | <ul> <li> <p><span>Azure リソース名</span>: <span>Microsoft Azure</span> で設定したリソース プロジェクト。</p> <p><span>Azure 展開名</span>: 選択した OpenAI モデルに対して設定した、特定の展開。</p> </li> <li> <p><span>Azure API&nbsp;バージョン</span>: Azure の API バージョン。現在の既定値があらかじめ入力されています。</p> </li> </ul> |
| OpenAI リクエスト | <ul> <li> <p><span>温度</span>: 使用するサンプル温度。</p> </li> <li> <p><span>トークンの最大数</span>: このパラメータは、生成されるトークンの最大数を調整します。言い換えると、生成される応答のサイズを制御します。接続をニーズに合わせて適切に機能させるためには、ほとんどの場合、デフォルト値を変更する必要があります。</p> </li> <li> <p><span>トップ P</span>: 核のサンプリングを調整します。これは、[<span>温度</span>] サンプルの代替値として変更できます。</p> </li> <li> <p><span>頻度ペナルティ</span>: 既存のトークンから逐語的に繰り返される新しいトークンにペナルティを課す頻度。</p> </li> <li> <p><span>プレゼンス ペナルティ</span>: 新しいトークンが導入される時点まで、そのトークンがすでにテキストに含まれている場合に、モデルがペナルティを課す度合い。</p> </li> <li> <p><span>ユーザー</span>: エンドユーザー ID。ポリシー違反を監視するのに役立ちます。</p> </li> </ul> |
| 関連付け | [関連項目] を指定します。一意の識別子を含む入力データ テーブルの項目。<br><br>キーを使用してソース 項目 テーブルに関連付けるために戻された結果テーブルのエンドポイント要求を行う場合は、この項目をソース データに含める必要があります。指定された項目がレスポンスの項目として返され、応答値をデータ モデルのソース データに関連付けることができます。これは、ソース データから、またはテーブルのロード プロセスの一部として、一意の ID を持つ任意の項目です。 |
| 名前 | 接続の名前。名前を入力しないと既定名が使用されます。 |

## 詳細を見る

* [Azure OpenAI Service REST API リファレンス](https://learn.microsoft.com/en-us/azure/ai-services/openai/reference)