创建 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 参考。
执行以下操作:
-
创建新的 Qlik Sense 应用程序或脚本,然后打开 数据加载编辑器 或 脚本。
-
单击创建新连接。
-
在空间下,选择连接所在的空间。
-
在分析源下,单击 Azure OpenAI。
-
选择所需的配置。有关每个可用选项的详细信息,请参阅可用的连接器配置。
-
输入Azure OpenAI API密钥。
- 输入 Azure API 版本。此字段已填充了当前默认值。
-
根据需要调整任何其他默认参数值。
有关参数的其他说明,请参阅 配置设置。
信息注释您几乎总是需要更改最大令牌数参数值,以便连接正常运行以满足您的需求。此参数控制将要生成的响应的大小。 -
单击创建。
数据连接保存到创建应用程序的空间中,因此可以在其他 Qlik Sense 应用程序或脚本中重复使用。
一旦您创建了连接,您就可以用它加载数据以发送到 OpenAI。此外,您还可以在图表表达式中使用它。有关更多信息,请参阅从 Azure OpenAI 连接选择并加载数据和在可视化表达式中使用 Azure OpenAI 连接。
配置设置
可以在连接对话框中配置下表中的设置。
字段 | 描述 |
---|---|
选择配置 | 在配置下,选择连接器的配置。有关更多信息,请参阅可用的连接器配置。 |
授权 | 输入Azure OpenAI API 密钥。有关更多信息,请参阅 Azure OpenAI Service REST API 参考。 |
Azure OpenAI 请求 |
|
OpenAI 请求 |
|
关联 |
指定关联字段,该字段来自包含唯一标识符的输入数据表。 当对使用密钥对返回的与源字段表相关联的结果表发出端点请求时,需要在源数据中包含该字段。指定的字段将作为字段返回到响应中,并使响应能够与数据模型中的源数据相关联。这可以是任何具有惟一 ID 的字段,可以来自源数据,也可以作为表加载过程的一部分。 |
名称 | 连接的名称。如果不输入名称,则使用默认名称。 |