Crea un guardrail

Puoi creare un guardrail impostando le configurazioni, definendo argomenti da negare, fornendo filtri per gestire contenuti dannosi e sensibili e scrivendo messaggi per quando le richieste e le risposte degli utenti sono bloccate.

Un guardrail deve contenere almeno un filtro e un messaggio per quando i prompt e le risposte degli utenti sono bloccati. Puoi scegliere di utilizzare la messaggistica predefinita. Puoi aggiungere filtri ed eseguire iterazioni sul guardrail in un secondo momento seguendo i passaggi indicati Modifica un guardrail per configurare tutti i componenti necessari per il guardrail.

Seleziona la scheda corrispondente al metodo scelto e segui i passaggi.

Console

Per creare un guardrail

Accedi a e apri AWS Management Console la console Amazon Bedrock all'indirizzo https://console.aws.amazon.com/bedrock/.
Dal riquadro di navigazione a sinistra, scegli Guardrails.
Nella sezione Guardrails, scegli Crea guardrail.
Nella pagina Fornisci i dettagli del guardrail, procedi come segue:
1. Nella sezione Dettagli del guardrail, fornisci un nome e una descrizione facoltativa per il guardrail.
2. (Facoltativo) Per impostazione predefinita, il guardrail è crittografato con un. Chiave gestita da AWS Per utilizzare la tua chiave KMS gestita dal cliente, seleziona la freccia destra accanto alla selezione della chiave KMS e seleziona la casella di controllo Personalizza le impostazioni di crittografia (avanzate). Puoi scegliere una AWS KMS chiave esistente o selezionare Crea una chiave per crearne una AWS KMS nuova.
3. (Facoltativo) Per aggiungere tag al guardrail, seleziona la freccia destra accanto a Tag. Quindi, scegli Aggiungi nuovo tag e definisci le coppie chiave-valore per i tuoi tag. Per ulteriori informazioni, consulta la pagina Aggiunta di tag alle risorse .
4. Seleziona Next (Successivo).
Nota
È necessario configurare almeno un filtro per creare un guardrail. Puoi quindi scegliere Vai alla revisione e crea per saltare la creazione di altri filtri.
(Facoltativo) Nella pagina Configura i filtri dei contenuti, imposta la forza con cui desideri filtrare i contenuti correlati alle categorie definite in Filtri di contenuto procedendo come segue:
1. Per configurare i filtri per i prompt su un modello, seleziona Abilita i filtri per i prompt nella sezione Filtra i prompt per i prompt del modello. Configura quanto rigoroso vuoi che ogni filtro sia per i prompt che l'utente fornisce al modello.
2. Per configurare i filtri per le risposte del modello, seleziona Abilita i filtri per le risposte in Filtra i punti di forza per le risposte. Configura quanto rigoroso vuoi che ogni filtro sia per le risposte restituite dal modello.
3. Seleziona Successivo.
(Facoltativo) Nella pagina Aggiungi argomenti negati, procedi come segue:
1. Per definire un argomento da bloccare, scegli Aggiungi argomento negato. Quindi, esegui queste operazioni:
  1. Immetti un nome per l'argomento.
  2. Nella casella Definizione per argomento, definisci l'argomento. Per linee guida su come definire un argomento negato, consultaArgomenti negati.
  3. (Facoltativo) Per aggiungere richieste di input rappresentative o risposte modello relative a questo argomento, seleziona la freccia destra accanto a Aggiungi frasi di esempio. Immettete una frase nella casella. Per aggiungere un'altra frase, scegli Aggiungi frase.
  4. Quando hai finito di configurare l'argomento negato, scegli Conferma.
2. Puoi eseguire le seguenti azioni con gli argomenti Negati.
  - Per aggiungere un altro argomento, scegli Aggiungi argomento negato.
  - Per modificare un argomento, scegli l'icona con i tre puntini nella stessa riga dell'argomento nella colonna Azioni. Quindi scegliere Edit (Modifica). Dopo aver terminato la modifica, scegli Conferma.
  - Per eliminare uno o più argomenti, seleziona le caselle di controllo relative agli argomenti da eliminare. Scegli Elimina, quindi seleziona Elimina selezionato.
  - Per eliminare tutti gli argomenti, scegli Elimina, quindi seleziona Elimina tutto.
  - Per configurare le dimensioni di ogni pagina della tabella o la visualizzazione delle colonne nella tabella, scegli l'icona delle impostazioni ( ). Imposta le tue preferenze, quindi scegli Conferma.
3. Al termine della configurazione degli argomenti negati, seleziona Avanti.

(Facoltativo) Nella pagina Aggiungi filtri di parole, procedi come segue:

Nella sezione Filtra parolacce, seleziona Filtra parolacce per bloccare le parolacce nei prompt e nelle risposte. L'elenco delle parolacce si basa su definizioni convenzionali e viene continuamente aggiornato.

Nella sezione Aggiungi parole e frasi personalizzate, seleziona come aggiungere parole e frasi da bloccare nel guardrail. Se scegli di caricare un file, ogni riga del file deve contenere una parola o una frase composta da un massimo di tre parole. Non includere un'intestazione. Sono disponibili le seguenti opzioni:

Opzione	Istruzioni
Aggiungi parole e frasi manualmente	Aggiungi direttamente parole e frasi nella sezione Visualizza e modifica parole e frasi.
Carica da un file locale	Per caricare un file.txt o .csv contenente le parole e le frasi, scegli Scegli file dopo aver selezionato questa opzione.
Caricamento da un oggetto Amazon S3	Per caricare un file da Amazon S3, specifica l'oggetto S3 dopo aver selezionato questa opzione. Ogni riga del file deve contenere una parola o una frase composta da un massimo di tre parole.

Puoi modificare le parole e le frasi che il guardrail deve bloccare nella sezione Visualizza e modifica parole e frasi. Sono disponibili le seguenti opzioni:
- Se hai caricato un elenco di parole da un file locale o da un oggetto Amazon S3, questa sezione verrà compilata con il tuo elenco di parole. Per filtrare gli elementi con errori, scegli Mostra errori.
- Per aggiungere un elemento all'elenco di parole, scegli Aggiungi parola o frase. Inserisci una parola o una frase composta da un massimo di tre parole nella casella e premi Invio o seleziona l'icona del segno di spunta per confermare l'elemento.
- Per modificare un elemento, scegli l'icona di modifica ( ) accanto all'elemento.
- Per eliminare un elemento dall'elenco di parole, scegli l'icona del cestino ( ) oppure, se stai modificando un elemento, scegli l'icona di eliminazione ( ) accanto all'elemento.
- Per eliminare gli elementi che contengono errori, scegli Elimina tutto, quindi seleziona Elimina tutte le righe con errore
- Per eliminare tutti gli elementi, scegli Elimina tutto, quindi seleziona Elimina tutte le righe
- Per cercare un elemento, inserisci un'espressione nella barra di ricerca.
- Per mostrare solo gli elementi con errori, scegli il menu a discesa denominato Mostra tutto e seleziona Mostra solo errori.
- Per configurare le dimensioni di ogni pagina della tabella o la visualizzazione delle colonne nella tabella, scegli l'icona delle impostazioni () . Imposta le tue preferenze, quindi scegli Conferma.
- Per impostazione predefinita, questa sezione mostra l'editor di tabelle. Per passare a un editor di testo in cui è possibile inserire una parola o una frase in ogni riga, seleziona Editor di testo. L'editor di testo offre le seguenti funzionalità:
  - È possibile copiare un elenco di parole da un altro editor di testo e incollarlo in questo editor.
  - Un'icona a forma di X rossa appare accanto agli elementi contenenti errori e un elenco di errori appare sotto l'editor.

(Facoltativo) Nella pagina Aggiungi filtri per informazioni sensibili, configura i filtri per bloccare o mascherare le informazioni sensibili. Per ulteriori informazioni, consulta Filtri per informazioni sensibili. Esegui questa operazione:

Nella sezione Tipi di PII, configura le categorie di informazioni di identificazione personale (PII) da bloccare o mascherare. Sono disponibili le seguenti opzioni:
- Per aggiungere un tipo di PII, scegli Aggiungi un tipo di PII. Successivamente, esegui queste operazioni:
  1. Nella colonna Tipo, seleziona un tipo di PII.
  2. Nella colonna Comportamento di Guardrail, seleziona se il guardrail deve bloccare il contenuto contenente il tipo PII o mascherarlo con un identificatore.
- Per aggiungere tutti i tipi di PII, scegli la freccia a discesa accanto a Aggiungi un tipo di PII. Quindi seleziona il comportamento del guardrail da applicare a loro.
  
  avvertimento
  Se specificate un comportamento, qualsiasi comportamento esistente configurato per i tipi di PII verrà sovrascritto.
- Per eliminare un tipo di PII, scegliete l'icona del cestino ().
- Per eliminare le righe che contengono errori, scegli Elimina tutto, quindi seleziona Elimina tutte le righe con errore
- Per eliminare tutti i tipi di PII, scegli Elimina tutto, quindi seleziona Elimina tutte le righe
- Per cercare una riga, inserisci un'espressione nella barra di ricerca.
- Per mostrare solo le righe con errori, scegli il menu a discesa denominato Mostra tutto e seleziona Mostra solo errori.
- Per configurare le dimensioni di ogni pagina della tabella o la visualizzazione delle colonne nella tabella, scegli l'icona delle impostazioni () . Imposta le tue preferenze, quindi scegli Conferma.

Nella sezione Regex patterns, usa le espressioni regolari per definire i pattern da filtrare nel guardrail. Sono disponibili le seguenti opzioni:

Per aggiungere un pattern, scegli Aggiungi pattern regex. Configura i campi seguenti:

Campo	Descrizione
Nome	Un nome per il pattern
Schema Regex	Un'espressione regolare che definisce il modello
Comportamento dei guardrail	Scegliete se bloccare il contenuto contenente il pattern o mascherarlo con un identificatore. Per mascherare il pattern solo nei log, scegli Nessuno.
Aggiungi descrizione	(Facoltativo) Scrivi una descrizione per il modello

Per modificare un motivo, scegli l'icona a tre punti nella stessa riga dell'argomento nella colonna Azioni. Quindi scegliere Edit (Modifica). Dopo aver terminato la modifica, scegli Conferma.
Per eliminare uno o più motivi, seleziona le caselle di controllo relative ai motivi da eliminare. Scegli Elimina, quindi seleziona Elimina selezionato.
Per eliminare tutti i pattern, scegli Elimina, quindi seleziona Elimina tutto.
Per cercare un pattern, inserisci un'espressione nella barra di ricerca.
Per configurare le dimensioni di ogni pagina della tabella o la visualizzazione delle colonne nella tabella, scegliete l'icona delle impostazioni ( ). Imposta le tue preferenze, quindi scegli Conferma.

Al termine della configurazione dei filtri per le informazioni sensibili, scegli Avanti.

Nella pagina Definisci messaggi bloccati, imposta i messaggi che desideri restituire all'utente quando il guardrail rileva e blocca il contenuto. Esegui questa operazione:
1. Nel campo Messaggi visualizzati per i prompt bloccati della sezione Messaggi bloccati, inserisci il messaggio da visualizzare se il guardrail blocca un prompt inviato al modello.
2. Nel campo Messaggi visualizzati per le risposte bloccate della sezione Messaggi bloccati, immettete il messaggio da visualizzare se il guardrail blocca una risposta generata dal modello.
3. Seleziona Successivo.
Rivedi e crea: rivedi le impostazioni del tuo guardrail.
1. Scegli Modifica in qualsiasi sezione a cui desideri apportare modifiche.
2. Quando sei soddisfatto delle impostazioni del tuo guardrail, seleziona Crea per creare il guardrail.

API

Per creare un guardrail, invia una richiesta. CreateGuardrail Il formato della richiesta è il seguente:


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

Specificare una name e description per il guardrail.
Specificate i messaggi che indicano quando il guardrail blocca correttamente un prompt o una risposta del modello nei campi and. blockedInputMessaging blockedOutputsMessaging
Specificate gli argomenti che il guardrail deve negare nell'oggetto. topicPolicy Ogni elemento dell'topicselenco riguarda un argomento. Per ulteriori informazioni sui campi di un argomento, vedere Argomento.
- Dai un name e description in modo che il guardrail possa identificare correttamente l'argomento.
- Specificare DENY nel action campo.
- (Facoltativo) Fornisci fino a cinque esempi da classificare come appartenenti all'argomento nell'exampleselenco.
Specificate i livelli di filtraggio per le categorie dannose definite in Amazon Bedrock nell'contentPolicyoggetto. Ogni elemento dell'filterselenco appartiene a una categoria dannosa. Per ulteriori informazioni, consulta Filtri di contenuto. Per ulteriori informazioni sui campi di un filtro di contenuti, consulta ContentFilter.
- Specificare la categoria nel type campo.
- Specificate l'intensità del filtro per i prompt nel strength campo del textToTextFiltersForPrompt campo e per le risposte del modello nel strength campo di. textToTextFiltersForResponse
(Facoltativo) Attacca qualsiasi tag al guardrail. Per ulteriori informazioni, consulta Aggiunta di tag alle risorse .
(Facoltativo) Per motivi di sicurezza, includi l'ARN di una chiave KMS nel campo. kmsKeyId

Il formato di risposta è il seguente:


HTTP/1.1 202
Content-type: application/json

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

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

Prerequisiti

Prova un guardrail

Crea un guardrail

Per creare un guardrail

Nota

avvertimento