# 在可视化表达式中使用 Azure OpenAI 连接

除了使用加载脚本将 Azure OpenAI 问答添加到应用程序的数据模型中，您还可以在应用程序中的图表中直接执行这些操作。单个字段的数据在您和 Azure OpenAI 服务之间来回发送。

在许多情况下，用于加载脚本连接的代码可以重新用于图表，但存在一些差异。

如果用例是基于用户输入的，那么您可以在图表表达式中使用分析连接和相应的服务器端扩展语法来创建交互式图表，可视化从模型端点接收到的数据。

## 数据请求量的注意事项

建议只在一行或几行数据的图表表达式中使用 Azure OpenAI 连接。不建议使用图表表达式向服务发送大量数据。

了解每个请求发送的行数非常重要。在图表表达式中配置 Azure OpenAI 连接的错误可能会导致意外的大型请求（例如，由于图表中数据模型的使用不当，导致具有相同问题的相同行）。您向 Azure OpenAI 服务发送的请求越大，您从 Microsoft Azure 产生的财务成本就越高。尽管该连接器的每个请求有 25 行的请求限制，但认识到这一点仍然很重要。

请遵循以下指南来调节和限制 Azure OpenAI 请求的大小：

* 使用图表表达式时，仅使用 Text 对象中的连接（来自 Dashboard bundle）。强烈建议在表对象中使用 Azure OpenAI 连接，尤其是当您将表达式添加到已添加一个或多个维度的表中时。

* 如果图表表达式链接到应用程序的数据模型，请在表达式中使用 if 语句，仅在应用程序中进行单个选择时计算图表。这大大减少了您的图表发送到 Azure OpenAI 服务的请求中的行数。

* 如果您使用 Azure OpenAI 连接发送大型请求，请在加载脚本中使用该连接，而不是在图表表达式中使用，以便将数据预加载到数据模型中。

## 简单示例

在这里，您可以找到在开始使用 Azure OpenAI 连接器时可以使用的示例表达式。请考虑以下细节：

* 仅使用带有 Text 对象的表达式（来自 Dashboard bundle）。请参阅[文本](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/Visualizations/DashboardBundle/text-object.htm)。

* 考虑在表达式中添加 `if` 语句，以控制何时重新计算图表，并根据应用程序中的用户选择进行更新。

* 为了使表达式工作，您必须替换 `connectionname` 值以及任何字段名称，以匹配您自己的连接和应用程序。

有关其他示例，请参阅[教程 - 在 Qlik Cloud 中使用 OpenAI 分析连接器](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/ac-openai-tutorial.htm)。

Azure OpenAI 分析连接器的图表表达式示例

Azure OpenAI 分析连接器的图表表达式示例

| 连接器配置 | 表达式 | 汇总 |
| --- | --- | --- |
| OpenAI 聊天补全 API | `endpoints.ScriptAggrStr('{"RequestType":"endpoint", "endpoint":{"connectionname":"My_OpenAIConnection","column":"choices.message.content"}}', 'Translate this text from english to spanish: The sun was rising over the new tomorrow with a tinge of excitement.')` | 此语句将返回对已输入到表达式中的单个问题的响应。<br><br>警告注释<br><br>此表达式不使用 `if` 语句，因此在绑定到数据模型中的字段时不适合使用。它只适用于具有包含硬编码值的单个输入单元格的独立表达式。 |
| OpenAI 聊天补全 API | `if(vQuestion <> '', endpoints.scriptAggrStr('{"RequestType":"endpoint", "endpoint":{"connectionname":"My_OpenAI_Connection_Rows_3","column":"choices.message.content"}}',vQuestion))` | 这是一个可以在链接到变量输入控件的文本对象（来自 Dashboard bundle）中使用的语句。只有在输入时才计算图表。当用户在对象中键入输入内容并按 Enter 键时，图表将显示对其输入的响应。 |
| OpenAI 聊天补全 API | `if(GetSelectedCount(BusinessTopic)=1, endpoints.ScriptAggrStr('{"RequestType":"endpoint", "endpoint":{"connectionname":"My_OpenAI_Connection_Rows_3", "column":"choices.message.content"}}', 'What are people saying about ' & 'BusinessTopic'), 'Please select a single value for BusinessTopic.')` | 这是一个复杂的 `if` 语句，其中只有当用户为字段 `BusinessTopic` 选择了一个值时，才会计算图表。只有当用户在应用程序中进行了此选择时，图表才会更新，如果用户没有，图表将显示以下备用消息：`Please select a single value for BusinessTopic`。 |
| OpenAI 聊天补全 API | `if(<br>count(distinct [IssueCategory]) = 1,<br>endpoints.ScriptAggrStr('{"RequestType":"endpoint", "endpoint":{"connectionname":"My_OpenAI_Connection_Chat_3_5","column":"choices.message.content"}}', 'write me a sample response from a technical support department for a customer complaint about ' & [IssueCategory]))` | 在本例中，只有在应用程序的数据模型的字段 `IssueCategory` 中选择了一个不同的值时，才会计算图表。发送一个请求，要求技术支持部门提供关于一般类型问题的示例响应，`IssueCategory` 字段中包含一个列表。图表将根据用户选择的值进行更新。 |

## 详细示例

显示如何在图表表达式中使用 Azure OpenAI 连接的示例可以在 OpenAI 连接器的教程中找到。请注意，Azure OpenAI 连接器通过平台而不是 Microsoft Azure 平台与模型进行通信。

[教程 - 在 Qlik Cloud 中使用 OpenAI 分析连接器](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/ac-openai-tutorial.htm)

[示例 – 为 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)

## 了解详情

* [服务器端扩展语法](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)