가드레일 정보 확인 - Amazon Bedrock

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

가드레일 정보 확인

AWS 콘솔 또는 API에서 다음 단계에 따라 가드레일에 대한 정보를 확인할 수 있습니다.

Console
가드레일 버전 및 설정에 대한 정보를 확인하는 방법

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

  2. 왼쪽 탐색 창에서 가드레일을 선택합니다. 그런 다음 가드레일 섹션에서 가드레일을 선택합니다.

  3. 가드레일 개요 섹션에는 모든 버전에 적용되는 가드레일의 구성이 표시됩니다.

  4. 규격 초안에 대한 자세한 내용을 보려면 규격 초안 섹션에서 규격 초안을 선택합니다.

  5. 가드레일의 특정 버전에 대한 자세한 내용을 보려면 버전 섹션에서 버전을 선택합니다.

규격 초안 및 가드레일 버전에 대한 자세한 내용은 가드레일 배포 섹션을 참조하세요.

API

가드레일에 대한 정보를 얻으려면 GetGuardrail 요청을 보내고 가드레일의 ID와 버전을 포함합니다. 버전을 지정하지 않으면 응답은 DRAFT 버전에 대한 세부 정보를 반환합니다.

요청 형식은 다음과 같습니다.

GET /guardrails/guardrailIdentifier?guardrailVersion=guardrailVersion HTTP/1.1

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

HTTP/1.1 200
Content-type: application/json

{
  "topicPolicy": {
    "topics": [
      {
        "definition": "string",
        "examples": [
          "string"
        ],
        "name": "string",
        "type": "DENY"
      }
    ]
  },
  "contentPolicy": {
    "filters": [
      {
        "type": "string",
        "inputStrength": "string",
        "outputStrength": "string"
      }
    ]
  },
  "wordPolicy": {
    "words": [
      {
        "text": "string"
      }
    ],
    "managedWordLists": [
      {
        "type": "string"
      }
    ]
  },
  "sensitiveInformationPolicy": {
    "piiEntities": [
      {
        "type": "string",
        "action": "string"
      }
    ],
    "regexes": [
      {
        "name": "string",
        "description": "string",
        "regex": "string",
        "action": "string"
      }
    ]
  },
  "contextualGroundingPolicy": {
    "groundingFilter": {
      "threshold": float
    },
    "relevanceFilter": {
      "threshold": float
    }
  },
  "createdAt": "string",
  "blockedInputMessaging": "string",
  "blockedOutputsMessaging": "string",
  "description": "string",
  "failureRecommendations": [
    "string"
  ],
  "guardrailArn": "string",
  "guardrailId": "string",
  "kmsKeyArn": "string",
  "name": "string",
  "status": "string",
  "statusReasons": [
    "string"
  ],
  "updatedAt": "string",
  "version": "string"
}

가드레일에 관한 정보를 나열하려면 ListGuardrails 요청을 전송합니다.

요청 형식은 다음과 같습니다.

GET /guardrails?guardrailIdentifier=guardrailIdentifier&maxResults=maxResults&nextToken=nextToken HTTP/1.1

  • 모든 가드레일의 DRAFT 버전을 나열하려면 guardrailIdentifier 필드를 지정하지 마세요.

  • 가드레일의 모든 버전을 나열하려면 guardrailIdentifier 필드에 가드레일의 ARN을 지정합니다.

응답으로 반환할 최대 결과 수를 maxResults 필드에 설정할 수 있습니다. 설정한 수보다 많은 결과가 있는 경우 응답에서 nextToken이 반환되며, 이를 다른 ListGuardrails 요청으로 전송하여 다음 결과 배치를 확인할 수 있습니다.

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

HTTP/1.1 200
Content-type: application/json

{
   "guardrails": [ 
      { 
         "arn": "string",
         "createdAt": "string",
         "description": "string",
         "id": "string",
         "name": "string",
         "status": "string",
         "updatedAt": "string",
         "version": "string"
      }
   ],
   "nextToken": "string"
}