View a markdown version of this page

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

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

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

참고

Amazon SageMaker A2I는 더 이상 신규 고객에게 공개되지 않습니다. 기존 고객은 서비스를 정상적으로 계속 사용할 수 있습니다. AWS 는 계속해서 A2I의 보안 및 가용성 개선에 투자하지만 새로운 기능을 도입할 계획은 없습니다.

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에서 인적 검토를 위해 ImportantFormKey 및 ImportantFormKeyAliases에서 지정한 키-값 블록 및 연결된 별칭에 대한 키-값 블록과 단어 블록 추론을 전송합니다.

흐름 정의를 만들 때 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가 양식에서 Address 및 Phone을 식별하지만 ImportantFormKey Name(MissingImportantFormKey 조건 유형)이 누락된 경우 감지된 양식 키(Address 및 Phone) 없이 해당 양식이 검토를 위해 사람에게 전송됩니다.

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

Sampling 입력 및 결과

Sampling ConditionType은 RandomSamplingPercentage 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 } } } ] } ] }