# 管理自定义词库
WAF预先内置一套不同类别的词库，用于AI应用的文本和图片的基础语义检测，可满足大部分合规需求。针对特殊业务情况，WAF支持上传自定义词库，构建专属关键词库，用于拦截或豁免文本中的关键词，以提高检测效率和准确度，进一步增强大模型防火墙的防护能力。
#### 约束条件
一个企业项目ID下，最多可添加5个词库，单个词库的关键词数量不超过1,000。
#### 添加词库
1. [登录Web应用防火墙控制台](https://console.huaweicloud.com/waf/?locale=zh-cn)。
2. 在控制台左上角，单击![](https://support.huaweicloud.com/usermanual-waf/zh-cn_image_0000002304713360.png)图标，选择区域或项目。
3. (可选) 如果您已开通企业项目，在左侧导航栏上方单击"按企业项目筛选"下拉框，选择您所在的企业项目。完成后，页面将为您展示该企业项目下的相关数据。
4. 在左侧导航栏，选择"对象管理 \> 自定义词库管理"。
5. 在词库列表左上方，单击"添加词库"。
6. 在"添加词库"面板，完成以下参数配置，添加自定义词库。一个企业项目ID下，最多可添加5个词库。 
   表1自定义词库参数说明 
   | 参数     | 参数说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | 取值样例          |
   |:---|:---|:---|
   | 词库名称   | 填写自定义词库的名称。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | 水果            |
   | 词库类别   | 选择自定义词库的类别。 - **违规**：违规类别中的关键词将被视为攻击词汇。输入文本携带该类词汇，则会触发相应防护动作。  - **豁免** ：豁免类别中的关键词将被视为安全词汇。WAF引擎会根据该类词汇，匹配并过滤输入文本中的关键词后，再对剩余文本进行后续大模型检测规则检测，如合规检测和注入检测等。 例如，**豁免关键词**为苹果, 香蕉时，输入文本我喜欢吃苹果和香蕉。 1. WAF引擎执行豁免词汇检测，得到输入文本我喜欢吃和。  2. WAF引擎对我喜欢吃和执行合规检测和注入检测等大模型规则检测。                                                                                                                                                            | 违规            |
   | 关键词    | 填写要加入词库的关键词。 - **填写要求** ： - 关键词只能由字母、汉字、\&符号组成，且不能超过64个字符，多个关键词之间用回车或半角逗号（,）分隔。  - 单个词库的关键词数量不超过1,000。    - **生效规则** ：使用回车或半角逗号（,）分隔时，命中其中一个关键词即可生效；使用\&符号时，需同时满足\&符号连接的关键词才能生效。 例如，关键词为苹果,香蕉,西瓜\&哈密瓜时，输入的文本中： - 存在**苹果**，执行对应处置。  - 存在**西瓜** ，不会执行对应处置，同时存在**西瓜** 和**哈密瓜**，执行对应处置。      | 苹果,香蕉,西瓜\&哈密瓜 |
   | 描述(可选) | 填写该词库的备注信息。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | --            |
      
   完成以上配置后，可在自定义词库列表**查看** 、**修改** 、**删除**已添加的词库。
   添加的词库可应用于[AI安全护栏](https://support.huaweicloud.com/usermanual-waf/waf_07_00015.html)的文本检测、图片检测。