Créez un garde-corps - 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éez un garde-corps

Vous créez une barrière de sécurité en configurant les configurations, en définissant les sujets à refuser, en fournissant des filtres pour gérer les contenus dangereux et sensibles et en écrivant des messages lorsque les invites et les réponses des utilisateurs sont bloquées.

Un garde-corps doit contenir au moins un filtre et un message lorsque les invites et les réponses des utilisateurs sont bloquées. Vous pouvez choisir d'utiliser la messagerie par défaut. Vous pouvez ajouter des filtres et effectuer une itération sur votre garde-corps ultérieurement en suivant les étapes décrites dans la section Modifier un garde-corps pour configurer tous les composants dont vous avez besoin pour votre garde-corps.

Sélectionnez l'onglet correspondant à la méthode de votre choix et suivez les étapes suivantes :

Console
Pour créer un garde-corps dans la console AWS
  1. Connectez-vous à l' AWS Management Console aide d'un IAMrôle avec les autorisations Amazon Bedrock et ouvrez la console Amazon Bedrock à l'adresse. https://console.aws.amazon.com/bedrock/

  2. Dans le volet de navigation de gauche, sélectionnez Guardrails.

  3. Dans la section Rambardes, sélectionnez Créer un garde-corps.

  4. Sur la page Fournir des informations sur le garde-corps, procédez comme suit :

    1. Dans la section Détails du garde-corps, indiquez un nom et une description facultative pour le garde-corps.

    2. Entrez un message pour la messagerie bloquée pour obtenir les instructions qui s'afficheront lorsque des garde-corps sont invoqués. Cochez la case Utiliser le même message bloqué pour les réponses afin d'utiliser le même message lorsque des garde-fous sont invoqués dans la réponse.

    3. (Facultatif) Par défaut, votre garde-corps est chiffré avec un. Clé gérée par AWS Pour utiliser votre propre KMS clé gérée par le client, sélectionnez la flèche droite à côté de la KMStouche sélectionnée et cochez la case Personnaliser les paramètres de chiffrement (avancés). Vous pouvez sélectionner une AWS KMS clé existante ou sélectionner Créer une AWS KMS clé pour en créer une nouvelle.

    4. Pour les options de création de garde-corps, sélectionnez Création rapide avec filtres de toxicité pour utiliser les paramètres par défaut, ou sélectionnez Créer votre propre garde-corps pour personnaliser les paramètres de votre garde-corps. Vous pouvez également sélectionner Afficher et modifier les filtres de toxicité pour afficher ou personnaliser les paramètres de blasphème et de filtre d'attaque rapide de votre garde-corps.

    5. (Facultatif) Pour ajouter des étiquettes à votre garde-corps, sélectionnez la flèche droite à côté de Tags. Sélectionnez ensuite Ajouter une nouvelle balise et définissez des paires clé-valeur pour vos balises. Pour de plus amples informations, veuillez consulter Marquer les ressources Amazon Bedrock.

    6. Choisissez Suivant.

    Note

    Vous devez configurer au moins un filtre pour créer un garde-corps. Vous pouvez ensuite sélectionner Créer pour ignorer la création d'autres filtres.

  5. (Facultatif) Sur la page Configurer les filtres de contenu, définissez l'intensité avec laquelle vous souhaitez filtrer le contenu lié aux catégories définies dans en Bloquez les mots et les conversations dangereux à l'aide de filtres de contenu procédant comme suit :

    1. Pour configurer les filtres pour les catégories dangereuses, sélectionnez Activer le filtre des catégories dangereuses. Vous pouvez sélectionner le filtre pour les attaques rapides dans les catégories dangereuses. Configurez dans quelle mesure vous souhaitez que chaque filtre soit strict pour les invites que l'utilisateur fournit au modèle.

    2. Pour configurer les filtres pour les attaques rapides, sélectionnez Activer le filtre des attaques rapides. Configurez la rigueur avec laquelle vous souhaitez que le filtre détecte et bloque les attaques par jailbreak et par injection rapide.

    3. Sélectionnez Créer pour créer le garde-corps ou sélectionnez Utiliser des filtres avancés pour personnaliser les paramètres des filtres.

  6. (Facultatif) Sur la page Ajouter des sujets refusés, vous pouvez ajouter des sujets refusés ou sélectionner Passer à la révision et créer.

    1. Pour définir un sujet à bloquer, sélectionnez Ajouter un sujet refusé. Ensuite, procédez comme suit :

      1. Entrez un Nom pour la rubrique.

      2. Dans la zone Définition du sujet, définissez le sujet. Pour obtenir des instructions sur la façon de définir un sujet refusé, consultezBloquez les sujets refusés pour supprimer le contenu préjudiciable.

      3. (Facultatif) Pour ajouter des invites de saisie représentatives ou des réponses modèles liées à cette rubrique, sélectionnez la flèche droite à côté de Ajouter des exemples de phrases. Entrez une phrase dans le champ. Pour ajouter une autre phrase, sélectionnez Ajouter une phrase.

      4. Lorsque vous avez terminé de configurer le sujet refusé, sélectionnez Confirmer.

    2. Vous pouvez effectuer les actions suivantes avec les sujets refusés.

      • Pour ajouter un autre sujet, sélectionnez Ajouter un sujet refusé.

      • Pour modifier un sujet, sélectionnez l'icône à trois points sur la même ligne que le sujet dans la colonne Actions. Sélectionnez ensuite Modifier. Une fois les modifications terminées, sélectionnez Confirmer.

      • Pour supprimer un ou plusieurs sujets, cochez les cases correspondant aux sujets à supprimer. Sélectionnez Supprimer, puis sélectionnez Supprimer la sélection.

      • Pour supprimer tous les sujets, sélectionnez Supprimer, puis sélectionnez Supprimer tout.

      • Pour configurer la taille de chaque page du tableau ou l'affichage des colonnes du tableau, sélectionnez l'icône des paramètres ( Gear icon representing settings or configuration options. ). Définissez vos préférences, puis sélectionnez Confirmer.

    3. Lorsque vous avez terminé de configurer les sujets refusés, sélectionnez Suivant.

  7. (Facultatif) Sur la page Ajouter des filtres de mots, procédez comme suit :

    1. Dans la section Filtrer les grossièretés, sélectionnez Filtrer les grossièretés pour bloquer les grossièretés dans les invites et les réponses. La liste des grossièretés est basée sur des définitions conventionnelles et est continuellement mise à jour.

    2. Dans la section Ajouter des mots et des phrases personnalisés, sélectionnez le mode d'ajout de mots et de phrases à bloquer par le garde-corps. Si vous choisissez de télécharger un fichier, chaque ligne du fichier doit contenir un mot ou une phrase de trois mots maximum. N'incluez pas d'en-tête. Vous avez les options suivantes :

      Option Instructions
      Ajouter des mots et des phrases manuellement Ajoutez directement des mots et des phrases dans la section Afficher et modifier des mots et des phrases.
      Téléchargement depuis un fichier local Pour télécharger un fichier .txt ou .csv contenant les mots et les phrases, sélectionnez Choisir un fichier après avoir sélectionné cette option.
      Chargement depuis un objet Amazon S3 Pour charger un fichier depuis Amazon S3, spécifiez l'objet S3 après avoir sélectionné cette option. Chaque ligne du fichier doit contenir un mot ou une phrase de trois mots maximum.
    3. Vous modifiez les mots et les phrases que le garde-corps doit bloquer dans la section Afficher et modifier les mots et les phrases. Vous avez les options suivantes :

      • Si vous avez chargé une liste de mots à partir d'un fichier local ou d'un objet Amazon S3, cette section sera renseignée avec votre liste de mots. Pour filtrer les éléments comportant des erreurs, sélectionnez Afficher les erreurs.

      • Pour ajouter un élément à la liste de mots, sélectionnez Ajouter un mot ou une phrase. Entrez un mot ou une phrase de trois mots maximum dans le champ et appuyez sur Entrée ou sélectionnez l'icône en forme de coche pour confirmer l'élément.

      • Pour modifier un élément, sélectionnez l'icône de modification ( Edit icon represented by a pencil symbol. ) à côté de l'élément.

      • Pour supprimer un élément de la liste de mots, sélectionnez l'icône de la corbeille ( Trapezoid-shaped diagram showing data flow from source to destination through AWS Transfer Family. ) ou, si vous modifiez un élément, sélectionnez l'icône de suppression ( Close or cancel icon represented by an "X" symbol. ) à côté de l'élément.

      • Pour supprimer les éléments contenant des erreurs, sélectionnez Tout supprimer, puis sélectionnez Supprimer toutes les lignes contenant une erreur

      • Pour supprimer tous les éléments, sélectionnez Tout supprimer, puis sélectionnez Supprimer toutes les lignes

      • Pour rechercher un élément, entrez une expression dans la barre de recherche.

      • Pour afficher uniquement les éléments comportant des erreurs, sélectionnez le menu déroulant intitulé Afficher tout, puis sélectionnez Afficher uniquement les erreurs.

      • Pour configurer la taille de chaque page du tableau ou l'affichage des colonnes du tableau, sélectionnez l'icône des paramètres ( Gear icon representing settings or configuration options. ). Définissez vos préférences, puis sélectionnez Confirmer.

      • Par défaut, cette section affiche l'éditeur de table. Pour passer à un éditeur de texte dans lequel vous pouvez saisir un mot ou une phrase sur chaque ligne, sélectionnez Éditeur de texte. L'éditeur de texte fournit les fonctionnalités suivantes :

        • Vous pouvez copier une liste de mots depuis un autre éditeur de texte et la coller dans cet éditeur.

        • Une icône X rouge apparaît à côté des éléments contenant des erreurs et une liste d'erreurs apparaît sous l'éditeur.

    4. Sélectionnez Ignorer pour réviser et créer pour créer le garde-corps, ou sélectionnez Suivant pour ajouter des filtres PII et des modèles regex.

  8. (Facultatif) Sur la page Ajouter des filtres d'informations sensibles, configurez des filtres pour bloquer ou masquer les informations sensibles. Pour de plus amples informations, veuillez consulter Supprimer PII des conversations en utilisant des filtres d'informations sensibles. Procédez comme suit :

    1. Dans la section PIItypes, configurez les catégories d'informations personnellement identifiables (PII) à bloquer ou à masquer. Vous avez les options suivantes :

      • Pour ajouter un PII type, sélectionnez Ajouter un PII type. Ensuite, procédez comme suit :

        1. Dans la colonne Type, sélectionnez un PII type.

        2. Dans la colonne Comportement du garde-corps, indiquez si le garde-corps doit bloquer le contenu contenant le PII type ou le masquer avec un identifiant.

      • Pour ajouter tous les PII types, sélectionnez la flèche déroulante à côté de Ajouter un PII type. Sélectionnez ensuite le comportement du garde-corps à leur appliquer.

        Avertissement

        Si vous spécifiez un comportement, tout comportement existant que vous avez configuré pour les PII types sera remplacé.

      • Pour supprimer un PII type, sélectionnez l'icône de la corbeille ( Trapezoid-shaped diagram showing data flow from source to destination through AWS Transfer Family. ).

      • Pour supprimer les lignes contenant des erreurs, sélectionnez Tout supprimer, puis sélectionnez Supprimer toutes les lignes contenant une erreur

      • Pour supprimer tous les PII types, sélectionnez Tout supprimer, puis sélectionnez Supprimer toutes les lignes

      • Pour rechercher une ligne, entrez une expression dans la barre de recherche.

      • Pour afficher uniquement les lignes comportant des erreurs, sélectionnez le menu déroulant intitulé Afficher tout, puis sélectionnez Afficher uniquement les erreurs.

      • Pour configurer la taille de chaque page du tableau ou l'affichage des colonnes du tableau, sélectionnez l'icône des paramètres ( Gear icon representing settings or configuration options. ). Définissez vos préférences, puis sélectionnez Confirmer.

    2. Dans la section Motifs Regex, utilisez des expressions régulières pour définir des modèles à filtrer par le garde-corps. Vous avez les options suivantes :

      • Pour ajouter un modèle, sélectionnez Ajouter un modèle regex. Configurez les champs suivants :

        Champ Description
        Nom Un nom pour le motif
        Motif Regex Une expression régulière qui définit le modèle
        Comportement d’une barrière de sécurité Choisissez de bloquer le contenu contenant le modèle ou de le masquer avec un identifiant. Pour masquer le modèle uniquement dans les journaux, sélectionnez Aucun.
        Ajouter une description (Facultatif) Rédigez une description du modèle
      • Pour modifier un modèle, sélectionnez l'icône à trois points sur la même ligne que le sujet dans la colonne Actions. Sélectionnez ensuite Modifier. Une fois les modifications terminées, sélectionnez Confirmer.

      • Pour supprimer un ou plusieurs modèles, cochez les cases correspondant aux modèles à supprimer. Sélectionnez Supprimer, puis sélectionnez Supprimer la sélection.

      • Pour supprimer tous les modèles, sélectionnez Supprimer, puis sélectionnez Supprimer tout.

      • Pour rechercher un modèle, entrez une expression dans la barre de recherche.

      • Pour configurer la taille de chaque page du tableau ou l'affichage des colonnes du tableau, sélectionnez l'icône des paramètres ( Gear icon representing settings or configuration options. ). Définissez vos préférences, puis sélectionnez Confirmer.

    3. Lorsque vous avez fini de configurer les filtres d'informations sensibles, sélectionnez Suivant ou Ignorer pour les consulter et les créer.

  9. Sur la page Ajouter une vérification contextuelle de base (facultatif), configurez des seuils pour bloquer les informations non fondées ou non pertinentes.

    Note

    Pour chaque type de vérification, vous pouvez déplacer le curseur ou saisir une valeur de seuil comprise entre 0 et 0,99. Sélectionnez un seuil adapté à vos utilisations. Un seuil plus élevé nécessite que les réponses soient fondées ou pertinentes avec un degré de confiance élevé pour être autorisées. Les réponses inférieures au seuil seront filtrées. Pour en savoir plus sur le contrôle de mise à la terre contextuel, consultez la section Vérification de mise à la terre contextuelle.

    1. Dans le champ Mise à la terre, sélectionnez Activer la vérification de mise à la terre pour vérifier si les réponses du modèle sont ancrées.

    2. Dans le champ Pertinence, sélectionnez Activer le contrôle de pertinence pour vérifier si les réponses du modèle sont pertinentes.

    3. Sélectionnez Suivant.

  10. Vérifiez et créez : passez en revue les paramètres de votre garde-corps.

    1. Sélectionnez Modifier dans la section à laquelle vous souhaitez apporter des modifications.

    2. Lorsque vous êtes satisfait des paramètres de votre garde-corps, sélectionnez Créer pour créer le garde-corps.

API

Pour créer un garde-corps, envoyez une CreateGuardraildemande. Le format de demande est le suivant :

POST /guardrails HTTP/1.1 Content-type: application/json { "blockedInputMessaging": "string", "blockedOutputsMessaging": "string", "contentPolicyConfig": { "filtersConfig": [ { "inputStrength": "NONE | LOW | MEDIUM | HIGH", "outputStrength": "NONE | LOW | MEDIUM | HIGH", "type": "SEXUAL | VIOLENCE | HATE | INSULTS | MISCONDUCT | PROMPT_ATTACK" } ] }, "wordPolicyConfig": { "wordsConfig": [ { "text": "string" } ], "managedWordListsConfig": [ { "type": "string" } ] }, "sensitiveInformationPolicyConfig": { "piiEntitiesConfig": [ { "type": "string", "action": "string" } ], "regexesConfig": [ { "name": "string", "description": "string", "regex": "string", "action": "string" } ] }, "description": "string", "kmsKeyId": "string", "name": "string", "tags": [ { "key": "string", "value": "string" } ], "topicPolicyConfig": { "topicsConfig": [ { "definition": "string", "examples": [ "string" ], "name": "string", "type": "DENY" } ] } }
  • Spécifiez un name et description pour le garde-corps.

  • Spécifiez les messages lorsque le garde-corps bloque avec succès une invite ou un modèle de réponse dans les champs blockedInputMessaging etblockedOutputsMessaging.

  • Spécifiez les sujets que le garde-corps doit refuser dans l'topicPolicyobjet. Chaque élément de la topics liste concerne un sujet. Pour plus d'informations sur les champs d'une rubrique, voir Rubrique.

    • Donnez un « name and » description pour que le garde-corps puisse identifier correctement le sujet.

    • Spécifiez DENY dans le action champ.

    • (Facultatif) Fournissez jusqu'à cinq exemples que vous pourriez classer comme appartenant au sujet de la examples liste.

  • Spécifiez l'intensité du filtre pour les catégories nocives définies dans Amazon Bedrock dans l'contentPolicyobjet. Chaque élément de la filters liste appartient à une catégorie dangereuse. Pour de plus amples informations, veuillez consulter Bloquez les mots et les conversations dangereux à l'aide de filtres de contenu. Pour plus d'informations sur les champs d'un filtre de contenu, consultez ContentFilter.

    • Spécifiez la catégorie dans le type champ.

    • Spécifiez l'intensité du filtre pour les invites dans le strength champ du textToTextFiltersForPrompt champ et pour les réponses du modèle dans le strength champ dutextToTextFiltersForResponse.

  • (Facultatif) Fixez des étiquettes sur le garde-corps. Pour de plus amples informations, veuillez consulter Marquer les ressources Amazon Bedrock.

  • (Facultatif) Pour des raisons de sécurité, incluez le code ARN d'une KMS clé dans le kmsKeyId champ.

Le format de réponse est le suivant :

HTTP/1.1 202 Content-type: application/json { "createdAt": "string", "guardrailArn": "string", "guardrailId": "string", "version": "string" }