Amazon Textract의 인적 루프 활성화 조건 JSON 스키마 사용 - Amazon SageMaker AI

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

Amazon Textract의 인적 루프 활성화 조건 JSON 스키마 사용

Amazon A2I와 함께 사용하면 AnalyzeDocument 작업은 ConditionType 파라미터에서 다음과 같은 입력을 지원합니다.

  • ImportantFormKeyConfidenceCheck - 추론 신뢰도가 문서 양식 키 및 단어 블록에 대해 지정된 범위 내에 있는 경우 인적 루프를 생성하려면 이 조건을 사용합니다. 양식 키는 입력과 연결된 문서의 모든 단어입니다. 입력을 값이라고 합니다. 양식 키와 값을 함께 사용하는 것을 키-값 페어라고 합니다. 단어 블록은 감지된 텍스트 블록 내부에서 Amazon Textract가 인식하는 단어를 말합니다. Amazon Textract 문서 블록에 대해 자세히 알아보려면 Amazon Textract 개발자 안내서의 문서 및 블록 객체를 참조하세요.

  • MissingImportantFormKey - Amazon Textract가 문서 내에서 키 또는 연결된 별칭을 식별하지 않은 경우 이 조건을 사용하여 인적 루프를 생성합니다.

  • Sampling - 추론 신뢰도 점수에 관계없이 인적 검토를 위해 전송할 양식 비율을 지정하려면 이 조건을 사용합니다. 이 조건을 사용하여 다음을 수행합니다.

    • 모델을 통해 분석된 모든 양식을 무작위로 샘플링하고 인적 검토를 위해 지정된 비율을 전송하여 ML 모델을 감사합니다.

    • ImportantFormKeyConfidenceCheck 조건을 사용하여 ImportantFormKeyConfidenceCheck에 지정된 조건을 충족하는 일정 비율의 추론을 무작위로 샘플링하여 인적 루프를 시작하고 지정된 비율만 검토를 위해 인적 작업자에게 전송합니다.

참고

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

ImportantFormKeyConfidenceCheck 입력 및 결과

ImportantFormKeyConfidenceCheck ConditionType은 다음 ConditionParameters를 지원합니다.

  • ImportantFormKey - Amazon Textract에서 감지된 키-값 페어의 키를 나타내는 문자열이며, 인적 작업자의 검토가 필요합니다. 이 파라미터의 값이 특수 catch-all 값(*)이면 모든 키가 해당 조건과 일치하는 것으로 간주됩니다. 이 값은 특정 신뢰도 임계값을 충족하는 키-값 페어에서 인적 검토가 필요한 경우를 모델링하는 데 사용할 수 있습니다.

  • ImportantFormKeyAliases - 중요한 양식 키에 대한 대체 철자 또는 논리적 등가물을 나타내는 배열입니다.

  • KeyValueBlockConfidenceEquals

  • KeyValueBlockConfidenceLessThan

  • KeyValueBlockConfidenceLessThanEquals

  • KeyValueBlockConfidenceGreaterThan

  • KeyValueBlockConfidenceGreaterThanEquals

  • WordBlockConfidenceEquals

  • WordBlockConfidenceLessThan

  • WordBlockConfidenceLessThanEquals

  • WordBlockConfidenceGreaterThan

  • WordBlockConfidenceGreaterThanEquals

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

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

MissingImportantFormKey 입력 및 결과

MissingImportantFormKey ConditionType은 다음 ConditionParameters를 지원합니다.

  • ImportantFormKey - Amazon Textract에서 감지된 키-값 페어의 키를 나타내는 문자열이며, 인적 작업자의 검토가 필요합니다.

  • ImportantFormKeyAliases - 중요한 양식 키에 대한 대체 철자 또는 논리적 등가물을 나타내는 배열입니다.

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

SageMaker AI 콘솔에 제공된 기본 작업자 작업 템플릿을 사용하는 경우 작업자에게의 키ImportantFormKey와 관련 값을 식별하도록 요청하는 작업이 생성됩니다. 사용자 지정 작업자 작업 템플릿을 사용하는 경우 이 작업을 구성하려면 <task.input.humanLoopContext> 사용자 지정 HTML 요소를 포함해야 합니다.

Sampling 입력 및 결과

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

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

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

예시

한 조건만 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 } } } ] } ] }