가드레일 생성 - Amazon Bedrock

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

가드레일 생성

구성을 설정하고, 거부할 주제를 정의하고, 유해하고 민감한 콘텐츠를 처리하기 위한 필터를 제공하고, 프롬프트 및 사용자 응답이 차단될 때 에 대한 메시지를 작성하여 가드레일을 생성합니다.

프롬프트 및 사용자 응답이 차단될 때 가드레일에는 에 대한 필터와 메시징이 하나 이상 포함되어야 합니다. 기본 메시징을 사용하도록 선택할 수 있습니다. 나중에 의 단계에 따라 가드레일에 필요한 모든 구성 요소를 구성가드레일 수정하여 필터를 추가하고 가드레일에 반복할 수 있습니다.

선택한 메서드에 해당하는 탭을 선택하고 다음 단계를 따릅니다.

Console
AWS 콘솔에서 가드레일을 생성하려면
  1. Amazon Bedrock 권한이 있는 역할을 AWS Management Console 사용하여 에 로그인하고 에서 Amazon Bedrock 콘솔을 엽니다https://console.aws.amazon.com/bedrock/. IAM

  2. 왼쪽 탐색 창에서 Guardrails 를 선택합니다.

  3. 가드레일 섹션에서 가드레일 생성 을 선택합니다.

  4. 가드레일 세부 정보 제공 페이지에서 다음을 수행합니다.

    1. 가드레일 세부 정보 섹션에서 가드레일의 이름 및 선택적 설명을 제공합니다.

    2. 가드레일이 호출될 때 표시될 프롬프트에 대한 차단된 메시징 메시지를 입력합니다. 응답에 가드레일이 호출될 때 동일한 메시지를 사용하도록 응답에 동일한 차단된 메시지 사용 확인란을 선택합니다.

    3. (선택 사항) 기본적으로 가드레일은 로 암호화됩니다 AWS 관리형 키. 자체 고객 관리형 KMS 키를 사용하려면 KMS 키 선택 옆의 오른쪽 화살표를 선택하고 암호화 설정(고급) 사용자 지정 확인란을 선택합니다. 기존 AWS KMS 키를 선택하거나 키 생성을 선택하여 새 AWS KMS 키를 생성할 수 있습니다.

    4. Guardrail 생성 옵션에서 독성 필터로 빠른 생성을 선택하여 기본 설정을 사용하거나 자체 가드레일 생성을 선택하여 가드레일 설정을 사용자 지정합니다. 독성 필터 보기 및 편집을 선택하여 가드레일 필터 비속어 및 프롬프트 공격 필터 설정을 보거나 사용자 지정할 수도 있습니다.

    5. (선택 사항) 가드레일에 태그를 추가하려면 태그 옆의 오른쪽 화살표를 선택합니다. 그런 다음 새 태그 추가를 선택하고 태그의 키-값 페어를 정의합니다. 자세한 내용은 Amazon Bedrock 리소스 태그 지정 단원을 참조하십시오.

    6. Next(다음)를 선택합니다.

    참고

    가드레일을 생성하려면 하나 이상의 필터를 구성해야 합니다. 그런 다음 생성을 선택하여 다른 필터 생성을 건너뛸 수 있습니다.

  5. (선택 사항) 콘텐츠 필터 구성 페이지에서 다음을 수행하여 에 정의된 범주와 관련된 콘텐츠를 얼마나 강력콘텐츠 필터로 유해한 단어 및 대화 차단하게 필터링할지 설정합니다.

    1. 유해 범주에 대한 필터를 구성하려면 유해 범주 필터 활성화를 선택합니다. 유해한 범주에서 프롬프트 공격에 대한 필터를 선택할 수 있습니다. 사용자가 모델에 제공하는 프롬프트에 대해 각 필터가 얼마나 엄격한지 구성합니다.

    2. 프롬프트 공격에 대한 필터를 구성하려면 프롬프트 공격 필터 활성화를 선택합니다. 필터가 탈옥 및 프롬프트 주입 공격을 탐지 및 차단하는 방법을 엄격하게 구성합니다.

    3. 생성을 선택하여 가드레일을 생성하거나 고급 필터를 사용하여 필터 설정을 사용자 지정합니다.를 선택합니다.

  6. (선택 사항) 거부된 주제 추가 페이지에서 거부된 주제를 추가하거나 검토 및 생성으로 건너뛰기를 선택할 수 있습니다.

    1. 차단할 주제를 정의하려면 거부된 주제 추가를 선택합니다. 뒤이어 다음과 같이 하십시오.

      1. 주제의 이름을 입력합니다.

      2. 주제 정의 상자에서 주제를 정의합니다. 거부된 주제를 정의하는 방법에 대한 지침은 섹션을 참조하세요거부된 주제를 차단하여 유해한 콘텐츠 삭제.

      3. (선택 사항) 이 주제와 관련된 대표적인 입력 프롬프트 또는 모델 응답을 추가하려면 샘플 구문 추가 옆의 오른쪽 화살표를 선택합니다. 상자에 구문을 입력합니다. 다른 구문을 추가하려면 구문 추가를 선택합니다.

      4. 거부된 주제 구성을 완료했으면 확인을 선택합니다.

    2. 거부된 주제 를 사용하여 다음 작업을 수행할 수 있습니다.

      • 다른 주제를 추가하려면 거부된 주제 추가를 선택합니다.

      • 주제를 편집하려면 작업 열의 주제와 동일한 행에서 점 3개 아이콘을 선택합니다. 그런 다음 편집을 선택합니다. 편집이 완료되면 확인을 선택합니다.

      • 주제 또는 주제를 삭제하려면 삭제할 주제의 확인란을 선택합니다. 삭제를 선택한 다음 선택한 삭제를 선택합니다.

      • 모든 주제를 삭제하려면 삭제를 선택한 다음 모두 삭제를 선택합니다.

      • 테이블의 각 페이지 또는 테이블의 열 디스플레이 크기를 구성하려면 설정 아이콘()을 선택합니다 Gear icon representing settings or configuration options. . 기본 설정을 설정한 다음 확인을 선택합니다.

    3. 거부된 주제 구성을 마치면 다음을 선택합니다.

  7. (선택 사항) 단어 필터 추가 페이지에서 다음을 수행합니다.

    1. 비속어 필터링 섹션에서 비속어 필터링을 선택하여 프롬프트 및 응답의 비속어를 차단합니다. 비속어 목록은 기존 정의를 기반으로 하며 지속적으로 업데이트됩니다.

    2. 사용자 지정 단어 및 문구 추가 섹션에서 가드레일이 차단할 단어 및 문구를 추가하는 방법을 선택합니다. 파일을 업로드하도록 선택하는 경우 파일의 각 줄에는 한 단어 또는 최대 세 단어의 구문이 포함되어야 합니다. 헤더를 포함하지 마세요. 다음과 같은 옵션이 있습니다:

      옵션 지침
      단어 및 구문을 수동으로 추가 단어 및 문구 보기 및 편집 섹션에 단어 및 문구를 직접 추가합니다.
      로컬 파일에서 업로드 단어와 문구가 포함된 .txt 또는 .csv 파일을 업로드하려면 이 옵션을 선택한 후 파일 선택을 선택합니다.
      Amazon S3 객체에서 업로드 Amazon S3에서 파일을 업로드하려면 이 옵션을 선택한 후 S3 객체를 지정합니다. 파일의 각 줄에는 한 단어 또는 최대 세 단어의 구문이 포함되어야 합니다.
    3. 가드레일의 단어 및 구문을 편집하여 단어 및 구문 보기 및 편집 섹션에서 차단합니다. 다음과 같은 옵션이 있습니다:

      • 로컬 파일 또는 Amazon S3 객체에서 단어 목록을 업로드한 경우 이 섹션에 단어 목록이 채워집니다. 오류가 있는 항목을 필터링하려면 오류 표시를 선택합니다.

      • 단어 목록에 항목을 추가하려면 단어 또는 구문 추가를 선택합니다. 상자에 단어 또는 최대 세 단어의 구문을 입력하고 Enter 키를 누르거나 체크 표시 아이콘을 선택하여 항목을 확인합니다.

      • 항목을 편집하려면 항목 옆의 편집 아이콘( Edit icon represented by a pencil symbol. )을 선택합니다.

      • 단어 목록에서 항목을 삭제하려면 휴지통 아이콘( Trapezoid-shaped diagram showing data flow from source to destination through AWS Transfer Family. )을 선택하거나 항목을 편집하는 경우 항목 옆에 있는 삭제 아이콘( Close or cancel icon represented by an "X" symbol. )을 선택합니다.

      • 오류가 포함된 항목을 삭제하려면 모두 삭제를 선택한 다음 오류가 있는 모든 행 삭제를 선택합니다.

      • 모든 항목을 삭제하려면 모두 삭제를 선택한 다음 모든 행 삭제를 선택합니다.

      • 항목을 검색하려면 검색 창에 표현식을 입력합니다.

      • 오류가 있는 항목만 표시하려면 모두 표시 드롭다운 메뉴를 선택하고 오류만 표시를 선택합니다.

      • 테이블의 각 페이지 또는 테이블의 열 디스플레이 크기를 구성하려면 설정 아이콘()을 선택합니다 Gear icon representing settings or configuration options. . 기본 설정을 설정한 다음 확인을 선택합니다.

      • 기본적으로 이 섹션에는 테이블 편집기가 표시됩니다. 각 줄에 단어 또는 구문을 입력할 수 있는 텍스트 편집기로 전환하려면 텍스트 편집기를 선택합니다. 텍스트 편집기는 다음 기능을 제공합니다.

        • 다른 텍스트 편집기에서 단어 목록을 복사하여 이 편집기에 붙여넣을 수 있습니다.

        • 오류가 포함된 항목 옆에 빨간색 X 아이콘이 나타나고 편집기 아래에 오류 목록이 나타납니다.

    4. 건너뛰기를 선택하여 검토하고 생성하여 가드레일을 생성하거나 다음을 선택하여 PII 및 정규식 패턴에 대한 필터를 추가합니다.

  8. (선택 사항) 민감한 정보 필터 추가 페이지에서 민감한 정보를 차단하거나 마스킹하도록 필터를 구성합니다. 자세한 내용은 민감한 정보 필터를 사용하여 PII 대화에서 제거 단원을 참조하십시오. 다음을 따릅니다.

    1. PII 유형 섹션에서 개인 식별 정보(PII) 범주를 차단하거나 마스킹하도록 구성합니다. 다음과 같은 옵션이 있습니다:

      • PII 유형을 추가하려면 PII 유형 추가를 선택합니다. 뒤이어 다음과 같이 하세요.

        1. 유형 열에서 PII 유형을 선택합니다.

        2. 가드레일 동작 열에서 가드레일이 PII 유형이 포함된 콘텐츠를 차단할지 아니면 식별자로 마스킹할지 선택합니다.

      • 모든 PII 유형을 추가하려면 PII 유형 추가 옆의 드롭다운 화살표를 선택합니다. 그런 다음 적용할 가드레일 동작을 선택합니다.

        주의

        동작을 지정하면 PII 유형에 대해 구성한 기존 동작을 덮어씁니다.

      • PII 유형을 삭제하려면 휴지통 아이콘()을 선택합니다 Trapezoid-shaped diagram showing data flow from source to destination through AWS Transfer Family. .

      • 오류가 있는 행을 삭제하려면 모두 삭제를 선택한 다음 오류가 있는 모든 행 삭제를 선택합니다.

      • 모든 PII 유형을 삭제하려면 모두 삭제를 선택한 다음 모든 행 삭제를 선택합니다.

      • 행을 검색하려면 검색 창에 표현식을 입력합니다.

      • 오류가 있는 행만 표시하려면 모두 표시 드롭다운 메뉴를 선택하고 오류만 표시를 선택합니다.

      • 테이블의 각 페이지 또는 테이블의 열 디스플레이 크기를 구성하려면 설정 아이콘()을 선택합니다 Gear icon representing settings or configuration options. . 기본 설정을 설정한 다음 확인을 선택합니다.

    2. 정규식 패턴 섹션에서 정규식을 사용하여 필터링할 가드레일의 패턴을 정의합니다. 다음과 같은 옵션이 있습니다:

      • 패턴을 추가하려면 정규식 패턴 추가를 선택합니다. 다음 필드를 구성합니다.

        필드 설명
        명칭 패턴의 이름
        정규식 패턴 패턴을 정의하는 정규식
        가드레일 동작 패턴이 포함된 콘텐츠를 차단할지 아니면 식별자로 마스킹할지 선택합니다. 로그에서만 패턴을 마스킹하려면 없음을 선택합니다.
        설명 추가 (선택 사항) 패턴에 대한 설명 작성
      • 패턴을 편집하려면 작업 열의 주제와 동일한 행에서 점 3개 아이콘을 선택합니다. 그런 다음 편집을 선택합니다. 편집이 완료되면 확인을 선택합니다.

      • 패턴 또는 패턴을 삭제하려면 삭제할 패턴의 확인란을 선택합니다. 삭제를 선택한 다음 선택한 삭제를 선택합니다.

      • 모든 패턴을 삭제하려면 삭제를 선택한 다음 모두 삭제를 선택합니다.

      • 패턴을 검색하려면 검색 창에 표현식을 입력합니다.

      • 테이블의 각 페이지 또는 테이블의 열 디스플레이 크기를 구성하려면 설정 아이콘()을 선택합니다 Gear icon representing settings or configuration options. . 기본 설정을 설정한 다음 확인을 선택합니다.

    3. 민감한 정보 필터 구성을 마치면 다음 또는 건너뛰기를 선택하여 를 검토하고 생성합니다.

  9. 상황별 접지 확인 추가 페이지(선택 사항)에서 접지되지 않았거나 관련이 없는 정보를 차단하도록 임계값을 구성합니다.

    참고

    각 검사 유형에 대해 슬라이더를 이동하거나 임계값을 0에서 0.99로 입력할 수 있습니다. 사용에 적합한 임계값을 선택합니다. 임계값이 높을수록 응답을 접지하거나 높은 수준의 신뢰도로 관련시켜야만 허용됩니다. 임계값 미만의 응답은 필터링됩니다. 상황별 접지 확인에 대한 자세한 내용은 상황별 접지 확인을 참조하세요.

    1. 접지 필드에서 접지 확인 활성화를 선택하여 모델 응답이 접지되었는지 확인합니다.

    2. 관련성 필드에서 관련성 확인 활성화를 선택하여 모델 응답이 관련이 있는지 확인합니다.

    3. 다음을 선택합니다.

  10. 검토 및 생성 - 가드레일의 설정을 검토합니다.

    1. 변경하려는 섹션에서 편집을 선택합니다.

    2. 가드레일의 설정에 만족하면 생성을 선택하여 가드레일을 생성합니다.

API

가드레일을 생성하려면 CreateGuardrail 요청을 보냅니다. 요청 형식은 다음과 같습니다.

POST /guardrails HTTP/1.1 Content-type: application/json { "blockedInputMessaging": "string", "blockedOutputsMessaging": "string", "contentPolicyConfig": { "filtersConfig": [ { "inputStrength": "NONE | LOW | MEDIUM | HIGH", "outputStrength": "NONE | LOW | MEDIUM | HIGH", "type": "SEXUAL | VIOLENCE | HATE | INSULTS | MISCONDUCT | PROMPT_ATTACK" } ] }, "wordPolicyConfig": { "wordsConfig": [ { "text": "string" } ], "managedWordListsConfig": [ { "type": "string" } ] }, "sensitiveInformationPolicyConfig": { "piiEntitiesConfig": [ { "type": "string", "action": "string" } ], "regexesConfig": [ { "name": "string", "description": "string", "regex": "string", "action": "string" } ] }, "description": "string", "kmsKeyId": "string", "name": "string", "tags": [ { "key": "string", "value": "string" } ], "topicPolicyConfig": { "topicsConfig": [ { "definition": "string", "examples": [ "string" ], "name": "string", "type": "DENY" } ] } }
  • 가드레일에 name description 및 를 지정합니다.

  • 가드레일이 blockedInputMessagingblockedOutputsMessaging 필드에서 프롬프트 또는 모델 응답을 성공적으로 차단할 때 에 대한 메시지를 지정합니다.

  • topicPolicy 객체에서 거부할 가드레일의 주제를 지정합니다. topics 목록의 각 항목은 하나의 주제와 관련이 있습니다. 주제의 필드에 대한 자세한 내용은 주제 단원을 참조하세요.

    • 가드레일이 주제를 제대로 식별할 수 description 있도록 name 및 를 제공합니다.

    • action 필드에 DENY 를 지정합니다.

    • (선택 사항) examples 목록에서 주제에 속하는 것으로 분류할 최대 5개의 예를 제공합니다.

  • contentPolicy 객체의 Amazon Bedrock에 정의된 유해 범주에 대한 필터 강도를 지정합니다. filters 목록의 각 항목은 유해한 범주와 관련이 있습니다. 자세한 내용은 콘텐츠 필터로 유해한 단어 및 대화 차단 단원을 참조하십시오. 콘텐츠 필터의 필드에 대한 자세한 내용은 섹션을 참조하세요ContentFilter.

    • type 필드에 범주를 지정합니다.

    • textToTextFiltersForPrompt 필드 필드에 프롬프트용 필터의 강도를 지정하고 strength 필드 strength 필드에 모델 응답을 지정합니다textToTextFiltersForResponse.

  • (선택 사항) 가드레일에 태그를 연결합니다. 자세한 내용은 Amazon Bedrock 리소스 태그 지정 단원을 참조하십시오.

  • (선택 사항) 보안을 위해 kmsKeyId 필드에 KMS 키ARN의 를 포함합니다.

응답 형식은 다음과 같습니다.

HTTP/1.1 202 Content-type: application/json { "createdAt": "string", "guardrailArn": "string", "guardrailId": "string", "version": "string" }