Tarea Doc AI - Operation

La tarea Doc AI - Operation te permite verificar el estado de una operación de larga duración (LRO) en el procesador de Document AI. El procesador de Document AI crea una LRO cada vez que envías una solicitud de procesamiento por lotes.

Cloud Document AI es un servicio de Google Cloud que permite analizar información estructurada de documentos no estructurados o semiestructurados mediante una IA de Google de vanguardia, como el lenguaje natural, la visión artificial, la traducción y AutoML.

Antes de comenzar

Asegúrate de realizar las siguientes tareas en tu proyecto de Google Cloud antes de configurar la tarea Doc AI - Operation:

Habilita la API de Cloud Document AI (documentai.googleapis.com) en tu proyecto de Google Cloud antes de configurar la tarea Doc AI - Operation.
Habilita la API de Cloud Document AI
Crea un perfil de autenticación. Apigee Integration usa un perfil de autenticación para conectarse a un extremo de autenticación de la tarea Doc AI - Operation.
Para obtener información sobre cómo otorgar roles o permisos adicionales a una cuenta de servicio, consulta Cómo otorgar, cambiar y revocar el acceso a los recursos.

Configura la tarea Doc AI - Operation

En la IU de Apigee, selecciona tu organización de Apigee.
Haz clic en Desarrollar > Integraciones.
Selecciona una integración existente o crea una nueva haciendo clic en Crear integración.
Si creas una integración nueva, haz lo siguiente:
1. Ingresa un nombre y una descripción en el diálogo Crear integración.
2. En la lista de regiones compatibles, selecciona Región para la integración.
3. Haz clic en Crear.
Esto abrirá la integración en la página del diseñador de integración.
En la barra de navegación Diseñador de integración, haz clic en +Agregar una tarea o un activador > Tareas para ver la lista de tareas disponibles.
Haz clic y coloca el elemento Doc AI - Operation en el diseñador de integración.
Haz clic en el elemento Doc AI - Operation en el diseñador para ver el panel de configuración de la tarea Doc AI - Operation.
Ve a Autenticación y selecciona un perfil de autenticación existente que desees usar.
Opcional. Si no creaste un perfil de autenticación antes de configurar la tarea, haz clic en + Nuevo perfil de autenticación y sigue los pasos que se mencionan en Crea un perfil de autenticación nuevo.
Ve a Entrada de tarea y configura los campos de entrada que se muestran con la siguiente tabla de parámetros de entrada de la tarea.
Los cambios en los campos de entrada se guardan de forma automática.

Parámetros de entrada de la tarea

En la siguiente tabla, se describen los parámetros de entrada de la tarea Doc AI - Operation:

Propiedad	Tipo de datos	Descripción
Región	String	Ubicación de Cloud Document para el procesador. Por ejemplo: `us` - Estados Unidos.
ProjectsId	String	Tu ID del proyecto de Google Cloud.
OperationId	String	El ID de la operación. El ID es el último elemento del nombre de la operación.

Resultado de la tarea

La tarea Doc AI - Operation muestra los detalles de tu operación de larga duración (LRO), similar al siguiente resultado de muestra:

{
    "name": "projects/[PROJECT_ID]/locations/[LOCATION]/operations/[OPERATION_ID]",
    "metadata": {
        "@type": "type.googleapis.com/google.cloud.documentai.v1.BatchProcessMetadata",
        "state": "SUCCEEDED",
        "stateMessage": "Processed 1 document(s) successfully",
        "createTime": "TIMESTAMP",
        "updateTime": "TIMESTAMP",
        "individualProcessStatuses": [
        {
            "inputGcsSource": "[INPUT_BUCKET_FOLDER]/DOCUMENT1.ext",
            "status": {},
            "outputGcsDestination": "OUTPUT_BUCKET_FOLDER/[OPERATION_ID]/0",
            "humanReviewStatus": {
            "state": "ERROR",
            "stateMessage": "Sharded document files are not supported for human review."
            }
        }
        ]
    },
    "done": true,
    "response": {
        "@type": "type.googleapis.com/google.cloud.documentai.v1.BatchProcessResponse"
    }
}

Estrategia de manejo de errores

Una estrategia de manejo de errores de una tarea específica la acción que se debe realizar si la tarea falla debido a un error temporal. Para obtener información sobre cómo usar una estrategia de manejo de errores y conocer los diferentes tipos de estrategias de manejo de errores, consulta Estrategias de manejo de errores.

¿Qué sigue?

Agrega perímetros y condiciones perimetrales.
Prueba y publica tu integración.
Configura un activador.
Agrega una tarea de asignación de datos.
Consulta todas las tareas para los servicios de Google Cloud.