As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Criar um fluxo de trabalho de revisão humana (API)
<a name="a2i-textract-create-flow-definition-api"></a>

É possível criar um fluxo de trabalho de revisão humana ou um*Definição de fluxo*, usando o Amazon A2I,[https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateFlowDefinition.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateFlowDefinition.html)operação. 

Para este exemplo, você pode usar seu próprio documento no Amazon S3 ou fazer o download[este exemplo de documento](https://d2908q01vomqb2.cloudfront.net/f1f836cb4ea6efb2a0b1b99f41ad8b103eff4b59/2020/04/17/sample-document-final.png)e armazene-o no seu bucket do S3.

Verifique se seu bucket do Amazon S3 está no mesmoAWSRegião que você planeja usar para ligar`AnalyzeDocument`. Para criar um bucket, siga as instruções em [Criar um bucket](https://docs.aws.amazon.com/AmazonS3/latest/user-guide/create-bucket.html) no *Guia do usuário do console do Amazon Simple Storage Service*.

**Pré-requisitos**

Para usar a API do Amazon A2I para criar um fluxo de trabalho de revisão humana, você deve preencher os seguintes pré-requisitos:
+ Configure uma função do IAM com permissão para chamar as operações de API do Amazon A2I e Amazon Textract. Para começar, você pode anexar as políticas da AWS, AmazonAugmentedAIFullAccess e AmazonTextractFullAccess a uma função do IAM. Registre a função do IAM Amazon Resources Name (ARN) porque você precisará dela mais tarde.

  Para obter permissões mais granulares ao usar o Amazon Textract, consulte[Exemplos de políticas baseadas em identidade do Amazon Textract](security_iam_id-based-policy-examples.md). Para o Amazon A2I, consulte[Permissões e segurança na Augmented AI da Amazon](https://docs.aws.amazon.com/sagemaker/latest/dg/a2i-permissions-security.html)no*Guia do desenvolvedor do Amazon SageMaker*.
+ Crie uma equipe de trabalho particular e registre o ARN da equipe de trabalho. Se você for um novo usuário do Amazon A2I, siga as instruções em[Etapa 1: Criar uma equipe de trabalho (Console)](a2i-textract-create-flow-definition-console.md#a2i-textract-create-flow-definition-workteam).
+ Crie um modelo de tarefa de operador. Siga as instruções em[Criar um modelo de tarefa de operador](https://docs.aws.amazon.com/sagemaker/latest/dg/a2i-worker-template-console.html#a2i-create-worker-template-console)para criar um modelo usando o console Amazon A2I. Quando você estiver criando o modelo, escolha**Extração em forma de texto**pelo**Tipo de modelo**. No modelo, substitua`s3_arn`com o ARN do Amazon S3 do documento. Adicione outras instruções do trabalhador em`<full-instructions header="Instructions"></full-instructions>`. 

  Se você quiser visualizar o modelo, verifique se a sua função do IAM tem as permissões descritas em[Habilitar visualizações do modelo de tarefa de operador](https://docs.aws.amazon.com/sagemaker/latest/dg/a2i-permissions-security.html#permissions-for-worker-task-templates-augmented-ai).

  Depois de criar seu modelo, registre o ARN do modelo de tarefa do trabalhador.

Usar recursos criados no**Pré-requisitos**Para configurar o`CreateFlowDefinition`solicitação. Nesta solicitação, você também especifica condições de ativação no formato JSON. Para saber como configurar suas condições de ativação, consulte[Usar o esquema JSON de condições de ativação de loop humano com o Amazon Textract](https://docs.aws.amazon.com/sagemaker/latest/dg/a2i-json-humantaskactivationconditions-textract-example.html).

## Criando um fluxo de trabalho de revisão humana (AWS SDK for Python (Boto3))
<a name="a2i-textract-create-flow-definition-api-example"></a>

Para usar esse exemplo, substitua a{{vermelho}}Texto com suas especificações e recursos.

Primeiro, codifique suas condições de ativação em um objeto JSON usando o código a seguir. Isso aciona uma avaliação humana se o Amazon Textract retornar uma pontuação de confiança menor que 99 para*Endereço de correio*e seu valor, ou se retornar uma pontuação de confiança menor que 90 para qualquer par de valores-chave detectado no documento. Se você estiver usando o documento de amostra fornecido neste exemplo, essas condições de ativação criarão uma tarefa de revisão humana.

```
import json

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

Usar o`humanLoopActivationConditions`para configurar o`create_flow_definition`solicitação. O exemplo a seguir usa o SDK for Python (Boto3) para chamar[https://docs.aws.amazon.com/goto/boto3/sagemaker-2017-07-24/CreateFlowDefinition](https://docs.aws.amazon.com/goto/boto3/sagemaker-2017-07-24/CreateFlowDefinition)na região us-west-2 da AWS. Ele especifica o uso de uma equipe de trabalho privada. 

```
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}}"
)
```