# 教程 - 在 Qlik Cloud 中使用 OpenAI 分析连接器

本教程教您如何使用 OpenAI 分析连接器，以增强您的 Qlik Sense 应用程序从生成式 AI 模型中获取上下文深度。

您可以将您的 OpenAI 分析连接直接集成到您的数据模型中，以便将它生成的数据预加载到应用程序中。或者，您可以在图表表达式中使用它。本教程将向您展示如何设置以使用连接器，以及如何在 Qlik Cloud 中创建与连接器的连接。从那里，它将指导您完成如何将功能并入您的 Qlik Sense 应用程序的基本示例。

本教程中的示例也可用于使用 Azure OpenAI 分析连接器。

展示如何使用 OpenAI 连接器增强分析内容的交互式表格

展示如何使用 OpenAI 连接器增强分析内容的交互式表格

展示如何使用 OpenAIOpenAI 连接器增强分析内容的交互式表格 ![交互式 Qlik Sense 应用程序，用于使用 OpenAI 与应用程序数据交互。](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Resources/Images/ui_gen_openai_example1_w_selection.png)

## 设置您的 OpenAI 平台帐户和 Qlik Cloud 环境

在使用 OpenAI 分析连接器之前，您需要完成几个步骤。这些包括：

* 创建一个 OpenAI 平台帐户

* 获取 OpenAI 密钥

* 启用分析连接功能于 Qlik Cloud

有关完整地详细信息，请参阅[开始使用 OpenAI 平台](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/ac-openai-overview.htm#Getting)。

信息注释如果您使用的是 Azure OpenAI 分析连接器，请按照 Azure OpenAI 连接器文档中提供的设置进行操作。请参阅[创建 Azure OpenAI 连接](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/ac-azure-openai-create.htm)。

## 创建连接

为 OpenAI 分析连接器创建两个连接，均使用 OpenAI Chat Completions API 配置。一旦您创建了连接，您就可以开始通过加载脚本或图表对象直接使用 OpenAI 平台了。

连接的使用方法如下所示：

* 首次连接：用于 [示例 – 为 OpenAI 分析连接器创建负载脚本和图表表达式](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/ac-openai-tutorial-example-3.htm) 。

* 第二个连接：用于 [OpenAI 分析连接器 - 交互式示例](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/ac-openai-tutorial-example-interactive.htm) 。

信息注释如果您使用的是 Azure OpenAI 分析连接器，请按照 Azure OpenAI 连接器文档中提供的设置进行操作。请参阅[创建 Azure OpenAI 连接](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/ac-azure-openai-create.htm)。

执行以下操作：

1. 从数据加载编辑器或 Analytics 活动中心的“创建”页面逐一创建 OpenAI 的两个新连接。在数据加载编辑器中，OpenAI 连接器位于分析源下。

2. 选择要使用的配置。本教程中的两个连接均使用 OpenAI Chat Completions API 配置。

3. 通过输入在本教程的准备部分中生成的 OpenAI 密钥，在连接上验证自己。

4. 根据需要调整默认参数值。

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

5. 添加一个关联字段，以将连接输出链接到一个或您的应用程序的数据模型：

   * 对于第一个连接，输入 RowId 作为关联字段。

   * 对于第二个连接，将关联字段留空。

6. 对于名称参数，为您创建的每个连接输入一个不同的名称值。在使用加载脚本或图表表达式时，需要使用这些参数值。

   为了教程示例的目的，请使用以下内容：

   * 对于 [示例 – 为 OpenAI 分析连接器创建负载脚本和图表表达式](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/ac-openai-tutorial-example-3.htm) 上的示例使用名称 OpenAI\_Examples\_Intro。

   * 对于 [OpenAI 分析连接器 - 交互式示例](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/ac-openai-tutorial-example-interactive.htm) 上的示例使用名称 OpenAI\_Example\_InteractiveApp。

7. 单击创建。

## 实例

一旦您使用此配置创建了连接，您就可以在加载脚本和图表表达式中使用它来与 OpenAI 模型进行通信。

这些示例被设计为独立的，并且可以彼此独立地完成。

1. [示例 – 为 OpenAI 分析连接器创建负载脚本和图表表达式](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/ac-openai-tutorial-example-3.htm)
2. [OpenAI 分析连接器 - 交互式示例](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/ac-openai-tutorial-example-interactive.htm)

## 了解详情

* [服务器端扩展语法](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/sse-syntax.htm)
* [GetSelectedCount - 图表函数](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/FieldFunctions/getselectedcount.htm)
* [在表达式中使用变量](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/Variables/work-with-variables.htm)