# 创建 Azure OpenAI 连接

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

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

## 在您开始之前

在您的 Microsoft Azure 帐户中，Azure OpenAI 服务位于 Azure 的认知服务中，默认情况下未启用。如果您在启用 Azure OpenAI 服务上需要帮助，请与 Microsoft 联系。

## 可用的连接器配置

使用以下配置之一设置 Azure OpenAI 分析连接。

### OpenAI 补全 API

此配置将每行数据作为问题发送给补全 API（以小批量的方式提高性能）。每个响应都将作为文本存储在一个表中，该表的行数与输入的行数相同。

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

### OpenAI 聊天补全 API

此配置将每行数据作为请求发送到 OpenAI 聊天补全 API。在这种情况下，请求是由“用户”消息角色发出的，来自 Qlik 的每一行数据都作为一个单独的请求发送。

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

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

## 创建连接

您可以从 Analytics 活动中心的“创建”页面，或从您已创建的应用程序中的数据加载编辑器创建与 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/zh-CN/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/zh-CN/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/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/ac-azure-openai-load.htm)和[在可视化表达式中使用 Azure OpenAI 连接](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/ac-azure-openai-use.htm)。

## 配置设置

可以在连接对话框中配置下表中的设置。

连接对话框中可配置的设置

| 字段 | 描述 |
| --- | --- |
| 选择配置 | 在配置下，选择连接器的配置。有关更多信息，请参阅[可用的连接器配置](https://help.qlik.com/zh-CN/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)