

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

# 用标签标记用户输入以筛选内容
<a name="guardrails-tagging"></a>

输入标签让您能够在输入文本中标记出需要由护栏处理的特定内容。当您想对输入的某些部分应用护栏而不处理其他部分时，输入标签非常有用。

例如，RAG 应用程序中的输入提示可能包含系统提示、来自可信文档来源的搜索结果和用户查询。由于系统提示由开发人员提供，并且搜索结果来自可信来源，因此您可能只需要对用户查询进行护栏评估。

再比如，对话应用程序中的输入提示可能包含系统提示、对话历史记录和当前用户输入。系统提示是开发人员设定的指令，对话历史记录包含历史用户输入和模型响应，这些内容可能已经过护栏评估。在这种情况下，您可能只需要评估当前用户输入。

通过使用输入标签，您可以更好地控制输入提示的哪些部分应由护栏处理和评估，从而确保根据您的应用场景定制保护措施。这还有助于提高性能和降低成本，因为您可以灵活地评估输入中相对较短且相关的部分，而不是整个输入提示。

**标记内容以供护栏处理**

要标记内容以供护栏处理，请使用包含一个预留前缀和一个自定义 `tagSuffix` 的 XML 标签。例如：

```
{
    "text": """
        You are a helpful assistant.
        Here is some information about my account:
          - There are 10,543 objects in an S3 bucket.
          - There are no active EC2 instances.
        Based on the above, answer the following question:
        Question: 
        <amazon-bedrock-guardrails-guardContent_xyz>
        How many objects do I have in my S3 bucket? 
        </amazon-bedrock-guardrails-guardContent_xyz>
         ...
        Here are other user queries:
        <amazon-bedrock-guardrails-guardContent_xyz>
        How do I download files from my S3 bucket?
        </amazon-bedrock-guardrails-guardContent_xyz>    
    """,
    "amazon-bedrock-guardrailConfig": {
        "tagSuffix": "xyz"
    }
}
```

在前面的示例中，内容 *`How many objects do I have in my S3 bucket?`* 和 "*How do I download files from my S3 bucket?*" 经过标记（使用标签 `<amazon-bedrock-guardrails-guardContent_xyz>`），以供护栏处理。请注意，前缀 `amazon-bedrock-guardrails-guardContent` 是护栏预留的。

**标签后缀**

标签后缀（前面的示例中的 `xyz`）是一个动态值，您必须在 `amazon-bedrock-guardrailConfig` 的 `tagSuffix` 字段中提供该值才能使用输入标签。建议每次请求使用新的随机字符串作为 `tagSuffix`。通过使标签结构不可预测，这有助于缓解潜在的提示注入攻击。静态标签可导致恶意用户关闭 XML 标签并在标签关闭后附加恶意内容，从而导致*注入攻击*。您只能使用字母数字字符，长度为 1 到 20 个字符（含）。使用示例后缀`xyz`，您必须使用带有后缀的 XML 标签来封装所有要保护的内容：。`<amazon-bedrock-guardrails-guardContent_xyz>` *your content* `</amazon-bedrock-guardrails-guardContent_xyz>`建议对每个请求使用动态唯一标识符作为标签后缀。

**多个标签**

您可以在输入文本中多次使用相同的标签结构来标记内容的不同部分，以供护栏处理。标签不能相互嵌套。

**未被标记的内容**

输入标签之外的任何内容不会被护栏处理。这让您能够添加指令、示例对话、知识库或您认为安全且不想被护栏处理的其他内容。如果输入提示中没有标签，护栏会处理整个提示。唯一的例外是 [使用 Amazon Bedrock 护栏检测提示攻击](guardrails-prompt-attack.md) 筛选条件，它要求输入中必须包含标签。