將標籤套用至使用者輸入以篩選內容

輸入標籤可讓您在您要由護欄處理的輸入文字中標記特定內容。當您想要將護欄套用至輸入的特定部分，同時讓其他部分保持未處理時，這非常有用。

例如，RAG 應用程式中的輸入提示可能包含系統提示、信任文件來源的搜尋結果，以及使用者查詢。由於系統提示是由開發人員提供，且搜尋結果來自信任的來源，您可能只需要在使用者查詢上進行護欄評估。

在另一個範例中，對話應用程式中的輸入提示可能包含系統提示、對話歷史記錄和目前的使用者輸入。系統提示是開發人員特定的說明，對話歷史記錄包含可能已由護欄評估的歷史使用者輸入和模型回應。對於這種情況，您可能只想要評估目前的使用者輸入。

透過使用輸入標籤，您可以更好地控制應由護欄處理和評估輸入提示的哪些部分，確保您的保護措施根據您的使用案例進行自訂。這也有助於改善效能和降低成本，因為您具有彈性來評估相對較短且相關的輸入區段，而不是整個輸入提示。

護欄的標籤內容

若要標記要處理的護欄內容，請使用 XML 標籤，這是預留字首和自訂 的組合tagSuffix。例如：

{
    "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"
    }
}

在上述範例中，內容 `我的 S3 儲存貯體中有多少物件？` 和 ""如何從 S3 儲存貯體下載檔案？" 已使用標籤 進行護欄處理<amazon-bedrock-guardrails-guardContent_xyz>。請注意，字首是由護欄amazon-bedrock-guardrails-guardContent保留。

標籤尾碼

標籤尾碼 (xyz在上述範例中） 是您必須在 的 tagSuffix 欄位中提供的動態值amazon-bedrock-guardrailConfig，才能使用輸入標記。建議tagSuffix針對每個請求使用新的隨機字串做為 。這有助於透過使標籤結構無法預測來緩解潛在的提示注入攻擊。靜態標籤可能會導致惡意使用者關閉 XML 標籤，並在標籤關閉後附加惡意內容，進而導致注入攻擊。您僅限於英數字元，長度介於 1 到 20 個字元之間。使用範例尾碼 時xyz，您必須使用 XML 標籤搭配尾碼：<amazon-bedrock-guardrails-guardContent_xyz>. 和您的內容 來括住要保護的所有內容</amazon-bedrock-guardrails-guardContent_xyz>。我們建議您為每個請求使用動態唯一識別符做為標籤尾碼。

多個標籤

您可以在輸入文字中使用相同的標籤結構多次，以標記內容的不同部分，以進行護欄處理。不允許巢狀化標籤。

未標記的內容

輸入標籤以外的任何內容都不會由護欄處理。這可讓您包含指示、範例對話、知識庫，或您認為安全且不想由護欄處理的其他內容。如果輸入提示中沒有標籤，則護欄會處理完整的提示。唯一的例外是需要輸入標籤存在的提示攻擊篩選條件。

您可以依照下列步驟，在護欄的測試窗格中嘗試輸入標記：

VIOLENT STATEMENT: I think I could fight a grizzly bear. 

<amazon-bedrock-guardrails-guardContent_playground>

BENIGN INPUT: How's the weather? 

</amazon-bedrock-guardrails-guardContent_playground>
            

您的護欄只會在輸入標籤之間的內容上執行。