Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra. # Création et stockage d’invites réutilisables avec la gestion des invites dans Amazon Bedrock Amazon Bedrock vous donne la possibilité de créer et d’enregistrer vos propres invites à l’aide de la gestion des invites, ce qui vous permet de gagner du temps en appliquant la même invite à différents flux de travail. Lorsque vous créez une invite, vous pouvez sélectionner un modèle sur lequel exécuter une inférence et modifier les paramètres d’inférence à utiliser. Vous pouvez inclure des variables dans l’invite afin de pouvoir l’ajuster en fonction des différents cas d’utilisation. Lorsque vous testez votre invite, vous avez la possibilité de comparer différentes variantes de l’invite et de choisir la variante qui produit les sorties les mieux adaptées à votre cas d’utilisation. Tout en itérant votre invite, vous pouvez en enregistrer des versions. Vous intégrez une invite dans votre application à l’aide d’[Amazon Bedrock Flows](flows.md). Voici le flux de travail général de la gestion des invites : 1. Créez une invite dans la gestion des invites que vous souhaitez réutiliser dans différents cas d’utilisation. Incluez des variables pour apporter de la flexibilité dans l’invite du modèle. 1. Choisissez un modèle, un profil d’inférence ou un agent pour exécuter l’inférence à l’invite et modifiez les configurations d’inférence si nécessaire. 1. Entrez les valeurs de test pour les variables et exécutez l’invite. Vous pouvez créer des variantes de votre invite et comparer les résultats des différentes variantes pour choisir la meilleure pour votre cas d’utilisation. 1. Intégrez l’invite à votre application de l’une des manières suivantes : + Spécifiez l’invite lors de l’[exécution de l’inférence de modèle](inference.md). + Ajoutez un nœud d’invite à un [flux](flows.md) et spécifiez l’invite. **Topics** + [Définitions clés](#prompt-management-definitions) + [Régions et modèles pris en charge pour la gestion des invites](prompt-management-supported.md) + [Conditions préalables pour la gestion des invites](prompt-management-prereq.md) + [Création d’une invite à l’aide de la gestion des invites](prompt-management-create.md) + [Affichage des informations sur les invites à l’aide de la gestion des invites](prompt-management-view.md) + [Modification d’une invite à l’aide de la gestion des invites](prompt-management-modify.md) + [Test d’une invite à l’aide de la gestion des invites](prompt-management-test.md) + [Optimisation d’une invite](prompt-management-optimize.md) + [Déploiement d’une invite dans votre application à l’aide des versions dans la gestion des invites](prompt-management-deploy.md) + [Suppression d’une invite dans la gestion des invites](prompt-management-delete.md) + [Exécution d’exemples de code de gestion des invites](prompt-management-code-ex.md) ## Définitions clés La liste suivante présente les concepts de base de la gestion des invites : + **Invite** : entrée fournie au modèle pour l’aider à générer une réponse ou sortie appropriée. + **Variable** : espace réservé que vous pouvez inclure dans l’invite. Vous pouvez inclure des valeurs pour chaque variable lorsque vous testez l’invite ou lorsque vous invoquez le modèle lors de l’exécution. + **Variante de l’invite** : configuration alternative de l’invite, y compris son message, le modèle ou les configurations d’inférence utilisés. Vous pouvez créer différentes variantes d’une invite, les tester et enregistrer la variante que vous souhaitez conserver. + **Créateur d’invites** : outil intégré à la console Amazon Bedrock qui vous permet de créer, de modifier et de tester des invites et leurs variantes dans une interface visuelle. # Régions et modèles pris en charge pour la gestion des invites La gestion rapide est prise en charge dans les domaines suivants Régions AWS : + ap-northeast-1 + ap-northeast-2 + ap-northeast-3 + ap-south-1 + ap-south-2 + ap-southeast-1 + ap-southeast-2 + ca-central-1 + eu-central-1 + eu-central-2 + eu-north-1 + eu-south-1 + eu-south-2 + eu-west-1 + eu-west-2 + eu-west-3 + sa-east-1 + us-east-1 + us-east-2 + us-gov-east-1 + us-gov-west-1 + us-west-2 Vous pouvez utiliser la gestion des invites avec tout modèle de texte pris en charge pour l’API [Converse](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html). Pour obtenir la liste des modèles pris en charge, consultez [Modèles et fonctionnalités des modèles pris en charge](conversation-inference-supported-models-features.md). **Note** [InvokeModel](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModel.html)et [InvokeModelWithResponseStream](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModelWithResponseStream.html)ne fonctionnent que sur les instructions de la gestion de Prompt dont la configuration spécifie un Meta Llama modèle Anthropic Claude or. # Conditions préalables pour la gestion des invites Pour qu’un rôle puisse utiliser la gestion des invites, vous devez l’autoriser à effectuer un certain nombre d’actions d’API. Passez en revue les conditions préalables suivantes et respectez celles qui s’appliquent à votre cas d’utilisation : 1. Si la politique [AmazonBedrockFullAccess](security-iam-awsmanpol.md#security-iam-awsmanpol-AmazonBedrockFullAccess)AWSgérée est attachée à votre rôle, vous pouvez ignorer cette section. Sinon, suivez les étapes décrites sous [Mise à jour de la politique d’autorisations pour un rôle](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_update-role-permissions.html#id_roles_update-role-permissions-policy) et associez la politique suivante à un rôle afin de fournir les autorisations nécessaires pour effectuer des actions liées à la gestion des invites : ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "PromptManagementPermissions", "Effect": "Allow", "Action": [ "bedrock:CreatePrompt", "bedrock:UpdatePrompt", "bedrock:GetPrompt", "bedrock:ListPrompts", "bedrock:DeletePrompt", "bedrock:CreatePromptVersion", "bedrock:OptimizePrompt", "bedrock:GetFoundationModel", "bedrock:ListFoundationModels", "bedrock:GetInferenceProfile", "bedrock:ListInferenceProfiles", "bedrock:InvokeModel", "bedrock:InvokeModelWithResponseStream", "bedrock:RenderPrompt", "bedrock:TagResource", "bedrock:UntagResource", "bedrock:ListTagsForResource" ], "Resource": "*" } ] } ``` ------ Pour restreindre davantage les autorisations, vous pouvez omettre des actions ou spécifier des ressources et des clés de condition permettant de filtrer les autorisations. Pour plus d’informations sur les actions, les ressources et les clés de condition, consultez les rubriques suivantes dans la *Référence des autorisations de service* : + [Actions définies par Amazon Bedrock](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonbedrock.html#amazonbedrock-actions-as-permissions) : découvrez les actions, les types de ressources auxquels vous pouvez les appliquer dans le champ `Resource` et les clés de condition qui vous permettent de filtrer les autorisations dans le champ `Condition`. + [Types de ressources définis par Amazon Bedrock](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonbedrock.html#amazonbedrock-resources-for-iam-policies) : découvrez les types de ressources dans Amazon Bedrock. + [Clés de condition pour Amazon Bedrock](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonbedrock.html#amazonbedrock-policy-keys) : découvrez les clés de condition dans Amazon Bedrock. **Note** Si vous envisagez de déployer votre invite à l’aide de l’API [Converse](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html), consultez [Conditions préalables à l’exécution de l’inférence de modèle](inference-prereq.md) pour en savoir plus sur les autorisations que vous devez configurer pour invoquer une invite. Si vous prévoyez d’utiliser un [flux](flows.md) dans les flux Amazon Bedrock pour déployer votre invite, consultez [Conditions préalables pour Amazon Bedrock Flows](flows-prereq.md) pour en savoir plus sur les autorisations que vous devez configurer pour créer un flux. 1. Si vous envisagez de chiffrer votre invite à l'aide d'une clé gérée par le client plutôt que d'utiliser une Clé gérée par AWS (pour plus d'informations, voir [AWS KMSclés](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html)), créez les politiques suivantes : 1. Suivez les étapes décrites dans la [section Création d'une politique clé](https://docs.aws.amazon.com/kms/latest/developerguide/key-policy-overview.html) et associez la politique clé suivante à une clé KMS pour permettre à Amazon Bedrock de chiffrer et de déchiffrer une invite à l'aide de la clé, en remplaçant la *values* si nécessaire. La politique contient des clés de condition facultatives (consultez [Clés de condition pour Amazon Bedrock](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonbedrock.html#amazonbedrock-policy-keys) et [Clés de contexte de condition globale AWS](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonbedrock.html#amazonbedrock-policy-keys)) dans le champ `Condition` que nous vous recommandons d’utiliser comme bonne pratique de sécurité. ``` { "Sid": "EncryptFlowKMS", "Effect": "Allow", "Principal": { "Service": "bedrock.amazonaws.com" }, "Action": [ "kms:GenerateDataKey", "kms:Decrypt" ], "Resource": "*", "Condition": { "StringEquals": { "kms:EncryptionContext:aws:bedrock-prompts:arn": "arn:${partition}:bedrock:${region}:${account-id}:prompt/${prompt-id}" } } } ``` 1. Suivez les étapes décrites dans [Mettre à jour la politique d'autorisations pour un rôle](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_update-role-permissions.html#id_roles_update-role-permissions-policy) et associez la politique suivante au rôle de gestion des invites, en remplaçant la *values* si nécessaire, pour lui permettre de générer et de déchiffrer la clé gérée par le client en cas d'invite. La politique contient des clés de condition facultatives (consultez [Clés de condition pour Amazon Bedrock](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonbedrock.html#amazonbedrock-policy-keys) et [Clés de contexte de condition globale AWS](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonbedrock.html#amazonbedrock-policy-keys)) dans le champ `Condition` que nous vous recommandons d’utiliser comme bonne pratique de sécurité. ``` { "Sid": "KMSPermissions", "Effect": "Allow", "Action": [ "kms:GenerateDataKey", "kms:Decrypt" ], "Resource": [ "arn:aws:kms:${region}:${account-id}:key/${key-id}" ], "Condition": { "StringEquals": { "aws:ResourceAccount": "${account-id}" } } } ``` # Création d’une invite à l’aide de la gestion des invites Lors de la création d’une invite, vous disposez des options suivantes : + Rédigez le message d’invite qui sert d’entrée à un modèle FM pour générer une sortie. + Utilisez des accolades doubles pour inclure des variables (comme dans *\$1\$1variable\$1\$1*) dans le message d’invite qui peut être rempli lorsque vous appelez l’invite. + Choisissez un modèle pour invoquer l’invite ou, si vous prévoyez d’utiliser l’invite avec un agent, ne le spécifiez pas. Si vous choisissez un modèle, vous pouvez également modifier les configurations d’inférence à utiliser. Pour afficher les paramètres d’inférence pour différents modèles, consultez [Paramètres de demande d’inférence et champs de réponse pour les modèles de fondation](model-parameters.md). Toutes les invites prennent en charge les paramètres d’inférence de base suivants : + **maxTokens** : le nombre maximum de jetons à autoriser dans la réponse générée. + **stopSequences** : liste de séquences d’arrêt. Une séquence d’arrêt est une séquence de caractères qui empêche le modèle de générer la réponse. + **Température** : probabilité que le modèle sélectionne des options à probabilité plus élevée tout en générant une réponse. + **topP** : pourcentage de candidats les plus probables pris en compte par le modèle pour le jeton suivant. Si un modèle prend en charge des paramètres d’inférence supplémentaires, vous pouvez les spécifier en tant que *champs supplémentaires* pour votre invite. Vous fournissez les champs supplémentaires dans un objet JSON. L’exemple suivant montre comment définir `top_k`, qui est disponible dans les modèles Anthropic Claude, mais qui n’est pas un paramètre d’inférence de base. ``` { "top_k": 200 } ``` Pour plus d’informations sur les paramètres d’inférence de modèle, consultez [Paramètres de demande d’inférence et champs de réponse pour les modèles de fondation](https://docs.aws.amazon.com/bedrock/latest/userguide/model-parameters.html). La définition d’un paramètre d’inférence de base en tant que champ supplémentaire ne remplace pas la valeur que vous avez définie dans la console. Si le modèle que vous choisissez pour l’invite prend en charge l’API [Converse](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html) (pour plus d’informations, consultez [Mener une conversation avec les opérations d’API Converse](conversation-inference.md)), vous pouvez inclure les éléments suivants lors de la création de l’invite : + Invite système pour fournir des instructions ou un contexte au modèle. + Invites précédentes (messages utilisateur) et réponses modèles (messages d’assistant) sous forme d’historique des conversations que le modèle doit prendre en compte lors de la génération d’une réponse pour le message utilisateur final. + (Si non pris en charge par le modèle) [Outils](tool-use.md) à utiliser par le modèle lors de la génération de la réponse. + (Si pris en charge par le modèle) Utilisez la [mise en cache des invites](prompt-caching.md) pour réduire les coûts en mettant en cache les invites volumineuses ou fréquemment utilisées. Selon le modèle, vous pouvez mettre en cache les instructions, les outils et les messages du système (utilisateur et assistant). La mise en cache des invites crée un point de contrôle du cache pour l’invite si le nombre total de préfixes d’invite correspond au nombre minimum de jetons requis par le modèle. Lorsqu’une variable modifiée est détectée dans une invite, la mise en cache des invites crée un nouveau point de contrôle du cache (si le nombre de jetons d’entrée atteint le minimum requis par le modèle). Pour savoir comment créer une invite à l’aide de la gestion des invites, choisissez l’onglet correspondant à votre méthode préférée, puis suivez les étapes : ------ #### [ Console ] **Pour créer une invite** 1. Connectez-vous à la AWS Management Console avec une identité IAM autorisée à utiliser la console Amazon Bedrock. Ensuite, ouvrez la console Amazon Bedrock à l’adresse [https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock). 1. Sélectionnez **Gestion des invites** dans le volet de navigation de gauche. Choisissez ensuite **Créer une invite**. 1. Fournissez un nom pour l’invite et une description facultative. 1. Pour chiffrer votre invite avec une clé gérée par le client, sélectionnez **Personnaliser les paramètres de chiffrement (avancé)** dans la section **Sélection de clé KMS**. Si vous omettez ce champ, votre Invite sera cryptée à l’aide d’une Clé gérée par AWS. Pour plus d’informations, consultez [Clés AWS KMS](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html). 1. Choisissez **Créer une invite**. Votre invite est créée et vous êtes redirigé vers le **créateur d’invites** pour l’invite que vous venez de créer, où vous pouvez configurer votre invite. 1. Vous pouvez passer à la procédure suivante pour configurer votre invite ou revenir au créateur d’invites ultérieurement. **Pour configurer votre invite** 1. Si vous n’êtes pas encore dans le créateur d’invites, procédez comme suit : 1. Connectez-vous à la AWS Management Console avec une identité IAM autorisée à utiliser la console Amazon Bedrock. Ensuite, ouvrez la console Amazon Bedrock à l’adresse [https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock). 1. Sélectionnez **Gestion des invites** dans le volet de navigation de gauche. Choisissez ensuite une invite dans la section **Invites**. 1. Dans la section **Brouillon d’invite**, choisissez **Modifier dans le créateur d’invites**. 1. Utilisez le volet **Invite** pour construire l’invite. Entrez l’invite dans la dernière boîte de **message utilisateur**. Si le modèle prend en charge l’API [Converse](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html) ou l’[API AnthropicClaude Messages](model-parameters-anthropic-claude-messages.md), vous pouvez également inclure une **invite système**, ainsi que les **messages d’utilisateur** et **messages d’assistant** précédents pour le contexte. Lorsque vous rédigez une invite, vous pouvez inclure des variables entre accolades (comme dans *\$1\$1variable\$1\$1*). Chaque variable que vous incluez apparaît dans la section **Variables de test**. 1. (Facultatif) Vous pouvez modifier votre invite comme suit : + Dans le volet **Configurations**, procédez comme suit : 1. Choisissez une **ressource d’IA générative** pour exécuter l’inférence. **Note** Si vous choisissez un agent, vous ne pouvez tester l’invite que dans la console. Pour découvrir comment vérifier une invite avec un agent dans l’API, consultez [Test d’une invite à l’aide de la gestion des invites](prompt-management-test.md). 1. Dans **Paramètres d’inférence**, définissez les paramètres d’inférence que vous souhaitez utiliser. 1. Si le modèle prend en charge le [raisonnement](inference-reasoning.md), activez **Raisonnement** pour inclure le raisonnement du modèle dans sa réponse. Dans **Jetons de raisonnement**, vous pouvez configurer le nombre de jetons de raisonnement que le modèle peut utiliser. 1. Dans **Champs de demande de modèle supplémentaires**, choisissez **Configurer** pour spécifier des paramètres d’inférence supplémentaires, en plus de ceux des **paramètres d’inférence**. 1. Si le modèle que vous choisissez prend en charge les outils, choisissez **Configurer les outils** pour utiliser des outils avec l’invite. 1. Si le modèle que vous choisissez prend en charge la [mise en cache des invites](prompt-caching.md), choisissez l’une des options suivantes (la disponibilité varie selon le modèle) : + **Aucun** : aucune mise en cache des invites n’est effectuée. + **Outils** : seuls les outils figurant dans l’invite sont mis en cache. + **Outils, instructions système** : les outils et les instructions système figurant dans l’invite sont mis en cache. + **Outils, instructions système et messages** : les outils, les instructions système et les messages (utilisateur et assistant) contenus dans l’invite sont mis en cache. + Pour comparer les différentes variantes de votre invite, choisissez **Comparer les variantes**. Sur la page de comparaison, vous pouvez effectuer les actions suivantes : + Pour ajouter une variante, choisissez le signe plus. Vous pouvez ajouter jusqu’à trois variantes. + Après avoir défini les détails d’une variante, vous pouvez spécifier n’importe quelle **variable de test** et choisir **Exécuter** pour tester le résultat de la variante. + Pour supprimer une variante, choisissez les trois points, puis sélectionnez **Supprimer de la comparaison**. + Pour remplacer le brouillon de travail et quitter le mode de comparaison, choisissez **Enregistrer en tant que brouillon**. Toutes les autres variantes seront supprimées. + Pour quitter le mode de comparaison, choisissez **Quitter le mode de comparaison**. 1. Lorsque vous avez fini de configurer l’invite, vous disposez des options suivantes : + Pour enregistrer votre invite, choisissez **Enregistrer le brouillon**. Pour plus d’informations sur la version de brouillons, consultez [Déploiement d’une invite dans votre application à l’aide des versions dans la gestion des invites](prompt-management-deploy.md). + Pour supprimer votre invite, choisissez **Supprimer**. Pour plus d’informations, consultez [Suppression d’une invite dans la gestion des invites](prompt-management-delete.md). + Pour créer une version de votre invite, choisissez **Créer une version**. Pour plus d’informations sur la gestion des versions d’invite, consultez [Déploiement d’une invite dans votre application à l’aide des versions dans la gestion des invites](prompt-management-deploy.md). ------ #### [ API ] Pour créer une invite, envoyez une demande [CreatePrompt](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_CreatePrompt.html) avec un [point de terminaison de développement des agents Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt). Les champs suivants sont obligatoires : **** | Champ | Brève description | | --- | --- | | name | Nom de l’invite. | | variants | Liste des différentes configurations pour l’invite (voir ci-dessous). | | defaultVariant | Nom de la variante par défaut. | Chaque variante de la liste `variants` est un objet [PromptVariant dont](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_PromptVariant.html) la structure générale suivante : ``` { "name": "string", # modelId or genAiResource (see below) "templateType": "TEXT", "templateConfiguration": # see below, "inferenceConfiguration": { "text": { "maxTokens": int, "stopSequences": ["string", ...], "temperature": float, "topP": float } }, "additionalModelRequestFields": { "key": "value", ... }, "metadata": [ { "key": "string", "value": "string" }, ... ] } ``` Remplissez les champs comme suit : + name : entrez un nom pour la variante. + Incluez l’un de ces champs, en fonction de la ressource d’invocation du modèle à utiliser : + modelId : pour spécifier un [modèle de fondation](models-supported.md) ou un [profil d’inférence](cross-region-inference.md) à utiliser avec l’invite, entrez son ARN ou son ID. + genAiResource : pour spécifier un [agent](agents.md), entrez son ID ou son ARN. L’entrée de la `genAiResource` est un objet JSON au format suivant : ``` { "genAiResource": { "agent": { "agentIdentifier": "string" } } ``` **Note** Si vous incluez le champ `genAiResource`, vous ne pouvez tester l’invite que dans la console. Pour tester une invite avec un agent dans l’API, vous devez entrer le texte de l’invite directement dans le champ `inputText` de la demande [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html). + templateType : entrez `TEXT` ou `CHAT`. `CHAT` est uniquement compatible avec les modèles prenant en charge l’API [Converse](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html). Si vous voulez utiliser la mise en cache des invites, vous devez utiliser le type de modèle `CHAT`. + templateConfiguration : la valeur dépend du type de modèle que vous avez spécifié : + Si vous avez spécifié `TEXT` comme de modèle, la valeur doit être un objet JSON [TextPromptTemplateConfiguration](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_TextPromptTemplateConfiguration.html.html). + Si vous avez spécifié `CHAT` comme type de modèle, la valeur doit être un objet JSON [ChatPromptTemplateConfiguration](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_ChatPromptTemplateConfiguration.html.html). + inferenceConfiguration : Le champ `text` est mappé à une configuration [PromptModelInferenceConfiguration](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_PromptModelInferenceConfiguration.html.html). Ce champ contient les paramètres d’inférence communs à tous les modèles. Pour plus d’informations sur les paramètres d’inférence, consultez [Génération de réponse d’influence à l’aide de paramètres d’inférence](inference-parameters.md). + additionalModelRequestFields : utilisez ce champ pour spécifier des paramètres d’inférence spécifiques au modèle avec lequel vous exécutez l’inférence. Pour plus d’informations sur les paramètres d’inférence spécifiques au modèle, consultez [Paramètres de demande d’inférence et champs de réponse pour les modèles de fondation](model-parameters.md). + metadata : métadonnées à associer à la variante d’invite. Vous pouvez ajouter des paires clé-valeur au tableau pour étiqueter la variante d’invite avec des métadonnées. Les champs suivants sont facultatifs : **** | Champ | Cas d’utilisation | | --- | --- | | description | Pour indiquer une description pour l’invite. | | clientToken | Pour garantir que la demande d’API n’est exécutée qu’une seule fois. Pour plus d’informations, consultez [Garantie de l’idempotence](https://docs.aws.amazon.com/ec2/latest/devguide/ec2-api-idempotency.html). | | balises | Pour associer des balises au flux. Pour plus d’informations, consultez [Balisage des ressources Amazon Bedrock](tagging.md). | La réponse crée une version `DRAFT` et renvoie un ID et un ARN que vous pouvez utiliser comme identifiant d’invite pour d’autres demandes d’API liées à une invite. ------ # Affichage des informations sur les invites à l’aide de la gestion des invites Pour savoir comment afficher les informations relatives aux invites à l’aide de la gestion des invites, choisissez l’onglet correspondant à votre méthode préférée, puis suivez les étapes : ------ #### [ Console ] **Pour afficher des informations sur une invite** 1. Connectez-vous à la AWS Management Console avec une identité IAM autorisée à utiliser la console Amazon Bedrock. Ensuite, ouvrez la console Amazon Bedrock à l’adresse [https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock). 1. Sélectionnez **Gestion des invites** dans le volet de navigation de gauche. Choisissez ensuite une invite dans la section **Invites**. 1. La page **Détails sur l’invite** comprend les sections suivantes : + **Vue d’ensemble** : contient des informations générales sur l’invite, ainsi que sur sa date de création et de dernière mise à jour. + **Brouillon d’invite** : contient le message d’invite et les configurations pour le dernier brouillon enregistré de l’invite. + **Versions de l’invite** : liste de toutes les versions de l’invite qui ont été créées. Pour plus d’informations sur les versions d’invite, consultez [Déploiement d’une invite dans votre application à l’aide des versions dans la gestion des invites](prompt-management-deploy.md). ------ #### [ API ] Pour obtenir des informations sur une invite, envoyez une demande [GetPrompt](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_GetPrompt.html) avec un [point de terminaison de compilation pour agents Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) et spécifiez l’ARN ou l’identifiant de l’invite comme `promptIdentifier`. Pour obtenir des informations sur une version spécifique de l’invite, spécifiez `DRAFT` ou le numéro de version dans le champ `promptVersion`. Pour répertorier des informations sur vos agents, envoyez une demande [ListPrompts](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_ListPrompts.html) avec un [point de terminaison de compilation pour agents Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt). Vous pouvez préciser les paramètres facultatifs suivants : **** | Champ | Description abrégée | | --- | --- | | maxResults | Nombre maximum de résultats à renvoyer en réponse. | | nextToken | Si le nombre de résultats est supérieur à ce que vous avez spécifié dans le champ maxResults, la réponse renvoie une valeur nextToken. Pour voir le prochain lot de résultats, envoyez la valeur nextToken dans une autre demande. | ------ # Modification d’une invite à l’aide de la gestion des invites Pour savoir comment modifier des invites à l’aide de la gestion des invites, choisissez l’onglet correspondant à votre méthode préférée, puis suivez les étapes : ------ #### [ Console ] **Pour modifier une invite** 1. Connectez-vous à la AWS Management Console avec une identité IAM autorisée à utiliser la console Amazon Bedrock. Ensuite, ouvrez la console Amazon Bedrock à l’adresse [https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock). 1. Sélectionnez **Gestion des invites** dans le volet de navigation de gauche. Choisissez ensuite une invite dans la section **Invites**. 1. Pour modifier le **Nom** ou la **Description** de l’invite, choisissez **Modifier** dans la section **Vue d’ensemble**. Après avoir apporté vos modifications, choisissez **Enregistrer**. 1. Pour modifier l’invite et ses configurations, choisissez **Modifier dans le créateur d’invites** 1. Pour en savoir plus sur les parties de l’invite que vous pouvez modifier, consultez [Création d’une invite à l’aide de la gestion des invites](prompt-management-create.md). ------ #### [ API ] Pour modifier une invite, envoyez une demande [UpdatePrompt](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UpdatePrompt.html) avec un [point de terminaison de compilation pour agents Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt). Incluez les champs que vous souhaitez conserver et ceux que vous souhaitez modifier. ------ # Test d’une invite à l’aide de la gestion des invites Pour savoir comment tester une invite que vous avez créée dans la gestion des invites, choisissez l’onglet correspondant à votre méthode préférée, puis suivez les étapes : ------ #### [ Console ] **Pour tester une invite dans la gestion des invites** 1. Connectez-vous à la AWS Management Console avec une identité IAM autorisée à utiliser la console Amazon Bedrock. Ensuite, ouvrez la console Amazon Bedrock à l’adresse [https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock). 1. Sélectionnez **Gestion des invites** dans le volet de navigation de gauche. Choisissez ensuite une invite dans la section **Invites**. 1. Choisissez **Modifier dans le créateur d’invites** dans la section **Brouillon d’invite**, ou choisissez une version de l’invite dans la section **Versions**. 1. (Facultatif) Pour fournir des valeurs pour les variables dans votre invite, vous devez d’abord sélectionner un modèle dans le volet **Configurations**. Entrez ensuite une **valeur de test** pour chaque variable dans le volet **Variables de test**. **Note** Ces valeurs de test sont temporaires et ne sont pas enregistrées si vous enregistrez votre invite. 1. Pour tester votre invite, choisissez **Exécuter** dans le volet de la **fenêtre de test**. 1. Modifiez votre invite ou ses configurations, puis réexécutez-la si nécessaire. Si vous êtes satisfait de votre invite, vous pouvez choisir **Créer une version** pour créer un instantané de votre invite qui pourra être utilisé en production. Pour plus d’informations, consultez [Déploiement d’une invite dans votre application à l’aide des versions dans la gestion des invites](prompt-management-deploy.md). Vous pouvez aussi tester l’invite des manières suivantes : + Pour tester l’invite dans un flux, incluez un nœud d’invite dans le flux. Pour plus d’informations, consultez [Création et conception d’un flux dans Amazon Bedrock](flows-create.md) et [Types de nœuds pour votre flux](flows-nodes.md). + Si vous n’avez pas configuré votre invite avec un agent, vous pouvez toujours tester l’invite avec un agent en l’important lors du test d’un agent. Pour plus d’informations, consultez [Test du comportement des agents et résolution des problèmes](agents-test.md). ------ #### [ API ] Vous pouvez tester votre invite des manières suivantes : + Pour exécuter l’inférence sur l’invite, envoyez une demande [InvokeModel](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModel.html) [InvokeModelWithResponseStream](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModelWithResponseStream.html), [Converse](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html), ou [ConverseStream](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_ConverseStream.html) avec un [point de terminaison d’exécution Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#br-rt) et spécifiez l’ARN de l’invite dans le paramètre `modelId`. **Note** Les restrictions suivantes s’appliquent lorsque vous utilisez une invite de la gestion des invites avec `Converse` ou `ConverseStream` : Vous ne pouvez pas inclure les champs `additionalModelRequestFields`, `inferenceConfig`, `system` ni `toolConfig`. Si vous incluez le champ `messages`, les messages sont ajoutés après les messages définis dans l’invite. Si vous incluez le champ `guardrailConfig`, la barrière de protection est appliquée à l’ensemble de l’invite. Si vous incluez des blocs `guardContent` dans le champ [ContentBlock](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_ContentBlock.html), la barrière de protection ne sera appliquée qu’à ces blocs. + Pour tester votre invite dans un flux, créez ou modifiez un flux en envoyant une demande [CreateFlow](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_CreateFlow.html) ou [UpdateFlow](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UpdateFlow.html) avec un [point de terminaison de compilation pour agents Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt). Incluez un kit SDK pour JavaScript dans Node.js de type `PromptNode` et incluez l’ARN de l’invite dans le champ `promptArn`. Envoyez ensuite une demande [InvokeFlow](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeFlow.html) avec un [point de terminaison d’exécution des agents Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-rt). Pour plus d’informations, consultez [Création et conception d’un flux dans Amazon Bedrock](flows-create.md) et [Types de nœuds pour votre flux](flows-nodes.md). + Pour tester votre invite auprès d’un agent, utilisez la console Amazon Bedrock (voir l’onglet **Console**) ou entrez le texte de l’invite dans le champ `inputText` d’une demande [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html). ------ # Optimisation d’une invite Amazon Bedrock propose un outil permettant d’optimiser les invites. L’optimisation réécrit les invites pour produire des résultats d’inférence mieux adaptés à votre cas d’utilisation. Vous pouvez choisir le modèle pour lequel vous souhaitez optimiser l’invite, puis générer une invite révisée. Une fois que vous avez envoyé une invite à optimiser, Amazon Bedrock analyse les composants de cette invite. Si l’analyse est réussie, il réécrit l’invite. Vous pouvez ensuite copier et utiliser le texte de l’invite optimisée. **Note** Pour de meilleurs résultats, nous recommandons d’optimiser les invites en anglais. **Topics** + [Régions et modèles pris en charge pour l’optimisation d’invite](#prompt-management-optimize-supported) + [Envoi d’une invite pour optimisation](#prompt-management-optimize-submit) ## Régions et modèles pris en charge pour l’optimisation d’invite Le tableau suivant indique la prise en charge des modèles pour une optimisation rapide : | Fournisseur | Modèle | ID du modèle | Support du modèle à région unique | | --- | --- | --- | --- | | Amazon | Nova Lite | amazon. nova-lite-v1:0 | ap-southeast-2 eu-west-2 us-east-1 | | Amazon | Nova Micro | amazon. nova-micro-v1:0 | ap-southeast-2 eu-west-2 us-east-1 | | Amazon | Nova Premier | amazon. nova-premier-v1:0 | | | Amazon | Nova Pro | amazon. nova-pro-v1:0 | ap-southeast-2 eu-west-2 us-east-1 | | Anthropic | Claude 3 Haiku | anthropic.claude-3-haiku-20240307-v1:0 | ap-south-1 ap-southeast-2 ca-central-1 eu-central-1 eu-west-1 eu-west-2 eu-west-3 sa-east-1 us-east-1 us-west-2 | | Anthropic | Claude 3 Opus | anthropic.claude-3-opus-20240229-v 1:0 | | | Anthropic | Claude 3 Sonnet | anthropic.claude-3-sonnet-20240229-v 1:0 | ap-south-1 ap-southeast-2 ca-central-1 eu-central-1 eu-west-1 eu-west-2 eu-west-3 sa-east-1 us-east-1 us-west-2 | | Anthropic | Claude 3.5 Haiku | anthropic.claude-3-5-haiku-20241022-v1:0 | us-west-2 | | Anthropic | Sonnet de Claude 3.5 | anthropic.claude-3-5-sonnet-20240620-v1:0 | eu-central-1 us-east-1 us-west-2 | | Anthropic | Claude 3.5 Sonnet v2 | anthropic.claude-3-5-sonnet-20241022-v2:0 | ap-southeast-2 us-west-2 | | Anthropic | Claude 3.7 Sonnet | anthropic.claude-3-7-sonnet-20250219-v1:0 | eu-west-2 | | Anthropic | Claude Opus 4 | anthropic.claude-opus-4-20250514-v1:0 | | | Anthropic | Claude Sonnet 4 | anthropic.claude-sonnet-4-20250514-v1:0 | | | DeepSeek | DeepSeek-R1 | deepseek.r1-v1:0 | | | Meta | Llama 3 70B Instruct | meta.llama-3-70 1:0 b-instruct-v | ap-south-1 ca-central-1 eu-west-2 us-east-1 us-west-2 | | Meta | Llama 3.1 70B Instruct | meta.llama3-1-70 1:0 b-instruct-v | us-west-2 | | Meta | Llama 3.2 11B Instruct | meta.llama3-2-11 1:0 b-instruct-v | | | Meta | Llama 3.3 70B Instruct | meta.llama3-3-70 1:0 b-instruct-v | | | Meta | Llama 4 Maverick 17B Instruct | meta.llama4-maverick-17 1:0 b-instruct-v | | | Meta | Llama 4 Scout 17B Instruct | meta.llama4-scout-17 1:0 b-instruct-v | | | Mistral AI | Mistral Large (24.02) | mistral.mistral-large-2402-v1:0 | ap-south-1 ap-southeast-2 ca-central-1 eu-west-1 eu-west-2 eu-west-3 sa-east-1 us-east-1 us-west-2 | | Mistral AI | Mistral Large (24.07) | mistral.mistral-large-2407-v1:0 | us-west-2 | ## Envoi d’une invite pour optimisation Pour découvrir comment optimiser une invite, cliquez sur l’onglet correspondant à votre méthode préférée, puis suivez les étapes : ------ #### [ Console ] Vous pouvez optimiser une invite en utilisant un terrain de jeu ou en utilisant la gestion des invites dans la AWS Management Console. Vous devez sélectionner un modèle avant de pouvoir optimiser une invite. L’invite est optimisée pour le modèle que vous choisissez. **Pour optimiser une invite dans un terrain de jeu** 1. Pour savoir comment rédiger une invite dans un terrain de jeu Amazon Bedrock, suivez les étapes décrites dans [Génération de réponses dans la console à l’aide de terrains de jeu](playgrounds.md). 1. Après avoir rédigé une invite et sélectionné un modèle, choisissez l’icône en forme de baguette (![\[Sparkle icon representing cleaning or refreshing functionality.\]](http://docs.aws.amazon.com/fr_fr/bedrock/latest/userguide/images/icons/wand.png)). La boîte de dialogue **Optimisation d’invite** s’ouvre et Amazon Bedrock commence à optimiser votre invite. 1. Une fois qu’Amazon Bedrock a terminé d’analyser et d’optimiser votre invite, vous pouvez comparer votre invite d’origine côte à côte avec l’invite optimisée dans la boîte de dialogue. 1. Pour remplacer votre invite par l’invite optimisée dans le terrain de jeu, choisissez **Utiliser l’invite optimisée**. Pour conserver l’invite initiale, choisissez **Annuler**. 1. Pour envoyer l’invite et générer une réponse, choisissez **Exécuter**. **Pour optimiser une invite dans la gestion des invites** 1. Pour savoir comment rédiger une invite à l’aide de la gestion des invites, suivez les étapes décrites dans [Création d’une invite à l’aide de la gestion des invites](prompt-management-create.md). 1. Après avoir rédigé une invite et sélectionné un modèle, choisissez **(![\[Sparkle icon representing cleaning or refreshing functionality.\]](http://docs.aws.amazon.com/fr_fr/bedrock/latest/userguide/images/icons/wand.png)) Optimiser** en haut de la zone **Invite**. 1. Une fois qu’Amazon Bedrock a terminé d’analyser et d’optimiser votre invite, celle-ci s’affiche sous forme de variante côte à côte avec l’invite d’origine. 1. Pour utiliser l’invite optimisée au lieu de l’invite d’origine, sélectionnez **Remplacer l’invite d’origine**. Pour conserver l’invite d’origine, sélectionnez **Quitter la comparaison** et choisissez d’enregistrer l’invite d’origine. **Note** Si vous avez 3 invites dans la vue de comparaison et que vous essayez d’optimiser une autre invite, il vous est demandé de remplacer l’invite d’origine ou l’une des variantes. 1. Pour envoyer l’invite et générer une réponse, choisissez **Exécuter**. ------ #### [ API ] Pour optimiser une invite, envoyez une [OptimizePrompt](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_OptimizePrompt.html)demande avec un point de [terminaison Agents for Amazon Bedrock Runtime](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-rt). Indiquez l’invite à optimiser dans l’objet `input` et spécifiez le modèle pour l’optimiser dans le champ `targetModelId`. Le flux de réponse renvoie les événements suivants : 1. [analyzePromptEvent](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_AnalyzePromptEvent.html)— Apparaît lorsque l'invite est terminée d'être analysée. Contient un message décrivant l’analyse de l’invite. 1. [optimizedPromptEvent](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_OptimizedPromptEvent.html)— Apparaît lorsque l'invite a fini d'être réécrite. Contient l’invite optimisée. Exécutez l’exemple de code suivant pour optimiser une invite : ``` import boto3 # Set values here TARGET_MODEL_ID = "anthropic.claude-3-sonnet-20240229-v1:0" # Model to optimize for. For model IDs, see https://docs.aws.amazon.com/bedrock/latest/userguide/model-ids.html PROMPT = "Please summarize this text: " # Prompt to optimize def get_input(prompt): return { "textPrompt": { "text": prompt } } def handle_response_stream(response): try: event_stream = response['optimizedPrompt'] for event in event_stream: if 'optimizedPromptEvent' in event: print("========================== OPTIMIZED PROMPT ======================\n") optimized_prompt = event['optimizedPromptEvent'] print(optimized_prompt) else: print("========================= ANALYZE PROMPT =======================\n") analyze_prompt = event['analyzePromptEvent'] print(analyze_prompt) except Exception as e: raise e if __name__ == '__main__': client = boto3.client('bedrock-agent-runtime') try: response = client.optimize_prompt( input=get_input(PROMPT), targetModelId=TARGET_MODEL_ID ) print("Request ID:", response.get("ResponseMetadata").get("RequestId")) print("========================== INPUT PROMPT ======================\n") print(PROMPT) handle_response_stream(response) except Exception as e: raise e ``` ------ # Déploiement d’une invite dans votre application à l’aide des versions dans la gestion des invites Lorsque vous enregistrez votre invite, vous en créez une *version préliminaire*. Vous pouvez continuer à itérer sur la version préliminaire en modifiant l’invite et ses configurations et en l’enregistrant. Lorsque vous êtes prêt à déployer une invite en production, vous créez une version de celle-ci à utiliser dans votre application. Une version est un instantané que vous créez au moment où vous itérez sur la version préliminaire de l’invite. Créez des versions de votre invite lorsque vous êtes satisfait d’un ensemble de configurations. Les versions vous permettent de passer facilement d’une configuration à l’autre de votre invite et de mettre à jour votre application avec la version la plus adaptée à votre cas d’utilisation. **Topics** + [Création d’une version d’une invite dans la gestion des invites](prompt-management-version-create.md) + [Affichage des informations sur les versions d’une invite dans la gestion des invites](prompt-management-version-view.md) + [Comparaison des versions d’une invite dans la gestion des invites](prompt-management-version-compare.md) + [Suppression d’une version d’une invite dans la gestion des invites](prompt-management-version-delete.md) # Création d’une version d’une invite dans la gestion des invites Pour découvrir comment créer une version de votre invite, cliquez sur l’onglet correspondant à votre méthode préférée, puis suivez les étapes : ------ #### [ Console ] Si vous utilisez le créateur d’invites, vous pouvez créer une version de votre invite en choisissant **Créer une version**. Sinon, procédez comme suit : **Pour créer une version de votre invite** 1. Connectez-vous à la AWS Management Console avec une identité IAM autorisée à utiliser la console Amazon Bedrock. Ensuite, ouvrez la console Amazon Bedrock à l’adresse [https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock). 1. Sélectionnez **Gestion des invites** dans le volet de navigation de gauche. Choisissez ensuite une invite dans la section **Invites**. 1. Dans la section **Versions d’invites**, choisissez **Créer une version** pour prendre un instantané de votre version préliminaire. ------ #### [ API ] Pour créer une version de votre invite, envoyez une demande [CreatePromptVersion](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_CreatePromptVersion.html) avec un [point de terminaison de compilation pour agents Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) et spécifiez l’ARN ou l’identifiant de l’invite comme `promptIdentifier`. La réponse renvoie un identifiant et un ARN pour la version. Les versions sont créées de manière incrémentielle, en commençant par 1. ------ # Affichage des informations sur les versions d’une invite dans la gestion des invites Pour découvrir comment afficher les informations relatives à une version de votre invite, cliquez sur l’onglet correspondant à votre méthode préférée, puis suivez les étapes : ------ #### [ Console ] **Pour afficher des informations sur une version de votre invite** 1. Connectez-vous à la AWS Management Console avec une identité IAM autorisée à utiliser la console Amazon Bedrock. Ensuite, ouvrez la console Amazon Bedrock à l’adresse [https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock). 1. Sélectionnez **Gestion des invites** dans le volet de navigation de gauche. Choisissez ensuite une invite dans la section **Invites**. 1. Dans la section **Versions d’invites**, choisissez une version. 1. Sur la page **Détails de la version**, vous pouvez voir des informations sur la version, le message d’invite et ses configurations. Pour plus d’informations sur le test d’une version de l’invite, consultez [Test d’une invite à l’aide de la gestion des invites](prompt-management-test.md). ------ #### [ API ] Pour obtenir des informations sur une version de votre invite, envoyez une demande [GetPrompt](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_GetPrompt.html) avec un [point de terminaison de compilation pour agents Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) et spécifiez l’ARN ou l’identifiant de l’invite comme `promptIdentifier`. Dans le champ `promptVersion`, spécifiez le numéro de version. ------ # Comparaison des versions d’une invite dans la gestion des invites La console Amazon Bedrock propose un outil qui vous permet de comparer les versions d’une invite que vous avez créée dans la gestion des invites. L’outil met en évidence les champs qui existent dans une version et qui n’existent pas dans l’autre. **Pour comparer les versions d’une invite** 1. Connectez-vous à la AWS Management Console avec une identité IAM autorisée à utiliser la console Amazon Bedrock. Ensuite, ouvrez la console Amazon Bedrock à l’adresse [https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock). 1. Sélectionnez **Gestion des invites** dans le volet de navigation de gauche. Choisissez ensuite une invite dans la section **Invites**. 1. Dans la section **Versions**, cochez les cases situées à côté de deux invites pour effectuer une comparaison. 1. Choisissez **Comparer**. 1. Les objets JSON définissant chaque version d’invite sont affichés côte à côte. Les différences entre les versions sont indiquées ci-dessous : + Les champs qui existent dans une version, mais qui n’existent pas dans l’autre, sont marqués par un symbole plus (\$1) et surlignés en vert. + Les champs qui n’existent pas dans une version, mais qui existent dans l’autre, sont marqués d’un signe moins (-) et surlignés en rouge. 1. Pour comparer les réponses du modèle de sortie pour les différentes versions, renseignez les **Variables de test** et choisissez **Exécuter l’invite**. # Suppression d’une version d’une invite dans la gestion des invites Pour découvrir comment supprimer une version de votre invite, cliquez sur l’onglet correspondant à votre méthode préférée, puis suivez les étapes : ------ #### [ Console ] **Pour supprimer une version de votre invite** 1. Connectez-vous à la AWS Management Console avec une identité IAM autorisée à utiliser la console Amazon Bedrock. Ensuite, ouvrez la console Amazon Bedrock à l’adresse [https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock). 1. Sélectionnez **Gestion des invites** dans le volet de navigation de gauche. Choisissez ensuite une invite dans la section **Invites**. 1. Dans la section **Versions d’invites**, sélectionnez une version et choisissez **Supprimer**. 1. Sur la page **Détails de la version**, vous pouvez voir des informations sur la version, le message d’invite et ses configurations. Pour plus d’informations sur le test d’une version de l’invite, consultez [Test d’une invite à l’aide de la gestion des invites](prompt-management-test.md). 1. Passez en revue l’avertissement qui s’affiche, tapez **confirmer**, puis choisissez **Supprimer**. ------ #### [ API ] Pour supprimer une version de votre invite, envoyez une demande [DeletePrompt](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_DeletePrompt.html) avec un [point de terminaison de compilation pour agents Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) et spécifiez l’ARN ou l’identifiant de l’invite comme `promptIdentifier`. Dans le champ `promptVersion`, spécifiez le numéro de version à supprimer. ------ # Suppression d’une invite dans la gestion des invites Si vous n’avez plus besoin d’invite, vous pouvez le supprimer. Les invites que vous supprimez sont conservés sur les serveurs AWS pendant une durée maximale de quatorze jours. Pour savoir comment supprimer une invite à l’aide de la gestion des invites, choisissez l’onglet correspondant à votre méthode préférée, puis suivez les étapes : ------ #### [ Console ] Si vous vous trouvez sur la page des **Détails sur l’invite** pour une invite ou dans le créateur d’invites, choisissez **Supprimer** pour supprimer une invite. **Note** Si vous supprimez une invite, toutes ses versions seront également supprimées. Toute ressource utilisant votre invite peut rencontrer des erreurs d’exécution. N’oubliez pas de dissocier l’invite de toutes les ressources qui l’utilisent. **Pour supprimer une invite** 1. Connectez-vous à la AWS Management Console avec une identité IAM autorisée à utiliser la console Amazon Bedrock. Ensuite, ouvrez la console Amazon Bedrock à l’adresse [https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock). 1. Sélectionnez **Gestion des invites** dans le volet de navigation de gauche. 1. Sélectionnez une invite et choisissez **Supprimer**. 1. Passez en revue l’avertissement qui s’affiche, tapez **confirmer**, puis choisissez **Supprimer**. ------ #### [ API ] Pour supprimer une invite, envoyez une demande [DeletePrompt](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_DeletePrompt.html) avec un [point de terminaison de compilation pour agents Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) et spécifiez l’ARN ou l’identifiant de l’invite comme `promptIdentifier`. Pour supprimer une version spécifique de l’invite, spécifiez le numéro de version dans le champ `promptVersion`. ------ # Exécution d’exemples de code de gestion des invites Pour tester des exemples de code pour la gestion des invites, choisissez l’onglet correspondant à votre méthode préférée, puis suivez les étapes. Les exemples de code suivants supposent que vous avez configuré vos informations d’identification pour utiliser l’API AWS. Si vous ne l’avez pas encore fait, consultez [Démarrage avec l’API](getting-started-api.md). ------ #### [ Python ] 1. Exécutez l’extrait de code suivant pour charger AWS SDK pour Python (Boto3), créer un client et créer une invite qui crée une playlist musicale à l’aide de deux variables (`genre` et `number`) en créant un [point de terminaison de compilation pour agents Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) [CreatePrompt](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_CreatePrompt.html) : ``` # Create a prompt in Prompt management import boto3 # Create an Amazon Bedrock Agents client client = boto3.client(service_name="bedrock-agent") # Create the prompt response = client.create_prompt( name="MakePlaylist", description="My first prompt.", variants=[ { "name": "Variant1", "modelId": "amazon.titan-text-express-v1", "templateType": "TEXT", "inferenceConfiguration": { "text": { "temperature": 0.8 } }, "templateConfiguration": { "text": { "text": "Make me a {{genre}} playlist consisting of the following number of songs: {{number}}." } } } ] ) prompt_id = response.get("id") ``` 1. Exécutez l’extrait de code suivant pour voir l’invite que vous venez de créer (ainsi que toute autre invite de votre compte) pour créer un [point de terminaison de compilation pour agents Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) [ListPrompts](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_ListPrompts.html) : ``` # List prompts that you've created client.list_prompts() ``` 1. Vous devriez voir l’ID de l’invite que vous avez créée dans le champ `id` dans l’objet du champ `promptSummaries`. Exécutez l’extrait de code suivant pour afficher les informations relatives à l’invite que vous avez créée en créant un [point de terminaison de compilation pour agents Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) [GetPrompt](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_GetPrompt.html) : ``` # Get information about the prompt that you created client.get_prompt(promptIdentifier=prompt_id) ``` 1. Créez une version de l’invite et obtenez son ID en exécutant l’extrait de code suivant pour créer un [point de terminaison de compilation pour agents Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) [CreatePromptVersion](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_CreatePromptVersion.html) : ``` # Create a version of the prompt that you created response = client.create_prompt_version(promptIdentifier=prompt_id) prompt_version = response.get("version") prompt_version_arn = response.get("arn") ``` 1. Consultez les informations sur la version de l’invite que vous venez de créer, ainsi que les informations sur la version préliminaire, en exécutant l’extrait de code suivant pour créer un [point de terminaison de compilation pour agents Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) [ListPrompts](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_ListPrompts.html) : ``` # List versions of the prompt that you just created client.list_prompts(promptIdentifier=prompt_id) ``` 1. Consultez les informations relatives à la version de l’invite que vous venez de créer en exécutant l’extrait de code suivant pour créer un [point de terminaison de compilation pour agents Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) [GetPrompt](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_GetPrompt.html) : ``` # Get information about the prompt version that you created client.get_prompt( promptIdentifier=prompt_id, promptVersion=prompt_version ) ``` 1. Testez l’invite en l’ajoutant à un flux en suivant les étapes sous [Exécution d’exemples de code Amazon Bedrock Flows](flows-code-ex.md). Lors de la première étape, lorsque vous créez le flux, exécutez plutôt l’extrait de code suivant pour utiliser l’invite que vous avez créée au lieu de définir une invite intégrée dans le flux (remplacez l’ARN de la version de l’invite dans le champ `promptARN` par l’ARN de la version de l’invite que vous avez créée) : ``` # Import Python SDK and create client import boto3 client = boto3.client(service_name='bedrock-agent') FLOWS_SERVICE_ROLE = "arn:aws:iam::123456789012:role/MyPromptFlowsRole" # Flows service role that you created. For more information, see https://docs.aws.amazon.com/bedrock/latest/userguide/flows-permissions.html PROMPT_ARN = prompt_version_arn # ARN of the prompt that you created, retrieved programatically during creation. # Define each node # The input node validates that the content of the InvokeFlow request is a JSON object. input_node = { "type": "Input", "name": "FlowInput", "outputs": [ { "name": "document", "type": "Object" } ] } # This prompt node contains a prompt that you defined in Prompt management. # It validates that the input is a JSON object that minimally contains the fields "genre" and "number", which it will map to the prompt variables. # The output must be named "modelCompletion" and be of the type "String". prompt_node = { "type": "Prompt", "name": "MakePlaylist", "configuration": { "prompt": { "sourceConfiguration": { "resource": { "promptArn": "" } } } }, "inputs": [ { "name": "genre", "type": "String", "expression": "$.data.genre" }, { "name": "number", "type": "Number", "expression": "$.data.number" } ], "outputs": [ { "name": "modelCompletion", "type": "String" } ] } # The output node validates that the output from the last node is a string and returns it as is. The name must be "document". output_node = { "type": "Output", "name": "FlowOutput", "inputs": [ { "name": "document", "type": "String", "expression": "$.data" } ] } # Create connections between the nodes connections = [] # First, create connections between the output of the flow input node and each input of the prompt node for input in prompt_node["inputs"]: connections.append( { "name": "_".join([input_node["name"], prompt_node["name"], input["name"]]), "source": input_node["name"], "target": prompt_node["name"], "type": "Data", "configuration": { "data": { "sourceOutput": input_node["outputs"][0]["name"], "targetInput": input["name"] } } } ) # Then, create a connection between the output of the prompt node and the input of the flow output node connections.append( { "name": "_".join([prompt_node["name"], output_node["name"]]), "source": prompt_node["name"], "target": output_node["name"], "type": "Data", "configuration": { "data": { "sourceOutput": prompt_node["outputs"][0]["name"], "targetInput": output_node["inputs"][0]["name"] } } } ) # Create the flow from the nodes and connections client.create_flow( name="FlowCreatePlaylist", description="A flow that creates a playlist given a genre and number of songs to include in the playlist.", executionRoleArn=FLOWS_SERVICE_ROLE, definition={ "nodes": [input_node, prompt_node, output_node], "connections": connections } ) ``` 1. Supprimez la version de l’invite que vous venez de créer en exécutant l’extrait de code suivant pour créer un [point de terminaison de compilation pour agents Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) [DeletePrompt](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_DeletePrompt.html) : ``` # Delete the prompt version that you created client.delete_prompt( promptIdentifier=prompt_id, promptVersion=prompt_version ) ``` 1. Supprimez complètement l’invite que vous venez de créer en exécutant l’extrait de code suivant pour créer un [point de terminaison de compilation pour agents Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) [DeletePrompt](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_DeletePrompt.html) : ``` # Delete the prompt that you created client.delete_prompt( promptIdentifier=prompt_id ) ``` ------