Google AI - Gemini-verbindingen gebruiken in visualisatie-uitdrukkingen
Naast het toevoegen van invoer en reacties van Gemini aan het gegevensmodel met behulp van het load-script, kunt u deze bewerkingen in de analysemodus ook direct in een diagram in uw app uitvoeren. Gegevens voor een afzonderlijk veld worden heen en weer gestuurd tussen u en Google AI - Gemini.
In veel gevallen kan de code die is gebruikt voor een verbinding met een load-script opnieuw worden gebruikt in een diagram, waarbij enkele wijzigingen moeten worden aangebracht.
Als het gebruik is gebaseerd op invoer van de gebruiker, kunt u in uw diagramuitdrukking een analytische verbinding met overeenkomstige SSE-syntax gebruiken om interactieve diagrammen te maken die van de modeleindpunten ontvangen gegevens visualiseren.
Overwegingen voor de aanvraag van gegevensvolumes
Aanbevolen wordt om Google AI - Gemini-verbindingen alleen in diagramuitdrukkingen te gebruiken voor een klein aantal rijen met gegevens. Het wordt niet aanbevolen om diagramuitdrukkingen te gebruiken om grote hoeveelheden gegevens naar het Gemini AI-platform te verzenden.
Het is van belang dat u weet hoeveel rijen u verzendt bij elke aanvraag. Fouten bij de configuratie van de verbinding in een diagramuitdrukking kunnen leiden tot onbedoeld grote aanvragen (bijvoorbeeld identieke rijen met dezelfde vraag omdat het gegevensmodel in een diagram onjuist wordt gebruikt). Voordat u werkt met een extern platform, moet u weten hoe de velden in de berekening van een diagramuitdrukking worden gebruikt, wat hun plaats is in het gegevensmodel en hoe het van invloed is op uw financiële overeenkomst en factureringsovereenkomsten met de derde partij. Een veelvuldiger gebruik van het externe platform kan leiden tot hogere kosten.
Volg de volgende richtlijnen om de grootte van uw aanvragen te beperken:
-
Veel van deze connectorconfiguraties retourneren meerdere onderling verbonden responsvelden. Als u de verbinding gebruikt in een scenario waarbij u slechts een van de responsvelden in uw diagram nodig hebt, gebruik dan de uitdrukkingen met een tekst en afbeeldingsobject. Gebruik de connector in het load-script als u meerdere responsvelden in tabelvorm wilt weergeven. Wanneer u deze uitdrukkingen koppelt aan velden in uw gegevensmodel, kan dit snel leiden tot onbedoeld grote aanvragen als ze verkeerd zijn geconfigureerd. Daarom wordt aanbevolen om in deze scenario's het load-script te gebruiken.
-
Overweeg om een if-instructie toe te voegen aan uw uitdrukking om te beheren wanneer het diagram opnieuw wordt berekend en wordt bijgewerkt op basis van selecties van de gebruiker in de app.
De diagramuitdrukking maken
Doe het volgende:
-
Klik bij het bewerken van een visualisatie op
om de uitdrukkingseditor te openen.
-
Geef in de uitdrukkingseditor een uitdrukking op in het uitdrukkingsveld. De uitdrukking moet worden gebouwd op basis van de SSE-syntax.
Snelle voorbeelden
Hier vindt u voorbeelduitdrukkingen die u kunt gebruiken als u gaat werken met de Google AI - Gemini‑connector. Houd rekening met het volgende:
-
Gebruik alleen de uitdrukkingen met een Tekstobject (vanuit de Dashboard bundle). Zie: Tekst.
-
Overweeg om een if-instructie toe te voegen aan uw uitdrukking om te beheren wanneer het diagram opnieuw wordt berekend en wordt bijgewerkt op basis van selecties van de gebruiker in de app.
-
U moet de waarde van connectionname en veldnamen vervangen zodat ze overeenkomen met uw verbindingen en scripts om te zorgen dat uitdrukkingen werken.
Voorbeeld 1
De instructie retourneert de reactie op een afzonderlijke vraag, die is ingevoerd in de uitdrukking.
Deze uitdrukking gebruikt geen if-instructie en is daarom niet geschikt om te gebruiken als deze is gekoppeld aan een veld in uw gegevensmodel. Deze is alleen geschikt om te gebruiken in een afzonderlijke uitdrukking met één invoercel met een hard-gecodeerde waarde.
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.')
Voorbeeld 2
Dit is een instructie die kan worden gebruikt in een Tekstobject (vanuit de Dashboard bundle) gekoppeld aan een besturingselement voor variabeleninvoer. Het diagram wordt alleen berekend als invoer wordt opgegeven. Als de gebruiker invoer in het object typt en op Enter drukt, toont het diagram de reactie van het model op de invoer.
Voor een vergelijkbare rondleiding met een andere connector, raadpleegt u Oefening: een tekstinvoervak maken met behulp van een variabele.
if(vQuestion <> '', endpoints.scriptAggrStr('{"RequestType":"endpoint", "endpoint":{"connectionname":"My_Google_Connection","column":"text"}}',vQuestion))
Voorbeeld 3
In dit voorbeeld wordt het diagram alleen berekend als één unieke waarde is geselecteerd in het veld IssueCategory in het gegevensmodel van de app. Er wordt een verzoek naar het model verzonden voor een voorbeeldreactie van een technische supportafdeling over een algemeen probleem. Een lijst daarvan is opgenomen in het veld IssueCategory. Het diagram wordt bijgewerkt op basis van de waarde die is geselecteerd door de gebruiker.
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]'))