# OpenAI 接続の作成

OpenAI プラットフォームと通信するには、OpenAI 分析ソースへの接続を作成します。

OpenAI と通信するには、OpenAI 分析ソースへの接続を作成します。分析 アクティビティ センター、データ ロード エディタ、または スクリプト の [作成] ページで接続を作成します。

これらの接続から受信したデータはロード スクリプトやチャートの数式で使用でき、Qlik Sense 分析アプリケーションを強化します。

## 構成と構成可能な設定

次のいずれかの構成を使用して OpenAI 分析接続をセット アップします。構成可能な設定は、使用する構成に応じて異なります。

### OpenAI Chat Completions API

この構成では、データの各行を質問として OpenAI Chat Completions API に送信します。各回答は、入力と同じ行数のテーブルにテキストとして保管されます。

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

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

この構成で使用される API に関する OpenAI のドキュメントについては、「[Chat](https://platform.openai.com/docs/api-reference/chat)」を参照してください。

OpenAI Chat Completions APIOpenAI Chat Completions API 構成の構成可能な設定

| フィールド | 説明 |
| --- | --- |
| 構成の選択 | [構成] で、OpenAI Chat Completion APIを選択します。 |
| 権限 | OpenAI API キーを入力します。詳細については、「[OpenAI API キーの生成](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/ac-openai-overview.htm#Generati)」を参照してください。 |
| OpenAI リクエスト | <ul> <li> <p><span>OpenAI&nbsp;モデル</span>: 使用するモデル。</p> </li> <li> <p><span>温度</span>: 使用するサンプル温度。</p> </li> <li> <p><span>トークンの最大数</span>: このパラメータは、生成されるトークンの最大数を調整します。言い換えると、生成される応答のサイズを制御します。接続をニーズに合わせて適切に機能させるためには、ほとんどの場合、デフォルト値を変更する必要があります。</p> </li> <li> <p><span>トップ&nbsp;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 を持つ任意の項目です。 |
| 名前 | 接続の名前。名前を入力しないと既定名が使用されます。 |

### OpenAI Embeddings

この構成では、入力テキストの行が OpenAI Embeddings API に送信されます。OpenAI は、各入力の個別のベクトル表現を返します。このベクトル表現は、機械学習モデルによって消費できる形式です。

この構成で使用される API に関する OpenAI のドキュメントについては、「[Embeddings](https://platform.openai.com/docs/api-reference/embeddings)」を参照してください。

OpenAI EmbeddingsOpenAI Embeddings 構成の構成可能な設定

| フィールド | 説明 |
| --- | --- |
| 構成の選択 | [構成] で、OpenAI Embeddings を選択します。 |
| 権限 | OpenAI API キーを入力します。詳細については、「[OpenAI API キーの生成](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/ac-openai-overview.htm#Generati)」を参照してください。 |
| OpenAI リクエスト | <ul> <li> <p><span>OpenAI&nbsp;モデル</span>: 使用するモデル。</p> </li> <li> <p><span>ユーザー</span>: エンドユーザー ID。ポリシー違反を監視するのに役立ちます。</p> </li> </ul> |
| 関連付け | [関連項目] を指定します。一意の識別子を含む入力データ テーブルの項目。<br><br>キーを使用してソース 項目 テーブルに関連付けるために戻された結果テーブルのエンドポイント要求を行う場合は、この項目をソース データに含める必要があります。指定された項目がレスポンスの項目として返され、応答値をデータ モデルのソース データに関連付けることができます。これは、ソース データから、またはテーブルのロード プロセスの一部として、一意の ID を持つ任意の項目です。 |
| 名前 | 接続の名前。名前を入力しないと既定名が使用されます。 |

## 接続の作成

分析コネクタへの接続は、分析 アクティビティ センター、既存のアプリケーションの データ ロード エディタ、または既存のスクリプトの スクリプト から作成できます。次の手順に従って、接続を作成します。

次の手順を実行します。

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

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

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

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

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

6. OpenAI API キーを入力します。詳細については、「[OpenAI API キーの生成](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/ac-openai-overview.htm#Generati)」を参照してください。

7. [OpenAI モデル] で、使用する OpenAI モデルを選択します。

8. 必要に応じて、他のデフォルト パラメータ値を調整します。これらのパラメータは、OpenAI の API ドキュメントに記載されています。詳細については、「[Chat](https://platform.openai.com/docs/api-reference/chat)」、「[Completions](https://platform.openai.com/docs/api-reference/completions)」、「[Embeddings](https://platform.openai.com/docs/api-reference/embeddings)」を参照してください。

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

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

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

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

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

## 詳細な例

OpenAI 分析コネクタの使い方の詳細な例については、「[チュートリアル – Qlik Cloud での OpenAI 分析コネクタの使用](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/ac-openai-tutorial.htm)」を参照してください。

## 詳細を見る

* [Chat](https://platform.openai.com/docs/api-reference/chat)
* [Completions](https://platform.openai.com/docs/api-reference/completions)
* [Embeddings](https://platform.openai.com/docs/api-reference/embeddings)
* [OpenAI ガイド - Embeddings](https://platform.openai.com/docs/guides/embeddings/what-are-embeddings)