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

# Amazon Rekognition의 인적 루프 활성화 조건 JSON 스키마 사용
<a name="a2i-json-humantaskactivationconditions-rekognition-example"></a>

Amazon A2I와 함께 사용하면 Amazon Rekognition `DetectModerationLabels` 작업은 `ConditionType` 파라미터에서 다음과 같은 입력을 지원합니다.
+ `ModerationLabelConfidenceCheck` – 하나 이상의 지정된 레이블에 대해 추론 신뢰도가 낮을 때 인적 루프를 생성하려면 이 조건 유형을 사용합니다.
+ `Sampling` – 모든 추론 중 인적 검토를 위해 전송할 비율을 지정하려면 이 조건을 사용합니다. 이 조건을 사용하여 다음을 수행합니다.
  + 모델의 모든 추론을 무작위로 샘플링하고 인적 검토를 위해 지정된 비율을 전송하여 ML 모델을 감사합니다.
  + `ModerationLabelConfidenceCheck` 조건을 사용하여 `ModerationLabelConfidenceCheck`에 지정된 조건을 충족하는 일정 비율의 추론을 무작위로 샘플링하여 인적 루프를 시작하고 지정된 비율만 검토를 위해 인적 작업자에게 전송합니다.

**참고**  
동일한 요청을 `DetectModerationLabels`로 여러 번 전송해도 해당 입력의 추론에 대한 `Sampling`의 결과는 변경되지 않습니다. 예를 들어, `DetectModerationLabels`를 한 번 요청했는데 `Sampling`이 인적 루프를 시작하지 않으면 이후 동일한 구성으로 `DetectModerationLabels`를 요청해도 인적 루프가 시작되지 않습니다.

흐름 정의를 만들 때 Amazon SageMaker AI 콘솔의 **인적 검토 워크플로** 섹션에서 제공되는 기본 작업자 태스크 템플릿을 사용하면, 작업자가 해당 작업을 열 때 이 활성화 조건에 따라 사람이 검토하도록 전송된 추론이 작업자 UI에 포함됩니다. 사용자 지정 작업자 작업 템플릿을 사용하는 경우 이러한 추론에 액세스하려면 `<task.input.selectedAiServiceResponse.blocks>` 사용자 지정 HTML 요소를 포함해야 합니다. 이 HTML 요소를 사용하는 사용자 지정 템플릿의 예제는 [Amazon Rekognition에 사용되는 사용자 지정 템플릿 예제](a2i-custom-templates.md#a2i-custom-templates-rekognition-sample) 섹션을 참조하세요.

## `ModerationLabelConfidenceCheck` 입력
<a name="a2i-rek-moderationlabelconfidencecheck"></a>

`ModerationLabelConfidenceCheck` `ConditionType`에 대해 다음 `ConditionParameters`가 지원됩니다.
+ `ModerationLabelName` – Amazon Rekognition `DetectModerationLabels` 작업에서 탐지된 [중재라벨의](https://docs.aws.amazon.com/rekognition/latest/dg/API_ModerationLabel.html) 정확한 이름(대소문자 구분). 중재 레이블을 나타내는 특수 catch-all 값(\*)을 지정할 수 있습니다.
+ `ConfidenceEquals`
+ `ConfidenceLessThan`
+ `ConfidenceLessThanEquals`
+ `ConfidenceGreaterThan`
+ `ConfidenceGreaterThanEquals`

`ModerationLabelConfidenceCheck` `ConditionType`을 사용하면 Amazon A2I는 `ModerationLabelName`에서 지정한 레이블에 대한 레이블 추론을 인적 검토를 위해 전송합니다.

## Sampling 입력
<a name="a2i-rek-randomsamplingpercentage"></a>

`Sampling` `ConditionType`은 `RandomSamplingPercentage` `ConditionParameters`를 지원합니다. `RandomSamplingPercentage` 파라미터에는 0.01\~100 사이의 실수만 입력해야 합니다. 이 숫자는 인적 검토 조건을 충족하여 인적 검토를 위해 전송할 추론의 비율을 나타냅니다. 다른 조건 없이 `Sampling` 조건을 사용하면 이 숫자는 단일 `DetectModerationLabel` 요청에 의한 모든 결과 추론 중 인적 검토를 위해 전송할 비율을 나타냅니다.

## 예제
<a name="a2i-json-rek-activation-condition-examples"></a>

**예 1: `And` 연산자가 있는 `ModerationLabelConfidenceCheck` 사용**

다음 `HumanLoopActivationConditions` 조건의 예제는 다음 조건 중 하나 이상을 충족하면 인적 루프를 시작합니다.
+ Amazon Rekognition은 신뢰도가 90에서 99 사이인 `Graphic Male Nudity` 조절 레이블을 감지합니다.
+ Amazon Rekognition은 신뢰도가 80에서 99 사이인 `Graphic Female Nudity` 조절 레이블을 감지합니다.

`Or` 및 `And` 논리 연산자의 용도는 이 논리를 모델링하는 것입니다.

`Or` 연산자 아래의 두 조건 중 하나만 `true`로 평가해도 인적 루프를 생성할 수 있지만 Amazon Augmented AI는 모든 조건을 평가합니다. 인적 검토자에게 `true`로 평가된 모든 조건에 대한 조절 레이블을 검토하도록 요청이 됩니다.

```
{
     "Conditions": [{
         "Or": [{
                 "And": [{
                         "ConditionType": "ModerationLabelConfidenceCheck",
                         "ConditionParameters": {
                             "ModerationLabelName": "Graphic Male Nudity",
                             "ConfidenceLessThanEquals": 99
                         }
                     },
                     {
                         "ConditionType": "ModerationLabelConfidenceCheck",
                         "ConditionParameters": {
                             "ModerationLabelName": "Graphic Male Nudity",
                             "ConfidenceGreaterThanEquals": 90
                         }
                     }
                 ]
             },
             {
                 "And": [{
                         "ConditionType": "ModerationLabelConfidenceCheck",
                         "ConditionParameters": {
                             "ModerationLabelName": "Graphic Female Nudity",
                             "ConfidenceLessThanEquals": 99
                         }
                     },
                     {
                         "ConditionType": "ModerationLabelConfidenceCheck",
                         "ConditionParameters": {
                             "ModerationLabelName": "Graphic Female Nudity",
                             "ConfidenceGreaterThanEquals": 80
                         }
                     }
                 ]
             }
         ]
     }]
}
```

**예 2: 포괄 값(\*)과 함께 `ModerationLabelConfidenceCheck` 사용**

다음 예제에서는 신뢰도가 75 이상인 조절 레이블이 감지되면 인적 루프가 시작됩니다. 인적 검토자는 신뢰도 점수가 75 이상인 모든 중재 레이블을 검토해야 합니다.

```
{
    "Conditions": [
        {
            "ConditionType": "ModerationLabelConfidenceCheck",
            "ConditionParameters": {
                "ModerationLabelName": "*",
                "ConfidenceGreaterThanEquals": 75
            }
        }
    ]
}
```

**예제 3: Sampling 사용**

다음 예에서는 `DetectModerationLabels` 요청으로 인한 Amazon Rekognition 추론 중 5%가 인적 작업자에게 전송됩니다. SageMaker AI 콘솔에 제공된 기본 작업자 태스크 템플릿을 사용하는 경우 Amazon Rekognition에서 반환한 모든 조절 레이블이 작업자 검토를 위해 전송됩니다.

```
{
  "Conditions": [
    {
      "ConditionType": "Sampling",
      "ConditionParameters": {
        "RandomSamplingPercentage": 5
      }
    }
  ]
}
```

**예 4: 샘플링 및 `And` 연산자가 있는 `ModerationLabelConfidenceCheck` 사용**

이 예에서는 `Graphic Male Nudity` 조절 레이블이 신뢰도가 50을 초과하면 Amazon Rekognition 추론 중 5%가 작업자 검토를 위해 전송됩니다. SageMaker AI 콘솔에 제공된 기본 작업자 태스크 템플릿을 사용하는 경우 `Graphic Male Nudity` 레이블의 추론만 작업자 검토를 위해 전송됩니다.

```
{
  "Conditions": [
    {
      "And": [
        {
          "ConditionType": "Sampling",
          "ConditionParameters": {
            "RandomSamplingPercentage": 5
          }
        },
        {
          "ConditionType": "ModerationLabelConfidenceCheck",
          "ConditionParameters": {
            "ModerationLabelName": "Graphic Male Nudity",
            "ConfidenceGreaterThan": 50
          }
        }
      ]
    }
  ]
}
```

**예 5: 샘플링 및 `And` 연산자가 있는 `ModerationLabelConfidenceCheck` 사용**

이 예제를 사용하여 지정된 레이블 중 낮은 신뢰도 추론을 항상 인적 검토를 위해 전송하고, 레이블 중 높은 신뢰도 추론을 지정된 비율만큼 샘플링하도록 인적 검토 워크플로를 구성합니다.

다음 예제에서는 인적 검토가 다음 방법 중 하나로 시작됩니다.
+ `Graphic Male Nudity` 중재 레이블에 대한 추론 중 신뢰도 점수가 60 미만인 경우 항상 인적 검토를 위해 전송됩니다. `Graphic Male Nudity` 레이블만 검토를 위해 작업자에게 전송됩니다.
+ 신뢰도 점수가 90을 초과하면 `Graphic Male Nudity` 조절 레이블에 대한 모든 추론 중 5%가 항상 인적 검토를 위해 전송됩니다. `Graphic Male Nudity` 레이블만 검토를 위해 작업자에게 전송됩니다.

```
{
  "Conditions": [
    {
      "Or": [
        {
          "ConditionType": "ModerationLabelConfidenceCheck",
          "ConditionParameters": {
            "ModerationLabelName": "Graphic Male Nudity",
            "ConfidenceLessThan": 60
          }
        },
        {
            "And": [
                {
                    "ConditionType": "Sampling",
                    "ConditionParameters": {
                        "RandomSamplingPercentage": 5
                    }
                },
                {
                    "ConditionType": "ModerationLabelConfidenceCheck",
                    "ConditionParameters": {
                        "ModerationLabelName": "Graphic Male Nudity",
                        "ConfidenceGreaterThan": 90
                    }
                }
            ]
        }
      ]
    }
  ]
}
```

**예 6: 샘플링 및 `Or` 연산자가 있는 `ModerationLabelConfidenceCheck` 사용**

다음 예제에서는 Amazon Rekognition 추론 응답에 추론 신뢰도가 50을 초과하는 'Graphic Male Nudity' 레이블이 포함되면 인적 루프가 생성됩니다. 또한 다른 모든 추론 중 5%가 인적 루프를 시작합니다.

```
{
  "Conditions": [
    {
      "Or": [
        {
          "ConditionType": "Sampling",
          "ConditionParameters": {
            "RandomSamplingPercentage": 5
          }
        },
        {
          "ConditionType": "ModerationLabelConfidenceCheck",
          "ConditionParameters": {
            "ModerationLabelName": "Graphic Male Nudity",
            "ConfidenceGreaterThan": 50
          }
        }
      ]
    }
  ]
}
```