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

创建 OpenAI 连接

要与 OpenAI 平台进行通信,请创建与 OpenAI 分析源的连接。

要与 OpenAI 进行通信,请创建与 OpenAI 分析源的连接。正在Analytics 活动中心的创建页面中创建连接数据加载编辑器脚本

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

配置和可配置设置

使用以下配置之一设置 OpenAI 分析连接。根据使用的配置,其他可配置设置可能会有所不同。

OpenAI 补全 API (GPT-3) – 行

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

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

有关此配置使用的 API 的 OpenAI 文档,请参阅完成

“OpenAI 补全 API (GPT-3) – 行”配置的可配置设置
字段 描述
选择配置 配置下,选择 OpenAI 补全 API (GPT-3) – 行
授权 输入OpenAI API密钥。有关详细信息,请参阅生成 OpenAI API 密钥
OpenAI 请求
  • OpenAI 模型:使用的模型。

  • 温度:要使用的采样温度。

  • 最大令牌数:此参数调整要生成的令牌的最大数量。换句话说,它控制将要生成的响应的大小。您几乎总是需要更改默认值,以便连接正常工作以满足您的需求。

  • 顶部 P:调整核心采样。这可以作为温度采样的替代方案进行更改。

  • 频率惩罚:模型惩罚从现有令牌逐字重复的新令牌的程度。

  • 存在惩罚:模型惩罚已经包含在文本中的新令牌的程度,直到它们被引入为止。

  • 用户:最终用户 ID,它可以帮助监视违反政策的情况。

关联

指定关联字段,该字段来自包含唯一标识符的输入数据表。

当对使用密钥对返回的与源字段表相关联的结果表发出端点请求时,需要在源数据中包含该字段。指定的字段将作为字段返回到响应中,并使响应能够与数据模型中的源数据相关联。这可以是任何具有惟一 ID 的字段,可以来自源数据,也可以作为表加载过程的一部分。

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

OpenAI 补全 (GPT-3) – JSON 表

此配置在每一行上发送一个请求,其中的响应应该是数据的 JSON 列表。连接器将 JSON 表转换为 Qlik 数据模型中的数据表。由于 OpenAI 响应的性质,它应该被视为实验性的。

此配置可以在加载脚本中用于合成数据。它不用于图表表达式。根据您提问的方式,它可能并不总是返回有效的JSON。

信息注释GPT 模型将以可能并不总是准确的方式预测 JSON 的形式,例如包含没有引号的文本的数字。在某些情况下,可以通过在加载脚本的请求中添加“作为 JSON 列表”来询问问题。在其他情况下,您必须更加具体才能获得所需的结果。
“OpenAI 补全 API (GPT-3) – JSON 表”配置的可配置设置
字段 描述
选择配置 配置下,选择 OpenAI 补全 API (GPT-3) – JSON 表
授权 输入OpenAI API密钥。有关详细信息,请参阅生成 OpenAI API 密钥
OpenAI 请求
  • OpenAI 模型:使用的模型。

  • 温度:要使用的采样温度。

  • 最大令牌数:此参数调整要生成的令牌的最大数量。换句话说,它控制将要生成的响应的大小。您几乎总是需要更改默认值,以便连接正常工作以满足您的需求。

  • 顶部 P:调整核心采样。这可以作为温度采样的替代方案进行更改。

  • 频率惩罚:模型惩罚从现有令牌逐字重复的新令牌的程度。

  • 存在惩罚:模型惩罚已经包含在文本中的新令牌的程度,直到它们被引入为止。

  • 用户:最终用户 ID,它可以帮助监视违反政策的情况。

关联

指定关联字段,该字段来自包含唯一标识符的输入数据表。

当对使用密钥对返回的与源字段表相关联的结果表发出端点请求时,需要在源数据中包含该字段。指定的字段将作为字段返回到响应中,并使响应能够与数据模型中的源数据相关联。这可以是任何具有惟一 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(GPT-3.5、GPT-4)– 行
授权 输入OpenAI API密钥。有关详细信息,请参阅生成 OpenAI API 密钥
OpenAI 请求
  • OpenAI 模型:使用的模型。

  • 温度:要使用的采样温度。

  • 最大令牌数:此参数调整要生成的令牌的最大数量。换句话说,它控制将要生成的响应的大小。您几乎总是需要更改默认值,以便连接正常工作以满足您的需求。

  • 顶部 P:调整核心采样。这可以作为温度采样的替代方案进行更改。

  • 频率惩罚:模型惩罚从现有令牌逐字重复的新令牌的程度。

  • 存在惩罚:模型惩罚已经包含在文本中的新令牌的程度,直到它们被引入为止。

  • 用户:最终用户 ID,它可以帮助监视违反政策的情况。

关联

指定关联字段,该字段来自包含唯一标识符的输入数据表。

当对使用密钥对返回的与源字段表相关联的结果表发出端点请求时,需要在源数据中包含该字段。指定的字段将作为字段返回到响应中,并使响应能够与数据模型中的源数据相关联。这可以是任何具有惟一 ID 的字段,可以来自源数据,也可以作为表加载过程的一部分。

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

OpenAI 嵌入

此配置将输入文本行发送到 OpenAI 嵌入 API。OpenAI 返回每个输入的单独矢量表示。这种向量表示的形式可以被机器学习模型所使用。

有关此配置使用的 API 的 OpenAI 文档,请参阅嵌入

“OpenAI 嵌入”配置的可配置设置
字段 描述
选择配置 配置下,选择 OpenAI 嵌入
授权 输入OpenAI API密钥。有关详细信息,请参阅生成 OpenAI API 密钥
OpenAI 请求
  • OpenAI 模型:使用的模型。

  • 用户:最终用户 ID,它可以帮助监视违反政策的情况。

关联

指定关联字段,该字段来自包含唯一标识符的输入数据表。

当对使用密钥对返回的与源字段表相关联的结果表发出端点请求时,需要在源数据中包含该字段。指定的字段将作为字段返回到响应中,并使响应能够与数据模型中的源数据相关联。这可以是任何具有惟一 ID 的字段,可以来自源数据,也可以作为表加载过程的一部分。

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

创建连接

您可以从 Analytics 活动中心、现有应用程序中的 数据加载编辑器 或现有脚本中的 脚本 创建到分析连接器的连接。按照以下步骤创建连接。

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

  2. 单击创建新连接

  3. 空间下,选择连接所在的空间。

  4. 分析源下,单击 OpenAI

  5. 选择所需的配置。有关每个可用选项的详细信息,请参阅配置和可配置设置

  6. 输入您的 OpenAI API 密钥。有关详细信息,请参阅生成 OpenAI API 密钥

  7. OpenAI 模型下,选择要使用的 OpenAI 模型。

  8. 根据需要调整任何其他默认参数值。OpenAI 的 API 文档中描述了这些参数。有关详细信息,请参阅聊天补全嵌入

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

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

数据连接保存到创建应用程序的空间中,因此可以在其他 Qlik Sense 应用程序和脚本中重复使用。它也列在 数据加载编辑器脚本 中的数据连接下。

一旦创建了连接,就可以使用它加载带有请求和平台对请求的响应的数据。此外,您还可以在图表表达式中使用它。有关更多信息,请参阅从 OpenAI 连接选择并加载数据在可视化表达式中使用 OpenAI 连接

详细示例

有关如何使用 OpenAI 分析连接器的完整示例,请参阅教程 - 在 Qlik Cloud 中使用 OpenAI 分析连接器

本页面有帮助吗?

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