Verwalte eine Leitplanke

Sie können eine bestehende Leitplanke ändern, um neue Konfigurationsrichtlinien hinzuzufügen oder eine bestehende Richtlinie zu bearbeiten. Wenn Sie eine Konfiguration für Ihre Guardrail erreicht haben, mit der Sie zufrieden sind, können Sie eine statische Version der Guardrail erstellen, die Sie mit Ihren Modellen oder Agenten verwenden können. Weitere Informationen finden Sie unter Stellen Sie eine Amazon Bedrock Guardrail bereit.

Informationen zu Ihren Leitplanken anzeigen

Console

Um Informationen über Ihre Leitplanken einzusehen

1. Melden Sie sich bei der AWS Management Console an und öffnen Sie die Amazon Bedrock-Konsole unter https://console.aws.amazon.com/bedrock/.

2. Wählen Sie im linken Navigationsbereich Guardrails aus. Wählen Sie dann im Abschnitt „Leitplanken“ eine Leitplanke aus.

3. Im Abschnitt Übersicht über die Leitplanke werden die Konfigurationen der Leitplanke angezeigt, die für alle Versionen gelten.

4. Um weitere Informationen über den Arbeitsentwurf anzuzeigen, wählen Sie den Arbeitsentwurf im Abschnitt Arbeitsentwurf aus.

5. Um weitere Informationen zu einer bestimmten Version der Leitplanke anzuzeigen, wählen Sie die Version im Abschnitt Versionen aus.

Weitere Informationen zu den Versionen Working Draft und Guardrail finden Sie unter. Stellen Sie eine Amazon Bedrock Guardrail bereit

API

Um Informationen zu einer Leitplanke zu erhalten, senden Sie eine GetGuardrailAnfrage und geben Sie die ID und die Version der Leitplanke an. Wenn Sie keine Version angeben, werden in der Antwort Details zur Version zurückgegeben. DRAFT

Das Anforderungsformat ist wie folgt:

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

Das Folgende ist das Antwortformat:

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"
}

Senden Sie eine Anfrage, um Informationen zu all Ihren Leitplanken aufzulisten. ListGuardrails

Das Anforderungsformat ist wie folgt:

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

• Um die DRAFT Version all Ihrer Leitplanken aufzulisten, geben Sie das guardrailIdentifier Feld nicht an.

• Um alle Versionen einer Leitplanke aufzulisten, geben Sie den ARN der Leitplanke in das Feld ein. guardrailIdentifier

Sie können in dem Feld die maximale Anzahl von Ergebnissen festlegen, die in einer Antwort zurückgegeben werden sollen. maxResults Wenn es mehr Ergebnisse als die von Ihnen festgelegte Höchstzahl gibt, gibt die Antwort ein nextToken zurück, das Sie in einer weiteren ListGuardrails-Anforderung senden können, um den nächsten Ergebnisstapel zu sehen.

Das folgende Antwortformat ist:

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"
}

Bearbeiten Sie eine Leitplanke

Console

Um eine Leitplanke zu bearbeiten

1. Melden Sie sich bei der AWS Management Console an und öffnen Sie die Amazon Bedrock-Konsole unter https://console.aws.amazon.com/bedrock/.

2. Wählen Sie im linken Navigationsbereich Guardrails aus. Wählen Sie dann im Abschnitt „Leitplanken“ eine Leitplanke aus.

3. Um den Namen, die Beschreibung, die Tags oder die Modellverschlüsselungseinstellungen für die Leitplanke zu bearbeiten, wählen Sie im Abschnitt Guardrail-Übersicht die Option Bearbeiten aus.

4. Um bestimmte Konfigurationen für die Leitplanke zu bearbeiten, wählen Sie im Abschnitt Arbeitsentwurf die Option Arbeitsentwurf aus.

5. Wählen Sie Bearbeiten für die Abschnitte aus, die die Einstellungen enthalten, die Sie ändern möchten.

6. Nehmen Sie die erforderlichen Änderungen vor und wählen Sie dann Speichern und beenden aus, um die Änderungen zu übernehmen.

API

Um eine Leitplanke zu bearbeiten, senden Sie eine Anfrage. UpdateGuardrail Schließen Sie sowohl Felder ein, die Sie aktualisieren möchten, als auch Felder, die unverändert bleiben sollen.

Das Anforderungsformat ist wie folgt:

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"
         }
      ]
   }
}

Das Folgende ist das Antwortformat:

HTTP/1.1 202
Content-type: application/json

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

Löscht eine Leitplanke

Sie können eine Leitplanke löschen, wenn Sie sie nicht mehr benötigen. Stellen Sie sicher, dass Sie die Guardrail von allen Ressourcen oder Anwendungen trennen, die sie verwenden, bevor Sie die Guardrail löschen, um mögliche Fehler zu vermeiden.

Console

Um eine Leitplanke zu löschen

1. Melden Sie sich bei der AWS Management Console an und öffnen Sie die Amazon Bedrock-Konsole unter https://console.aws.amazon.com/bedrock/.

2. Wählen Sie im linken Navigationsbereich Guardrails aus. Wählen Sie dann im Abschnitt „Leitplanken“ eine Leitplanke aus.

3. Wählen Sie im Abschnitt Leitplanken eine Leitplanke aus, die Sie löschen möchten, und wählen Sie dann Löschen.

4. Geben Sie den delete Text in das Benutzereingabefeld ein und wählen Sie Löschen, um die Leitplanke zu löschen.

API

Um eine Leitplanke zu löschen, senden Sie eine DeleteGuardrailAnfrage und geben Sie nur den ARN der Leitplanke in das Feld ein. guardrailIdentifier Geben Sie nicht die an guardrailVersion

Das Anforderungsformat ist wie folgt:

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

Warnung

Wenn Sie eine Leitplanke löschen, werden alle ihre Versionen gelöscht.

Wenn das Löschen erfolgreich ist, gibt die Antwort einen HTTP 200-Statuscode zurück.