Eine Version einer Leitplanke erstellen und verwalten

In den folgenden Themen wird erläutert, wie Sie eine Version Ihrer Guardrail erstellen, wenn sie einsatzbereit ist, Informationen dazu anzeigen und sie löschen, wenn Sie sie nicht mehr benötigen.

Anmerkung

Guardrail-Versionen gelten nicht als Ressourcen und haben daher keinen ARN. IAM-Richtlinien, die für eine Guardrail gelten, gelten für alle ihre Versionen.

Erstellen Sie eine Version einer Amazon Bedrock-Leitplanke

Um zu erfahren, wie Sie eine Version einer Leitplanke erstellen, wählen Sie die Registerkarte aus, die der Methode Ihrer Wahl entspricht, und folgen Sie den Schritten.

Console

Um eine Version zu erstellen

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 der Amazon Bedrock-Konsole Guardrails aus und wählen Sie im Abschnitt Guardrails den Namen der Guardrails aus, die Sie bearbeiten möchten.

3. Führen Sie einen der folgenden Schritte aus.

   • Wählen Sie im Abschnitt Versionen die Option Erstellen aus.

   • Wählen Sie den Arbeitsentwurf aus und klicken Sie oben auf der Seite auf Version erstellen

4. Geben Sie optional eine Beschreibung für die Version ein und wählen Sie dann Version erstellen aus.

5. Wenn dies erfolgreich ist, werden Sie zu dem Bildschirm mit einer Liste von Versionen weitergeleitet, zu der Ihre neue Version hinzugefügt wurde.

API

Um eine Version Ihrer Leitplanke zu erstellen, senden Sie eine CreateGuardrailVersionAnfrage. Geben Sie die ID und eine optionale Beschreibung an.

Das Anforderungsformat lautet wie folgt:

POST /guardrails/guardrailIdentifier HTTP/1.1
Content-type: application/json


{
  "clientRequestToken": "string",
  "description": "string"
}

Das Antwortformat lautet wie folgt:

HTTP/1.1 202
Content-type: application/json

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

Informationen zu Amazon Bedrock Guardrail-Versionen anzeigen

Um zu erfahren, wie Sie Informationen zu einer oder mehreren Versionen einer Leitplanke anzeigen können, wählen Sie die Registerkarte aus, die der Methode Ihrer Wahl entspricht, und folgen Sie den Schritten.

Console

Um Informationen zu den Versionen Ihrer Leitplanken anzuzeigen

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 Versionen eine Version aus, um Informationen dazu anzuzeigen.

API

Um Informationen zu einer Leitplankenversion zu erhalten, senden Sie eine GetGuardrailAnfrage und geben Sie die ID und Version der Leitplanke an. Wenn Sie keine Version angeben, werden in der Antwort Details für die 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": [ 
         { 
            "inputStrength": "NONE | LOW | MEDIUM | HIGH",
            "outputStrength": "NONE | LOW | MEDIUM | HIGH",
            "type": "SEXUAL | VIOLENCE | HATE | INSULTS | MISCONDUCT | PROMPT_ATTACK"
         }
      ]
   },
    "wordPolicy": {
    "words": [
      {
        "text": "string"
      }
    ],
    "managedWordLists": [
      {
        "type": "string"
      }
    ]
  },
  "sensitiveInformationPolicy": {
    "piiEntities": [
      {
        "type": "string",
        "action": "string"
      }
    ],
    "regexes": [
      {
        "name": "string",
        "description": "string",
        "pattern": "string",
        "action": "string"
      }
    ]
  },
   "createdAt": "string",
   "description": "string",
   "failureRecommendations": [ "string" ],
   "guardrailArn": "string",
   "guardrailId": "string",
   "kmsKeyArn": "string",
   "name": "string",
   "status": "string",
   "statusReasons": [ "string" ],
   "topicPolicy": { 
      "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"
}

Löschen Sie eine Version einer Amazon Bedrock-Leitplanke

Um zu erfahren, wie Sie eine Version einer Leitplanke löschen, wählen Sie die Registerkarte aus, die der Methode Ihrer Wahl entspricht, und folgen Sie den Schritten.

Console

Wenn Sie eine Version nicht mehr benötigen, können Sie sie mit den folgenden Schritten löschen.

Löschen einer Version

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 Versionen die Version aus, die Sie löschen möchten, und wählen Sie Löschen.

4. Es erscheint ein Fenster, das Sie vor Ressourcen warnt, die von dieser Version der Leitplanke abhängig sind. Trennen Sie die Version vor dem Löschen von den Ressourcen, um Fehler zu vermeiden.

5. Geben Sie den delete Text in das Benutzereingabefeld ein und wählen Sie Löschen, um die Guardrail-Version zu löschen.

API

Um eine Version einer Leitplanke zu löschen, senden Sie eine Anfrage. DeleteGuardrail Geben Sie den ARN der Leitplanke im guardrailIdentifier Feld und die Version im guardrailVersion Feld an.

Das Anforderungsformat ist wie folgt:

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

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