Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Rimuovere un elenco specifico di parole e frasi dalle conversazioni con filtri per parole
Guardrail per Amazon Bedrock dispone di filtri per parole che è possibile utilizzare per bloccare parole e frasi (corrispondenza esatta) nei prompt di input e nelle risposte dei modelli. È possibile utilizzare i seguenti filtri per parole per bloccare contenuti volgari, offensivi o inappropriati o contenuti con nomi di prodotti o concorrenti.
+ **Filtro volgarità**: da attivare per bloccare parole volgari. L’elenco delle volgarità si basa su definizioni convenzionali di volgarità e viene continuamente aggiornato.
+ **Filtro parole personalizzato**: aggiungi parole e frasi personalizzate utilizzando un massimo Console di gestione AWS di tre parole a un elenco. È possibile aggiungere fino a 10.000 voci al filtro per parole personalizzato.
Per aggiungere parole e frasi con Amazon Bedrock Console di gestione AWS sono disponibili le opzioni seguenti:
+ Aggiunta manuale nell’editor di testo.
+ Caricamento di un file .txt o .csv.
+ Caricamento di oggetti da un bucket Amazon S3.
**Nota**
Puoi caricare documenti e oggetti solo utilizzando. Console di gestione AWS Le operazioni dell’API e dell’SDK supportano solo testo e non includono il caricamento di documenti e oggetti.
## Configurare la policy delle parole per il guardrail
Puoi configurare le policy word per il tuo guardrail utilizzando l'API Console di gestione AWS o Amazon Bedrock.
------
#### [ Console ]
1. Accedi a Console di gestione AWS con un'identità IAM che dispone delle autorizzazioni per utilizzare la console Amazon Bedrock. Quindi, apri la console Amazon Bedrock in [https://console.aws.amazon.com/bedrock.](https://console.aws.amazon.com/bedrock)
1. Nel riquadro di navigazione a sinistra, scegli **Guardrail** e poi **Crea guardrail**.
1. 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.
1. Per **Messaggi relativi ai prompt bloccati**, inserisci un messaggio che viene visualizzato quando viene applicato il guardrail. Seleziona la casella di controllo **Applica lo stesso messaggio bloccato per le risposte** per utilizzare lo stesso messaggio quando il guardrail viene applicato alla risposta.
1. (Facoltativo) Per abilitare l’[inferenza interregionale](guardrails-cross-region.md) per il guardrail, espandi **Inferenza interregionale**, quindi seleziona **Abilita inferenza interregionale per il tuo guardrail**. Scegli un profilo guardrail che definisca la destinazione in Regioni AWS cui possono essere instradate le richieste di inferenza del guardrail.
1. (Facoltativo) Per impostazione predefinita, il guardrail è crittografato con un. Chiave gestita da AWS Per utilizzare la tua chiave KMS gestita dal cliente, espandi **Selezione chiave KMS** e seleziona la casella di controllo **Personalizza impostazioni di crittografia (avanzate)**.
È possibile selezionare una AWS KMS chiave esistente o selezionare **Crea una AWS KMS chiave** per crearne una nuova.
1. (Facoltativo) Per aggiungere tag al guardrail, espandi **Tag**, quindi seleziona **Aggiungi nuovo tag** per ogni tag che definisci.
Per ulteriori informazioni, consulta [Assegnazione di tag alle risorse Amazon Bedrock](tagging.md).
1. Scegli **Avanti**.
1. Nella pagina **Aggiungi filtri per parole**, procedi come segue:
1. Seleziona **Filtra volgarità** per bloccare le volgarità nei prompt e nelle risposte. L’elenco delle volgarità si basa su definizioni convenzionali e viene continuamente aggiornato.
1. In **Aggiungi parole e frasi personalizzate**, seleziona come aggiungere parole e frasi che il guardrail deve bloccare. Se carichi un file di parole, 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:
****
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/bedrock/latest/userguide/guardrails-word-filters.html)
1. Modifica le parole e le frasi da bloccare nel guardrail 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 viene compilata con il tuo elenco di parole. Per filtrare le voci con errori, seleziona **Mostra errori**.
+ Per aggiungere una voce all’elenco di parole, seleziona **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 la voce.
+ Per modificare una voce, seleziona l’icona di modifica (![\[Edit icon represented by a pencil symbol.\]](http://docs.aws.amazon.com/it_it/bedrock/latest/userguide/images/icons/edit.png)) accanto alla voce.
+ Per eliminare una voce dall’elenco di parole, seleziona l’icona del cestino (![\[Trapezoid-shaped diagram showing data flow from source to destination through AWS Transfer Family.\]](http://docs.aws.amazon.com/it_it/bedrock/latest/userguide/images/icons/trash.png)) oppure, se stai modificando una voce, seleziona l’icona di eliminazione (![\[Close or cancel icon represented by an "X" symbol.\]](http://docs.aws.amazon.com/it_it/bedrock/latest/userguide/images/icons/close.png)) accanto alla voce.
+ Per eliminare le voci che contengono errori, seleziona **Elimina tutto**, quindi seleziona **Elimina tutte le righe con errore**.
+ Per eliminare le voci che contengono errori, seleziona **Elimina tutto**, quindi seleziona **Elimina tutte le righe con errore**.
+ Per cercare una voce, inserisci un’espressione nella barra di ricerca.
+ Per mostrare solo le voci con errori, seleziona il menu a discesa **Mostra tutto** e seleziona **Mostra solo errori**.
+ Per configurare le dimensioni di ogni pagina della tabella o la visualizzazione delle colonne nella tabella, seleziona l’icona delle impostazioni (![\[Gear icon representing settings or configuration options.\]](http://docs.aws.amazon.com/it_it/bedrock/latest/userguide/images/icons/settings.png)). Imposta le tue preferenze, quindi seleziona **Conferma**.
+ Per impostazione predefinita, questa sezione mostra l’editor di **tabelle**. Per passare a un editor di testo in cui puoi inserire una parola o una frase in ogni riga, seleziona **Editor di testo**. L’**editor di testo** offre le seguenti funzionalità:
+ Puoi 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 alle voci contenenti errori e sotto l’editor viene visualizzato un elenco di errori.
1. Scegli **Avanti** per configurare le altre policy in base alle tue necessità o **Passa a Rivedi e crea** per completare la creazione del guardrail.
1. Rivedi le impostazioni del guardrail.
1. Seleziona **Modifica** in qualsiasi sezione a cui vuoi apportare modifiche.
1. Al termine della configurazione delle policy, seleziona **Crea** per creare il guardrail.
------
#### [ API ]
Per creare un guardrail con policy Word, invia una [CreateGuardrail](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_CreateGuardrail.html)richiesta. Il formato della richiesta è il seguente:
```
POST /guardrails HTTP/1.1
Content-type: application/json
{
"blockedInputMessaging": "string",
"blockedOutputsMessaging": "string",
"wordPolicyConfig": {
"managedWordListsConfig": [
{
"inputAction": "BLOCK | NONE",
"inputEnabled": true,
"outputAction": "BLOCK | NONE",
"outputEnabled": true,
"type": "PROFANITY"
},
],
"wordsConfig": [{
"text": "string",
"inputAction": "BLOCK | NONE",
"inputEnabled": true,
"outputAction": "BLOCK | NONE",
"outputEnabled": true
}]
},
"description": "string",
"kmsKeyId": "string",
"name": "string",
"tags": [{
"key": "string",
"value": "string"
}],
"crossRegionConfig": {
"guardrailProfileIdentifier": "string"
}
}
```
+ Specifica `name` e `description` per il guardrail.
+ Specifica i messaggi che indicano quando il guardrail blocca correttamente un prompt o una risposta del modello nei campi `blockedInputMessaging` e `blockedOutputsMessaging`.
+ Configura le policy delle parole nell’oggetto `wordPolicyConfig`:
+ Utilizza `managedWordListsConfig` per configurare un elenco predefinito di volgarità.
+ Utilizza l’array `wordsConfig` per specificare parole e frasi personalizzate da filtrare:
+ Specifica le parole e le frasi da filtrare nel campo `text`.
+ (Facoltativo) Specifica l’azione da intraprendere quando viene rilevata la parola nei prompt utilizzando `inputAction` o nelle risposte utilizzando `outputAction`. Scegli `BLOCK` per bloccare i contenuti e sostituirli con messaggi bloccati oppure `NONE` per non intraprendere alcuna azione ma restituire informazioni sul rilevamento.
+ (Facoltativo) Utilizza `inputEnabled` e `outputEnabled` per controllare se la valutazione del guardrail è abilitata per input e output.
+ (Facoltativo) Collega eventuali tag al guardrail. Per ulteriori informazioni, consulta [Assegnazione di tag alle risorse Amazon Bedrock](tagging.md).
+ (Facoltativo) Per motivi di sicurezza, includi l’ARN di una chiave KMS nel campo `kmsKeyId`.
+ (Facoltativo) Per abilitare l’[inferenza tra Regioni](guardrails-cross-region.md), specifica un profilo di guardrail nell’oggetto `crossRegionConfig`.
Il formato della risposta è il seguente:
```
HTTP/1.1 202
Content-type: application/json
{
"createdAt": "string",
"guardrailArn": "string",
"guardrailId": "string",
"version": "string"
}
```
------