翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Amazon Textract でヒューマンループのアクティベーション条件 JSON スキーマを使用する

Amazon A2I で使用する場合、AnalyzeDocument オペレーションでは、ConditionType パラメータで次の入力がサポートされます。

ImportantFormKeyConfidenceCheck の入力と結果

ImportantFormKeyConfidenceCheck ConditionType では、以下の ConditionParameters がサポートされています。

ImportantFormKeyConfidenceCheck ConditionType を使用すると、Amazon A2I によって、人間によるレビューのために ImportantFormKey と ImportantFormKeyAliases で指定されているキーと値のブロック、そのキーと値のブロックの単語ブロックの推論、関連付けられているエイリアスが送られます。

フロー定義を作成するときに、Amazon SageMaker AI コンソールの「ヒューマンレビューワークフロー」セクションで提供されているデフォルトのワーカータスクテンプレートを使用する場合、このアクティベーション条件によってヒューマンレビューのために送信されたキーと値の推論とブロック推論がワーカー UI に含まれます。カスタムのワーカータスクテンプレートを使用する場合、Amazon Textract の初期値入力データ (推論) を含めるために {{ task.input.selectedAiServiceResponse.blocks }} 要素を含める必要があります。この入力要素を使用するカスタムテンプレートの例については、「Amazon Textract のカスタムテンプレートの例」を参照してください。

MissingImportantFormKey の入力と結果

MissingImportantFormKey ConditionType では、以下の ConditionParameters がサポートされています。

MissingImportantFormKey ConditionType を使用する場合、ImportantFormKey または ImportantFormKeyAliases のエイリアスが Amazon Textract 推論に含まれていない場合、そのフォームは人間によるレビュー用に送られます。予測されたキーと値のペアは含められません。例えば、Amazon Textract によってフォーム内の Address および Phone のみが特定され、(MissingImportantFormKey 条件タイプ内で) ImportantFormKey Name が欠落していた場合、そのフォームは人間によるレビュー用に送られます。検出されたフォームキー (Address および Phone) は含められません。

SageMaker AI コンソールで提供されているデフォルトのワーカータスクテンプレートを使用する場合、 のキーImportantFormKeyと関連する値を識別するようにワーカーに求めるタスクが作成されます。カスタムのワーカータスクテンプレートを使用する場合、このタスクを設定するにはカスタム HTML 要素の <task.input.humanLoopContext> を含める必要があります。

サンプリングの入力と結果

Sampling ConditionType では、RandomSamplingPercentage ConditionParameters がサポートされています。RandomSamplingPercentage の入力は、0.01～100 の実数である必要があります。この数値は、人間によるレビューの対象となるデータの割合を表し、この割合が人間によるレビューに送られます。Sampling 条件をその他の条件を指定せずに使用する場合、この数値は 1 つのリクエストによって AnalyzeDocument オペレーションが行ったすべての推論に対する割合を表し、この割合が人間によるレビュー用に送られます。

その他の条件タイプを指定せずに Sampling 条件を指定すると、すべてのキーと値のペアとブロックの推論がレビューのためにワーカーに送られます。

フロー定義を作成するときに、SageMaker AI コンソールのヒューマンレビューワークフローセクションで提供されているデフォルトのワーカータスクテンプレートを使用する場合、このアクティベーション条件によってヒューマンレビューのために送信されたすべてのキーバリューとブロック推論がワーカー UI に含まれます。カスタムのワーカータスクテンプレートを使用する場合、Amazon Textract の初期値入力データ (推論) を含めるために {{ task.input.selectedAiServiceResponse.blocks }} 要素を含める必要があります。この入力要素を使用するカスタムテンプレートの例については、「Amazon Textract のカスタムテンプレートの例」を参照してください。

例

ヒューマンループを開始するために true と評価される必要がある条件は 1 つのみですが、Amazon A2I は Amazon Textract によって分析される各オブジェクトのすべての条件を評価します。人間によるレビュー担当者は、true と評価されたすべての条件の重要なフォームキーを確認するように求められます。

例 1: ヒューマンループを開始する指定された範囲の信頼スコアを持つ重要なフォームキーを検出する

次の 3 つの条件のいずれかが満たされた場合に、ヒューマンループを開始する HumanLoopActivationConditions JSON の例を以下に示します。

{
    "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: が欠落している場合に、人間によるレビューが開始されます。デフォルトのワーカータスクテンプレートを使用する場合、ワーカーは、キー Mailing Address か、Mailing Address: および関連する値を特定するように、ワーカー UI によって要求されます。

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

例 5: サンプリングと ImportantFormKeyConfidenceCheck を And オペレーターで使用する

この例では、Amazon Textract によって検出されたキーと値のペアの 5% のうち、キーが Pay Date、PayDate、DateOfPay、pay-date のいずれかであり、キーと値のブロックの信頼度が 65 未満で、キーと値を構成する各単語ブロックの信頼度が 85 未満のものがレビュー用にワーカーに送られます。

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

例 6: サンプリングと ImportantFormKeyConfidenceCheck を And オペレーターで使用する

この例では、指定したキーと値のペアの信頼度の低い推論は常にヒューマンレビューに送り、信頼度の高い推論は指定した割合でサンプリングするようにヒューマンレビューワークフローを設定します。

この例では、人間によるレビューは次のいずれかの方法で開始されます。

{
  "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: サンプリングと ImportantFormKeyConfidenceCheck を Or オペレーターで使用する

次の例では、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
            }
          }
        }
      ]
    }
  ]
}