Verwenden von Google AI - Gemini-Verbindungen in Visualisierungsformeln
Sie können Gemini-Eingaben und -Antworten nicht nur über das Ladeskript zum Datenmodell hinzufügen, sondern diese Vorgänge auch direkt in einem Diagramm in Ihrer App im Analysemodus durchführen. Daten für ein einzelnes Feld werden zwischen Ihnen und Google AI - Gemini hin und her gesendet.
In vielen Fällen kann der für die Ladeskriptverbindung genutzte Code für ein Diagramm wiederverwendet werden, mit einigen Unterschieden.
Wenn der Anwendungsfall auf Benutzereingaben basiert, können Sie eine Analyseverbindung und die zugehörige Syntax für serverseitige Erweiterungen in Ihrer Diagrammformel verwenden, um interaktive Diagramme zu erstellen, die von den Modellendpunkten empfangene Daten visualisieren.
Überlegungen zu Datenanfragemengen
Es wird empfohlen, Google AI - Gemini-Verbindungen in Diagrammformeln nur für eine oder wenige Datenzeilen zu verwenden. Diagrammformeln sollten nicht dazu verwendet werden, große Datenmengen an die Gemini AI-Plattform zu senden.
Achten Sie unbedingt darauf, wie viele Zeilen Sie mit jeder Anfrage senden. Fehler beim Konfigurieren der Verbindung in einer Diagrammformel können zu unbeabsichtigt großen Anfragen führen (z. B. identische Zeilen mit der gleichen Frage, weil das Datenmodell in einem Diagramm falsch verwendet wurde). Bevor Sie mit einer Drittplattform interagieren, müssen Sie sich damit vertraut machen, wie die Felder, die in der Berechnung der Diagrammformel verwendet werden, und ihre Position im Datenmodell sich auf Ihre Zahlungs- und Abrechnungsvereinbarungen mit dem Dritten auswirken. Eine stärkere Nutzung der externen Plattform kann zu höheren Kosten führen.
Befolgen Sie die folgenden Leitlinien, um die Größe Ihrer Anfragen einzuschränken:
-
Viele dieser Konnektorkonfigurationen geben mehrere miteinander in Beziehung stehende Antwortfelder zurück. Wenn Sie die Verbindung in einem Szenario verwenden, in dem Sie nur eines der Antwortfelder in Ihrem Diagramm benötigen, verwenden Sie die Formeln mit einem Text und Bild-Objekt. Wenn Sie mehrere Antwortfelder in Tabellenform darstellen müssen, verwenden Sie den Konnektor stattdessen im Ladeskript. Wenn Sie diese Formeln mit Feldern in Ihrem Datenmodell verbinden, kann dies bei ungenauer Konfiguration leicht zu unbeabsichtigt großen Anfragen führen. Für diese Szenarios wird empfohlen, stattdessen das Ladeskript zu verwenden.
-
Erwägen Sie das Hinzufügen eines if-Befehls zu Ihren Formeln, um zu steuern, wann das Diagramm neu berechnet wird, und um es entsprechend den Benutzerauswahlen in der App zu aktualisieren.
Erstellen der Diagrammformel
Gehen Sie folgendermaßen vor:
-
Klicken Sie bei der Bearbeitung einer Visualisierung auf
, um den Formel-Editor zu öffnen. -
Geben Sie im Formel-Editor eine Formel in das Formelfeld ein. Die Formel muss gemäß der Syntax für serverseitige Erweiterungen aufgebaut sein.
Kurze Beispiele
Hier finden Sie Beispielformeln, die bei den ersten Schritten mit dem Google AI - Gemini-Konnektor verwendet werden können. Beachten Sie Folgendes:
-
Verwenden Sie nur die Formeln mit einem Text-Objekt (aus dem Dashboard bundle). Weitere Informationen finden Sie unter Text.
-
Erwägen Sie das Hinzufügen eines if-Befehls zu Ihren Formeln, um zu steuern, wann das Diagramm neu berechnet wird, und um es entsprechend den Benutzerauswahlen in der App zu aktualisieren.
-
Damit die Formeln funktionieren, müssen Sie den Wert connectionname und die Feldnamen ersetzen, damit sie mit Ihren eigenen Verbindungen und Skripten übereinstimmen.
Beispiel 1
Dieser Befehl gibt die Antwort auf eine einzelne Frage zurück, die in die Formel eingegeben wurde.
Diese Formel verwendet keinen if-Befehl, und von der Verwendung wird abgeraten, wenn sie an ein Feld in Ihrem Datenmodell gebunden ist. Sie eignet sich nur für die Verwendung in einer eigenständigen Formel mit einer einzelnen Eingabezelle, die einen hartcodierten Wert enthält.
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.')Beispiel 2
Dies ist ein Befehl, der in einem Text-Objekt (aus dem Dashboard bundle) verwendet werden kann, das mit einem Variableneingabe-Steuerelement verknüpft ist. Das Diagramm wird nur berechnet, wenn eine Eingabe vorgenommen wird. Wenn der Benutzer eine Eingabe in das Objekt eingibt und die Eingabetaste drückt, zeigt das Diagramm die Antwort des Modells auf die Eingabe an.
Eine ähnliche Anleitung mit einem anderen Konnektor finden Sie unter Übung: Erstellen eines Texteingabefelds mithilfe einer Variablen.
if(vQuestion <> '', endpoints.scriptAggrStr('{"RequestType":"endpoint", "endpoint":{"connectionname":"My_Google_Connection","column":"text"}}',vQuestion))Beispiel 3
In diesem Beispiel wird das Diagramm nur berechnet, wenn ein einzelner distinkter Wert aus dem Feld IssueCategory im Datenmodell der App ausgewählt wurde. Es wird eine Anfrage an das Modell gesendet, die eine Beispielantwort von einer Abteilung für technischen Support auf ein allgemeines Problem anfordert. Eine entsprechende Liste ist im Feld IssueCategory enthalten. Das Diagramm wird je nach dem vom Benutzer ausgewählten Wert aktualisiert.
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]'))