Używanie połączeń Google AI - Gemini w wyrażeniach wizualizacji
Oprócz dodawania danych wejściowych i odpowiedzi Gemini do modelu danych aplikacji za pomocą skryptu ładowania można także wykonywać te operacje bezpośrednio na wykresie w aplikacji w trybie analizy. Dane pojedynczego pola są przesyłane między Tobą a Google AI - Gemini.
W wielu przypadkach kod używany do połączenia skryptu ładowania można ponownie wykorzystać na wykresie, ale z pewnymi różnicami.
Jeśli zastosowanie bazuje na danych wejściowych użytkownika, można użyć połączenia analitycznego i odpowiedniej składni rozszerzenia po stronie serwera w wyrażeniu wykresu, aby tworzyć interaktywne wykresy, które wizualizują dane otrzymane z punktów końcowych modelu.
Uwagi dotyczące wolumenów żądań danych
Zaleca się używanie połączeń Google AI - Gemini w wyrażeniach wykresu tylko dla jednego lub kilku wierszy danych. Używanie wyrażeń wykresu do wysyłania dużych ilości danych do platformy AI Gemini nie jest zalecane.
Ważne jest, aby mieć świadomość, ile wierszy wysyła się z każdym żądaniem. Błędy w konfiguracji połączenia w wyrażeniu wykresu mogą prowadzić do nieumyślnie dużych żądań (na przykład z identycznymi wierszami z tym samym pytaniem z powodu niewłaściwego użycia modelu danych na wykresie). Zanim wejdziesz w interakcję z platformą podmiotu zewnętrznego, musisz wiedzieć, jak pola używane do obliczania wyrażeń wykresu oraz ich miejsce w modelu danych wpływają na Twoją umowę finansową i ustalenia rozliczeniowe z podmiotem zewnętrznym. Częstsze korzystanie z platformy zewnętrznej może skutkować wyższymi kosztami.
Aby moderować i ograniczać rozmiar żądań, postępuj zgodnie z tymi wskazówkami:
-
Wiele z tych konfiguracji łączników zwraca wiele powiązanych ze sobą pól odpowiedzi. Jeśli używasz połączenia w sytuacji, w której potrzebujesz tylko jednego z pól odpowiedzi na wykresie, użyj wyrażeń z obiektem Tekst i grafika. Jeśli musisz przedstawić wiele pól odpowiedzi w formie tabelarycznej, zamiast tego użyj łącznika w skrypcie ładowania. Łączenie tych wyrażeń z polami w modelu danych może z łatwością skutkować niezamierzonymi dużymi żądaniami w przypadku nieprawidłowej konfiguracji. Zamiast tego w takich sytuacjach zaleca się użycie skryptu ładowania.
-
Rozważ dodanie instrukcji if do wyrażeń, aby kontrolować moment przeliczenia wykresu i aktualizować w zależności od wyborów dokonanych przez użytkownika w aplikacji.
Tworzenie wyrażenia wykresu
Wykonaj następujące czynności:
-
Podczas edycji wizualizacji kliknij
, aby otworzyć edytor wyrażeń. -
W edytorze wyrażeń wprowadź wyrażenie do pola wyrażenia. Wyrażenie należy skonstruować przy użyciu składni rozszerzenia po stronie serwera.
Szybkie przykłady
Tutaj znajdziesz przykładowe wyrażenia, których można używać podczas rozpoczynania pracy z łącznikiem Google AI - Gemini. Uwzględnij następujące szczegóły:
-
Używaj tych wyrażeń wyłącznie z obiektem Tekst (z Dashboard bundle). Zob. Tekst.
-
Rozważ dodanie instrukcji if do wyrażeń, aby kontrolować moment przeliczenia wykresu i aktualizować w zależności od wyborów dokonanych przez użytkownika w aplikacji.
-
Aby wyrażenia działały, musisz zastąpić wartość connectionname oraz nazwy pól tak, aby odpowiadały Twoim własnym połączeniom i skryptom.
Przykład 1:
Ta instrukcja zwróci odpowiedź na pojedyncze pytanie, które zostało wprowadzone do wyrażenia.
To wyrażenie nie używa instrukcji if i dlatego nie zaleca się używania go, jeśli jest powiązane z polem w modelu danych. Nadaje się tylko do użycia w samodzielnym wyrażeniu z pojedynczą komórką wejściową zawierającą zakodowaną na stałe wartość.
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.')Przykład 2
Jest to instrukcja, której można użyć w obiekcie Tekst (z Dashboard bundle) połączonym z elementem sterującym Wprowadzanie zmiennych. Wykres jest obliczany dopiero po wprowadzeniu danych wejściowych. Gdy użytkownik wprowadzi dane wejściowe do obiektu i naciśnie klawisz Enter, na wykresie zostanie wyświetlona odpowiedź modelu na dane wejściowe.
Podobny przewodnik z innym łącznikiem zawiera temat Ćwiczenie: tworzenie pola wprowadzania tekstu przy użyciu zmiennej.
if(vQuestion <> '', endpoints.scriptAggrStr('{"RequestType":"endpoint", "endpoint":{"connectionname":"My_Google_Connection","column":"text"}}',vQuestion))Przykład 3
W tym przykładzie wykres jest obliczany tylko wtedy, gdy z pola IssueCategory w modelu danych aplikacji wybrano jedną odrębną wartość. Wysyłane jest do modelu żądanie przykładowej odpowiedzi działu pomocy technicznej dotyczącej ogólnego rodzaju problemu z listy problemów w polu IssueCategory. Wykres jest aktualizowany na podstawie wartości wybranej przez użytkownika.
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]'))