Gérer un garde-corps

Vous pouvez modifier un garde-corps existant pour ajouter de nouvelles politiques de configuration ou modifier une politique existante. Lorsque vous avez atteint une configuration de votre garde-corps qui vous convient, vous pouvez créer une version statique du garde-corps à utiliser avec vos modèles ou agents. Pour plus d’informations, consultez Déployez un garde-corps Amazon Bedrock.

Afficher les informations relatives à vos rambardes

Console

Pour consulter les informations relatives à vos rambardes

1. Connectez-vous à la AWS Management Console console Amazon Bedrock et ouvrez-la à l'adresse https://console.aws.amazon.com/bedrock/.

2. Choisissez Guardrails dans le volet de navigation de gauche. Sélectionnez ensuite un garde-corps dans la section Rambardes.

3. La section de présentation du garde-corps affiche les configurations du garde-corps qui s'appliquent à toutes les versions.

4. Pour afficher plus d'informations sur le projet de travail, sélectionnez le projet de travail dans la section Projet de travail.

5. Pour afficher plus d'informations sur une version spécifique du garde-corps, sélectionnez la version dans la section Versions.

Pour en savoir plus sur les versions de travail et de garde-corps, voir. Déployez un garde-corps Amazon Bedrock

API

Pour obtenir des informations sur un garde-corps, envoyez une GetGuardraildemande en indiquant l'identifiant et la version du garde-corps. Si vous ne spécifiez pas de version, la réponse renvoie les détails de la DRAFT version.

Le format de demande est le suivant :

GET /guardrails/guardrailIdentifier?guardrailVersion=guardrailVersion HTTP/1.1

Le format de réponse est le suivant :

HTTP/1.1 200
Content-type: application/json

{
   "blockedInputMessaging": "string",
   "blockedOutputsMessaging": "string",
   "contentPolicy": {
    "filters": [
      {
        "type": "string",
        "inputStrength": "string",
        "outputStrength": "string"
      }
    ]
  },
  "wordPolicy": {
    "words": [
      {
        "text": "string"
      }
    ],
    "managedWordLists": [
      {
        "type": "string"
      }
    ]
  },
  "sensitiveInformationPolicy": {
    "piiEntities": [
      {
        "type": "string",
        "action": "string"
      }
    ],
    "regexes": [
      {
        "name": "string",
        "description": "string",
        "regex": "string",
        "action": "string"
      }
    ]
  },
   "createdAt": "string",
   "description": "string",
   "failureRecommendations": [ "string" ],
   "guardrailArn": "string",
   "guardrailId": "string",
   "kmsKeyArn": "string",
   "name": "string",
   "status": "string",
   "statusReasons": [ "string" ],
   "topicPolicyConfig": { 
      "topics": [ 
         { 
            "definition": "string",
            "examples": [ "string" ],
            "name": "string",
            "type": "DENY"
         }
      ]
   },
   "updatedAt": "string",
   "version": "string"
}

Pour répertorier les informations relatives à tous vos garde-corps, envoyez une ListGuardrailsdemande.

Le format de demande est le suivant :

GET /guardrails?guardrailIdentifier=guardrailIdentifier&maxResults=maxResults&nextToken=nextToken HTTP/1.1

• Pour répertorier la DRAFT version de tous vos garde-corps, ne spécifiez pas le guardrailIdentifier champ.

• Pour répertorier toutes les versions d'un garde-corps, spécifiez l'ARN du garde-corps dans le champ. guardrailIdentifier

Vous pouvez définir le nombre maximum de résultats à renvoyer dans une réponse dans le maxResults champ. Si le nombre de résultats est supérieur à ce que vous avez défini, la réponse renvoie un nextToken que vous pouvez envoyer dans une autre demande ListGuardrails afin de voir le lot suivant de résultats.

Le format de réponse est le suivant :

HTTP/1.1 200
Content-type: application/json

{
   "guardrails": [ 
      { 
         "arn": "string",
         "createdAt": "string",
         "description": "string",
         "id": "string",
         "name": "string",
         "status": "string",
         "updatedAt": "string",
         "version": "string"
      }
   ],
   "nextToken": "string"
}

Modifier un garde-corps

Console

Pour modifier un garde-corps

1. Connectez-vous à la AWS Management Console console Amazon Bedrock et ouvrez-la à l'adresse https://console.aws.amazon.com/bedrock/.

2. Choisissez Guardrails dans le volet de navigation de gauche. Sélectionnez ensuite un garde-corps dans la section Rambardes.

3. Pour modifier le nom, la description, les balises ou les paramètres de chiffrement du modèle du garde-corps, sélectionnez Modifier dans la section de présentation du garde-corps.

4. Pour modifier des configurations spécifiques pour le garde-corps, sélectionnez Projet de travail dans la section Projet de travail.

5. Sélectionnez Modifier pour les sections contenant les paramètres que vous souhaitez modifier.

6. Apportez les modifications nécessaires, puis sélectionnez Enregistrer et quitter pour implémenter les modifications.

API

Pour modifier un garde-corps, envoyez une UpdateGuardraildemande. Incluez à la fois les champs que vous souhaitez mettre à jour et les champs que vous souhaitez conserver tels quels.

Le format de demande est le suivant :

PUT /guardrails/guardrailIdentifier 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"
         }
      ]
   },
   "description": "string",
   "kmsKeyId": "string",
   "name": "string",
   "tags": [ 
      { 
         "key": "string",
         "value": "string"
      }
   ],
   "topicPolicyConfig": { 
      "topicsConfig": [ 
         { 
            "definition": "string",
            "examples": [ "string" ],
            "name": "string",
            "type": "DENY"
         }
      ]
   }
}

Le format de réponse est le suivant :

HTTP/1.1 202
Content-type: application/json

{
   "guardrailArn": "string",
   "guardrailId": "string",
   "updatedAt": "string",
   "version": "string"
}

Supprimer un garde-corps

Vous pouvez supprimer un garde-corps lorsque vous n'en avez plus besoin. Assurez-vous de dissocier le garde-corps de toutes les ressources ou applications qui l'utilisent avant de le supprimer afin d'éviter d'éventuelles erreurs.

Console

Pour supprimer un garde-corps

1. Connectez-vous à la AWS Management Console console Amazon Bedrock et ouvrez-la à l'adresse https://console.aws.amazon.com/bedrock/.

2. Choisissez Guardrails dans le volet de navigation de gauche. Sélectionnez ensuite un garde-corps dans la section Rambardes.

3. Dans la section Gardrails, sélectionnez le garde-corps que vous souhaitez supprimer, puis choisissez Supprimer.

4. Entrez delete dans le champ de saisie utilisateur et choisissez Supprimer pour supprimer le garde-corps.

API

Pour supprimer un garde-corps, envoyez une DeleteGuardraildemande et spécifiez uniquement l'ARN du garde-corps dans le champ. guardrailIdentifier Ne spécifiez pas guardrailVersion

Le format de demande est le suivant :

DELETE /guardrails/guardrailIdentifier?guardrailVersion=guardrailVersion HTTP/1.1

Avertissement

Si vous supprimez un garde-corps, toutes ses versions seront supprimées.

Si la suppression est réussie, la réponse renvoie un code d'état HTTP 200.