创建 OpenAI 连接
要与 OpenAI 平台进行通信,请创建与 OpenAI 分析源的连接。
要与 OpenAI 进行通信,请创建与 OpenAI 分析源的连接。正在Analytics 活动中心的创建页面中创建连接,数据加载编辑器 或脚本 。
从这些连接接收到的数据可以用于加载脚本,还可以用于图表表达式,以增强您的 Qlik Sense 分析应用程序。
配置和可配置设置
使用以下配置之一设置 OpenAI 分析连接。根据使用的配置,其他可配置设置可能会有所不同。
OpenAI 补全 API (GPT-3) – 行
此配置将每行数据作为问题发送给补全 API(以小批量的方式提高性能)。每个响应都将作为文本存储在一个表中,该表的行数与输入的行数相同。
此配置既可用于加载脚本,也可用于图表表达式。
有关此配置使用的 API 的 OpenAI 文档,请参阅完成。
字段 | 描述 |
---|---|
选择配置 | 在配置下,选择 OpenAI 补全 API (GPT-3) – 行。 |
授权 | 输入OpenAI API密钥。有关详细信息,请参阅生成 OpenAI API 密钥。 |
OpenAI 请求 |
|
关联 |
指定关联字段,该字段来自包含唯一标识符的输入数据表。 当对使用密钥对返回的与源字段表相关联的结果表发出端点请求时,需要在源数据中包含该字段。指定的字段将作为字段返回到响应中,并使响应能够与数据模型中的源数据相关联。这可以是任何具有惟一 ID 的字段,可以来自源数据,也可以作为表加载过程的一部分。 |
名称 | 连接的名称。如果不输入名称,则使用默认名称。 |
OpenAI 补全 (GPT-3) – JSON 表
此配置在每一行上发送一个请求,其中的响应应该是数据的 JSON 列表。连接器将 JSON 表转换为 Qlik 数据模型中的数据表。由于 OpenAI 响应的性质,它应该被视为实验性的。
此配置可以在加载脚本中用于合成数据。它不用于图表表达式。根据您提问的方式,它可能并不总是返回有效的JSON。
字段 | 描述 |
---|---|
选择配置 | 在配置下,选择 OpenAI 补全 API (GPT-3) – JSON 表。 |
授权 | 输入OpenAI API密钥。有关详细信息,请参阅生成 OpenAI API 密钥。 |
OpenAI 请求 |
|
关联 |
指定关联字段,该字段来自包含唯一标识符的输入数据表。 当对使用密钥对返回的与源字段表相关联的结果表发出端点请求时,需要在源数据中包含该字段。指定的字段将作为字段返回到响应中,并使响应能够与数据模型中的源数据相关联。这可以是任何具有惟一 ID 的字段,可以来自源数据,也可以作为表加载过程的一部分。 |
名称 | 连接的名称。如果不输入名称,则使用默认名称。 |
OpenAI 聊天补全 API(GPT-3.5、GPT-4)– 行
此配置的工作方式与 OpenAI 补全 API (GPT-3) - 行配置类似,但它将每行数据作为请求发送到 OpenAI 聊天补全 API。在这种情况下,请求是由“用户”消息角色发出的,来自 Qlik 的每一行数据都作为一个单独的请求发送。
此配置既可用于加载脚本,也可用于图表表达式。
有关此配置使用的 API 的 OpenAI 文档,请参阅图表。
字段 | 描述 |
---|---|
选择配置 | 在配置下,选择 OpenAI 补全 API(GPT-3.5、GPT-4)– 行。 |
授权 | 输入OpenAI API密钥。有关详细信息,请参阅生成 OpenAI API 密钥。 |
OpenAI 请求 |
|
关联 |
指定关联字段,该字段来自包含唯一标识符的输入数据表。 当对使用密钥对返回的与源字段表相关联的结果表发出端点请求时,需要在源数据中包含该字段。指定的字段将作为字段返回到响应中,并使响应能够与数据模型中的源数据相关联。这可以是任何具有惟一 ID 的字段,可以来自源数据,也可以作为表加载过程的一部分。 |
名称 | 连接的名称。如果不输入名称,则使用默认名称。 |
OpenAI 嵌入
此配置将输入文本行发送到 OpenAI 嵌入 API。OpenAI 返回每个输入的单独矢量表示。这种向量表示的形式可以被机器学习模型所使用。
有关此配置使用的 API 的 OpenAI 文档,请参阅嵌入。
字段 | 描述 |
---|---|
选择配置 | 在配置下,选择 OpenAI 嵌入。 |
授权 | 输入OpenAI API密钥。有关详细信息,请参阅生成 OpenAI API 密钥。 |
OpenAI 请求 |
|
关联 |
指定关联字段,该字段来自包含唯一标识符的输入数据表。 当对使用密钥对返回的与源字段表相关联的结果表发出端点请求时,需要在源数据中包含该字段。指定的字段将作为字段返回到响应中,并使响应能够与数据模型中的源数据相关联。这可以是任何具有惟一 ID 的字段,可以来自源数据,也可以作为表加载过程的一部分。 |
名称 | 连接的名称。如果不输入名称,则使用默认名称。 |
创建连接
您可以从 Analytics 活动中心、现有应用程序中的 数据加载编辑器 或现有脚本中的 脚本 创建到分析连接器的连接。按照以下步骤创建连接。
执行以下操作:
-
创建新 Qlik Sense 应用程序或脚本打开 数据加载编辑器 或 脚本。
-
单击创建新连接。
-
在空间下,选择连接所在的空间。
-
在分析源下,单击 OpenAI。
-
选择所需的配置。有关每个可用选项的详细信息,请参阅配置和可配置设置。
-
输入您的 OpenAI API 密钥。有关详细信息,请参阅生成 OpenAI API 密钥。
-
在 OpenAI 模型下,选择要使用的 OpenAI 模型。
-
根据需要调整任何其他默认参数值。OpenAI 的 API 文档中描述了这些参数。有关详细信息,请参阅聊天、补全和嵌入。
有关参数的其他说明,请参阅 配置和可配置设置。
信息注释您几乎总是需要更改最大令牌数参数值,以便连接正常运行以满足您的需求。此参数控制将要生成的响应的大小。 -
单击创建。
数据连接保存到创建应用程序的空间中,因此可以在其他 Qlik Sense 应用程序和脚本中重复使用。它也列在 数据加载编辑器 或 脚本 中的数据连接下。
一旦创建了连接,就可以使用它加载带有请求和平台对请求的响应的数据。此外,您还可以在图表表达式中使用它。有关更多信息,请参阅从 OpenAI 连接选择并加载数据和在可视化表达式中使用 OpenAI 连接。
详细示例
有关如何使用 OpenAI 分析连接器的完整示例,请参阅教程 - 在 Qlik Cloud 中使用 OpenAI 分析连接器 。