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

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.

  • Utilisez des accolades doubles pour inclure des variables (comme dans{{variable}}) dans le message d'invite qui peuvent être renseignées lorsque vous appelez l'invite.

  • Choisissez un modèle pour appeler 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 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.

Si le modèle que vous choisissez pour l'invite est compatible avec le Converse API (pour plus d'informations, voirMenez une conversation avec le Converse Opérations API), vous pouvez inclure les éléments suivants lors de la création de l'invite :

  • Invite du système à 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 le modèle le prend en charge) Outils à utiliser par le modèle lors de la génération de la réponse.

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 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. Donnez un nom à l'invite et une description facultative.

  4. Pour chiffrer votre demande à l'aide d'une clé gérée par le client, sélectionnez Personnaliser les paramètres de chiffrement (avancés) dans la section de sélection des KMS clés. Si vous omettez ce champ, votre message sera chiffré avec un Clé gérée par AWS. Pour plus d'informations, consultez la section AWS KMS Clés.

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

  6. 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. Utilisez le volet Prompt pour créer l'invite. Entrez l'invite dans la dernière boîte de message utilisateur. Si le modèle est compatible avec les modèles Converse API ou AnthropicClaude Messages API, vous pouvez également inclure une invite du système et les messages précédents de l'utilisateur et de l'assistant pour le contexte.

    Lorsque vous rédigez une invite, vous pouvez inclure des variables entre accolades (comme dans{{variable}}). Chaque variable que vous incluez apparaît dans la section Variables de test.

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

    • 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 savoir comment tester une invite avec un agent dans leAPI, voirTester une invite à l'aide de la gestion rapide.

      2. Définissez les paramètres d'inférence.

      3. Si le modèle que vous choisissez prend en charge les outils, choisissez Configurer les outils pour utiliser les outils à l'invite.

    • 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 et 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 à 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 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 :

  • nom — Entrez le nom de la variante.

  • Incluez l'un de ces champs, en fonction du modèle de ressource d'invocation à utiliser :

    • modelId — Pour spécifier un modèle de base ou un profil d'inférence à utiliser avec l'invite, entrez son identifiant ARN ou son identifiant.

    • genAiResource — Pour spécifier un agent, entrez son ID ouARN. La valeur de genAiResource est un JSON objet au format suivant :

      {
    "genAiResource": {
    "agent": {
        "agentIdentifier": "string"
    }   
}
      Note

      Si vous incluez le genAiResource champ, vous ne pouvez tester l'invite que dans la console. Pour tester une invite avec un agent dans leAPI, vous devez saisir le texte de l'invite directement dans le inputText champ du InvokeAgent de la demande.

  • templateType — Entrez TEXT ouCHAT. CHATest uniquement compatible avec les modèles compatibles avec la Converse. API

  • templateConfiguration — La valeur dépend du type de modèle que vous avez spécifié :

  • inferenceConfiguration — Le text champ correspond à un PromptModelInferenceConfiguration. Ce champ contient les paramètres d'inférence communs à tous les modèles. 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.

  • additionalModelRequestChamps : utilisez ce champ pour spécifier les paramètres d'inférence spécifiques au modèle avec lequel vous exécutez l'inférence. Pour en savoir plus 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 base

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

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.