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.

Utilizar el esquema JSON de condiciones de activación del bucle humano con Amazon Textract

Cuando se utiliza con Amazon A2I, la operación AnalyzeDocument admite las siguientes entradas en el parámetro ConditionType:

Entradas y resultados de ImportantFormKeyConfidenceCheck

El ConditionType de ImportantFormKeyConfidenceCheck admite los siguientes ConditionParameters:

Cuando se utiliza el ConditionType ImportantFormKeyConfidenceCheck, Amazon A2I envía las inferencias de bloque clave-valor y de bloque de palabras en los bloques clave-valor y los alias asociados especificados en ImportantFormKey y ImportantFormKeyAliases para la revisión humana.

Al crear una definición de flujo, si utilizas la plantilla de tareas de trabajador predeterminada que se proporciona en la sección Flujos de trabajo de revisión humana de la consola de Amazon SageMaker AI, las inferencias de clave-valor y bloque enviadas para su revisión humana mediante esta condición de activación se incluyen en la interfaz de usuario del trabajador. Si utiliza una plantilla de tarea de trabajador personalizada, tiene que incluir el elemento {{ task.input.selectedAiServiceResponse.blocks }} a fin de incluir datos de entrada de valor inicial (inferencias) desde Amazon Textract. Para ver un ejemplo de una plantilla personalizada que utiliza este elemento de entrada, consulte Ejemplo de plantilla personalizada para Amazon Textract.

Entradas y resultados de MissingImportantFormKey

El ConditionType de MissingImportantFormKey admite los siguientes ConditionParameters:

Cuando utilice el ConditionType MissingImportantFormKey, si la clave en ImportantFormKey o los alias en ImportantFormKeyAliases no están incluidos en la inferencia de Amazon Textract, ese formulario se enviará a un humano para su revisión y no se incluirán pares clave-valor predichos. Por ejemplo, si Amazon Textract solo identifica Address y Phone en un formulario, pero le falta el Name de ImportantFormKey (en el tipo de condición MissingImportantFormKey), ese formulario se enviaría a los humanos para su revisión sin que se detectara ninguna de las claves de formulario (Address y Phone).

Si utiliza la plantilla de tareas de trabajo predeterminada que se proporciona en la consola de SageMaker IA, se crea una tarea en la que se pide a los trabajadores que identifiquen la clave ImportantFormKey y el valor asociado. Si utiliza una plantilla de tarea de trabajador personalizada, tiene que incluir el elemento HTML personalizado <task.input.humanLoopContext> para configurar esta tarea.

Entradas y resultados de muestreo

El ConditionType Sampling admite los ConditionParameters RandomSamplingPercentage. La entrada en RandomSamplingPercentage debe ser un número real entre 0,01 y 100. Este número representa el porcentaje de datos que califican para una revisión humana y que se envían a humanos para que los revisen. Si utiliza la condición Sampling sin ninguna otra condición, este número representa el porcentaje de todas las inferencias resultantes realizadas por la operación AnalyzeDocument a partir de una única solicitud que se enviará a los humanos para que la revisen.

Si especifica la condición Sampling sin ningún otro tipo de condición, todas las inferencias clave-valor y bloque se envían a los trabajadores para su revisión.

Al crear una definición de flujo, si utilizas la plantilla de tareas de trabajador predeterminada que se proporciona en la sección de flujos de trabajo de revisión humana de la consola de SageMaker IA, todas las inferencias clave-valor y bloque enviadas para su revisión humana mediante esta condición de activación se incluyen en la interfaz de usuario del trabajador. Si utiliza una plantilla de tarea de trabajador personalizada, tiene que incluir el elemento {{ task.input.selectedAiServiceResponse.blocks }} a fin de incluir datos de entrada de valor inicial (inferencias) desde Amazon Textract. Para ver un ejemplo de una plantilla personalizada que utiliza este elemento de entrada, consulte Ejemplo de plantilla personalizada para Amazon Textract.

Ejemplos

Aunque solo debe evaluarse como true una condición para desencadenar un bucle humano, Amazon A2I evaluará todas las condiciones de cada objeto analizado por Amazon Textract. A los revisores humanos se les solicita que revisen las claves de formulario importantes de todas las condiciones que se evalúan como true.

Ejemplo 1: detectar claves de formulario importantes con puntuaciones de confianza en un rango especificado que inicia un bucle humano

A continuación, se muestra un ejemplo de un JSON HumanLoopActivationConditions que inicia un bucle humano si se cumple cualquiera de las tres condiciones siguientes:

{
    "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
            }
        }
    ]
}

Ejemplo 2: uso de ImportantFormKeyConfidenceCheck

En el siguiente ejemplo, si Amazon Textract detecta un par clave-valor cuya confianza para el bloque clave-valor es menor de 60 y menor de 90 para cualquier bloque de palabras subyacente, se crea un bucle humano. Se pide a los revisores humanos que revisen todos los pares clave-valor de forma que coincidan con las comparaciones de valor de confianza.

{
    "Conditions": [
        {
            "ConditionType": "ImportantFormKeyConfidenceCheck",
            "ConditionParameters": {
                "ImportantFormKey": "*",
                "KeyValueBlockConfidenceLessThan": 60,
                "WordBlockConfidenceLessThan": 90
            }
        }
    ]
}

Ejemplo 3: Usar muestreo

En el siguiente ejemplo, el 5 % de las inferencias resultantes de una solicitud AnalyzeDocument de Amazon Textract serán enviadas a trabajadores humanos para que las revisen. Todos los pares clave-valor detectados y devueltos por Amazon Textract se envían a los trabajadores para su revisión.

{
  "Conditions": [
    {
      "ConditionType": "Sampling",
      "ConditionParameters": {
        "RandomSamplingPercentage": 5
      }
    }
  ]
}

Ejemplo 4: uso de MissingImportantFormKey

En el siguiente ejemplo, si Mailing Address o su alias (Mailing Address:) no se encuentran en las claves detectadas por Amazon Textract, se inicia una revisión humana. Cuando se utiliza la plantilla de tarea de trabajo predeterminada, la interfaz de usuario del trabajador pedirá a los trabajadores que identifiquen la clave Mailing Address o Mailing Address: y su valor asociado.

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

Ejemplo 5: uso del muestreo y de ImportantFormKeyConfidenceCheck con el operadorAnd

En este ejemplo, se envía para la revisión de los trabajadores el 5 % de los pares clave-valor detectados por Amazon Textract cuya clave sea Pay Date, PayDate, DateOfPay o pay-date y cuyos niveles de confianza sean los siguientes: la confianza del bloque clave-valor es inferior a 65 y las confianzas de cada uno de los bloques de palabras que componen la clave y el valor es inferior a 85.

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

Ejemplo 6: uso del muestreo y de ImportantFormKeyConfidenceCheck con el operador And

Utilice este ejemplo para configurar el flujo de trabajo de revisión humana para enviar siempre inferencias de baja confianza de un par clave-valor especificado para revisión humana e inferencias de alta confianza de un par clave-valor a una velocidad especificada.

En el siguiente ejemplo, la revisión humana se inicia de una de las siguientes maneras:

{
  "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
                    }
                }
            ]
        }
      ]
    }
  ]
}

Ejemplo 7: uso del muestreo y de ImportantFormKeyConfidenceCheck con el operador Or

En el siguiente ejemplo, la operación AnalyzeDocument de Amazon Textract devuelve un par clave-valor cuya clave es Pay Date, PayDate, DateOfPay o pay-date; la confianza del bloque clave-valor es menor de 65 y la de los bloques de palabras que componen la clave y el valor es menor de 85. Además, el 5 % de todos los demás formularios inicia un bucle humano. En cada formulario elegido aleatoriamente, todos los pares clave-valor detectados para ese formulario se enviarán a personas para que los revisen.

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