Gestisci un guardrail

È possibile modificare un guardrail esistente per aggiungere nuove politiche di configurazione o modificare una politica esistente. Quando hai raggiunto una configurazione del guardrail che ti soddisfa, puoi creare una versione statica del guardrail da utilizzare con i tuoi modelli o agenti. Per ulteriori informazioni, consulta Implementa un guardrail Amazon Bedrock.

Visualizza le informazioni sui tuoi guardrail

Console

Per visualizzare le informazioni sui guardrail

1. Accedi a e apri AWS Management Console la console Amazon Bedrock all'indirizzo https://console.aws.amazon.com/bedrock/.

2. Scegli Guardrails dal riquadro di navigazione a sinistra. Quindi, seleziona un guardrail nella sezione Guardrails.

3. La sezione panoramica del guardrail mostra le configurazioni del guardrail che si applicano a tutte le versioni.

4. Per visualizzare ulteriori informazioni sulla bozza di lavoro, seleziona la bozza di lavoro nella sezione Bozza di lavoro.

5. Per visualizzare ulteriori informazioni su una versione specifica del guardrail, selezionate la versione dalla sezione Versioni.

Per ulteriori informazioni sulle versioni Working Draft e Guardrail, consulta. Implementa un guardrail Amazon Bedrock

API

Per ottenere informazioni su un guardrail, invia una GetGuardrailrichiesta e includi l'ID e la versione del guardrail. Se non specifichi una versione, la risposta restituisce i dettagli relativi alla DRAFT versione.

Di seguito è riportato il formato della richiesta:

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

Di seguito è riportato il formato della risposta:

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

Per elencare le informazioni su tutti i tuoi guardrail, invia una ListGuardrailsrichiesta.

Di seguito è riportato il formato della richiesta:

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

• Per elencare la DRAFT versione di tutti i tuoi guardrail, non specificare il guardrailIdentifier campo.

• Per elencare tutte le versioni di un guardrail, specificare l'ARN del guardrail nel campo. guardrailIdentifier

È possibile impostare il numero massimo di risultati da restituire in una risposta nel campo. maxResults Se i risultati sono superiori al numero impostato, la risposta restituisce un nextToken che puoi inviare in un'altra richiesta ListGuardrails per visualizzare il successivo batch di risultati.

Di seguito è riportato il formato della risposta:

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

Modifica un guardrail

Console

Per modificare un guardrail

1. Accedi a e apri AWS Management Console la console Amazon Bedrock all'indirizzo https://console.aws.amazon.com/bedrock/.

2. Scegli Guardrails dal riquadro di navigazione a sinistra. Quindi, seleziona un guardrail nella sezione Guardrails.

3. Per modificare il nome, la descrizione, i tag o le impostazioni di crittografia del modello per il guardrail, seleziona Modifica nella sezione panoramica di Guardrail.

4. Per modificare configurazioni specifiche per il guardrail, seleziona Bozza di lavoro nella sezione Bozza di lavoro.

5. Seleziona Modifica per le sezioni contenenti le impostazioni che desideri modificare.

6. Apporta le modifiche necessarie, quindi seleziona Salva ed esci per implementare le modifiche.

API

Per modificare un guardrail, invia una richiesta. UpdateGuardrail Includi sia i campi che desideri aggiornare sia i campi che desideri mantenere invariati.

Di seguito è riportato il formato della richiesta:

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

Di seguito è riportato il formato della risposta:

HTTP/1.1 202
Content-type: application/json

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

Eliminare un guardrail

È possibile eliminare un guardrail quando non è più necessario utilizzarlo. Assicurati di dissociare il guardrail da tutte le risorse o applicazioni che lo utilizzano prima di eliminare il guardrail per evitare potenziali errori.

Console

Per eliminare un guardrail

1. Accedi a e apri AWS Management Console la console Amazon Bedrock all'indirizzo https://console.aws.amazon.com/bedrock/.

2. Scegli Guardrails dal riquadro di navigazione a sinistra. Quindi, seleziona un guardrail nella sezione Guardrails.

3. Nella sezione Guardrail, selezionate un guardrail che desiderate eliminare, quindi scegliete Elimina.

4. Entra delete nel campo di immissione dell'utente e scegli Elimina per eliminare il guardrail.

API

Per eliminare un guardrail, invia una DeleteGuardrailrichiesta e specifica solo l'ARN del guardrail nel campo. guardrailIdentifier Non specificare il guardrailVersion

Di seguito è riportato il formato della richiesta:

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

avvertimento

Se elimini un guardrail, verranno eliminate tutte le sue versioni.

Se l'eliminazione ha esito positivo, la risposta restituisce un codice di stato HTTP 200.