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

# ヒューマンレビューワークフローを作成する (API)
<a name="a2i-textract-create-flow-definition-api"></a>

ヒューマンレビューワークフローを作成するには、*フロー定義*、Amazon A2I を使用して、[https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateFlowDefinition.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateFlowDefinition.html)オペレーション.

この例では、Amazon S3 で独自のドキュメントを使用するか、ダウンロードすることができます。[このサンプルドキュメント](https://d2908q01vomqb2.cloudfront.net/f1f836cb4ea6efb2a0b1b99f41ad8b103eff4b59/2020/04/17/sample-document-final.png)S3 バケットに保存します。

Amazon S3 バケットが同じであることを確認してください。AWS電話に使用するリージョン`AnalyzeDocument`。バケットを作成するには、「」の手順に従います。[バケットの作成](https://docs.aws.amazon.com/AmazonS3/latest/user-guide/create-bucket.html)の*Amazon Simple Storage Service Console*。

**前提条件**

Amazon A2I API を使用してヒューマンレビューワークフローを作成するには、次の前提条件を満たす必要があります。
+ Amazon A2I と Amazon Textract API オペレーションの両方を呼び出す権限を持つ IAM ロールを設定します。開始するには、AWS ポリシー、AmazonAugmentedAIFullAccess、および AmazonTextractFullAccess を IAM ロールにアタッチできます。後で必要になるため、IAM ロールの Amazon リソースネーム (ARN) を記録します。

  Amazon Textract を使用する際の詳細な権限については、「」を参照してください。[Amazon Textract のアイデンティティベースのポリシーの例](security_iam_id-based-policy-examples.md)。Amazon A2I については、[Amazon Augmented AI におけるアクセス許可とセキュリティ](https://docs.aws.amazon.com/sagemaker/latest/dg/a2i-permissions-security.html)の*Amazon SageMaker 開発者ガイド*。
+ プライベートワークチームを作成し、ワークチーム ARN を記録します。Amazon A2I を初めて使用する方は、の手順に従います。[ステップ 1: 作業チームの作成 (コンソール)](a2i-textract-create-flow-definition-console.md#a2i-textract-create-flow-definition-workteam)。
+ ワーカータスクテンプレートを作成します。「」の指示に従って、[ワーカータスクテンプレートを作成する](https://docs.aws.amazon.com/sagemaker/latest/dg/a2i-worker-template-console.html#a2i-create-worker-template-console)をクリックして、Amazon A2I コンソールを使用してテンプレートを作成します。テンプレートを作成するときは、**テキスト形式の抽出**にとって**テンプレートタイプ**。テンプレートで、`s3_arn`ドキュメントの Amazon S3 ARN を使用します。での作業者の指示の追加`<full-instructions header="Instructions"></full-instructions>`。

  テンプレートをプレビューする場合は、「」で説明されている権限が IAM ロールに付与されていることを確認してください。[ワーカータスクテンプレートプレビューを有効にする](https://docs.aws.amazon.com/sagemaker/latest/dg/a2i-permissions-security.html#permissions-for-worker-task-templates-augmented-ai)。

  テンプレートを作成したら、ワーカータスクテンプレート ARN を記録します。

「」で作成したリソースを使用します。**前提条件**を設定するには`CreateFlowDefinition`リクエスト. このリクエストでは、JSON 形式でアクティベーション条件も指定します。アクティベーション条件を構成する方法については、「」を参照してください。[Amazon Textract でヒューマンループアクティブ化条件 JSON スキーマの使用](https://docs.aws.amazon.com/sagemaker/latest/dg/a2i-json-humantaskactivationconditions-textract-example.html)。

## ヒューマンレビューワークフローの作成 (AWS SDK for Python (Boto3)))
<a name="a2i-textract-create-flow-definition-api-example"></a>

この例を使用するには、{{red}}仕様とリソースを含むテキスト。

まず、次のコードを使用して、アクティベーション条件を JSON オブジェクトにエンコードします。これにより、Amazon Textract が 99 未満の信頼スコアが返された場合、人間のレビューがトリガーされます。*メールアドレス*およびその値、またはドキュメント内で検出されたキーと値のペアについて 90 未満の信頼スコアを返す場合。この例で提供されているサンプルドキュメントを使用している場合、これらのアクティベーション条件によってヒューマンレビュータスクが作成されます。

```
import json

humanLoopActivationConditions = json.dumps({{"{
                "Conditions": [
                    {
                        "ConditionType": "ImportantFormKeyConfidenceCheck",
                        "ConditionParameters": {
                            "ImportantFormKey": "Mail Address",
                            "KeyValueBlockConfidenceLessThan": 99,
                            "WordBlockConfidenceLessThan": 99
                        }
                    },
                    {
                        "ConditionType": "ImportantFormKeyConfidenceCheck",
                        "ConditionParameters": {
                            "ImportantFormKey": "*",
                            "KeyValueBlockConfidenceLessThan": 90,
                            "WordBlockConfidenceLessThan": 90
                        }
                    }
                ]
            }"}}
)
```

を使用する`humanLoopActivationConditions`を構成するには`create_flow_definition`リクエスト. 次の例では、SDK for Python (Boto3) を使用して[https://docs.aws.amazon.com/goto/boto3/sagemaker-2017-07-24/CreateFlowDefinition](https://docs.aws.amazon.com/goto/boto3/sagemaker-2017-07-24/CreateFlowDefinition)us-west-2 AWS リージョン内。プライベートワークチームの使用を指定します。

```
response = client.create_flow_definition(
    FlowDefinitionName='string',
    HumanLoopRequestSource={
         'AwsManagedHumanLoopRequestSource': {{"AWS/Textract/AnalyzeDocument/Forms/V1"}}
    }, 
    HumanLoopActivationConfig={
        'HumanLoopActivationConditionsConfig': {
            'HumanLoopActivationConditions': humanLoopActivationConditions
        }
    },
    HumanLoopConfig={
        'WorkteamArn': "arn:aws:sagemaker:{{us-west-2}}:{{111122223333}}:workteam/{{private-crowd}}/{{work-team-name}}",
        'HumanTaskUiArn': "arn:aws:sagemaker:{{us-west-2}}:{{111122223333}}:human-task-ui/{{worker-task-template-name}}",
        'TaskTitle': {{"Add a task title"}},
        'TaskDescription': {{"Describe your task"}},
        'TaskCount': {{1}},
        'TaskAvailabilityLifetimeInSeconds': {{3600}},
        'TaskTimeLimitInSeconds': {{86400}},
        'TaskKeywords': [{{"Document Review"}}, {{"Content Review"}}]
        }
    },
    OutputConfig={
        'S3OutputPath': "s3://{{DOC-EXAMPLE-BUCKET/prefix/}}",
    },
    RoleArn="arn:aws:iam::{{111122223333}}:role/{{role-name}}"
)
```