Używanie połączeń Amazon Bedrock - Converse API w wyrażeniach wizualizacji
Oprócz dodawania pytań i odpowiedzi Amazon Bedrock do modelu danych aplikacji za pomocą skryptu ładowania można także wykonywać te operacje bezpośrednio na wykresie w aplikacji. Dane pojedynczego pola są przesyłane między Tobą a Amazon Bedrock.
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ń Amazon Bedrock - Converse API 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 Amazon Bedrock 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:
-
Podczas pracy z wyrażeniami wykresu należy używać połączenia tylko w obiekcie Tekst (z Dashboard bundle). Zdecydowanie odradza się używanie połączenia Amazon Bedrock - Converse API w obiekcie Tabela, zwłaszcza jeśli dodajesz wyrażenie do tabeli z dodanym już co najmniej jednym wymiarem.
-
Jeśli wyrażenie wykresu jest połączone z modelem danych Twojej aplikacji, użyj w nim instrukcji if, aby obliczać wykres tylko wtedy, gdy w aplikacji zostanie dokonany pojedynczy wybór. Zmniejsza to znacznie liczbę wierszy w żądaniach, które Twój wykres wyśle do Amazon Bedrock.
-
Jeśli używasz połączenia Amazon Bedrock - Converse API do wysyłania dużych żądań, użyj połączenia w skrypcie ładowania zamiast w wyrażeniu wykresu, aby dane zostały wstępnie załadowane do modelu danych.
Inżynieria żądań
Pisząc żądania, które wysyłasz do modelu generatywnej sztucznej inteligencji (nazywane też promptami lub zapytaniami), postępuj zgodnie ze wskazówkami specyficznymi dla danej platformy. Aby uzyskać informacje na temat inżynierii promptów i wskazówki dotyczące struktury promptów dla łączników Amazon Bedrock, zobacz temat Prompt engineering concepts.
Z łącznikiem Amazon Bedrock - Converse API można wchodzić w interakcję, używając standardowego formatowania zdań lub tekstu. Nie ma potrzeby poprzedzać polecenia żadnymi specjalnymi słowami kluczowymi ani ciągami znaków. Zob. Szybkie przykłady.
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 Amazon Bedrock - Converse API. 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_Bedrock_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_Bedrock_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_Bedrock_Connection","column":"text"}}', 'Write me a sample response from a technical support department for a customer complaint about ' & [IssueCategory]'))