# 创建 OpenAI 连接

要与 OpenAI 平台进行通信，请创建与 OpenAI 分析源的连接。

要与 OpenAI 进行通信，请创建与 OpenAI 分析源的连接。正在 Analytics 活动中心、数据加载编辑器 或 脚本 的“创建”页面中创建连接。

从这些连接接收到的数据可以用于加载脚本，还可以用于图表表达式，以增强您的 Qlik Sense 分析应用程序。

## 配置和可配置设置

使用以下配置之一设置 OpenAI 分析连接。根据使用的配置，可配置设置可能会有所不同。

### OpenAI 聊天补全 API

此配置将每行数据作为问题发送到 OpenAI 聊天补全 API。每个响应都将作为文本存储在一个表中，该表的行数与输入的行数相同。

信息注释不支持将多行作为聊天上下文发送。您需要在一个请求行中包含所有问题。

此配置既可用于加载脚本，也可用于图表表达式。

有关此配置使用的 API 的 OpenAI 文档，请参阅[图表](https://platform.openai.com/docs/api-reference/chat)。

OpenAI Chat Completions APIOpenAI Chat Completions API 配置的可配置设置

| 字段 | 描述 |
| --- | --- |
| 选择配置 | 在配置下，选择 OpenAI 聊天补全 API。 |
| 授权 | 输入OpenAI API密钥。有关更多信息，请参阅[生成 OpenAI API 密钥](https://help.qlik.com/zh-CN/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>顶部 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 嵌入

此配置将输入文本行发送到 OpenAI 嵌入 API。OpenAI 返回每个输入的单独矢量表示。这种向量表示的形式可以被机器学习模型所使用。

有关此配置使用的 API 的 OpenAI 文档，请参阅[嵌入](https://platform.openai.com/docs/api-reference/embeddings)。

OpenAI EmbeddingsOpenAI Embeddings 配置的可配置设置

| 字段 | 描述 |
| --- | --- |
| 选择配置 | 在配置下，选择 OpenAI 嵌入。 |
| 授权 | 输入OpenAI API密钥。有关更多信息，请参阅[生成 OpenAI API 密钥](https://help.qlik.com/zh-CN/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 的字段，可以来自源数据，也可以作为表加载过程的一部分。 |
| 名称 | 连接的名称。如果不输入名称，则使用默认名称。 |

## 创建连接

您可以从 Analytics 活动中心、现有应用程序中的 数据加载编辑器 或现有脚本中的 脚本 创建到分析连接器的连接。按照以下步骤创建连接。

执行以下操作：

1. 创建新的 Qlik Sense 应用程序或脚本。打开 数据加载编辑器 或 脚本。

2. 单击创建新连接。

3. 在空间下，选择连接所在的空间。

4. 在分析源下，单击 OpenAI。

5. 选择所需的配置。有关每个可用选项的详细信息，请参阅[配置和可配置设置](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/ac-openai-create.htm#Configur2)。

6. 输入您的 OpenAI API 密钥。有关更多信息，请参阅[生成 OpenAI API 密钥](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/ac-openai-overview.htm#Generati)。

7. 在 OpenAI 模型下，选择要使用的 OpenAI 模型。

8. 根据需要调整任何其他默认参数值。OpenAI 的 API 文档中描述了这些参数。有关详细信息，请参阅[聊天](https://platform.openai.com/docs/api-reference/chat)、[补全](https://platform.openai.com/docs/api-reference/completions)和[嵌入](https://platform.openai.com/docs/api-reference/embeddings)。

   有关参数的其他说明，请参阅 [配置和可配置设置](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/ac-openai-create.htm#Configur2)。

   信息注释您几乎总是需要更改最大令牌数参数值，以便连接正常运行以满足您的需求。此参数控制将要生成的响应的大小。

9. 单击创建。

数据连接保存到创建应用程序的空间中，因此可以在其他 Qlik Sense 应用程序和脚本中重复使用。它也列在 数据加载编辑器 或 脚本 中的数据连接下。

一旦创建了连接，就可以使用它加载带有请求和平台对请求的响应的数据。此外，您还可以在图表表达式中使用它。有关更多信息，请参阅[从 OpenAI 连接选择并加载数据](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/ac-openai-load.htm)和[在可视化表达式中使用 OpenAI 连接](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/ac-openai-use.htm)。

## 详细示例

有关如何使用 OpenAI 分析连接器的完整示例，请参阅[教程 - 在 Qlik Cloud 中使用 OpenAI 分析连接器](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/ac-openai-tutorial.htm)。

## 了解详情

* [聊天](https://platform.openai.com/docs/api-reference/chat)
* [完成](https://platform.openai.com/docs/api-reference/completions)
* [嵌入](https://platform.openai.com/docs/api-reference/embeddings)
* [OpenAI 指南 - 嵌入](https://platform.openai.com/docs/guides/embeddings/what-are-embeddings)