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

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

Amazon A2I와 함께 사용하면 `AnalyzeDocument` 작업은 `ConditionType` 파라미터에서 다음과 같은 입력을 지원합니다.
+ `ImportantFormKeyConfidenceCheck` - 추론 신뢰도가 문서 양식 키 및 단어 블록에 대해 지정된 범위 내에 있는 경우 인적 루프를 생성하려면 이 조건을 사용합니다. 양식 키는 입력과 연결된 문서의 모든 단어입니다.** 입력을 값이라고 합니다.** 양식 키와 값을 함께 사용하는 것을 키-값 페어라고 합니다.** 단어 블록은 감지된 텍스트 블록 내부에서 Amazon Textract가 인식하는 단어를 말합니다.** Amazon Textract 문서 블록에 대해 자세히 알아보려면 Amazon Textract 개발자 안내서의 [문서 및 블록 객체를](https://docs.aws.amazon.com/textract/latest/dg/how-it-works-document-layout.html) 참조하세요.**
+ `MissingImportantFormKey` - Amazon Textract가 문서 내에서 키 또는 연결된 별칭을 식별하지 않은 경우 이 조건을 사용하여 인적 루프를 생성합니다.
+ `Sampling` - 추론 신뢰도 점수에 관계없이 인적 검토를 위해 전송할 양식 비율을 지정하려면 이 조건을 사용합니다. 이 조건을 사용하여 다음을 수행합니다.
  + 모델을 통해 분석된 모든 양식을 무작위로 샘플링하고 인적 검토를 위해 지정된 비율을 전송하여 ML 모델을 감사합니다.
  + `ImportantFormKeyConfidenceCheck` 조건을 사용하여 `ImportantFormKeyConfidenceCheck`에 지정된 조건을 충족하는 일정 비율의 추론을 무작위로 샘플링하여 인적 루프를 시작하고 지정된 비율만 검토를 위해 인적 작업자에게 전송합니다.

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

## `ImportantFormKeyConfidenceCheck` 입력 및 결과
<a name="a2i-textract-importantformkeycofidencecheck"></a>

`ImportantFormKeyConfidenceCheck` `ConditionType`은 다음 `ConditionParameters`를 지원합니다.
+ `ImportantFormKey` - Amazon Textract에서 감지된 키-값 페어의 키를 나타내는 문자열이며, 인적 작업자의 검토가 필요합니다. 이 파라미터의 값이 특수 catch-all 값(\*)이면 모든 키가 해당 조건과 일치하는 것으로 간주됩니다. 이 값은 특정 신뢰도 임계값을 충족하는 키-값 페어에서 인적 검토가 필요한 경우를 모델링하는 데 사용할 수 있습니다.
+ `ImportantFormKeyAliases` - 중요한 양식 키에 대한 대체 철자 또는 논리적 등가물을 나타내는 배열입니다.
+ `KeyValueBlockConfidenceEquals`
+ `KeyValueBlockConfidenceLessThan`
+ `KeyValueBlockConfidenceLessThanEquals`
+ `KeyValueBlockConfidenceGreaterThan`
+ `KeyValueBlockConfidenceGreaterThanEquals`
+ `WordBlockConfidenceEquals`
+ `WordBlockConfidenceLessThan`
+ `WordBlockConfidenceLessThanEquals`
+ `WordBlockConfidenceGreaterThan`
+ `WordBlockConfidenceGreaterThanEquals`

`ImportantFormKeyConfidenceCheck` `ConditionType`을 사용하면 Amazon A2I에서 인적 검토를 위해 `ImportantFormKey` 및 `ImportantFormKeyAliases`에서 지정한 키-값 블록 및 연결된 별칭에 대한 키-값 블록과 단어 블록 추론을 전송합니다.

흐름 정의를 만들 때 Amazon SageMaker AI 콘솔의 **인적 검토 워크플로** 섹션에서 제공되는 기본 작업자 태스크 템플릿을 사용하면 이 활성화 조건에 따라 사람이 검토하도록 전송된 키-값 및 블록 추론이 작업자 UI에 포함됩니다. 사용자 지정 작업자 태스크 템플릿을 사용하는 경우 Amazon Textract의 초기 값 입력 데이터(추론)를 포함하려면 `{{ task.input.selectedAiServiceResponse.blocks }}` 요소를 포함해야 합니다. 이 입력 요소를 사용하는 사용자 지정 템플릿의 예제는 [Amazon Textract에 사용되는 사용자 지정 템플릿 예제](a2i-custom-templates.md#a2i-custom-templates-textract-sample) 섹션을 참조하세요.

## `MissingImportantFormKey` 입력 및 결과
<a name="a2i-textract-missingimportantformkey"></a>

`MissingImportantFormKey` `ConditionType`은 다음 `ConditionParameters`를 지원합니다.
+ `ImportantFormKey` - Amazon Textract에서 감지된 키-값 페어의 키를 나타내는 문자열이며, 인적 작업자의 검토가 필요합니다.
+ `ImportantFormKeyAliases` - 중요한 양식 키에 대한 대체 철자 또는 논리적 등가물을 나타내는 배열입니다.

`MissingImportantFormKey` `ConditionType`을 사용할 때 `ImportantFormKey`의 키 또는 `ImportantFormKeyAliases`의 별칭이 Amazon Textract 추론에 포함되지 않은 경우 해당 양식이 검토를 위해 사람에게 전송되고 예측된 키-값 페어는 포함되지 않습니다. 예를 들어 Amazon Textract가 양식에서 `Address` 및 `Phone`을 식별하지만 `ImportantFormKey` `Name`(`MissingImportantFormKey` 조건 유형)이 누락된 경우 감지된 양식 키(`Address` 및 `Phone`) 없이 해당 양식이 검토를 위해 사람에게 전송됩니다.

SageMaker AI 콘솔에 제공되는 기본 작업자 태스크 템플릿을 사용하는 경우 작업자가 `ImportantFormKey`의 키 및 연결된 값을 식별하도록 요청하는 작업이 만들어집니다. 사용자 지정 작업자 작업 템플릿을 사용하는 경우 이 작업을 구성하려면 `<task.input.humanLoopContext>` 사용자 지정 HTML 요소를 포함해야 합니다.

## Sampling 입력 및 결과
<a name="a2i-textract-randomsamplingpercentage"></a>

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

다른 조건 유형 없이 `Sampling` 조건을 지정하면 모든 키-값 및 블록 추론이 작업자 검토를 위해 전송됩니다.

흐름 정의를 만들 때 SageMaker AI 콘솔의 **인적 검토 워크플로** 섹션에서 제공되는 기본 작업자 태스크 템플릿을 사용하면 이 활성화 조건에 따라 사람이 검토하도록 전송된 모든 키-값 및 블록 추론이 작업자 UI에 포함됩니다. 사용자 지정 작업자 태스크 템플릿을 사용하는 경우 Amazon Textract의 초기 값 입력 데이터(추론)를 포함하려면 `{{ task.input.selectedAiServiceResponse.blocks }}` 요소를 포함해야 합니다. 이 입력 요소를 사용하는 사용자 지정 템플릿의 예제는 [Amazon Textract에 사용되는 사용자 지정 템플릿 예제](a2i-custom-templates.md#a2i-custom-templates-textract-sample) 섹션을 참조하세요.

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

한 조건만 `true`로 평가되어도 인적 루프가 시작되지만, Amazon A2I에서는 Amazon Textract에서 분석된 각 객체에 대해 모든 조건을 평가합니다. 인적 검토자에게 `true`로 평가된 모든 조건에 대해 중요한 양식 키를 검토하도록 요청이 됩니다.

**예제 1: 신뢰도 점수가 인적 루프를 시작하는 지정된 범위 내에 있는 중요 양식 키 감지**

아래는 다음 세 가지 조건 중 하나가 충족되는 경우 인적 루프를 시작하는 `HumanLoopActivationConditions` JSON의 예제입니다.
+ Amazon Textract `AnalyzeDocument` API는 키-값 블록의 신뢰도가 60 미만이고 키와 값을 구성하는 각 단어 블록의 신뢰도가 85 미만이며 키가 `Name`, `Employee Name` 또는 `EmployeeName` 중 하나인 키-값 페어를 반환합니다.
+ Amazon Textract `AnalyzeDocument` API는 키-값 블록의 신뢰도가 65 미만이고 키와 값을 구성하는 각 단어 블록의 신뢰도가 85 미만이며 키가 `Pay Date`, `PayDate`, `DateOfPay`, 또는 `pay-date` 중 하나인 키-값 페어를 반환합니다.
+ Amazon Textract `AnalyzeDocument` API는 키-값 블록의 신뢰도가 60 미만이고 키와 값을 구성하는 각 단어 블록의 신뢰도가 85 미만이며 키가 `GrossPay`, `Gross Pay` 또는 `GrossAmount` 중 하나인 키-값 페어를 반환합니다.

```
{
    "Conditions": [
        {
            "ConditionType": "ImportantFormKeyConfidenceCheck",
            "ConditionParameters": {
                "ImportantFormKey": {{"Employee Name"}},
                "ImportantFormKeyAliases": [
                    {{"Name"}},
                   {{ "EmployeeName"}}
                ],
                "KeyValueBlockConfidenceLessThan": 60,
                "WordBlockConfidenceLessThan": 85
            }
        },
        {
            "ConditionType": "ImportantFormKeyConfidenceCheck",
            "ConditionParameters": {
                "ImportantFormKey": "Pay Date",
                "ImportantFormKeyAliases": [
                    "PayDate",
                    "DateOfPay",
                    "pay-date"
                ],
                "KeyValueBlockConfidenceLessThan": 65,
                "WordBlockConfidenceLessThan": 85
            }
        },
        {
            "ConditionType": "ImportantFormKeyConfidenceCheck",
            "ConditionParameters": {
                "ImportantFormKey": "Gross Pay",
                "ImportantFormKeyAliases": [
                    "GrossPay",
                    "GrossAmount"
                ],
                "KeyValueBlockConfidenceLessThan": 60,
                "WordBlockConfidenceLessThan": 85
            }
        }
    ]
}
```

**예제 2: `ImportantFormKeyConfidenceCheck` 사용**

다음 예제에서는 Amazon Textract에서 키-값 블록에 대한 신뢰도가 60 미만이고 기본 단어 블록에 대한 신뢰도가 90 미만인 키-값 페어를 감지하면 인적 루프가 생성됩니다. 사람인 검토자에게 신뢰도 값 비교와 일치한 모든 양식 키-값 페어를 검토하라는 메시지가 나타납니다.

```
{
    "Conditions": [
        {
            "ConditionType": "ImportantFormKeyConfidenceCheck",
            "ConditionParameters": {
                "ImportantFormKey": "*",
                "KeyValueBlockConfidenceLessThan": 60,
                "WordBlockConfidenceLessThan": 90
            }
        }
    ]
}
```

**예제 3: Sampling 사용**

다음 예제에서는 Amazon Textract `AnalyzeDocument` 요청으로 인한 추론 중 5%가 인적 작업자에게 검토를 위해 전송됩니다. Amazon Textract에서 반환된 모든 감지된 키-값 페어가 작업자 검토를 위해 전송됩니다.

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

**예제 4: `MissingImportantFormKey` 사용**

다음 예제에서는 Amazon Textract에서 감지된 키에 `Mailing Address` 또는 그 별칭 `Mailing Address:`가 누락될 경우 인적 검토가 시작됩니다. 기본 작업자 작업 템플릿을 사용하는 경우 작업자 UI에서 작업자에게 `Mailing Address` 또는 `Mailing Address:` 키 및 연결된 값을 식별하도록 요청합니다.

```
{
    "ConditionType": "MissingImportantFormKey",
    "ConditionParameters": {
        "ImportantFormKey": "Mailing Address",
        "ImportantFormKeyAliases": ["Mailing Address:"]
    }
}
```

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

이 예제에서는 키가 `Pay Date`, `PayDate`, `DateOfPay`, 또는 `pay-date` 중 하나이고 키 값 블록의 신뢰도가 65 미만이며 키와 값을 구성하는 각 단어 블록의 신뢰도가 85 미만이면 Amazon Textract에서 감지된 키-값 페어 중 5%가 검토를 위해 작업자에게 전송됩니다.

```
{
  "Conditions": [
    {
      "And": [
        {
          "ConditionType": "Sampling",
          "ConditionParameters": {
            "RandomSamplingPercentage": 5
          }
        },
        {
          "ConditionType": "ImportantFormKeyConfidenceCheck",
            "ConditionParameters": {
                "ImportantFormKey": "Pay Date",
                "ImportantFormKeyAliases": [
                    "PayDate",
                    "DateOfPay",
                    "pay-date"
                ],
                "KeyValueBlockConfidenceLessThan": 65,
                "WordBlockConfidenceLessThan": 85
            }
        }
      ]
    }
  ]
}
```

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

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

다음 예제에서는 인적 검토가 다음 방법 중 하나로 시작됩니다.
+ 키-값 페어에서 키가 `Pay Date`, `PayDate`, `DateOfPay` 또는 `pay-date` 중 하나이고, 키-값 및 단어 블록 신뢰도가 60 미만으로 감지되면 인적 검토를 위해 전송됩니다. `Pay Date` 양식 키(및 해당 별칭) 및 연결된 값만 검토를 위해 작업자에게 전송됩니다.
+ 키가 `Pay Date`, `PayDate`, `DateOfPay` 또는 `pay-date` 중 하나이고, 키-값 및 단어 블록 신뢰도가 90을 초과하면 감지된 키-값 페어 중 5%가 인적 검토를 위해 전송됩니다. `Pay Date` 양식 키(및 해당 별칭) 및 연결된 값만 검토를 위해 작업자에게 전송됩니다.

```
{
  "Conditions": [
    {
      "Or": [
       {
          "ConditionType": "ImportantFormKeyConfidenceCheck",
            "ConditionParameters": {
                "ImportantFormKey": "Pay Date",
                "ImportantFormKeyAliases": [
                    "PayDate",
                    "DateOfPay",
                    "pay-date"
                ],
                "KeyValueBlockConfidenceLessThan": 60,
                "WordBlockConfidenceLessThan": 60
            }
        },
        {
            "And": [
                {
                    "ConditionType": "Sampling",
                    "ConditionParameters": {
                        "RandomSamplingPercentage": 5
                    }
                },
                {
                    "ConditionType": "ImportantFormKeyConfidenceCheck",
                        "ConditionParameters": {
                            "ImportantFormKey": "Pay Date",
                            "ImportantFormKeyAliases": [
                                "PayDate",
                                "DateOfPay",
                                "pay-date"
                        ],
                        "KeyValueBlockConfidenceLessThan": 90
                        "WordBlockConfidenceGreaterThan": 90
                    }
                }
            ]
        }
      ]
    }
  ]
}
```

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

다음 예제에서 Amazon Textract `AnalyzeDocument` 작업은 키가 `Pay Date`, `PayDate`, `DateOfPay` 또는 `pay-date` 중 하나이고, 키-값 블록의 신뢰도가 65 미만이고, 키와 값을 구성하는 각 단어 블록의 신뢰도가 85 미만인 키-값 페어를 반환합니다. 또한 다른 모든 양식 중 5%가 인적 루프를 시작합니다. 무작위로 선택한 각 양식에 대해 해당 양식에 대해 감지된 모든 키-값 페어가 검토를 위해 사람에게 전송됩니다.

```
{
  "Conditions": [
    {
      "Or": [
        {
          "ConditionType": "Sampling",
          "ConditionParameters": {
            "RandomSamplingPercentage": 5
          }
        },
        {
           "ConditionType": "ImportantFormKeyConfidenceCheck",
            "ConditionParameters": {
                "ImportantFormKey": "Pay Date",
                "ImportantFormKeyAliases": [
                    "PayDate",
                    "DateOfPay",
                    "pay-date"
                ],
                "KeyValueBlockConfidenceLessThan": 65,
                "WordBlockConfidenceLessThan": 85
            }
          }
        }
      ]
    }
  ]
}
```