Använda Google AI - Gemini-kopplingar i visualiseringsuttryck
Förutom att lägga till Gemini-indata och -svar i din apps datamodell med laddningsskriptet kan du också utföra de här åtgärderna direkt i ett diagram i din app i analysläge. Data för ett enstaka fält skickas fram och tillbaka mellan dig och Google AI - Gemini.
I många fall kan koden som används för en laddningsskriptskoppling modifieras och återanvändas för användning i ett diagram, med några skillnader.
Om användningscachen baseras på användarinmatning kan du använda en analyskoppling och motsvarande syntax för komplement på serversidan i ditt diagramuttryck till att skapa interaktiva diagram som visualiserar data som tagits emot från modellens slutpunkter.
Överväganden för dataförfrågningsvolymer
Vi rekommenderar att du endast använder Google AI - Gemini-kopplingar i diagramuttryck för en rad eller ett fåtal rader med data. Vi avråder från att använda diagramuttryck för att skicka stora mängder data till AI-plattformen Gemini.
Det är viktigt att vara medveten om hur många rader du skickar med varje begäran. Fel vid konfigurering av kopplingen i ett diagramuttryck kan leda till oavsiktligt stora förfrågningar (t.ex. identiska rader med samma fråga på grund av felaktig användning av datamodellen i ett diagram). Innan du interagerar med en tredjepartsplattform bör du se till att du är medveten om hur de fält som används i beräkningen av diagramuttryck, och deras plats i datamodellen, påverkar ditt finansiella avtal och faktureringsarrangemang med tredje part. Högre användning av den externa plattformen kan leda till högre kostnader.
Följ dessa riktlinjer för att begränsa storleken på dina förfrågningar.
-
Många av dessa kopplingskonfigurationen returnerar flera sinsemellan relaterade svarsfält. Om du använder kopplingen i ett scenario där du bara behöver ett av svarsfälten i ditt diagram använder du uttrycken med ett text och bild-objekt. Om du behöver representera flera svarsfält i tabellform använder du kopplingen i laddningsskriptet i stället. Att koppla de här uttrycken till fält i din datamodell kan lätt leda till oavsiktligt stora begäran om konfigurationen är felaktig. Vi rekommenderar i stället att du använder laddningsskriptet i de här scenarierna.
-
Överväg att lägga till en if-sats till dina uttryck för att kontrollera när diagrammet beräknas om, och för att uppdatera beroende på användarval i appen.
Skapa diagramuttrycket
Gör följande:
-
När du redigerar en visualisering klickar du på
för att gå till uttrycksredigeraren. -
Ange ett uttryck i uttrycksfältet i uttrycksredigeraren. Uttrycket måste konstrueras med syntaxen för komplement på serversidan.
Snabbexempel
Här kan du hitta exempeluttryck som kan användas när du kommer igång med Google AI - Gemini-kopplingen. Tänk på följande detaljer:
-
Använd endast uttryck med ett Text-objekt (från Dashboard bundle). Se Text.
-
Överväg att lägga till en if-sats till dina uttryck för att kontrollera när diagrammet beräknas om, och för att uppdatera beroende på användarval i appen.
-
För att uttrycken ska fungera måste du ersätta connectionname-värdet och eventuella fältnamn så att de matchar dina egna kopplingar och skript.
Exempel 1
Denna sats kommer att returnera svaret på en enda fråga som har angivits i uttrycket.
Det här uttrycket använder inte en if-sats, och rekommenderas inte att användas om det är kopplat till ett fält i din datamodell. Det är endast lämpligt för användning i ett fristående uttryck med en cell för enkelvärdesindata som innehåller ett hårdkodat värde.
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.')Exempel 2
Detta är en sats som kan användas i ett Text-objekt (från Dashboard bundle) länkat till en kontroll för variabelinmatning. Diagrammet beräknas endast när indata anges. När användaren anger indata i objektet och trycker på Retur visar diagrammet modellens svar på hens indata.
För en liknande genomgång med en annan koppling, se Övning: skapa en textindatabox med en variabel.
if(vQuestion <> '', endpoints.scriptAggrStr('{"RequestType":"endpoint", "endpoint":{"connectionname":"My_Google_Connection","column":"text"}}',vQuestion))Exempel 3
I det här exemplet beräknas diagrammet endast om ett distinkt värde har valts från fältet IssueCategory i appens datamodell. En förfrågan skickas till modellen för att be om ett exempelsvar från en avdelning för teknisk support om en allmän typ av problem, en lista som finns i fältet IssueCategory. Diagrammet uppdateras beroende på det värde som valts av användaren.
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]'))