가드레일 만들기

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

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

선택한 방법에 해당하는 탭을 선택하고 단계를 따르세요.

Console

가드레일을 만들려면

에 AWS Management Console로그인하고 https://console.aws.amazon.com/bedrock/ 에서 Amazon Bedrock 콘솔을 엽니다.
왼쪽 탐색 창에서 가드레일을 선택합니다.
가드레일 섹션에서 가드레일 생성을 선택합니다.
가드레일 세부정보 제공 페이지에서 다음을 수행하십시오.
1. 가드레일 세부 정보 섹션에서 가드레일의 이름 및 선택적 설명을 입력합니다.
2. (선택 사항) 기본적으로 가드레일은 a로 암호화됩니다. AWS 관리형 키고객 관리형 KMS 키를 사용하려면 KMS 키 선택 옆의 오른쪽 화살표를 선택하고 암호화 설정 사용자 지정 (고급) 확인란을 선택합니다. 기존 AWS KMS 키를 선택하거나 키 생성을 선택하여 새 키를 생성할 수 있습니다. AWS KMS
3. (선택 사항) 가드레일에 태그를 추가하려면 태그 옆의 오른쪽 화살표를 선택합니다. 그런 다음 새 태그 추가를 선택하고 태그의 키-값 쌍을 정의합니다. 자세한 정보는 리소스 태깅을 참조하세요.
4. 다음을 선택하세요.
참고
가드레일을 만들려면 필터를 하나 이상 구성해야 합니다. 그런 다음 [검토 및 생성으로 건너뛰기] 를 선택하여 다른 필터 생성을 건너뛸 수 있습니다.
(선택 사항) 콘텐츠 필터 구성 페이지에서 다음을 콘텐츠 필터 수행하여 에 정의된 카테고리와 관련된 콘텐츠를 필터링할 강도를 설정합니다.
1. 모델에 대한 프롬프트의 필터를 구성하려면 모델 프롬프트의 필터 강도 섹션에서 프롬프트에 대한 필터 활성화를 선택합니다. 사용자가 모델에 제공하는 프롬프트에 대해 각 필터를 얼마나 엄격하게 적용할지 구성하십시오.
2. 모델 응답에 대한 필터를 구성하려면 응답에 대한 필터 강도에서 응답에 대한 필터 활성화를 선택합니다. 모델이 반환하는 응답에 대해 각 필터를 얼마나 엄격하게 적용할지 구성하십시오.
3. 다음을 선택합니다.
(선택 사항) 거부된 주제 추가 페이지에서 다음을 수행하십시오.
1. 차단할 주제를 정의하려면 거부된 주제 추가를 선택합니다. 뒤이어 다음과 같이 하십시오.
  1. 주제의 이름을 입력합니다.
  2. 주제 정의 상자에서 주제를 정의합니다. 거부된 주제를 정의하는 방법에 대한 지침은 을 참조하십시오거부된 주제.
  3. (선택 사항) 이 주제와 관련된 대표적인 입력 프롬프트 또는 모델 응답을 추가하려면 샘플 문구 추가 옆의 오른쪽 화살표를 선택합니다. 상자에 문구를 입력합니다. 다른 문구를 추가하려면 [문구 추가] 를 선택합니다.
  4. 거부된 주제를 모두 구성했으면 확인을 선택합니다.
2. 거부된 주제를 사용하여 다음 작업을 수행할 수 있습니다.
  - 다른 주제를 추가하려면 거부된 주제 추가를 선택합니다.
  - 주제를 편집하려면 작업 열의 주제와 같은 행에 있는 점 세 개 아이콘을 선택합니다. 그런 다음 편집을 선택합니다. 편집을 마친 후 확인을 선택합니다.
  - 주제를 삭제하려면 삭제할 주제의 확인란을 선택합니다. 삭제를 선택한 다음 선택한 항목 삭제를 선택합니다.
  - 모든 주제를 삭제하려면 삭제를 선택한 다음 모두 삭제를 선택합니다.
  - 표의 각 페이지 또는 표의 열 표시 크기를 구성하려면 설정 아이콘 ( ) 을 선택합니다. 기본 설정을 지정한 다음 확인을 선택합니다.
3. 거부된 주제 구성을 마치면 다음을 선택합니다.

(선택 사항) 단어 필터 추가 페이지에서 다음을 수행하십시오.

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

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

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

단어 및 구문 보기 및 편집 섹션에서 차단할 가드레일의 단어와 문구를 편집합니다. 다음과 같은 옵션이 있습니다:
- 로컬 파일 또는 Amazon S3 객체에서 단어 목록을 업로드한 경우 이 섹션은 단어 목록으로 채워집니다. 오류가 있는 항목을 필터링하려면 오류 보기를 선택합니다.
- 단어 목록에 항목을 추가하려면 단어 또는 구문 추가를 선택합니다. 상자에 최대 세 단어의 단어 또는 문구를 입력하고 Enter 키를 누르거나 체크 표시 아이콘을 선택하여 항목을 확인합니다.
- 항목을 편집하려면 해당 항목 옆에 있는 편집 아이콘 ( ) 을 선택합니다.
- 단어 목록에서 항목을 삭제하려면 휴지통 아이콘 ( ) 을 선택하거나, 항목을 편집하는 경우 항목 옆에 있는 삭제 아이콘 ( ) 을 선택합니다.
- 오류가 있는 항목을 삭제하려면 모두 삭제를 선택한 다음 오류가 있는 모든 행 삭제를 선택합니다.
- 모든 항목을 삭제하려면 모두 삭제를 선택한 다음 모든 행 삭제를 선택합니다.
- 항목을 검색하려면 검색 창에 표현식을 입력합니다.
- 오류가 있는 항목만 표시하려면 모두 표시라는 레이블이 붙은 드롭다운 메뉴를 선택하고 오류만 표시를 선택합니다.
- 표의 각 페이지 또는 표의 열 표시 크기를 구성하려면 설정 아이콘 () 을 선택합니다. 기본 설정을 지정한 다음 확인을 선택합니다.
- 기본적으로 이 섹션에는 테이블 편집기가 표시됩니다. 각 줄에 단어나 문구를 입력할 수 있는 텍스트 편집기로 전환하려면 텍스트 편집기를 선택합니다. 텍스트 편집기는 다음과 같은 기능을 제공합니다.
  - 다른 텍스트 편집기에서 단어 목록을 복사하여 이 편집기에 붙여넣을 수 있습니다.
  - 오류가 있는 항목 옆에는 빨간색 X 아이콘이 나타나고 편집기 아래에는 오류 목록이 표시됩니다.

(선택 사항) 민감한 정보 필터 추가 페이지에서 민감한 정보를 차단하거나 마스킹하도록 필터를 구성합니다. 자세한 정보는 민감한 정보 필터을 참조하세요. 다음을 따릅니다.

PII 유형 섹션에서 차단하거나 마스킹할 개인 식별 정보 (PII) 범주를 구성합니다. 다음과 같은 옵션이 있습니다:
- PII 유형을 추가하려면 PII 유형 추가를 선택합니다. 뒤이어 다음과 같이 하세요.
  1. 유형 열에서 PII 유형을 선택합니다.
  2. 가드레일 행동 열에서 가드레일에서 PII 유형이 포함된 콘텐츠를 차단할지 아니면 식별자로 마스킹할지 선택합니다.
- 모든 PII 유형을 추가하려면 PII 유형 추가 옆의 드롭다운 화살표를 선택합니다. 그런 다음 적용할 가드레일 동작을 선택합니다.
  
  주의
  동작을 지정하면 PII 유형에 대해 구성한 기존 동작을 모두 덮어씁니다.
- PII 유형을 삭제하려면 휴지통 아이콘 () 을 선택합니다.
- 오류가 있는 행을 삭제하려면 모두 삭제를 선택한 다음 오류가 있는 모든 행 삭제를 선택합니다.
- 모든 PII 유형을 삭제하려면 모두 삭제를 선택한 다음 모든 행 삭제를 선택합니다.
- 행을 검색하려면 검색 창에 표현식을 입력합니다.
- 오류가 있는 행만 표시하려면 모두 표시라는 레이블이 붙은 드롭다운 메뉴를 선택하고 오류만 표시를 선택합니다.
- 표의 각 페이지 또는 표의 열 표시 크기를 구성하려면 설정 아이콘 () 을 선택합니다. 기본 설정을 지정한 다음 확인을 선택합니다.

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

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

필드	설명
명칭	패턴 이름
레젝스 패턴	패턴을 정의하는 정규 표현식
가드레일 동작	패턴이 포함된 콘텐츠를 차단할지 아니면 식별자로 마스킹할지 선택합니다. 로그에서만 패턴을 마스킹하려면 없음을 선택합니다.
설명 추가	(선택 사항) 패턴에 대한 설명 작성

패턴을 편집하려면 작업 열의 항목과 같은 행에 있는 점 세 개 아이콘을 선택합니다. 그런 다음 편집을 선택합니다. 편집을 마친 후 확인을 선택합니다.
패턴을 삭제하려면 삭제할 패턴의 확인란을 선택합니다. 삭제를 선택한 다음 선택한 항목 삭제를 선택합니다.
패턴을 모두 삭제하려면 삭제를 선택한 다음 모두 삭제를 선택합니다.
패턴을 검색하려면 검색 창에 표현식을 입력합니다.
표의 각 페이지 또는 표의 열 표시 크기를 구성하려면 설정 아이콘 ( ) 을 선택합니다. 기본 설정을 지정한 다음 확인을 선택합니다.

민감한 정보 필터 구성을 마치면 [다음] 을 선택합니다.

차단된 메시지 정의 페이지에서 가드레일이 콘텐츠를 탐지하고 차단할 때 사용자에게 반환할 메시지를 설정합니다. 다음을 따릅니다.
1. 차단된 메시지 섹션의 차단된 프롬프트에 대해 표시되는 메시지 필드에 모델로 전송된 프롬프트를 가드레일이 차단하는 경우 표시할 메시지를 입력합니다.
2. 차단된 메시지 섹션의 차단된 응답에 대해 표시되는 메시지 필드에 모델에서 생성된 응답을 가드레일이 차단하는지 여부를 표시할 메시지를 입력합니다.
3. 다음을 선택합니다.
검토 및 생성 - 가드레일의 설정을 검토합니다.
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 a와 description a를 지정하십시오.
및 필드에 가드레일이 프롬프트 또는 모델 응답을 성공적으로 차단한 경우에 대한 메시지를 지정합니다. blockedInputMessaging blockedOutputsMessaging
객체에서 거부할 가드레일의 주제를 지정하십시오. topicPolicy topics목록의 각 항목은 하나의 주제와 관련이 있습니다. 주제의 필드에 대한 자세한 내용은 주제를 참조하십시오.
- name가드레일이 주제를 제대로 식별할 수 description 있도록 an을 주십시오.
- DENY필드에 지정하십시오. action
- (선택 사항) examples 목록에 있는 주제에 속하는 것으로 분류할 예제를 최대 5개까지 제공하십시오.
Amazon Bedrock에 정의된 유해 카테고리에 대한 필터 강도를 객체에 지정합니다. contentPolicy filters목록의 각 항목은 유해 카테고리와 관련이 있습니다. 자세한 정보는 콘텐츠 필터을 참조하세요. 콘텐츠 필터의 필드에 대한 자세한 내용은 을 참조하십시오 ContentFilter.
- type필드에 카테고리를 지정합니다.
- strength필드의 프롬프트와 필드의 모델 응답에 대한 textToTextFiltersForPrompt 필터의 강도를 지정합니다. strength textToTextFiltersForResponse
(선택 사항) 가드레일에 태그를 부착합니다. 자세한 정보는 리소스 태깅을 참조하세요.
(선택 사항) 보안을 위해 KMS 키의 ARN을 필드에 포함하십시오. kmsKeyId

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


HTTP/1.1 202
Content-type: application/json

{
   "createdAt": "string",
   "guardrailArn": "string",
   "guardrailId": "string",
   "version": "string"
}

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

문서 규칙

필수 조건

가드레일 테스트

가드레일 만들기

가드레일을 만들려면

참고

주의