Tâche Doc AI – Opération

La tâche Doc AI – Opération vous permet de vérifier l'état d'une opération de longue durée dans le processeur Document AI. Le processeur Document AI crée une opération de longue durée chaque fois que vous envoyez une requête de traitement par lot.

Cloud Document AI est un service Google Cloud qui vous permet d'analyser des informations structurées à partir de documents non structurés ou semi-structurés à l'aide d'une IA Google de pointe telle que le langage naturel, la vision par ordinateur, la traduction et AutoML.

Avant de commencer

Assurez-vous d'effectuer les tâches suivantes dans votre projet Google Cloud avant de configurer la tâche Doc AI – Opération:

Activez l'API Cloud Document AI (documentai.googleapis.com) dans votre projet Google Cloud avant de configurer la tâche Doc AI - Opération.
Activer l'API Cloud Document AI
Créer un profil d'authentification L'intégration Apigee utilise un profil d'authentification pour se connecter à un point de terminaison d'authentification pour la tâche Doc AI - Operation.
Pour en savoir plus sur l'attribution de rôles ou d'autorisations supplémentaires à un compte de service, consultez la page Accorder, modifier et révoquer des accès.

Configurer la tâche Doc AI - Opération

Dans l'interface utilisateur Apigee, sélectionnez votre organisation Apigee.
Cliquez sur Développer > Intégrations.
Sélectionnez une intégration existante ou créez-en une en cliquant sur Créer une intégration.
Si vous créez une intégration :
1. Saisissez un nom et une description dans la boîte de dialogue Créer une intégration.
2. Dans la liste des régions compatibles, sélectionnez une région pour l'intégration.
3. Cliquez sur Créer.
La page de conception d'intégration s'affiche.
Dans la barre de navigation de la page de conception d'intégration, cliquez sur +Ajouter une tâche ou un déclencheur > Tâches pour afficher la liste des tâches disponibles.
Cliquez sur l'élément Doc AI - Operation puis placez-le dans le concepteur d'intégration.
Cliquez sur l'élément Doc AI – Opération sur le concepteur pour afficher le volet de configuration de la tâche Doc AI – Opération.
Accédez à Authentification, puis sélectionnez un profil d'authentification existant que vous souhaitez utiliser.
Facultatif. Si vous n'avez pas créé de profil d'authentification avant de configurer la tâche, cliquez sur + Nouveau profil d'authentification et suivez les étapes mentionnées dans la section Créer un profil d'authentification.
Accédez à l'Entrée de la tâche et configurez les champs d'entrée affichés à l'aide du tableau Paramètres d'entrée de la tâche suivant.
Les modifications apportées aux champs d'entrée sont enregistrées automatiquement.

Paramètres d'entrée des tâches

Le tableau suivant décrit les paramètres d'entrée de la tâche Doc AI – Opération:

Propriété	Type de données	Description
Région	String	Emplacement de Cloud Document AI pour le processeur. Par exemple : `us` - États-Unis.
ProjectsId	Chaîne	L'ID de votre projet Google Cloud.
OperationId	String	ID de l'opération. L'ID est le dernier élément du nom de l'opération.

Résultat de la tâche

La tâche Doc AI - Operation renvoie les détails de votre opération de longue durée, semblable à l'exemple de résultat suivant:

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

Stratégie de traitement des erreurs

Une stratégie de traitement des erreurs d'une tâche spécifie l'action à effectuer si celle-ci échoue en raison d'une erreur temporaire. Pour en savoir plus sur l'utilisation et les différents types de stratégies de traitement des erreurs, consultez la page Stratégies de traitement des erreurs.

Étapes suivantes

Ajoutez des arêtes et conditions d'arêtes.
Testez et publiez votre intégration.
Configurez un déclencheur.
Ajoutez une tâche de mappage de données.
Consultez toutes les tâches des services Google Cloud.