Verwenden von Anthropic (Amazon Bedrock)-Verbindungen in Visualisierungsformeln
Sie können Anthropic-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 Anthropic 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, Anthropic (Amazon Bedrock)-Verbindungen in Diagrammformeln nur für eine oder wenige Datenzeilen zu verwenden. Diagrammformeln sollten nicht dazu verwendet werden, große Datenmengen an Anthropic 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:
-
Verwenden Sie die Verbindung nur in einer Text und Bild-Diagrammformel. Es wird dringend davon abgeraten, eine Anthropic (Amazon Bedrock)-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 Anthropic sendet, erheblich verringert.
-
Wenn Sie eine Anthropic (Amazon Bedrock)-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
Beim Schreiben der Anfragen, die Sie an ein generatives KI-Modell senden (oft als Eingabeaufforderungen oder Prompts bezeichnet), folgen Sie den Leitlinien für die Plattform, mit der Sie interagieren. Weitere Informationen zum Erstellen von Prompts und einige Leitlinien zum Strukturieren Ihrer Prompts für Amazon Bedrock-Konnektoren finden Sie unter Prompt-Engineering-Richtlinien.
Erstellen von Eingabeaufforderungen für die Anthropic - Claude-Konfiguration
Sie können die Konfiguration Anthropic - Claude dieses Konnektors nutzen, um auf die folgenden Legacy-Modelle zuzugreifen:
-
Claude 2.1
-
Claude 2
-
Claude Instant 1.2
Für Eingabeaufforderungen, die für diese Konfiguration geschrieben werden, ist eine bestimmte Syntax erforderlich, damit Vervollständigungen erfolgreich zurückgegeben werden. Es gelten die folgenden Anforderungen:
-
Jeder Eingabeaufforderung muss der Text Human: vorangestellt werden
-
Jeder Eingabeaufforderung muss der Text Assistant: nachgestellt werden
-
Das Präfix Human: muss zwei voranstehende Zeilenumbrüche enthalten. Dies wird erreicht, indem vor dem Präfix chr(10) & chr(10) zur Formel hinzugefügt wird.
-
Das Suffix Assistant: muss zwei voranstehende Zeilenumbrüche enthalten. Dies wird erreicht, indem vor dem Suffix chr(10) & chr(10) zur Formel hinzugefügt wird.
Informationen zum Strukturieren und Formatieren einer Claude-Eingabeaufforderung finden Sie unter Aufbau einer Eingabeaufforderung.
Beispiele finden Sie unter Kurze Beispiele.
Erstellen von Eingabeaufforderungen („Prompt-Engineering“) für die Anthropic - Claude (Messages API)-Konfiguration
Die Konfiguration Anthropic - Claude (Messages API) stellt eine Verbindung zur Messages API her. Sie können diese Konfiguration nutzen, um auf die folgenden Claude-Modelle zuzugreifen:
-
Claude 3.5 Sonnet
-
Claude 3 Opus
-
Claude 3 Sonnet
-
Claude 3 Haiku
-
Claude 2.1
-
Claude 2
-
Claude Instant 1.2
Eingabeaufforderungen für diese Modelle erfordern keine spezifische Syntax. Beispiele 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 Anthropic (Amazon Bedrock)-Konnektor verwendet werden können. Beachten Sie Folgendes:
-
Verwenden Sie nur die Formeln mit einem Text und Bild-Objekt.
-
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 Apps übereinstimmen.
-
Es gibt verschiedene Syntaxanforderungen für jede Konfiguration dieses Konnektors. Siehe Erstellen von Eingabeaufforderungen.
| Konnektorkonfiguration | Formel | Zusammenfassung |
|---|---|---|
| Anthropic - Claude | endpoints.ScriptAggrStr('{"RequestType":"endpoint", "endpoint":{"connectionname":"Anthropic_(Amazon_Bedrock)","column":"completion"}}', chr(10) & chr(10) & 'Human:' & 'Translate this text from English to Spanish: The sun was rising over the new tomorrow with a tinge of excitement.' & chr(10) & chr(10) & 'Assistant:') |
Dieser Befehl gibt die Antwort von Anthropic auf eine einzelne Frage zurück, die in die Formel eingegeben wurde. Warnhinweis
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. |
| Anthropic - Claude | if(vQuestion <> '', endpoints.scriptAggrStr('{"RequestType":"endpoint", "endpoint":{"connectionname":"Anthropic_(Amazon_Bedrock)","column":"completion"}}', chr(10) & chr(10) & 'Human:' & vQuestion & chr(10) & chr(10) & ' Assistant:')) |
Dies ist ein Befehl, der in einem Text und Bild-Objekt 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. Beachten Sie, dass aufgrund der Anforderungen an die Anthropic-Eingabeaufforderungen der Benutzer das Präfix und das Suffix manuell zur Eingabe hinzufügen muss. Eine ähnliche Anleitung mit einem anderen Konnektor finden Sie unter Übung: Erstellen eines Texteingabefelds mithilfe einer Variablen. |
| Anthropic - Claude | if(count(distinct [BusinessTopic]) = 1, endpoints.ScriptAggrStr('{"RequestType":"endpoint", "endpoint":{"connectionname":"Anthropic_(Amazon_Bedrock)","column":"completion"}}', chr(10) & chr(10) & 'Human: write me a sample response from a technical support department for a customer complaint about ' & [BusinessTopic] & chr(10) & chr(10) & ' Assistant:')) | In diesem Beispiel wird das Diagramm nur berechnet, wenn ein 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. |
| Anthropic - Claude (Messages API) | endpoints.ScriptAggrStr('{"RequestType":"endpoint", "endpoint":{"connectionname":"Anthropic_(Amazon_Bedrock)","column":"text"}}', 'Translate this text from English to Spanish: The sun was rising over the new tomorrow with a tinge of excitement.') |
Dieser Befehl gibt die Antwort von Anthropic auf eine einzelne Frage zurück, die in die Formel eingegeben wurde. Warnhinweis
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. |
| Anthropic - Claude (Messages API) | if(vQuestion <> '', endpoints.scriptAggrStr('{"RequestType":"endpoint", "endpoint":{"connectionname":"Anthropic_(Amazon_Bedrock)","column":"text"}}',vQuestion)) |
Dies ist ein Befehl, der in einem Text und Bild-Objekt 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. Beachten Sie, dass aufgrund der Anforderungen an die Anthropic-Eingabeaufforderungen der Benutzer das Präfix und das Suffix manuell zur Eingabe hinzufügen muss. Eine ähnliche Anleitung mit einem anderen Konnektor finden Sie unter Übung: Erstellen eines Texteingabefelds mithilfe einer Variablen. |
| Anthropic - Claude (Messages API) | if(count(distinct [IssueCategory]) = 1, endpoints.ScriptAggrStr('{"RequestType":"endpoint", "endpoint":{"connectionname":"Anthropic_(Amazon_Bedrock)","column":"text"}}', 'Write me a sample response from a technical support department for a customer complaint about ' & [IssueCategory]')) | In diesem Beispiel wird das Diagramm nur berechnet, wenn ein 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. |