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 뒤에 Guardrail 버전:version인가 옵니다.

  • 가드레일은 관리 계정이 소유해야 합니다. 다른 계정의 가드레일을 사용하여 정책을 생성할 수 없습니다.

  • 가드레일에는 버전이 있어야 하며 해당 버전은 초안일 수 없습니다. 가드레일 버전을 생성하려면 Amazon Bedrock 사용 설명서의 가드레일 버전 생성을 참조하세요.

  • 가드레일에는 조직 구성원이를 호출할 수 있도록 허용하는 리소스 기반 정책이 있어야 합니다ApplyGuardrail.

  • 지정된 리전에서 가드레일을 생성하고 사용해야 합니다.

"selective_content_guarding" (선택 사항)

Amazon Bedrock APIs 사용하면 호출자가 가드레일을 처리하려는 입력 내에서 특정 콘텐츠를 표시할 수 있습니다. 이러한 설정을 통해 시행자는 호출자가 내린 콘텐츠 태그 지정 결정을 준수할지 여부를 제어할 수 있습니다. 지정된 경우 "system" 또는 중 하나가 "messages" 필요합니다.

"system" (선택 사항)

가드레일에서 시스템 프롬프트를 처리하는 방법을 선택합니다. 지정comprehensive하지 않으면 기본값은 입니다.

  • "comprehensive": 가드 콘텐츠 태그에 관계없이 모든 콘텐츠를 평가합니다.

  • "selective": 가드 콘텐츠 태그 내의 콘텐츠만 평가합니다. 태그가 지정되지 않은 경우 콘텐츠를 평가하지 않습니다.

"messages" (선택 사항)

가드레일에서 사용자 및 어시스턴트 대화가 포함된 메시지 콘텐츠를 처리하는 방법을 선택합니다. 지정comprehensive하지 않으면 기본값은 입니다.

  • "comprehensive": 가드 콘텐츠 태그에 관계없이 모든 콘텐츠를 평가합니다.

  • "selective": 가드 콘텐츠 태그 내의 콘텐츠만 평가합니다. 태그가 지정되지 않은 경우 메시지 내의 모든 콘텐츠를 평가합니다.

"model_enforcement" (선택 사항)

적용 가드레일 구성에 대한 모델별 정보입니다. 없는 경우 구성은 모든 모델에 적용됩니다.

"included_models"(필수)

가드레일을 적용할 모델 목록입니다. 비어 있는 경우는 모든 모델에 적용을 적용합니다. 또한 키워드 “ALL”을 수락하여 모든 모델을 명시적으로 포함합니다.

"excluded_models"(필수)

가드레일 적용에서 제외할 모델입니다. 비어 있는 경우는 적용에서 모델을 제외하지 않습니다. 포함된 모델 목록과 제외된 모델 목록에 모두 모델이 있는 경우 해당 모델은 제외됩니다.