View a markdown version of this page

Amazon Bedrock 政策語法和範例 - AWS Organizations
Amazon Bedrock 政策語法包含下列元素

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

Amazon Bedrock 政策語法和範例

Amazon Bedrock 政策是根據 JSON 規則建構的純文字檔案。Amazon Bedrock 政策的語法遵循所有宣告政策類型的語法。如需詳細資訊，請參閱宣告政策類型的政策語法和繼承。本主題著重於將該一般語法套用至 Amazon Bedrock 政策類型的特定需求。

下列 Amazon Bedrock 政策範例顯示基本 Amazon Bedrock 政策語法：

{
    "bedrock": {
        "guardrail_inference": {
            "us-east-1": {
                "config_1": {
                    "identifier": {
                        "@@assign": "arn:aws:bedrock:us-east-1:123456789012:guardrail/hu1dlsv9wy1d:1"
                    },
                    "selective_content_guarding": {
                        "system": {
                            "@@assign": "selective"
                        },
                        "messages": {
                            "@@assign": "comprehensive"
                        }
                    },
                    "model_enforcement": {
                        "included_models": {
                            "@@assign": ["ALL"]
                        },
                        "excluded_models": {
                            "@@assign": ["amazon.titan-embed-text-v2:0", "cohere.embed-english-v3"]
                        }
                    }
                }
            }
        }
    }
}

Amazon Bedrock 政策語法包含下列元素

"bedrock"

Amazon Bedrock 政策文件的最上層金鑰。

"guardrail_inference"

定義護欄強制執行組態。

<region>

要強制執行政策的區域。例如 "us-east-1"。

"config_1"

護欄設定的組態識別符。

"identifier" (必要)

護欄 ARN，後面接著 :versionGuardrail 版本。

  • 護欄必須由 管理帳戶擁有。您無法從另一個帳戶使用 Guardrail 建立政策。

  • 護欄必須具有 版本，且該版本不能為 DRAFT。若要建立護欄版本，請參閱《Amazon Bedrock 使用者指南》中的建立護欄版本。

  • Guardrail 必須具有資源型政策，允許組織成員呼叫 ApplyGuardrail。

  • Guardrail 必須在指定的區域中建立和使用。

"selective_content_guarding" (選用)

Amazon Bedrock APIs在呼叫者希望護欄處理的輸入中標記特定內容。這些設定可讓強制執行者控制是否遵守發起人所做的內容標記決策。指定時，"messages"需要其中一個 "system"或 。

"system" (選用)

選擇護欄將如何處理系統提示。未指定comprehensive時，預設為 。

  • "comprehensive"：評估所有內容，無論護衛內容標籤為何。

  • "selective"：僅評估防護內容標籤中的內容。未指定標籤時， 不會評估任何內容。

"messages" (選用)

選擇護欄如何處理使用者和助理對話的訊息內容。未指定comprehensive時，預設為 。

  • "comprehensive"：評估所有內容，無論護衛內容標籤為何。

  • "selective"：僅評估防護內容標籤中的內容。未指定標籤時，評估訊息中的所有內容。

"model_enforcement" (選用)

強制執行護欄組態的模型特定資訊。如果不存在，則會在所有模型上強制執行組態。

"included_models" (必要)

要強制執行護欄的模型清單。空白時， 會將強制執行套用至所有模型。也接受關鍵字「ALL」以明確包含所有模型。

"excluded_models" (必要)

要排除護欄強制執行的模型。空白時， 不會將任何模型排除在強制執行之外。如果包含和排除的模型清單中都存在模型，則會排除該模型。