# 在視覺化運算式中使用 Google AI - Gemini 連線

除了使用載入指令碼將 Gemini 輸入和回應新增至資料模型，您也可以直接在分析模式下於應用程式的圖表中執行這些操作。會在您和 Google AI - Gemini 之間來回傳送單一欄位的資料。

在許多情況下，用於載入指令碼連線的程式碼可以重新用於圖表，並具有差異。

如果使用案例是根據使用者輸入，您可以在圖表運算式中使用分析連線和對應的伺服器端延伸語法來建立互動式圖表，以視覺化從模型端點接收的資料。

## 資料請求量的考慮事項

在圖表運算式中使用 Google AI - Gemini 連線建議僅用於一列或幾列資料。不建議使用圖表運算式將大量資料傳送至 Gemini AI 平台。

重要的是，應注意您對每個請求傳送多少列。若在圖表運算式中設定 連線時發生錯誤，可能導致意外的大量請求 (例如由於不當使用圖表中的資料模型而出現問題相同的相同列)。在您與第三方平台互動之前，請確認您瞭解欄位在圖表運算式計算的使用方式，及其在資料模型中的位置，會影響與第三方的財務協議和計費安排。較高的外部平台使用率可能會造成較高的費用。

遵守這些準則以節制並限制請求的大小：

* 其中許多連接器設定會傳回多個互相關聯的回應欄位。若您在只需要圖表中其中一個回應欄位的情境下使用連線，則使用運算式以及文字與影像物件。若您需要以表格形式呈現多個回應欄位，請改為在載入指令碼中使用連接器。將這些運算式連線至資料模型中的欄位容易在無意間產生大量請求 (若正確設定)。建議在這些情境下使用載入指令碼。

* 考慮將 `if` 陳述式新增至運算式，以控制何時重新計算圖表，以及根據應用程式中的使用者選項更新。

## 建立圖表運算式

請執行下列動作：

1. 編輯視覺效果時，按一下 the 運算式 icon 進入運算式編輯器。

2. 在運算式編輯器中，在運算式欄位中輸入運算式。必須使用伺服器端延伸語法建構運算式。

## 快速範例

您可在此找到樣本運算式，這可在開始使用 Google AI - Gemini 連接器時使用。考慮下列詳細資訊：

* 僅搭配文字物件使用運算式 (從 Dashboard bundle)。請參閱 [文字](https://help.qlik.com/zh-TW/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-TW/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-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/sse-syntax.htm)
* [if 指令碼與圖表函數](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ConditionalFunctions/if.htm)
* [GetSelectedCount - 圖表函數](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/FieldFunctions/getselectedcount.htm)
* [在運算式中使用變數](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/Variables/work-with-variables.htm)