创建 OpenAI 连接
要与 OpenAI 平台进行通信，请创建与 OpenAI 分析源的连接。
要与 OpenAI 进行通信，请创建与 OpenAI 分析源的连接。 在应用中心、数据加载编辑器 或 脚本编辑器 中创建连接。
从这些连接接收到的数据可以用于加载脚本，还可以用于图表表达式，以增强您的 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 的字段，可以来自源数据，也可以作为表加载过程的一部分。 |
| 名称 | 连接的名称。如果不输入名称，则使用默认名称。 |
创建连接
您可以从应用中心、现有应用程序中的 数据加载编辑器 或现有脚本中的 脚本编辑器 创建到分析连接器的连接。按照以下步骤创建连接。
执行以下操作：
-
创建新 Qlik Sense 应用程序或脚本打开 数据加载编辑器 或 脚本编辑器。
-
单击创建新连接。
-
在分析源下，单击 OpenAI。
-
选择所需的配置。有关每个可用选项的详细信息，请参阅配置和可配置设置。
-
输入您的 OpenAI API 密钥。有关详细信息，请参阅生成 OpenAI API 密钥。
-
在 OpenAI 模型下，选择要使用的 OpenAI 模型。
-
根据需要调整任何其他默认参数值。OpenAI 的 API 文档中描述了这些参数。有关详细信息，请参阅聊天、补全和嵌入。
有关参数的其他说明，请参阅 配置和可配置设置。
信息注释您几乎总是需要更改最大令牌数参数值，以便连接正常运行以满足您的需求。此参数控制将要生成的响应的大小。 -
单击创建。
数据连接保存到创建应用程序的空间中，因此可以在其他 Qlik Sense 应用程序和脚本中重复使用。它也列在 数据加载编辑器 或 脚本编辑器 中的数据连接下。
一旦创建了连接，就可以使用它加载带有请求和平台对请求的响应的数据。此外，您还可以在图表表达式中使用它。有关更多信息，请参阅从 OpenAI 连接选择并加载数据和在可视化表达式中使用 OpenAI 连接。
详细示例
有关如何使用 OpenAI 分析连接器的完整示例，请参阅教程 - 在 Qlik Cloud 中使用 OpenAI 分析连接器 。