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 des itérations 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.

Console

Pour créer un garde-corps

Connectez-vous à la AWS Management Console console Amazon Bedrock et ouvrez-la à l'adresse https://console.aws.amazon.com/bedrock/.
Dans le volet de navigation de gauche, choisissez Guardrails.
Dans la section Rambardes, choisissez Créer un garde-corps.
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. (Facultatif) Par défaut, votre garde-corps est chiffré avec un. Clé gérée par AWS Pour utiliser votre propre clé KMS gérée par le client, sélectionnez la flèche droite à côté de la sélection de la clé KMS et cochez la case Personnaliser les paramètres de chiffrement (avancés). Vous pouvez choisir une AWS KMS clé existante ou sélectionner Créer une AWS KMS clé pour en créer une nouvelle.
3. (Facultatif) Pour ajouter des étiquettes à votre garde-corps, sélectionnez la flèche droite à côté de Tags. Choisissez ensuite Ajouter une nouvelle balise et définissez des paires clé-valeur pour vos balises. Pour plus d’informations, consultez Balisage des ressources.
4. Choisissez Suivant.
Note
Vous devez configurer au moins un filtre pour créer un garde-corps. Vous pouvez ensuite choisir Passer à la révision et créer pour ignorer la création d'autres filtres.
(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 Filtres de contenu procédant comme suit :
1. Pour configurer les filtres pour les invites d'un modèle, sélectionnez Activer les filtres pour les invites dans la section Intensité du filtre pour les invites du modèle. 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 réponses du modèle, sélectionnez Activer les filtres pour les réponses dans Intensités des filtres pour les réponses. Configurez le degré de rigueur que vous souhaitez appliquer à chaque filtre pour les réponses renvoyées par le modèle.
3. Choisissez Suivant.
(Facultatif) Sur la page Ajouter des sujets refusés, procédez comme suit :
1. Pour définir un sujet à bloquer, choisissez 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é, consultezSujets refusés.
  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, choisissez Ajouter une phrase.
  4. Lorsque vous avez terminé de configurer le sujet refusé, choisissez Confirmer.
2. Vous pouvez effectuer les actions suivantes avec les sujets refusés.
  - Pour ajouter un autre sujet, choisissez Ajouter un sujet refusé.
  - Pour modifier un sujet, cliquez sur l'icône à trois points sur la même ligne que le sujet dans la colonne Actions. Puis, choisissez Modifier. Une fois les modifications terminées, choisissez Confirmer.
  - Pour supprimer un ou plusieurs sujets, cochez les cases correspondant aux sujets à supprimer. Choisissez Supprimer, puis sélectionnez Supprimer la sélection.
  - Pour supprimer tous les sujets, choisissez Supprimer, puis sélectionnez Supprimer tout.
  - Pour configurer la taille de chaque page du tableau ou l'affichage des colonnes du tableau, cliquez sur l'icône des paramètres ( ). Définissez vos préférences, puis choisissez Confirmer.
3. Lorsque vous avez terminé de configurer les sujets refusés, sélectionnez Suivant.

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

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.

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, choisissez 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.

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, choisissez Afficher les erreurs.
- Pour ajouter un élément à la liste de mots, choisissez 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, cliquez sur l'icône de modification ( ) à côté de l'élément.
- Pour supprimer un élément de la liste de mots, cliquez sur l'icône de la corbeille ( ) ou, si vous modifiez un élément, cliquez sur l'icône de suppression ( ) à côté de l'élément.
- Pour supprimer les éléments contenant des erreurs, choisissez Supprimer tout, puis sélectionnez Supprimer toutes les lignes contenant une erreur
- Pour supprimer tous les éléments, choisissez Supprimer tout, 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, choisissez le menu déroulant intitulé Afficher tout et sélectionnez Afficher uniquement les erreurs.
- Pour configurer la taille de chaque page du tableau ou l'affichage des colonnes du tableau, cliquez sur l'icône des paramètres ( ). Définissez vos préférences, puis choisissez 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.

(Facultatif) Sur la page Ajouter des filtres d'informations sensibles, configurez des filtres pour bloquer ou masquer les informations sensibles. Pour plus d’informations, consultez Filtres d'informations sensibles. Procédez comme suit :

Dans la section Types d'informations personnelles, configurez les catégories d'informations personnelles (PII) à bloquer ou à masquer. Vous avez les options suivantes :
- Pour ajouter un type de PII, choisissez Ajouter un type d'IPI. Ensuite, procédez comme suit :
  1. Dans la colonne Type, sélectionnez un type de PII.
  2. Dans la colonne Comportement du garde-corps, indiquez si le garde-corps doit bloquer le contenu contenant le type d'informations personnelles ou le masquer avec un identifiant.
- Pour ajouter tous les types d'informations personnelles, cliquez sur la flèche déroulante située à côté de Ajouter un type de données personnelles. Sélectionnez ensuite le comportement du garde-corps à appliquer à ces derniers.
  
  Avertissement
  Si vous spécifiez un comportement, tout comportement existant que vous avez configuré pour les types d'informations personnelles sera remplacé.
- Pour supprimer un type d'informations personnelles, cliquez sur l'icône de la corbeille ( ).
- Pour supprimer les lignes contenant des erreurs, choisissez Supprimer tout, puis sélectionnez Supprimer toutes les lignes contenant une erreur
- Pour supprimer tous les types d'informations personnelles, choisissez Supprimer tout, 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, choisissez le menu déroulant intitulé Afficher tout et sélectionnez Afficher uniquement les erreurs.
- Pour configurer la taille de chaque page du tableau ou l'affichage des colonnes du tableau, cliquez sur l'icône des paramètres ( ). Définissez vos préférences, puis choisissez Confirmer.

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, choisissez 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, choisissez None.
Ajouter une description	(Facultatif) Rédigez une description du modèle

Pour modifier un modèle, choisissez l'icône à trois points sur la même ligne que le sujet dans la colonne Actions. Puis, choisissez Modifier. Une fois les modifications terminées, choisissez Confirmer.
Pour supprimer un ou plusieurs modèles, cochez les cases correspondant aux modèles à supprimer. Choisissez Supprimer, puis sélectionnez Supprimer la sélection.
Pour supprimer tous les modèles, choisissez 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, cliquez sur l'icône des paramètres ( ). Définissez vos préférences, puis choisissez Confirmer.

Lorsque vous avez terminé de configurer les filtres d'informations sensibles, choisissez Next.

Sur la page Définir les messages bloqués, configurez les messages que vous souhaitez renvoyer à l'utilisateur lorsque le garde-corps détecte et bloque du contenu. Procédez comme suit :
1. Dans le champ Messagerie affichée pour les invites bloquées de la section Messagerie bloquée, entrez le message à afficher si le garde-corps bloque une invite envoyée au modèle.
2. Dans le champ Messagerie affichée pour les réponses bloquées de la section Messagerie bloquée, entrez le message à afficher si le garde-corps bloque une réponse générée par le modèle.
3. Choisissez Suivant.
Vérifiez et créez : passez en revue les paramètres de votre garde-corps.
1. Choisissez 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 se rapporte à 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 plus d’informations, consultez 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 n'importe quelle étiquette au garde-corps. Pour plus d’informations, consultez Balisage des ressources.
(Facultatif) Pour des raisons de sécurité, incluez l'ARN d'une clé KMS 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"
}

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

Prérequis

Testez un garde-corps

Créez un garde-corps

Pour créer un garde-corps

Note

Avertissement