本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
Guardrails 是用來為生成式 AI 應用程式實作保護措施，這些應用程式是針對您的使用案例自訂的，並與您的負責 AI 政策保持一致。護欄可讓您設定拒絕的主題、篩選有害內容，以及移除敏感資訊。
您可以使用 ApplyGuardrail API，使用預先設定的 Amazon Bedrock Guardrails 來評估任何文字，而無需叫用基礎模型。
ApplyGuardrail API 的功能：
-
內容驗證 – 您可以將任何文字輸入或輸出傳送至
ApplyGuardrailAPI，以與定義的主題迴避規則、內容篩選條件、PII 偵測器和字詞區塊清單進行比較。您可以獨立評估使用者輸入和 FM 產生的輸出。 -
彈性部署 – 您可以在應用程式流程中的任意位置整合
ApplyGuardrailAPI，以在處理或提供結果給使用者之前驗證資料。例如，如果您使用的是 RAG 應用程式，您現在可以在執行擷取之前評估使用者輸入，而不是等到產生最終回應。 -
從 FMs 解耦。–
ApplyGuardrailAPI 會從基礎模型解耦。您現在可以使用 Guardrail，而無需叫用 Foundation Models。您可以使用評估結果來設計生成式 AI 應用程式的體驗。
在您的應用程式流程中呼叫 ApplyGuardrail API
請求可讓客戶傳遞應使用其定義的護欄保護的所有內容。當要評估的內容來自使用者時，來源欄位應設定為「INPUT」，通常是 LLM 提示。當模型輸出護欄應強制執行時，來源應設定為「OUTPUT」，通常是 LLM 回應。
主題
設定護欄以搭配 ApplyGuardrail API 使用
您可以在guardrailConfig輸入參數中指定護欄的組態資訊。組態包含 ID 和您要使用的護欄版本。您也可以啟用護欄的追蹤，提供護欄封鎖內容的相關資訊。
POST /guardrail/{guardrailIdentifier}/version/{guardrailVersion}/apply HTTP/1.1
{
"source": "INPUT" | "OUTPUT",
"content": [
{
"text": {
"text": "string",
}
},
]
}
ApplyGuardrail API 使用案例範例
ApplyGuardrail 請求的輸出取決於對傳遞內容採取的動作護欄。
-
如果護欄介入只遮罩內容的位置，則會傳回套用遮罩的確切內容。
-
如果護欄介入並封鎖請求內容，輸出欄位將是單一文字，這是根據護欄組態的固定訊息。
-
如果請求內容未採取任何護欄動作，輸出陣列會是空的。
請求範例
{
"source": "OUTPUT",
"content": [
"text": {
"text": "Hi, my name is Zaid. Which car brand is reliable?",
}
]
}
如果護欄未介入，則回應
{
"usage": {
"topicPolicyUnitsProcessed": 1,
"contentPolicyUnitsProcessed": 1,
"wordPolicyUnitsProcessed": 0,
"sensitiveInformationPolicyFreeUnits": 0
},
"action": "NONE",
"outputs": [],
"assessments": [{}]
}
