# Usando conexões Google AI - Gemini em expressões de visualização

Além de adicionar entradas e respostas do Gemini ao seu modelo de dados usando o script de carregamento, você também pode executar essas operações diretamente em um gráfico no seu aplicativo no modo de análise. Os dados de um único campo são enviados e recebidos entre você e o Google AI - Gemini.

Em muitos casos, o código usado para uma conexão de script de carregamento pode ser reaproveitado para uso em um gráfico, com algumas diferenças.

Se o caso de uso for baseado na entrada do usuário, você poderá usar uma conexão analítica e a sintaxe de extensão no lado do servidor correspondente na sua expressão de gráfico para criar gráficos interativos que visualizam os dados recebidos dos terminais do modelo.

## Considerações para volumes de solicitação de dados

Recomenda-se usar apenas conexões Google AI - Gemini em expressões de gráfico para uma ou algumas linhas de dados. Não é recomendado usar expressões de gráfico para enviar grandes quantidades de dados para a plataforma de IA do Gemini.

É importante estar ciente de quantas linhas você está enviando com cada solicitação. Erros na configuração da conexão em uma expressão de gráfico podem levar a solicitações involuntariamente grandes (por exemplo, linhas idênticas com a mesma pergunta devido ao uso indevido do modelo de dados em um gráfico). Antes de interagir com uma plataforma de terceiros, certifique-se de estar ciente de como os campos usados no cálculo da expressão de gráfico e seu lugar no modelo de dados afetam seu contrato financeiro e acordos de cobrança com terceiros. Uma maior utilização da plataforma externa pode resultar em custos mais elevados.

Siga estas diretrizes para moderar e limitar o tamanho das suas solicitações:

* Muitas dessas configurações de conector retornam vários campos de resposta inter-relacionados. Se você estiver usando a conexão em um cenário em que precisa apenas de um dos campos de resposta em seu gráfico, use as expressões com um objeto de Texto e imagem. Se você precisar representar vários campos de resposta em formato tabular, use o conector no script de carregamento. Conectar essas expressões a campos em seu modelo de dados pode facilmente resultar em solicitações grandes e involuntárias se configuradas incorretamente. Em vez disso, é recomendado usar o script de carregamento nesses cenários.

* Considere adicionar uma instrução `if` às suas expressões para controlar quando o gráfico é recalculado e para atualizar dependendo das seleções do usuário no aplicativo.

## Criando a expressão de gráfico

Faça o seguinte:

1. Ao editar uma visualização, clique em the Expressão icon para entrar no editor de expressões.

2. No editor de expressões, insira uma expressão no campo de expressão. A expressão deve ser construída usando a sintaxe de extensão no lado do servidor.

## Exemplos rápidos

Aqui você pode encontrar expressões de exemplo que podem ser usadas ao começar a usar o conector do Google AI - Gemini. Considere os seguintes detalhes:

* Use as expressões apenas com um objeto Texto (do Dashboard bundle). Consulte [Texto](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Visualizations/DashboardBundle/text-object.htm).

* Considere adicionar uma instrução `if` às suas expressões para controlar quando o gráfico é recalculado e para atualizar dependendo das seleções do usuário no aplicativo.

* Para que as expressões funcionem, você deve substituir o valor `connectionname` e quaisquer nomes de campo para corresponder às suas próprias conexões e scripts.

### Exemplo 1

Essa instrução retornará a resposta a uma única pergunta, que foi inserida na expressão.

Nota de advertência

Essa expressão não usa uma instrução `if`, e não é aconselhável usá-la se estiver vinculada a um campo em seu modelo de dados. É adequado apenas para uso em uma expressão autônoma com uma única célula de entrada contendo um valor codificado.

```
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.')
```

### Exemplo 2

Esta é uma instrução que pode ser usada em um objeto Texto (do Dashboard bundle) vinculado a um controle de entrada Variável. O gráfico só é calculado quando a entrada é inserida. Quando o usuário digita a entrada no objeto e pressiona Enter, o gráfico exibe a resposta do modelo à sua entrada.

Para obter um passo a passo semelhante com um conector diferente, consulte [Exercício: criando uma caixa de entrada de texto usando uma variável](https://help.qlik.com/pt-BR/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))
```

### Exemplo 3

Neste exemplo, o gráfico só será calculado se um valor distinto tiver sido selecionado no campo `IssueCategory` no modelo de dados do aplicativo. Uma solicitação é enviada ao modelo solicitando um exemplo de resposta de um departamento de suporte técnico sobre um tipo geral de problema, cuja lista está contida no campo `IssueCategory`. O gráfico é atualizado dependendo do valor selecionado pelo usuário.

```
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]'))
```

## Saiba mais

* [Sintaxe das extensões no lado do servidor](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/sse-syntax.htm)
* [if Função de script e de gráfico](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ConditionalFunctions/if.htm)
* [GetSelectedCount - função de gráfico](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/FieldFunctions/getselectedcount.htm)
* [Usando variáveis em expressões](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Variables/work-with-variables.htm)