기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

애플리케이션에 자동 추론 정책 배포

자동 추론 정책을 테스트하고 성능에 만족하면 Amazon Bedrock Guardrails에서 애플리케이션에 사용할 수 있도록 배포할 수 있습니다. 이 페이지에서는 변경 불가능한 버전 저장, 가드레일에 연결,를 사용한 배포 자동화 CloudFormation, CI/CD 파이프라인에 통합 등 전체 배포 워크플로를 다룹니다.

자동 추론 정책 버전 저장

정책 테스트를 마치면 변경할 수 없는 버전을 생성합니다. 변경 불가능한 버전은 초안을 계속 편집할 때 가드레일에 연결된 정책이 예기치 않게 변경되지 않도록 합니다. 각 버전은 숫자 버전 번호(1, 2, 3, ...)로 식별되며 생성 후에는 수정할 수 없습니다.

콘솔 사용

API 사용

CreateAutomatedReasoningPolicyVersion API를 사용하여 변경 불가능한 버전의 자동 추론 정책을 생성합니다.

요청 파라미터

예제

# Get the current definition hash
aws bedrock get-automated-reasoning-policy \
  --policy-arn "arn:aws:bedrock:us-east-1:111122223333:automated-reasoning-policy/lnq5hhz70wgk" \
  --query "definitionHash" --output text

# Create the version
aws bedrock create-automated-reasoning-policy-version \
  --policy-arn "arn:aws:bedrock:us-east-1:111122223333:automated-reasoning-policy/lnq5hhz70wgk" \
  --last-updated-definition-hash "583463f067a8a4f49fc1206b4642fd40..."

응답 예제:

{
  "policyArn": "arn:aws:bedrock:us-east-1:111122223333:automated-reasoning-policy/lnq5hhz70wgk",
  "version": "1",
  "name": "MyHRPolicy"
}

가드레일에 자동 추론 정책 추가

자동 추론 정책의 저장된 버전이 있으면 가드레일에 추가합니다. 가드레일은 애플리케이션이 LLM 응답을 검증하기 위해 호출하는 런타임 구성 요소입니다. 자동 추론 정책을 새 가드레일 또는 기존 가드레일에 추가할 수 있습니다.

콘솔 사용

API 사용

CreateGuardrail 또는 UpdateGuardrail API를 사용하여 가드레일에 자동 추론 정책을 추가합니다. 버전이 지정된 정책 ARN에 automatedReasoningConfig 파라미터를 포함합니다.

요청 파라미터

예제

aws bedrock create-guardrail \
  --name "HR-Policy-Guardrail" \
  --description "Guardrail for HR policy validation" \
  --automated-reasoning-policy-config policies="arn:aws:bedrock:us-east-1:111122223333:automated-reasoning-policy/lnq5hhz70wgk:1" \
  --cross-region-config '{"guardrailProfileIdentifier": "us.guardrail.v1:0"}' \
  --blocked-input-messaging "I cannot process this request." \
  --blocked-outputs-messaging "I cannot provide this response."

배포를 위한 정책 버전 내보내기

CloudFormation 또는 CI/CD 파이프라인을 통해 정책을 배포하려면 정책 정의 JSON이 필요합니다. ExportAutomatedReasoningPolicyVersion API를 사용하여 저장된 버전에서 모든 규칙, 변수 및 사용자 지정 유형을 포함한 전체 정책 정의를 내보냅니다.

내보낸 정의는 AWS::Bedrock::AutomatedReasoningPolicy 리소스의 PolicyDefinition 속성에서 CloudFormation 허용하는 것과 동일한 형식입니다. 이렇게 하면 대화형 콘솔 워크플로에서 자동 배포로 정책을 쉽게 이동할 수 있습니다.

# Export the policy definition from version 1
aws bedrock export-automated-reasoning-policy-version \
  --policy-arn "arn:aws:bedrock:us-east-1:111122223333:automated-reasoning-policy/lnq5hhz70wgk:1" \
  --query "policyDefinition" \
  --output json > policy-definition.json

내보낸 JSON의 구조는 다음과 같습니다.

{
  "version": "1.0",
  "variables": [
    {
      "name": "isFullTime",
      "type": "BOOL",
      "description": "Whether the employee works full-time (true) or part-time (false)."
    },
    {
      "name": "tenureMonths",
      "type": "INT",
      "description": "The number of complete months the employee has been continuously employed."
    }
  ],
  "rules": [
    {
      "id": "A1B2C3D4E5F6",
      "expression": "(=> (and isFullTime (> tenureMonths 12)) eligibleForParentalLeave)"
    }
  ],
  "types": []
}

이 파일을 CloudFormation 템플릿과 함께 버전 제어에 저장합니다. 정책을 업데이트할 때 새 버전을 내보내고 파일을 업데이트하여 배포를 트리거합니다.

를 사용하여 배포 자동화 CloudFormation

CloudFormation 를 사용하여 자동화된 추론 정책과 가드레일을 코드형 인프라로 배포합니다. AWS::Bedrock::AutomatedReasoningPolicy 리소스는 API 또는 콘솔에서 내보내는 정책 정의가 포함된 정책을 생성합니다. 와 함께 전체 검증 스택을 단일 템플릿에 배포할 AWS::Bedrock::Guardrail수 있습니다.

정책 리소스의 전체 속성 참조는 템플릿 참조의 AWS::Bedrock::AutomatedReasoningPolicy를 참조하세요. CloudFormation

예: 정책 및 가드레일 배포

다음 CloudFormation 템플릿은 정책 정의와 이를 참조하는 가드레일을 사용하여 자동 추론 정책을 생성합니다. 정책 정의를 테스트된 정책에서 내보낸 JSON으로 바꿉니다.

AWSTemplateFormatVersion: '2010-09-09'
Description: Deploy an Automated Reasoning policy and guardrail

Parameters:
  PolicyName:
    Type: String
    Default: MyHRPolicy
    Description: Name of the Automated Reasoning policy
  GuardrailName:
    Type: String
    Default: HR-Policy-Guardrail
    Description: Name of the guardrail

Resources:
  AutomatedReasoningPolicy:
    Type: AWS::Bedrock::AutomatedReasoningPolicy
    Properties:
      Name: !Ref PolicyName
      Description: Validates HR chatbot responses about leave eligibility
      PolicyDefinition:
        Version: '1.0'
        Variables:
          - Name: isFullTime
            Type: BOOL
            Description: >-
              Whether the employee works full-time (true) or part-time (false).
              Set to true when users mention being full-time or working 40+ hours
              per week.
          - Name: tenureMonths
            Type: INT
            Description: >-
              The number of complete months the employee has been continuously
              employed. When users mention years of service, convert to months
              (for example, 2 years = 24 months).
          - Name: eligibleForParentalLeave
            Type: BOOL
            Description: >-
              Whether the employee is eligible for parental leave based on
              employment status and tenure.
        Rules:
          - Id: A1B2C3D4E5F6
            Expression: >-
              (=> (and isFullTime (> tenureMonths 12))
              eligibleForParentalLeave)
          - Id: G7H8I9J0K1L2
            Expression: >-
              (=> (or (not isFullTime) (<= tenureMonths 12))
              (not eligibleForParentalLeave))
        Types: []
      Tags:
        - Key: Environment
          Value: Production
        - Key: Team
          Value: HR

  Guardrail:
    Type: AWS::Bedrock::Guardrail
    Properties:
      Name: !Ref GuardrailName
      Description: Guardrail with Automated Reasoning checks for HR policy
      BlockedInputMessaging: I cannot process this request.
      BlockedOutputsMessaging: I cannot provide this response.
      AutomatedReasoningPolicyConfig:
        Policies:
          - !GetAtt AutomatedReasoningPolicy.PolicyArn
      CrossRegionConfig:
        GuardrailProfileArn: !Sub "arn:aws:bedrock:${AWS::Region}:${AWS::AccountId}:guardrail-profile/us.guardrail.v1:0"

Outputs:
  PolicyArn:
    Description: ARN of the Automated Reasoning policy
    Value: !GetAtt AutomatedReasoningPolicy.PolicyArn
  PolicyId:
    Description: ID of the Automated Reasoning policy
    Value: !GetAtt AutomatedReasoningPolicy.PolicyId
  GuardrailId:
    Description: ID of the guardrail
    Value: !Ref Guardrail

예: 고객 관리형 KMS 키를 사용하여 배포

고객 관리형 KMS 키로 정책을 암호화하려면 KmsKeyId 속성을 추가합니다. 또한 Amazon Bedrock이 키를 사용할 수 있도록 키 정책을 구성해야 합니다. 필요한 키 정책 권한은 섹션을 참조하세요자동 추론 정책에 대한 KMS 권한.

  AutomatedReasoningPolicy:
    Type: AWS::Bedrock::AutomatedReasoningPolicy
    Properties:
      Name: !Ref PolicyName
      Description: Validates HR chatbot responses about leave eligibility
      KmsKeyId: !GetAtt PolicyEncryptionKey.Arn
      PolicyDefinition:
        # ... policy definition ...
      Tags:
        - Key: Environment
          Value: Production

다음 단계

정책 및 가드레일을 배포한 후 자동화된 추론 검사를 애플리케이션에 통합하여 런타임 시 LLM 응답을 검증합니다. 자세한 내용은 애플리케이션에 자동 추론 검사 통합 단원을 참조하십시오.