Utilisation de connexions Google AI - Gemini dans des expressions de visualisation
Outre l'ajout d'une entrée et de réponses Gemini à votre modèle de données via le script de chargement, vous pouvez effectuer ces opérations directement dans un graphique de votre application en mode d'analyse. Les données d'un seul champ font l'aller-retour entre vous et Google AI - Gemini.
Dans de nombreux cas, le code utilisé pour une connexion de script de chargement peut être adapté pour être réutilisé dans un graphique, en y intégrant quelques différences.
Si le cas d'utilisation est basé sur la saisie de l'utilisateur, vous pouvez utiliser une connexion analytique et la syntaxe server-side extension (SSE) correspondante dans votre expression de graphique pour créer des graphiques interactifs qui visualisent les données reçues depuis les points de terminaison du modèle.
Considérations relatives aux volumes de requêtes de données
Il est recommandé d'utiliser uniquement des connexions Google AI - Gemini dans des expressions de graphique pour une ou plusieurs lignes de données. Il n'est pas recommandé d'utiliser des expressions de graphique pour envoyer de grandes quantités de données à la plateforme d'IA Gemini.
Il est important de connaître le nombre de lignes que vous envoyez à chaque requête. Des erreurs de configuration de la connexion dans une expression de graphique peuvent produire des requêtes involontairement volumineuses (par exemple, des lignes identiques avec la même question en raison de l'utilisation inappropriée du modèle de données dans un graphique). Avant d'interagir avec une plateforme tierce, assurez-vous de savoir comment les champs utilisés dans le calcul des expressions de graphique et leur placement dans le modèle de données affectent vos accords financiers et de facturation avec le tiers. Une utilisation supérieure de la plateforme externe peut entraîner une augmentation des coûts encourus.
Suivez ces consignes pour modérer et limiter la taille de vos requêtes :
-
Un grand nombre de ces configurations de connecteur renvoient différents champs de réponse interdépendants. Si vous utilisez la connexion dans un scénario dans lequel vous avez besoin d'un seul des champs de réponse dans votre graphique, utilisez les expressions avec un objet Texte et image. Si vous avez besoin de représenter plusieurs champs de réponse au format tabulaire, utilisez plutôt le connecteur dans le script de chargement. La connexion de ces expressions à des champs de votre modèle de données peut facilement produire des requêtes involontairement de grande taille, en cas de configuration incorrecte. Dans ces scénarios, il est plutôt recommandé d'utiliser le script de chargement.
-
Pensez à ajouter une instruction if à vos expressions pour contrôler le moment du recalcul du graphique et pour effectuer une mise à jour en fonction des sélections utilisateur dans l'application.
Création de l'expression de graphique
Procédez comme suit :
-
Lors de l'édition d'une visualisation, cliquez sur
pour ouvrir l'éditeur d'expression. -
Dans l'éditeur d'expression, saisissez une expression dans le champ d'expression. L'expression peut être créée via la syntaxe server-side extension (SSE).
Exemples rapides
Vous trouverez ici en exemple des expressions qui peuvent être utilisées lorsque vous démarrez avec le connecteur Google AI - Gemini. N'oubliez pas les informations suivantes :
-
Utilisez uniquement les expressions avec un objet Texte (du Dashboard bundle). Consultez Texte.
-
Pensez à ajouter une instruction if à vos expressions pour contrôler le moment du recalcul du graphique et pour effectuer une mise à jour en fonction des sélections utilisateur dans l'application.
-
Pour que les expressions fonctionnent, vous devez remplacer la valeur connectionname et tous les noms de champ de sorte qu'ils correspondent à vos propres connexions et scripts.
Exemple 1
Cette instruction renverra la réponse à une seule question, qui a été saisie dans l'expression.
Cette expression n'utilise pas d'instruction if, et il n'est pas conseillé de l'utiliser si elle est liée à un champ de votre modèle de données. Elle peut être utilisée uniquement dans une expression autonome avec une seule cellule d'entrée contenant une valeur codée en dur.
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.')Exemple 2
Cette instruction peut être utilisée dans un objet Texte (du Dashboard bundle) lié à un contrôle Entrée de variable. Le graphique est calculé uniquement lorsque l'entrée est validée via Entrée. Lorsque l'utilisateur saisit une entrée dans l'objet et appuie sur Entrée, le graphique affiche la réponse du modèle à son entrée.
Pour une présentation similaire avec un autre connecteur, consultez Exercice : Création d'une zone de saisie de texte via une variable.
if(vQuestion <> '', endpoints.scriptAggrStr('{"RequestType":"endpoint", "endpoint":{"connectionname":"My_Google_Connection","column":"text"}}',vQuestion))Exemple 3
Dans cet exemple, le graphique est calculé uniquement si une valeur distincte a été sélectionnée dans le champ IssueCategory du modèle de données de l'application. Une requête est envoyée au modèle, demandant un exemple de réponse d'un service d'assistance technique sur un type de problème général, dont la liste est contenue dans le champ IssueCategory. Le graphique est mis à jour en fonction de la valeur sélectionnée par l'utilisateur.
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]'))