Utilizzo delle connessioni Google AI - Gemini nelle espressioni di visualizzazione
Oltre ad aggiungere l'input e le risposte di Gemini al modello dati della propria utilizzando lo script di caricamento, è possibile anche eseguire queste operazioni direttamente in un grafico della propria app nella modalità di analisi. I dati per un singolo campo vengono inviati avanti e indietro tra l'utente e Google AI - Gemini.
In molti casi, il codice usato per la connessione di uno script di caricamento può essere riutilizzato in un grafico, con alcune differenze.
Se il caso di utilizzo si basa sull'input dell'utente, è possibile utilizzare una connessione di analisi e la sintassi corrispondente di estensione lato server nell'espressione del grafico dell'utente al fine di creare grafici interattivi che visualizzino i dati ricevuti dagli endpoint modello.
Considerazioni relative al volume dati delle richieste
Per le espressioni del grafico per una o alcune righe di dati, si consiglia di utilizzare esclusivamente le connessioni Google AI - Gemini. Non si consiglia l'utilizzo di espressioni del grafico per inviare grandi quantità di dati alla piattaforma IA Gemini.
È importante conoscere il numero di righe che si inviano con ogni richiesta. Gli errori nella configurazione della connessione in un'espressione del grafico possono portare a richieste accidentalmente grandi (ad esempio, a causa di righe identiche con la stessa domanda a causa dell'utilizzo scorretto del modello dati in un grafico). Prima di interagire con una piattaforma di terze parti, assicurarsi di conoscere in che modo i campi utilizzati nel calcolo dell'espressione del grafico, e la loro posizione nel modello dati, hanno effetto sull'accordo finanziario e sulle modalità di fatturazione con le terze parti. Un utilizzo più elevato della piattaforma esterna può determinare costi superiori.
Seguire queste linee guida per controllare e limitare le dimensioni delle richieste:
-
Molte delle configurazioni di questo connettore restituiscono più campi di risposta interdipendenti. Se si utilizza una connessione in uno scenario in cui è necessario solo uno dei campi di risposta nel grafico, utilizzare le espressioni con un oggetto Testo e immagine. Se l'utente deve rappresentare più campi di risposta in formato tabulare, utilizzare invece il connettore nello script di caricamento. La connessione di queste espressioni ai campi nel modello dati può generare richieste accidentalmente di grandi dimensioni, se configurata in modo incorretto. In questi scenari, si consiglia invece di utilizzare lo script di caricamento.
-
Considerare di aggiungere un'istruzione if alle espressioni per controllare quando bisogna ricalcolare e aggiornare il grafico, a seconda delle selezioni dell'utente nell'app.
Creazione di espressioni del grafico
Procedere come indicato di seguito:
-
Al momento di modificare una visualizzazione, fare clic su
per accedere all'editor delle espressioni. -
Nell'editor delle espressioni, inserire un'espressione nel campo espressioni. L'espressione deve essere formulata usando la sintassi dell'estensione lato server.
Esempi rapidi
In questa sezione vengono elencate alcune espressioni di esempio che è possibile utilizzare quando con il connettore Google AI - Gemini. Tenere presente le seguenti indicazioni:
-
Utilizzare unicamente espressioni con un oggetto Testo (da Dashboard bundle). Vedere Testo.
-
Considerare di aggiungere un'istruzione if alle espressioni per controllare quando bisogna ricalcolare e aggiornare il grafico, a seconda delle selezioni dell'utente nell'app.
-
Per fare in modo che le espressioni funzionino correttamente, è necessario sostituire il valore connectionname e i nomi di qualsiasi campo in modo che corrispondano alle connessioni e script utilizzati dall'utente.
Esempio 1
Questa istruzione restituirà la risposta a una singola domanda, inserita nell'espressione.
Questa espressione non utilizza un'istruzione if, e non se ne consiglia l'uso se vincolata a un campo nel modello dati dell'utente. È adatta per l'uso solo in un'espressione indipendente con un'unica cella di input contenente un valore codificato.
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.')Esempio 2
Questa è un'istruzione che può essere utilizzata in un oggetto Testo (da Dashboard bundle) collegato a un controllo Input variabile. Il grafico viene calcolato solo dopo aver inserito l'input. Quando l'utente digita l'input nell'oggetto e preme Invio, il grafico visualizza la risposta del modello al testo inserito.
Per una procedura dettagliata simile con un connettore differente, vedere Esercizio: creazione di una casella di testo di input che utilizza una variabile.
if(vQuestion <> '', endpoints.scriptAggrStr('{"RequestType":"endpoint", "endpoint":{"connectionname":"My_Google_Connection","column":"text"}}',vQuestion))Esempio 3
In questo esempio, il grafico viene calcolato solo se un valore distinto viene selezionato dal campo IssueCategory nel modello dati dell'app. Un prompt viene inviato al modello per richiedere una risposta di esempio da un dipartimento di supporto tecnico riguardante un tipo generale di problema, un elenco dei quali è incluso nel campo IssueCategory. Il grafico viene aggiornato a seconda del valore selezionato dall'utente.
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]'))