翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # Amazon Textract でヒューマンループのアクティベーション条件 JSON スキーマを使用する 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` へのリクエストを 1 回行って `Sampling` によってヒューマンループが開始されなかった場合、同じ設定で `AnalyzeDocument` に続けてリクエストを行ってもヒューマンループは開始されません。 ## `ImportantFormKeyConfidenceCheck` の入力と結果 `ImportantFormKeyConfidenceCheck` `ConditionType` では、以下の `ConditionParameters` がサポートされています。 + `ImportantFormKey` - Amazon Textract によって検出されるキーと値のペアのキーを表す文字列であり、人間のワーカーによるレビューが必要です。このパラメータの値が特別なキャッチオール値 (\*) の場合、すべてのキーは条件に一致していると見なされます。これを使用することにより、キーと値のペアが信頼度の特定のしきい値を超えた場合にヒューマンレビューを必要とする条件をモデル化できます。 + `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` の入力と結果 `MissingImportantFormKey` `ConditionType` では、以下の `ConditionParameters` がサポートされています。 + `ImportantFormKey` - Amazon Textract によって検出されるキーと値のペアのキーを表す文字列であり、人間のワーカーによるレビューが必要です。 + `ImportantFormKeyAliases` - 重要なフォームキーの代替スペルまたは論理的な同等を表す配列です。 `MissingImportantFormKey` `ConditionType` を使用する場合、`ImportantFormKey` または `ImportantFormKeyAliases` のエイリアスが Amazon Textract 推論に含まれていない場合、そのフォームは人間によるレビュー用に送られます。予測されたキーと値のペアは含められません。例えば、Amazon Textract によってフォーム内の `Address` および `Phone` のみが特定され、(`MissingImportantFormKey` 条件タイプ内で) `ImportantFormKey` `Name` が欠落していた場合、そのフォームは人間によるレビュー用に送られます。検出されたフォームキー (`Address` および `Phone`) は含められません。 SageMaker AI コンソールで提供されているデフォルトのワーカータスクテンプレートを使用する場合、`ImportantFormKey` のキーおよび関連する値を特定するようにワーカーに求めるタスクが作成されます。カスタムのワーカータスクテンプレートを使用する場合、このタスクを設定するにはカスタム HTML 要素の `` を含める必要があります。 ## サンプリングの入力と結果 `Sampling` `ConditionType` では、`RandomSamplingPercentage` `ConditionParameters` がサポートされています。`RandomSamplingPercentage` の入力は、0.01～100 の実数である必要があります。この数値は、人間によるレビューの対象となるデータの割合を表し、この割合が人間によるレビューに送られます。`Sampling` 条件をその他の条件を指定せずに使用する場合、この数値は 1 つのリクエストによって `AnalyzeDocument` オペレーションが行ったすべての推論に対する割合を表し、この割合が人間によるレビュー用に送られます。 その他の条件タイプを指定せずに `Sampling` 条件を指定すると、すべてのキーと値のペアとブロックの推論がレビューのためにワーカーに送られます。 フロー定義を作成するときに、SageMaker AI コンソールの **[人間によるレビューワークフロー]** セクションで提供されているデフォルトのワーカータスクテンプレートを使用する場合、このアクティベーション条件によって人間によるレビュー用に送られたすべてのキーと値およびブロック推論がワーカー UI に含まれます。カスタムのワーカータスクテンプレートを使用する場合、Amazon Textract の初期値入力データ (推論) を含めるために `{{ task.input.selectedAiServiceResponse.blocks }}` 要素を含める必要があります。この入力要素を使用するカスタムテンプレートの例については、「[Amazon Textract のカスタムテンプレートの例](a2i-custom-templates.md#a2i-custom-templates-textract-sample)」を参照してください。 ## 例 ヒューマンループを開始するために `true` と評価される必要がある条件は 1 つのみですが、Amazon A2I は Amazon Textract によって分析される各オブジェクトのすべての条件を評価します。人間によるレビュー担当者は、`true` と評価されたすべての条件の重要なフォームキーを確認するように求められます。 **例 1: ヒューマンループを開始する指定された範囲の信頼スコアを持つ重要なフォームキーを検出する** 次の 3 つの条件のいずれかが満たされた場合に、ヒューマンループを開始する `HumanLoopActivationConditions` JSON の例を以下に示します。 + Amazon Textract `AnalyzeDocument` API は、キーが `Employee Name`、`Name`、`EmployeeName` のいずれかであるキーと値のペアで、キーと値のブロックの信頼度が 60 未満であり、キーと値を構成する各単語ブロックの信頼度が 85 未満のものを返します。 + Amazon Textract `AnalyzeDocument` API は、キーが `Pay Date`、`PayDate`、`DateOfPay`、`pay-date` のいずれかであるキーと値のペアで、キーと値のブロックの信頼度が 65 未満であり、キーと値を構成する各単語ブロックの信頼度が 85 未満のものを返します。 + Amazon Textract `AnalyzeDocument` API は、キーが `Gross Pay`、`GrossPay`、`GrossAmount` のいずれかであるキーと値のペアで、キーと値のブロックの信頼度が 60 未満であり、キーと値を構成する各単語ブロックの信頼度が 85 未満のものを返します。 ``` { "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` オペレーターで使用する** この例では、指定したキーと値のペアの信頼度の低い推論は常にヒューマンレビューに送り、信頼度の高い推論は指定した割合でサンプリングするようにヒューマンレビューワークフローを設定します。 この例では、人間によるレビューは次のいずれかの方法で開始されます。 + 検出されたキーと値のペアのうち、キーが `Pay Date`、`PayDate`、`DateOfPay`、`pay-date` のいずれかであり、キーと値のブロックおよび単語ブロックの信頼度が 60 未満のものが人間によるレビューに送られます。`Pay Date` フォームキー (およびそのエイリアス) と関連する値のみが、レビューのためにワーカーに送られます。 + 検出されたキーと値のペアの 5% のうち、キーが `Pay Date`、`PayDate`、`DateOfPay`、`pay-date` のいずれかであり、キーと値のブロックおよび単語ブロックの信頼度が 90 より上のものが人間によるレビューに送られます。`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: サンプリングと `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 } } } ] } ] } ```