# 在可视化表达式中使用 Google AI - Gemini 连接

除了使用加载脚本向您的数据模型添加 Gemini 输入和响应外，您还可以在分析模式下直接在应用程序的图表中执行这些操作。单个字段的数据在您和 Google AI - Gemini 之间来回发送。

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

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

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

建议只在一行或几行数据的图表表达式中使用 OpenAI 连接。Google AI - Gemini不建议使用图表表达式向 Gemini AI 平台发送大量数据。

了解每个请求发送的行数非常重要。在图表表达式中配置 Azure OpenAI 连接的错误可能会导致意外的大型请求（例如，由于图表中数据模型的使用不当，导致具有相同问题的相同行）。在与第三方平台交互之前，请确保您了解图表表达式计算中使用的字段及其在数据模型中的位置如何影响您与第三方的财务协议和计费安排。外部平台的使用率越高，所产生的成本就越高。

请遵循以下指导原则来缓和和限制您的请求大小：

* 这些连接器配置中的许多都返回多个相互关联的响应字段。如果在图表中只需要一个响应字段的情况下使用连接，请将表达式与文本和图像对象一起使用。如果确实需要以表格形式表示多个响应字段，请改用加载脚本中的连接器。如果配置不正确，将这些表达式连接到数据模型中的字段很容易导致大小意外过高的请求。相反，建议在这些场景中使用加载脚本。

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

## 创建图表表达式

执行以下操作：

1. 在编辑可视化时，单击 the 表达式 icon 进入表达式编辑器。

2. 在表达式编辑器中，在表达式字段中输入一个表达式。表达式必须使用服务器端扩展语法构造。

## 简单示例

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

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

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

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

### 示例 1

此语句将返回对已输入到表达式中的单个问题的响应。

警告注释

此表达式不使用 `if` 语句，因此在绑定到数据模型中的字段时不建议使用。它只适用于具有包含硬编码值的单个输入单元格的独立表达式。

```
endpoints.ScriptAggrStr('{"RequestType":"endpoint", "endpoint":{"connectionname":"My_Google_Connection","column":"text"}}', 'Translate this text from english to spanish: The sun was rising over the new tomorrow with a tinge of excitement.')
```

### 示例 2

这是一个可以在链接到变量输入控件的文本对象（来自 Dashboard bundle）中使用的语句。只有在输入时才计算图表。当用户在对象中键入输入内容并按 Enter 键时，图表将显示对其输入的响应。

有关使用不同连接器的类似演练，请参阅[练习：使用变量创建文本输入框](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/ac-openai-tutorial-example-3.htm#Exercise)。

```
if(vQuestion <> '', endpoints.scriptAggrStr('{"RequestType":"endpoint", "endpoint":{"connectionname":"My_Google_Connection","column":"text"}}',vQuestion))
```

### 示例 3

在本例中，只有在从应用程序的数据模型的字段 `IssueCategory` 中选择了一个不同的值时，才会计算图表。向模型发送一个请求，要求技术支持部门提供关于一般类型问题的示例响应，`IssueCategory` 字段中包含一个列表。图表将根据用户选择的值进行更新。

```
if(count(distinct [IssueCategory]) = 1, endpoints.ScriptAggrStr('{"RequestType":"endpoint", "endpoint":{"connectionname":"My_Google_Connection","column":"text"}}', 'Write me a sample response from a technical support department for a customer complaint about ' & [IssueCategory]'))
```

## 了解详情

* [服务器端扩展语法](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/sse-syntax.htm)
* [if 脚本和图表功能](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ConditionalFunctions/if.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)