Remove a specific list of words and phrases from conversations with word filters

Sign in to the AWS Management Console with an IAM identity that has permissions to use the Amazon Bedrock console. Then, open the Amazon Bedrock console at https://console.aws.amazon.com/bedrock/.

From the left navigation pane, choose Guardrails, and then choose Create guardrail.

For Provide guardrail details page, do the following:

1. In the Guardrail details section, provide a Name and optional Description for the guardrail.

2. For Messaging for blocked prompts, enter a message that displays when your guardrail is applied. Select the Apply the same blocked message for responses checkbox to use the same message when your guardrail is applied on the response.

3. (Optional) To enable cross-Region inference for your guardrail, expand Cross-Region inference, and then select Enable cross-Region inference for your guardrail. Choose a guardrail profile that defines the destination AWS Regions where guardrail inference requests can be routed.

4. (Optional) By default, your guardrail is encrypted with an AWS managed key. To use your own customer-managed KMS key, expand KMS key selection and select the Customize encryption settings (advanced) checkbox.

   You can select an existing AWS KMS key or select Create an AWS KMS key to create a new one.

5. (Optional) To add tags to your guardrail, expand Tags, and then, select Add new tag for each tag you define.

   For more information, see Tagging Amazon Bedrock resources.

6. Choose Next.

On the Add word filters page, do the following:

1. Select Filter profanity to block profanity in prompts and responses. The list of profanity is based on conventional definitions and is continually updated.

2. For Add custom words and phrases, select how to add words and phrases for your guardrail to block. If you upload a file of words, each line in the file should contain one word or a phrase of up to three words. Don't include a header. You have the following options:

   Option	Instructions
   Add words and phrases manually	Directly add words and phrases in the View and edit words and phrases section.
   Upload from a local file	Upload a .txt or .csv file containing the words and phrases by selecting Choose file after selecting this option.
   Upload from Amazon S3 object	Upload an object from an S3 bucket.

3. Edit the words and phrases for the guardrail to block in the View and edit words and phrases section. You have the following options:

   • If you uploaded a word list from a local file or Amazon S3 object, this section will populate with your word list. To filter for items with errors, select Show errors.

   • To add an item to the word list, select Add word or phrase. Enter a word or a phrase of up to three words in the box and press Enter or select the checkmark icon to confirm the item.

   • To edit an item, select the edit icon ( ) next to the item.

   • To delete an item from the word list, select the trash can icon ( ) or, if you're editing an item, select the delete icon ( ) next to the item.

   • To delete items that contain errors, select Delete all and then select Delete all rows with error.

   • To delete all items, select Delete all and then select Delete all rows.

   • To search for an item, enter an expression in the search bar.

   • To show only items with errors, select the dropdown menu labeled Show all and select Show errors only.

   • To configure the size of each page in the table or the column display in the table, select the settings icon ( ). Set your preferences and then select Confirm.

   • By default, this section displays the Table editor. To switch to a text editor in which you can enter a word or phrase in each line, select Text editor. The Text editor provides the following features:

     • You can copy a word list from another text editor and paste it into this editor.

     • A red X icon appears next to items containing errors and a list of errors appears at the below the editor.

4. Choose Next to configure other policies as needed or Skip to Review and create to finish creating your guardrail.

5. Review the settings for your guardrail.

   1. Select Edit in any section you want to make changes to.

   2. When you're done configuring policies, select Create to create the guardrail.