跳到主要内容 跳到补充内容

创建 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 的每一行数据都作为一个单独的请求发送。

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

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

创建连接

您可以从应用中心或您已经创建的应用程序中的数据加载编辑器创建与 Azure OpenAI 分析连接器的连接。按照以下步骤创建连接。

有关如何设置参数值的信息,请参阅 Azure OpenAI Service REST API 参考

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

  2. 单击创建新连接

  3. 分析源下,单击 Azure OpenAI

  4. 选择所需的配置。有关每个可用选项的详细信息,请参阅可用的连接器配置

  5. 输入Azure OpenAI API密钥

  6. 输入 Azure API 版本。此字段已填充了当前默认值。
  7. 根据需要调整任何其他默认参数值。

    有关参数的其他说明,请参阅 配置设置

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

数据连接保存到创建应用程序的空间中,因此可以在其他 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 的字段,可以来自源数据,也可以作为表加载过程的一部分。

名称 连接的名称。如果不输入名称,则使用默认名称。

本页面有帮助吗?

如果您发现此页面或其内容有任何问题 – 打字错误、遗漏步骤或技术错误 – 请告诉我们如何改进!