

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.

# Esquema JSON para condiciones de activación del bucle humano en Amazon Augmented AI
<a name="a2i-human-fallback-conditions-json-schema"></a>

`HumanLoopActivationConditions` es un parámetro de entrada de la API [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateFlowDefinition.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateFlowDefinition.html). Este parámetro es una cadena con formato JSON. El JSON modela las condiciones en las que se creará un bucle humano cuando esas condiciones se comparan con la respuesta de una API de servicio de IA de integración (como `Rekognition.DetectModerationLabels` o `Textract.AnalyzeDocument`). Esta respuesta se conoce como una *inferencia*. Por ejemplo, Amazon Rekognition envía una inferencia de una etiqueta de moderación con una puntuación de confianza asociada. En este ejemplo, la inferencia es la mejor estimación del modelo de la etiqueta adecuada para una imagen. Para Amazon Textract, se hace una inferencia sobre la asociación entre bloques de texto (*pares clave-valor*), como la asociación entre `Name:` y `Sue` en un formulario, así como el contenido dentro de un bloque de texto, o *bloque de palabras*, como “Nombre”.

A continuación se muestra el esquema para el JSON. En el nivel superior, `HumanLoopActivationConditions` tiene una matriz JSON, `Conditions`. Cada miembro de esta matriz es una condición independiente que, si se evalúa como `true`, dará como resultado que Amazon A2I cree un bucle humano. Cada condición independiente puede ser una condición simple o compleja. Una condición simple tiene los siguientes atributos:
+ `ConditionType`: este atributo identifica el tipo de condición. Cada API de servicio de IA de AWS que se integra con Amazon A2I define su propio conjunto de `ConditionTypes` permitidas. 
  + Rekognition `DetectModerationLabels`: esta API admite los valores `ModerationLabelConfidenceCheck` y `Sampling` de `ConditionType`.
  + Textract `AnalyzeDocument`: esta API admite los valores `ImportantFormKeyConfidenceCheck`, `MissingImportantFormKey` y `Sampling` de `ConditionType`.
+ `ConditionParameters`: un objeto JSON que parametriza la condición. El conjunto de atributos permitidos de este objeto depende del valor de `ConditionType`. Cada `ConditionType` define su propio conjunto de `ConditionParameters`. 

Un miembro de la matriz `Conditions` puede modelar una condición compleja. Esto se logra conectando lógicamente las condiciones simples con los operadores lógicos `And` y `Or` y anidando las condiciones simples subyacentes. Se admiten hasta dos niveles de anidamiento. 

```
{
    "$schema": "http://json-schema.org/draft-07/schema#",
    "definitions": {
        "Condition": {
            "type": "object",
            "properties": {
                "ConditionType": {
                    "type": "string"
                },
                "ConditionParameters": {
                    "type": "object"
                }
            },
            "required": [
                "ConditionType"
            ]
        },
        "OrConditionArray": {
            "type": "object",
            "properties": {
                "Or": {
                    "type": "array",
                    "minItems": 2,
                    "items": {
                        "$ref": "#/definitions/ComplexCondition"
                    }
                }
            }
        },
        "AndConditionArray": {
            "type": "object",
            "properties": {
                "And": {
                    "type": "array",
                    "minItems": 2,
                    "items": {
                        "$ref": "#/definitions/ComplexCondition"
                    }
                }
            }
        },
        "ComplexCondition": {
            "anyOf": [
                {
                    "$ref": "#/definitions/Condition"
                },
                {
                    "$ref": "#/definitions/OrConditionArray"
                },
                {
                    "$ref": "#/definitions/AndConditionArray"
                }
            ]
        }
    },
    "type": "object",
    "properties": {
        "Conditions": {
            "type": "array",
            "items": {
                "$ref": "#/definitions/ComplexCondition"
            }
        }
    }
}
```

**nota**  
Las condiciones de activación de bucle humano no están disponibles para flujos de trabajo de revisión humana integrados con tipos de tareas personalizados. El parámetro `HumanLoopActivationConditions` está deshabilitado para los tipos de tareas personalizados. 

**Topics**
+ [Utilizar el esquema JSON de condiciones de activación del bucle humano con Amazon Textract](a2i-json-humantaskactivationconditions-textract-example.md)
+ [Utilizar el esquema JSON de condiciones de activación del bucle humano con Amazon Rekognition](a2i-json-humantaskactivationconditions-rekognition-example.md)