Utilisation de connexions Anthropic (Amazon Bedrock) dans des expressions de visualisation
Outre l'ajout de questions et de réponses Anthropic au modèle de données de votre application via le script de chargement, vous pouvez effectuer ces opérations directement dans un graphique de votre application en mode d'analyse. Les données d'un seul champ font l'aller-retour entre vous et Anthropic.
Dans de nombreux cas, le code utilisé pour une connexion de script de chargement peut être adapté pour être réutilisé dans un graphique, en y intégrant quelques différences.
Si le cas d'utilisation est basé sur la saisie de l'utilisateur, vous pouvez utiliser une connexion analytique et la syntaxe server-side extension (SSE) correspondante dans votre expression de graphique pour créer des graphiques interactifs qui visualisent les données reçues depuis les points de terminaison du modèle.
Considérations relatives aux volumes de requêtes de données
Il est recommandé d'utiliser uniquement des connexions Anthropic (Amazon Bedrock) dans des expressions de graphique pour une ou plusieurs lignes de données. Il n'est pas recommandé d'utiliser des expressions de graphique pour envoyer de grandes quantités de données à Anthropic.
Il est important de connaître le nombre de lignes que vous envoyez à chaque requête. Des erreurs de configuration de la connexion dans une expression de graphique peuvent produire des requêtes involontairement volumineuses (par exemple, des lignes identiques avec la même question en raison de l'utilisation inappropriée du modèle de données dans un graphique). Avant d'interagir avec une plate-forme tierce, assurez-vous de savoir comment les champs utilisés dans le calcul des expressions de graphique et leur placement dans le modèle de données affectent vos accords financiers et de facturation avec le tiers. Une utilisation supérieure de la plate-forme externe peut entraîner une augmentation des coûts encourus.
Suivez ces consignes pour modérer et limiter la taille de vos requêtes :
-
Utilisez uniquement la connexion dans une expression de graphique Texte et image. L'utilisation de la connexion Anthropic (Amazon Bedrock) dans un objet Table est vivement déconseillée, en particulier si vous ajoutez l'expression à une table à laquelle une ou plusieurs dimensions ont déjà été ajoutées.
-
Si l'expression de graphique est liée au modèle de données de votre application, utilisez une instruction if dans l'expression pour calculer uniquement le graphique lorsqu'une seule sélection est effectuée dans l'application. Cela réduit radicalement le nombre de lignes des requêtes envoyées à Anthropic par votre graphique.
-
Si vous utilisez la connexion Anthropic (Amazon Bedrock) pour envoyer des requêtes de grande taille, utilisez la connexion dans votre script de chargement au lieu de l'utiliser dans une expression de graphique, de sorte que les données soient préchargées dans votre modèle de données.
Conception d'invites
Lorsque vous rédigez les requêtes que vous envoyez à un modèle d'IA générative (souvent connues sous le nom d'invites), suivez les consignes propres à la plate-forme avec laquelle vous interagissez. Pour des informations sur la conception d'invites et des consignes sur la manière de structurer vos invites pour les connecteurs Amazon Bedrock, voir Consignes en matière de conception d'invites.
Construction d'invites pour la configuration d'Anthropic - Claude
Vous pouvez utiliser la configuration Anthropic - Claude de ce connecteur pour vous connecter aux modèles hérités suivants :
-
Claude 2.1
-
Claude 2
-
Claude Instant 1.2
Pour pouvoir renvoyer correctement des « completions », les invites rédigées pour cette configuration nécessitent une syntaxe spécifique. Les conditions sont les suivantes :
-
Chaque invite doit comporter en préfixe le texte Human:.
-
Chaque invite doit comporter en suffixe le texte Assistant:.
-
Le préfixe Human: doit être précédé de deux retours chariot. Pour ce faire, ajoutez chr(10) & chr(10) à l'expression, avant le préfixe.
-
Le suffixe Assistant: doit être précédé de deux retours chariot. Pour ce faire, ajoutez chr(10) & chr(10) à l'expression, avant le suffixe.
Pour des informations sur la structure et le format d'une invite Claude, voir Création d'une invite.
Pour des exemples, voir Exemples rapides.
Construction d'invites pour la configuration d'Anthropic - Claude (Messages API)
La configuration Anthropic - Claude (Messages API) se connecte à l'API Messages. Vous pouvez utiliser cette configuration pour accéder aux modèles Claude suivants :
-
Claude 3.5 Sonnet
-
Claude 3 Opus
-
Claude 3 Sonnet
-
Claude 3 Haiku
-
Claude 2.1
-
Claude 2
-
Claude Instant 1.2
Les invites de ces modèles ne nécessitent aucune syntaxe spécifique. Pour des exemples, voir Exemples rapides.
Création de l'expression de graphique
Procédez comme suit :
-
Lors de l'édition d'une visualisation, cliquez sur
pour ouvrir l'éditeur d'expression. -
Dans l'éditeur d'expression, saisissez une expression dans le champ d'expression. L'expression peut être créée via la syntaxe server-side extension (SSE).
Exemples rapides
Vous trouverez ici en exemple des expressions qui peuvent être utilisées lorsque vous démarrez avec le connecteur Anthropic (Amazon Bedrock). N'oubliez pas les informations suivantes :
-
Utilisez uniquement les expressions avec un objet Texte et image.
-
Pensez à ajouter une instruction if à vos expressions pour contrôler le moment du recalcul du graphique et pour effectuer une mise à jour en fonction des sélections utilisateur dans l'application.
-
Pour que les expressions fonctionnent, vous devez remplacer la valeur connectionname et tous les noms de champ de sorte qu'ils correspondent à vos propres connexions et applications.
-
Il existe des conditions de syntaxe différentes pour chaque configuration de ce connecteur. Voir Conception d'invites.
| Configuration du connecteur | Expression | Récapitulatif |
|---|---|---|
| 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:') |
Cette instruction renverra la réponse Anthropic à une seule question, qui a été saisie dans l'expression. Note Avertissement
Cette expression n'utilise pas d'instruction if, et il n'est pas conseillé de l'utiliser si elle est liée à un champ de votre modèle de données. Elle peut être utilisée uniquement dans une expression autonome avec une seule cellule d'entrée contenant une valeur codée en dur. |
| 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:')) |
Cette instruction peut être utilisée dans un objet Texte et image lié à un Contrôle d'entrée de variable. Le graphique est calculé uniquement lorsque l'entrée est validée via Entrée. Lorsque l'utilisateur saisit une entrée dans l'objet et appuie sur Entrée, le graphique affiche la réponse du modèle à son entrée. Notez qu'étant donné les conditions d'invite Anthropic, l'utilisateur doit saisir le préfixe et le suffixe manuellement dans l'entrée. Pour une présentation similaire avec un autre connecteur, voir Exercice : Création d'une zone de saisie de texte via une variable. |
| 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:')) | Dans cet exemple, le graphique est calculé uniquement si une valeur distincte a été sélectionnée dans le champ IssueCategory du modèle de données de l'application. Une requête est envoyée au modèle, demandant un exemple de réponse d'un service d'assistance technique sur un type de problème général, dont la liste est contenue dans le champ IssueCategory. Le graphique est mis à jour en fonction de la valeur sélectionnée par l'utilisateur. |
| 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.') |
Cette instruction renverra la réponse Anthropic à une seule question, qui a été saisie dans l'expression. Note Avertissement
Cette expression n'utilise pas d'instruction if, et il n'est pas conseillé de l'utiliser si elle est liée à un champ de votre modèle de données. Elle peut être utilisée uniquement dans une expression autonome avec une seule cellule d'entrée contenant une valeur codée en dur. |
| Anthropic - Claude (Messages API) | if(vQuestion <> '', endpoints.scriptAggrStr('{"RequestType":"endpoint", "endpoint":{"connectionname":"Anthropic_(Amazon_Bedrock)","column":"text"}}',vQuestion)) |
Cette instruction peut être utilisée dans un objet Texte et image lié à un Contrôle d'entrée de variable. Le graphique est calculé uniquement lorsque l'entrée est validée via Entrée. Lorsque l'utilisateur saisit une entrée dans l'objet et appuie sur Entrée, le graphique affiche la réponse du modèle à son entrée. Notez qu'étant donné les conditions d'invite Anthropic, l'utilisateur doit saisir le préfixe et le suffixe manuellement dans l'entrée. Pour une présentation similaire avec un autre connecteur, voir Exercice : Création d'une zone de saisie de texte via une variable. |
| 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]')) | Dans cet exemple, le graphique est calculé uniquement si une valeur distincte a été sélectionnée dans le champ IssueCategory du modèle de données de l'application. Une requête est envoyée au modèle, demandant un exemple de réponse d'un service d'assistance technique sur un type de problème général, dont la liste est contenue dans le champ IssueCategory. Le graphique est mis à jour en fonction de la valeur sélectionnée par l'utilisateur. |