本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 使用单词筛选条件从对话中删除特定的单词和短语
<a name="guardrails-word-filters"></a>

Amazon Bedrock 护栏提供了单词筛选条件，您可以使用这些筛选条件来阻止输入提示和模型响应中的单词和短语（完全匹配）。您可以使用以下单词筛选条件来屏蔽亵渎性内容、冒犯性内容或不当内容，或者提及竞争对手或产品名称的内容。
+ **亵渎性内容筛选条件** – 启用这一功能来屏蔽亵渎性字词。亵渎性内容列表基于常规的亵渎性内容定义制定，并且会不断更新。
+ **自定义单词过滤器**-使用最多三个单词向列表中 AWS 管理控制台 添加自定义单词和短语。您最多可以向自定义单词筛选条件中添加 10,000 个项目。

  您可以通过以下选项，使用 Amazon Bedrock AWS 管理控制台添加单词和短语：
  + 在文本编辑器中手动添加。
  + 上传 .txt 或 .csv 文件。
  + 从 Amazon S3 存储桶上传对象。
**注意**  
您只能使用上传文档和对象 AWS 管理控制台。API 和 SDK 操作仅支持文本，不支持上传文档和对象。

## 为护栏配置单词策略
<a name="guardrails-word-policy-configure"></a>

您可以使用或 AWS 管理控制台 Amazon Bedrock API 为护栏配置文字政策。

------
#### [ Console ]

1. 使用有权使用 Amazon Bedrock 控制台的 IAM 身份登录。 AWS 管理控制台 然后，在 [https://console.aws.amazon.com/](https://console.aws.amazon.com/bedrock)bedrock 上打开 Amazon Bedrock 控制台。

1. 从左侧导航栏中，选择**护栏**，然后选择**创建护栏**。

1. 对于**提供护栏详细信息**页面，执行以下操作：

   1. 在**护栏详细信息**部分，提供护栏的**名称**和（可选的）**描述**。

   1. 对于**针对阻止的提示显示的消息**，输入一条将在应用护栏时显示的消息。选中**对回应应用相同的阻止消息**复选框，以便在对响应应用您的护栏时使用相同的消息。

   1. （可选）要为护栏启用[跨区域推理](guardrails-cross-region.md)，请展开**跨区域推理**，然后选择**为护栏启用跨区域推理**。选择一个护栏配置文件，该配置文件定义了 AWS 区域 可以路由护栏推理请求的目的地。

   1. （可选）默认情况下，您的护栏使用加密。 AWS 托管式密钥要使用您自己的客户自主管理型 KMS 密钥，请展开 **KMS 密钥选择**，然后选中**自定义加密设置（高级）**复选框。

      您可以选择现有 AWS KMS 密钥或选择**创建 AWS KMS 密钥**来创建新密钥。

   1. （可选）要向护栏添加标签，请展开**标签**，然后为您定义的每个标签选择**添加新标签**。

      有关更多信息，请参阅 [标记 Amazon Bedrock 资源](tagging.md)。

   1. 选择**下一步**。

1. 在**添加单词筛选条件**页面上，执行以下操作：

   1. 选择**筛选不雅词**以阻止提示和响应中的不雅词。亵渎性内容清单是基于传统定义制定的，并且会不断更新。

   1. 对于**添加自定义单词和短语**，选择如何为护栏添加要阻止的单词和短语。如果上传单词文件，则文件中的每一行应包含一个单词或一个由最多三个单词组成的短语。不要添加标题。您有以下选项：  
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/bedrock/latest/userguide/guardrails-word-filters.html)

   1. 在**查看和编辑单词与短语**部分，编辑护栏要阻止的单词和短语。您有以下选项：
      + 如果您从本地文件或 Amazon S3 对象上传了单词列表，则此部分将填充您的单词列表。要筛选有错误的项目，请选择**显示错误**。
      + 要向单词列表中添加项目，请选择**添加单词或短语**。在框中输入一个单词或最多包含三个单词的短语，然后按 **Enter** 键或选中复选标记图标以确认该项目。
      + 要编辑项目，请选择该项目旁边的“编辑”图标（![\[Edit icon represented by a pencil symbol.\]](http://docs.aws.amazon.com/zh_cn/bedrock/latest/userguide/images/icons/edit.png)）。
      + 要从单词列表中删除项目，请选择“垃圾桶”图标（![\[Trapezoid-shaped diagram showing data flow from source to destination through AWS Transfer Family.\]](http://docs.aws.amazon.com/zh_cn/bedrock/latest/userguide/images/icons/trash.png)），或者，如果在编辑项目，请选择该项目旁边的“删除”图标（![\[Close or cancel icon represented by an "X" symbol.\]](http://docs.aws.amazon.com/zh_cn/bedrock/latest/userguide/images/icons/close.png)）。
      + 要删除包含错误的项目，请选择**全部删除**，然后选择**删除所有有错误的行**。
      + 要删除所有项目，请选择**全部删除**，然后选择**删除所有行**。
      + 要搜索项目，请在搜索栏中输入表达式。
      + 要仅显示有错误的项目，请选择标有**全部显示**的下拉菜单，然后选择**仅显示错误**。
      + 要配置表格中每页的大小或表格中显示的列，请选择“设置”图标（![\[Gear icon representing settings or configuration options.\]](http://docs.aws.amazon.com/zh_cn/bedrock/latest/userguide/images/icons/settings.png)）。设置您的首选项，然后选择**确认**。
      + 默认情况下，此部分显示**表格**编辑器。要切换到可以在每行中输入单词或短语的文本编辑器，请选择**文本编辑器**。**文本编辑器**提供以下功能：
        + 您可以从其他文本编辑器中复制单词列表并将其粘贴到该编辑器中。
        + 包含错误的项目旁边会出现一个红色 X 图标，错误列表出现在编辑器下方。

   1. 选择**下一步**可根据需要配置其他策略，或者选择**跳至“审查”并创建**以完成护栏的创建。

   1. 查看护栏的设置。

      1. 在要对其进行更改的任何部分，选择**编辑**。

      1. 配置完策略后，选择**创建**以创建护栏。

------
#### [ API ]

要使用文字策略创建护栏，请发送请求。[CreateGuardrail](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_CreateGuardrail.html)请求的格式如下：

```
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"
    }
}
```
+ 在 `name` 和 `description` 字段分别为护栏指定名称和描述。
+ 在 `blockedInputMessaging` 和 `blockedOutputsMessaging` 字段中指定护栏成功阻止提示或模型响应时显示的消息。
+ 在 `wordPolicyConfig` 对象中配置单词策略：
  + 使用 `managedWordListsConfig` 来配置预定义的不雅词列表。
  + 使用 `wordsConfig` 数组来指定要筛选的自定义单词和短语：
    + 在 `text` 字段中指定要筛选的单词和短语。
    + （可选）使用 `inputAction`（在提示中）和 `outputAction`（在响应中）指定检测到该单词时要执行的操作。选择 `BLOCK` 以阻止内容并替换为被阻止时显示的消息，或选择 `NONE`，不执行任何操作而只返回检测信息。
    + （可选）使用 `inputEnabled` 和 `outputEnabled` 控制是否为输入和输出启用护栏评估。
+ （可选）向护栏附加任何标签。有关更多信息，请参阅 [标记 Amazon Bedrock 资源](tagging.md)。
+ （可选）为了安全起见，请在 `kmsKeyId` 字段中包含 KMS 密钥的 ARN。
+ （可选）要启用[跨区域推理](guardrails-cross-region.md)，请在 `crossRegionConfig` 对象中指定护栏配置文件。

响应的格式如下：

```
HTTP/1.1 202
Content-type: application/json

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

------