Création d'une invite à l'aide de la gestion rapide - Amazon Bedrock

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 d'une invite à l'aide de la gestion rapide

Note

La gestion rapide est en cours de prévisualisation et est sujette à modification.

Lorsque vous créez une invite, les options suivantes s'offrent à vous :

  • Rédigez le message d'invite qui sert d'entrée à un FM pour générer une sortie.

  • Incluez dans le message d'invite des variables qui peuvent être renseignées lors de l'exécution.

  • Choisissez un modèle pour exécuter l'invite ou laissez-le être renseigné lors de l'exécution. Si vous choisissez un modèle, vous pouvez également modifier les configurations d'inférence à utiliser. Pour consulter les paramètres d'inférence des différents modèles, voirParamètres de demande d'inférence et champs de réponse pour les modèles de base.

  • Créez des variantes de votre invite qui utilisent des messages, des modèles ou des configurations différents afin de pouvoir comparer leurs sorties afin de décider de la variante la mieux adaptée à votre cas d'utilisation.

Pour savoir comment créer une invite à l'aide de la gestion des invites, sélectionnez l'onglet correspondant à la méthode de votre choix et suivez les étapes suivantes :

Console
Pour créer une invite

  1. Connectez-vous à l' AWS Management Console aide d'un IAMrôle avec les autorisations Amazon Bedrock et ouvrez la console Amazon Bedrock sur Getting Started with the. AWS Management Console

  2. Sélectionnez Gestion rapide dans le volet de navigation de gauche. Choisissez ensuite Create prompt.

  3. (Facultatif) Modifiez le nom par défaut de l'invite et sa description.

  4. Choisissez Créer une invite. Votre invite est créée et vous serez redirigé vers le générateur d'invite pour votre nouvelle invite, où vous pouvez configurer votre invite.

  5. Vous pouvez passer à la procédure suivante pour configurer votre invite ou revenir au générateur d'invite ultérieurement.

Pour configurer votre invite

  1. Si vous n'êtes pas encore dans le générateur d'invite, procédez comme suit :

    1. Connectez-vous à l' AWS Management Console aide d'un IAMrôle avec les autorisations Amazon Bedrock et ouvrez la console Amazon Bedrock sur Getting Started with the. AWS Management Console

    2. Sélectionnez Gestion rapide dans le volet de navigation de gauche. Choisissez ensuite une invite dans la section Prompts.

    3. Dans la section Prompt Brouillon, choisissez Modifier dans le générateur d'invite.

  2. Dans le volet Invite, entrez une invite dans la zone Message. Vous pouvez utiliser des accolades doubles pour inclure des variables (comme dans {{variable}}). Notez ce qui suit à propos des variables d'invite :

    • Chaque variable que vous incluez apparaît dans la section Variables de test.

    • Vous pouvez remplacer ces variables par des valeurs réelles lorsque vous testez l'invite ou lorsque vous configurez l'invite dans un flux d'invite.

  3. (Facultatif) Vous pouvez modifier votre invite de la manière suivante :

    • Dans le volet Configurations, choisissez un modèle pour exécuter l'inférence et définissez les paramètres d'inférence.

    • Pour comparer les différentes variantes de votre invite, choisissez Actions, puis sélectionnez Comparer les variantes de l'invite. Vous pouvez effectuer les opérations suivantes sur la page de comparaison :

      • 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.

  4. Lorsque vous avez terminé de configurer l'invite, vous disposez des options suivantes :

API

Pour créer une invite, envoyez une CreatePromptdemande (voir le lien pour les formats de demande et de réponse et les détails des champs) avec un point de terminaison Agents for Amazon Bedrock Build-time.

Les champs suivants sont obligatoires :

Champ Brève description
name Nom de l'invite.
variantes Liste des différentes configurations pour l'invite (voir ci-dessous).
defaultVariant Nom de la variante par défaut.

Chaque variante de la variants liste est un PromptVariantobjet de la structure générale suivante :

{
        "name": "string",
        "modelId": "string",
        "templateType": "TEXT",
        "templateConfiguration": {
            "text": {
                "text": "string",
                "inputVariables": [
                    {
                        "name": "string"
                    },
                    ...
                ]
            }
        },
        "inferenceConfiguration": {
            "text": {
                "maxTokens": int,
                "stopSequences": ["string", ...],
                "temperature": float,
                "topK": int,
                "topP": float
            }
        },
        "metadata": [
            {
                "key": "string",
                "value": "string"
            },
            ...
        ]
}

Remplissez les champs comme suit :

  • nom — Entrez le nom de la variante.

  • modelId — Entrez l'ID du modèle ou le profil d'inférence avec lequel exécuter l'inférence.

  • templateType — Entrez TEXT (actuellement, seuls les messages texte sont pris en charge).

  • templateConfiguration — Le text champ correspond à un TextPromptTemplateConfiguration. Renseignez les champs suivants :

    • text — Le message d'invite. Placez les variables entre accolades doubles : {{variable}}.

    • inputVariables — Pour chaque objet de la liste, entrez chaque variable que vous avez créée dans le name champ.

  • inferenceConfiguration — Le text champ correspond à un PromptModelInferenceConfiguration. Pour en savoir plus sur les paramètres d'inférence, consultezInfluencez la génération de réponses avec des paramètres d'inférence.

  • 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 fournir une description de l'invite.
clientToken Pour garantir que la API demande ne soit traitée qu'une seule fois. Pour plus d'informations, consultez la section Garantir l'idempuissance.
balises Pour associer des balises au flux. Pour de plus amples informations, veuillez consulter Marquer les ressources Amazon Bedrock.
customerEncryptionKeyArn Pour chiffrer le flux à l'aide d'une KMS clé. Pour de plus amples informations, veuillez consulter Politique clé permettant à Amazon Bedrock de chiffrer et de déchiffrer un flux.

La réponse crée une DRAFT version et renvoie un identifiant ARN que vous pouvez utiliser comme identifiant d'invite pour d'autres demandes liées à une inviteAPI.