

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Crear un flujo de trabajo de revisión humana (API)
<a name="a2i-textract-create-flow-definition-api"></a>

Puede crear un flujo de trabajo de revisión humana o un*Definición del flujo*, utilizando Amazon A2I,[https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateFlowDefinition.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateFlowDefinition.html). 

En este ejemplo, puede utilizar su propio documento en Amazon S3 o descargar[este documento de ejemplo](https://d2908q01vomqb2.cloudfront.net/f1f836cb4ea6efb2a0b1b99f41ad8b103eff4b59/2020/04/17/sample-document-final.png)y guárdelo en su bucket S3.

Asegúrese de que el bucket de Amazon S3 esté en el mismoAWSRegión a la que planeas usar para llamar`AnalyzeDocument`. Para crear un bucket, siga las instrucciones en [Crear un bucket](https://docs.aws.amazon.com/AmazonS3/latest/user-guide/create-bucket.html) en la *Guía del usuario de la consola de Amazon Simple Storage Service*.

**Requisitos previos**

Para utilizar la API de Amazon A2I para crear un flujo de trabajo de revisión humana, debe completar los siguientes requisitos previos:
+ Configure un rol de IAM con permiso para llamar a las operaciones de la API de Amazon A2I y Amazon Textract. Para empezar, puede adjuntar las políticas de AWS, AmazonAugmentedAIFullAccess y AmazonTextractFullAccess a un rol de IAM. Registre el nombre de recursos de Amazon (ARN) de IAM, ya que lo necesitará más adelante.

  Para obtener permisos más detallados al utilizar Amazon Textract, consulte[Ejemplos de políticas basadas en identidades de Amazon Textract](security_iam_id-based-policy-examples.md). Para Amazon A2I, consulte[Permisos y seguridad en la Augmented AI de Amazon](https://docs.aws.amazon.com/sagemaker/latest/dg/a2i-permissions-security.html)en la*Guía para desarrolladores de Amazon SageMaker*.
+ Cree un equipo de trabajo privado y registre el ARN del equipo de trabajo. Si es un usuario nuevo de Amazon A2I, siga las instrucciones de[Paso 1: Crear un equipo de trabajo (consola)](a2i-textract-create-flow-definition-console.md#a2i-textract-create-flow-definition-workteam).
+ Cree una plantilla de tarea del trabajador. Siga las instrucciones en[Crear una plantilla de tarea de trabajo](https://docs.aws.amazon.com/sagemaker/latest/dg/a2i-worker-template-console.html#a2i-create-worker-template-console)para crear una plantilla mediante la consola Amazon A2I. Cuando estés creando la plantilla, elige**Extracción de forma de texto**para**Tipo de plantilla**. En la plantilla, sustituya`s3_arn`con el ARN de Amazon S3 de su documento. Añadir instrucciones adicionales para el trabajador en`<full-instructions header="Instructions"></full-instructions>`. 

  Si desea obtener una vista previa de la plantilla, asegúrese de que su rol de IAM tenga los permisos descritos en[Habilitar vistas previas de plantillas de tareas del trabajador](https://docs.aws.amazon.com/sagemaker/latest/dg/a2i-permissions-security.html#permissions-for-worker-task-templates-augmented-ai).

  Después de crear la plantilla, registre el ARN de la plantilla de tarea del trabajador.

Usa los recursos que ha creado en**Requisitos previos**para configurar`CreateFlowDefinition`request. En esta solicitud, también especificará las condiciones de activación en formato JSON. Para obtener información sobre cómo configurar las condiciones de activación, consulte[Utilizar el esquema JSON de condiciones de activación del bucle humano con Amazon Textract](https://docs.aws.amazon.com/sagemaker/latest/dg/a2i-json-humantaskactivationconditions-textract-example.html).

## Creación de un flujo de trabajo de revisión humana (SDK de AWS para Python (Boto3))
<a name="a2i-textract-create-flow-definition-api-example"></a>

Para utilizar este ejemplo, reemplace la{{red}}texto con sus especificaciones y recursos.

En primer lugar, codifique las condiciones de activación en un objeto JSON utilizando el siguiente código. Esto desencadena una revisión humana si Amazon Textract devuelve un puntaje de confianza inferior al 99 para*Dirección de correo*y su valor, o si devuelve una puntuación de confianza inferior a 90 para cualquier par clave-valor detectado en el documento. Si utiliza el documento de ejemplo que se proporciona en este ejemplo, estas condiciones de activación crean una tarea de revisión 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`humanLoopActivationConditions`para configurar el`create_flow_definition`request. El siguiente ejemplo utiliza el SDK for Python (Boto3) para llamar[https://docs.aws.amazon.com/goto/boto3/sagemaker-2017-07-24/CreateFlowDefinition](https://docs.aws.amazon.com/goto/boto3/sagemaker-2017-07-24/CreateFlowDefinition)en us-west-2 de la región de AWS. Especifica el uso de un equipo de trabajo privado. 

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