Verwenden von Amazon Bedrock - Converse API-Verbindungen in Visualisierungsformeln
Sie können Amazon Bedrock-Fragen und -Antworten nicht nur über das Ladeskript zum Datenmodell Ihrer App 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 Amazon Bedrock 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, Amazon Bedrock - Converse API-Verbindungen in Diagrammformeln nur für eine oder wenige Datenzeilen zu verwenden. Diagrammformeln sollten nicht dazu verwendet werden, große Datenmengen an Amazon Bedrock 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:
-
Wenn Sie mit Diagrammformeln arbeiten, verwenden Sie die Verbindung nur in einem Text-Objekt (aus dem Dashboard bundle). Es wird dringend davon abgeraten, eine Amazon Bedrock - Converse API-Verbindung in einem Tabellen-Objekt zu verwenden, besonders, wenn Sie die Formel zu einer Tabelle hinzufügen, der bereits eine oder mehrere Dimensionen hinzugefügt wurden.
-
Wenn die Diagrammformel mit dem Datenmodell Ihrer App verknüpft ist, verwenden Sie einen if-Befehl in der Formel, um das Diagramm nur zu berechnen, wenn eine einzelne Auswahl in der App getroffen wird. Damit wird die Zeilenanzahl der Anfragen, die Ihr Diagramm an Amazon Bedrock sendet, erheblich verringert.
-
Wenn Sie eine Amazon Bedrock - Converse API-Verbindung zum Senden großer Anfragen verwenden, sollten Sie die Verbindung in Ihrem Ladeskript statt in einer Diagrammformel nutzen, damit die Daten vorab in Ihr Datenmodell geladen werden.
Erstellen von Eingabeaufforderungen
Folgen Sie beim Schreiben der Anfragen, die Sie an ein generatives KI-Modell senden (oft als Eingabeaufforderungen bzw. Prompts bezeichnet) den spezifischen Leitlinien für die Plattform, mit der Sie interagieren. Informationen zum Erstellen von Eingabeaufforderungen und einige Leitlinien zum Strukturieren Ihrer Eingabeaufforderungen für Amazon Bedrock-Konnektoren finden Sie unter Konzepte zum Erstellen von Eingabeaufforderungen.
Sie können anhand von Standardsatz- oder -textformatierung mit dem Amazon Bedrock - Converse API-Konnektor interagieren. Sie benötigen keine besonderen Schlüsselwörter oder Strings als Präfix oder Suffix der Eingabeaufforderung. Weitere Informationen finden Sie unter Kurze Beispiele.
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 Amazon Bedrock - Converse API-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_Bedrock_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_Bedrock_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_Bedrock_Connection","column":"text"}}', 'Write me a sample response from a technical support department for a customer complaint about ' & [IssueCategory]'))