Découvrez comment résoudre certaines erreurs générées par Document AI. Cette rubrique traite des erreurs dont la résolution nécessite un nombre d'étapes ne pouvant pas être indiqué facilement dans un message d'erreur.
Consultez la documentation de l'API Cloud pour connaître les bonnes pratiques de gestion des exceptions.
Autorisations
Pour résoudre le problème, vous devez suivre quelques étapes, comme indiqué dans le message d'erreur.
Les identifiants par défaut de l'application ne sont pas disponibles
Si vous recevez ce message :
The Application Default Credentials are not available. They are available if running in Compute Engine. Otherwise, the environment variable GOOGLE_APPLICATION_CREDENTIALS must be defined pointing to a file defining the credentials. See https://developers.google.com/accounts/docs/application-default-credentials for more information.
Document AI utilise les identifiants par défaut de l'application pour l'authentification.
Vous devez disposer d'un compte de service pour votre projet, télécharger la clé (fichier JSON) de votre compte de service dans votre environnement de développement, puis définir l'emplacement de ce fichier JSON sur une variable d'environnement nommée GOOGLE_APPLICATION_CREDENTIALS
.
En outre, la variable d'environnement GOOGLE_APPLICATION_CREDENTIALS
doit être disponible dans le contexte d'appel de l'API Document AI. Par exemple, si vous définissez la variable à partir d'une session de terminal, mais exécutez le code dans le débogueur de votre IDE, le contexte d'exécution du code peut ne pas avoir accès à la variable. Dans ce cas, la requête à Document AI pourrait échouer faute d'authentification appropriée.
Pour en savoir plus sur la définition de la variable d'environnement GOOGLE_APPLICATION_CREDENTIALS
, consultez le guide de démarrage rapide Document AI ou la documentation sur l'utilisation des identifiants par défaut de l'application.
Autorisation refusée
Si vous recevez ce message :
ERROR: (gcloud.auth.application-default.print-access-token) File (pointed by GOOGLE_APPLICATION_CREDENTIALS environment variable) does not exist! { "error": { "code": 403, "message": "The request is missing a valid API key.", "status": "PERMISSION_DENIED" } }
Vérifiez que vous disposez d'un fichier JSON de clé de compte de service valide à l'emplacement stocké dans la variable d'environnement GOOGLE_APPLICATION_CREDENTIALS
et que cette dernière pointe vers l'emplacement approprié.
Pour diagnostiquer cette erreur, essayez d'ouvrir le fichier de clé du compte de service depuis le dossier à partir duquel vous tentez d'appeler l'API Document AI.
cat $GOOGLE_APPLICATION_CREDENTIALS
"Interdit : 403 La méthode POST de l'API n'est pas utilisée ou est désactivée"
Si vous recevez le message suivant :
Forbidden: 403 POST Document AI API has not been used in project # before or it is disabled. Enable it by visiting [url], then retry. If you enabled this API recently, wait a few minutes for the action to propagate and retry.
- Utilisez le lien indiqué dans le message d'erreur et activez l'API Document AI. Patientez quelques minutes, puis réessayez.
- Vérifiez que vous disposez d'un fichier JSON de clé de compte de service valide stocké dans la variable d'environnement
GOOGLE_APPLICATION_CREDENTIALS
. Pour diagnostiquer cette erreur, essayez d'ouvrir le fichier de clé du compte de service depuis le dossier à partir duquel vous tentez d'appeler l'API Document AI.cat $GOOGLE_APPLICATION_CREDENTIALS
Erreur lors de l'écriture du résultat final
Si vous recevez un message semblable à celui-ci lorsque vous recevez les résultats d'une requête de traitement par lot :
{ "name": "projects/project-name/operations/operation-id", "metadata": { "@type": "type.googleapis.com/google.cloud.document.v1beta1.OperationMetadata", "state": "SUCCEEDED", "createTime": "2019-09-19T02:02:15.885267760Z", "updateTime": "2019-09-19T02:02:31.896425001Z" }, "done": true, "error": { "code": 5, "message": "Error writing final output to: gs://bucket-name/filename.json" } }
Il est possible que votre compte de service ne dispose pas des autorisations nécessaires pour créer des objets dans votre bucket Cloud Storage. Assurez-vous d'avoir attribué les autorisations appropriées à votre compte de service, comme décrit dans le guide de démarrage rapide.
Il est également possible que vous ayez mal orthographié le nom de votre bucket Cloud Storage. Vérifiez que le bucket auquel vous essayez d'accéder existe.
P4SA n'a pas accès à Cloud Storage
Lorsque le compte de service Document AI par produit (P4SA) n'est pas autorisé à accéder à certaines ressources Cloud Storage.
message: "Cloud DocumentAI P4SA doesn't have access to this Cloud Storage resource:"
Le compte de service ne peut pas créer d'objet dans Cloud Storage
Lorsque le compte de service par produit (P4SA) Document AI n'est pas autorisé à créer un objet dans Cloud Storage.
message: "Service account service-123@gcp-sa-prod-dai-core.iam.gserviceaccount.com
does not have permission storage.objects.create to create
Google Cloud Storage object in bucket gs://foo."
Il est possible que le compte de service Document AI ne dispose pas des autorisations nécessaires pour créer des objets dans votre bucket Cloud Storage. Assurez-vous d'avoir attribué les autorisations appropriées au compte de service Document AI, comme décrit dans la configuration de l'accès aux fichiers entre projets.
Il est également possible que vous ayez mal orthographié le nom de votre bucket Cloud Storage. Vérifiez que le bucket auquel vous essayez d'accéder existe.
L'appelant ne peut pas obtenir d'objets dans Cloud Storage
Lorsque l'appelant de l'API Document AI n'est pas autorisé à obtenir des objets dans Cloud Storage.
message: "The caller does not have permission storage.objects.get to get Google
Cloud Storage objects in bucket gs://foo."
Il se peut que l'appelant de l'API ne dispose pas des autorisations nécessaires pour obtenir des objets dans votre bucket Cloud Storage. Assurez-vous d'avoir attribué les autorisations appropriées à l'appelant.
Il est également possible que vous ayez mal orthographié le nom de votre bucket Cloud Storage. Vérifiez que le bucket auquel vous essayez d'accéder existe.
Arguments non valides
Pour résoudre le problème, vous devez suivre quelques étapes, comme indiqué dans le message d'erreur.
Version de l'API non compatible
Lorsqu'une requête est envoyée à une version d'API qui ne prend pas en charge l'opération.
message: "The requested operation is unsupported for the API version."
Type de processeur non compatible
Lorsqu'une requête est envoyée à une méthode d'API qui ne prend pas en charge le type de processeur donné.
message: "The requested operation is unsupported for the processor type: ${PROCESSOR_TYPE}."
Requête incorrecte
Lorsqu'une requête API est envoyée, mais que les champs de la requête comportent une ou plusieurs infractions.
Chaque cas de non-respect est enregistré en tant que field_violations
dans les détails de google.rpc.BadRequest
.
message: "Request contains an invalid argument."
details {
[type.googleapis.com/google.rpc.BadRequest] {
field_violations { field: "foo" description: "bar" }
}
}
Échec du traitement par lot de tous les documents
Lorsque le traitement de chaque document d'une requête de traitement par lot échoue.
message: "Failed to process all documents."
details {
[type.googleapis.com/google.rpc.ErrorInfo] {
reason: "FAILED_TO_PROCESS_ALL_DOCUMENTS"
domain: "documentai.googleapis.com"
}
}
Aucun document
Lorsque des documents sont requis ou attendus, mais qu'aucun n'est fourni, par exemple lors de l'importation de documents par URI Cloud Storage.
message: "No valid documents found in ${training|test} directory. Ensure files are in a supported MIME type. For details, see https://cloud.google.com/document-ai/docs/file-types."
details {
[type.googleapis.com/google.rpc.ErrorInfo] {
reason: "NO_DOCUMENTS"
domain: "documentai.googleapis.com"
}
}
Les paramètres gcsUriPrefix
et gcsOutputConfig.gcsUri
doivent commencer par gs://
et se terminer par une barre oblique inverse (/
). Vérifiez la configuration des URI de bucket.
Exemple : gs://bucket/directory/
L'entraînement n'est pas accepté
Lorsqu'une demande d'entraînement d'une version de processeur est effectuée sur un type de processeur qui ne prend pas en charge l'entraînement.
message: "Training is not supported on processor type: ${DOCUMENT_TYPE}_PROCESSOR."
Aucun document sélectionné
Lorsque des documents sont attendus, mais qu'aucun n'est sélectionné dans l'ensemble de données, par exemple lors de la création de tâches d'étiquetage de données.
message: No documents selected. Please select at least one document."
details {
[type.googleapis.com/google.rpc.ErrorInfo] {
reason: "NO_DOCUMENTS_SELECTED"
domain: "documentai.googleapis.com"
}
}
Type de document introuvable
Lorsque la classe d'un document (comme un permis, un passeport ou une facture) ne correspond pas à la classification nécessaire pour le type de processeur. Par exemple, lorsque l'étape de classification du parseur W2 ne trouve pas d'éléments dans une facture.
Il peut également s'afficher sous la forme Couldn't preview the document: Unable to find a document of type: 'foo'
dans la console Google Cloud .
Ce message d'erreur s'applique aux anciens processeurs.
message: "Unable to find a document of type: 'foo'"
details {
[type.googleapis.com/google.rpc.ErrorInfo] {
reason: "DOCUMENT_OF_TYPE_NOT_FOUND"
domain: "documentai.googleapis.com"
}
}
La taille limite du document a été dépassée
Lorsque la limite supérieure de la taille de fichier d'un document a été dépassée lors de l'importation d'un ensemble de données ou de l'exécution d'une prédiction.
message: "Document size (2) exceeds limit: 1 (bytes)."
details {
[type.googleapis.com/google.rpc.ErrorInfo] {
reason: "DOCUMENT_SIZE_LIMIT_EXCEEDED"
domain: "documentai.googleapis.com"
metadata { key: "limit" value: "1" }
metadata { key: "size" value: "2" }
}
}
Limite de documents dépassée
Lorsque la limite supérieure du nombre de documents a été dépassée.
message: "Document count exceed the limit: 5 got 6"
details {
[type.googleapis.com/google.rpc.ErrorInfo] {
reason: "DOCUMENT_LIMIT_EXCEEDED"
domain: "documentai.googleapis.com"
metadata { key: "document_limit" value: "5" }
metadata { key: "documents" value: "6" }
}
}
Type MIME non accepté
Lorsqu'un type MIME non compatible a été fourni. Le système vérifie le format du fichier (type MIME) lorsque vous importez un ensemble de données ou effectuez un appel de prédiction. Consultez Fichiers acceptés (et Analyseur de mise en page) pour connaître les types de fichiers disponibles. Si le format de fichier n'est pas accepté, le message d'erreur suivant s'affiche :
message: "INVALID_ARGUMENT: Unsupported MIME type: 'foo'."
details {
[type.googleapis.com/google.rpc.ErrorInfo] {
reason: "UNSUPPORTED_MIME_TYPE"
domain: "documentai.googleapis.com"
metadata { key: "mime_type" value: "foo" }
}
}
Aucune page
Lorsqu'un document sans page a été fourni, mais qu'une ou plusieurs pages sont requises.
message: "No pages were found in the document."
details {
[type.googleapis.com/google.rpc.ErrorInfo] {
reason: "NO_PAGES"
domain: "documentai.googleapis.com"
}
}
Numéro de page négatif
Lorsqu'un document indique une valeur négative pour l'un de ses numéros de page.
message: "Page number cannot be negative."
details {
[type.googleapis.com/google.rpc.ErrorInfo] {
reason: "NEGATIVE_PAGE_NUMBER"
domain: "documentai.googleapis.com"
}
}
Numéros de page en double
Un document liste le même numéro de page une ou plusieurs fois.
message: "Duplicate page number detected (page numbers to indices): [{1, [1, 2]}, {4, [4, 5]}]."
details {
[type.googleapis.com/google.rpc.ErrorInfo] {
reason: "DUPLICATE_PAGE_NUMBERS"
domain: "documentai.googleapis.com"
metadata {
key: "page_number_to_indices"
value: "[{1, [1, 2]}, {4, [4, 5]}]"
}
}
}
Limite de pages dépassée
Lorsque la limite supérieure du nombre total de pages d'un document est dépassée. Cette erreur se produit lors de l'importation ou de la prédiction d'un ensemble de données lorsqu'un document de l'ensemble de données comporte trop de pages, ce qui dépasse les limites du processeur.
message: "Document pages exceed the limit: 5 got 6"
details {
[type.googleapis.com/google.rpc.ErrorInfo] {
reason: "PAGE_LIMIT_EXCEEDED"
domain: "documentai.googleapis.com"
metadata { key: "page_limit" value: "5" }
metadata { key: "pages" value: "6" }
}
}
Nombre de pages dépassé en mode sans image
Cette erreur se produit lors de l'importation ou de la prédiction d'un ensemble de données lorsqu'un document de l'ensemble de données comporte trop de pages, ce qui dépasse les limites du processeur. Vous pouvez demander l'ajout de votre projet à une liste d'autorisation pour activer le mode sans images. La limite de pages passe alors à 30.
message: "Document pages in non-imageless mode exceed the limit: 15 got 16. Try using imageless mode to increase the limit to 30."
details {
[type.googleapis.com/google.rpc.ErrorInfo] {
reason: "PAGE_LIMIT_EXCEEDED_IN_IMAGELESS_MODE"
domain: "documentai.googleapis.com"
metadata { key: "page_limit" value: "15" }
metadata { key: "pages" value: "16" }
metadata { key: "imageless_page_limit" value: "30" }
}
}
Changement d'état de la version du processeur pré-entraîné
Lorsqu'une demande de modification de l'état d'une version de processeur préentraînée a été émise. Cette erreur se produit lorsque vous essayez de supprimer une version de processeur préentraîné.
message: "ProcessorVersion with id 'xyz' is pretrained by Google and cannot change states."
details {
[type.googleapis.com/google.rpc.ErrorInfo] {
reason: "PRETRAINED_PROCESSOR_VERSION_STATE_CHANGE"
domain: "documentai.googleapis.com"
metadata { key: "processor_id" value: "abc" }
metadata { key: "target_state" value: "DELETING" }
metadata { key: "version_id" value: "xyz" }
}
}
Validation de l'ensemble de données
Lorsqu'un ensemble de données ne répond pas aux critères de validation, par exemple en raison d'ancres de page manquantes, de données incorrectes ou de détails incomplets dans certains attributs de l'objet proto du document.
message: "Invalid dataset. See operation metadata for specific errors."
details {
[type.googleapis.com/google.rpc.ErrorInfo] {
reason: "INVALID_DATASET"
domain: "documentai.googleapis.com"
}
}
Document non intégré pour examen avec intervention humaine
Un examen manuel a été lancé pour un document qui n'a pas été défini de manière intégrée.
message: "The document for review must be provided inline."
details {
[type.googleapis.com/google.rpc.ErrorInfo] {
reason: "HUMAN_REVIEW_NON_INLINED_DOCUMENT"
domain: "documentai.googleapis.com"
}
}
Type de document non valide
Lorsque le type de document n'est pas valide ou n'est pas accepté par le processeur. Un type de document fait référence à la catégorie du document (par exemple, W2), et non son format de fichier ou son type MIME, comme PDF ou JPEG.
message: "Invalid document type: 'foo'."
details {
[type.googleapis.com/google.rpc.ErrorInfo] {
reason: "INVALID_DOCUMENT_TYPE"
domain: "documentai.googleapis.com"
metadata { key: "type" value: "foo" }
}
}
La portée du document est hors limites
message: "Text span [1, 5) is out of bounds: [1, 3)."
details {
[type.googleapis.com/google.rpc.ErrorInfo] {
reason: "DOCUMENT_SPAN_OUT_OF_BOUNDS"
domain: "documentai.googleapis.com"
metadata { key: "bounds" value: "[1, 3)" }
metadata { key: "span" value: "[1, 5)" }
metadata { key: "type" value: "Text" }
}
}
Portée du document non valide
Lorsqu'une étendue de document non valide est fournie (par exemple, lorsque le début est après la fin).
message: "Character span is invalid. Ensure the max is greater than the min."
details {
[type.googleapis.com/google.rpc.ErrorInfo] {
reason: "DOCUMENT_SPAN_INVALID"
domain: "documentai.googleapis.com"
metadata { key: "span" value: "Character" }
}
}
Document UTF-8 non valide
Lorsqu'un document contenant des caractères UTF-8 non valides est fourni.
message: "Document contains invalid UTF-8 text."
details {
[type.googleapis.com/google.rpc.ErrorInfo] {
reason: "DOCUMENT_INVALID_UTF_8"
domain: "documentai.googleapis.com"
metadata { key: "bytes" value: "[2, 3)" }
}
}
Le schéma de l'ensemble de données n'est pas valide
Lorsqu'un processeur ne dispose pas d'un schéma d'union valide ou que le schéma de l'ensemble de données fourni n'est pas valide.
message: "The processor has an empty or invalid schema: "
details {
[type.googleapis.com/google.rpc.ErrorInfo] {
reason: "INVALID_SCHEMA_ERROR"
domain: "documentai.googleapis.com"
}
}
OcrConfig non pris en charge
Lorsqu'une demande de traitement est émise pour un processeur qui ne prend pas en charge OcrConfig.
message: "OcrConfig is not supported for processor type: 'foo'."
details {
[type.googleapis.com/google.rpc.ErrorInfo] {
reason: "OCR_CONFIG_UNSUPPORTED"
domain: "documentai.googleapis.com"
}
}
Configuration d'importation non valide
Lorsque la configuration d'importation n'est pas valide.
message: "The import config is invalid: foo"
details {
[type.googleapis.com/google.rpc.ErrorInfo] {
reason: "INVALID_IMPORT_CONFIG"
domain: "documentai.googleapis.com"
}
}
La version du processeur source n'est pas valide
Lorsque vous essayez d'importer une version de processeur, la version de processeur source n'est pas valide pour l'importation.
message: "The source processor version is invalid in import processor version."
details {
[type.googleapis.com/google.rpc.ErrorInfo] {
reason: "INVALID_SOURCE_PROCESSOR_VERSION_ERROR"
domain: "documentai.googleapis.com"
}
}
Taille de bloc non valide
Lorsque la configuration de la taille des blocs n'est pas valide.
message: "Invalid chunk size. Requested chunk size (${CHUNK_SIZE}) must be in the range of [${MIN_CHUNK_SIZE}, ${MAX_CHUNK_SIZE}]."
details {
[type.googleapis.com/google.rpc.ErrorInfo] {
reason: "INVALID_ARGUMENT"
domain: "documentai.googleapis.com"
}
}
Condition préalable non remplie
Pour résoudre le problème, vous devez suivre quelques étapes, comme indiqué dans le message d'erreur.
Clé KMS non valide
Lorsqu'une clé non valide (par exemple, désactivée) a été fournie.
message: "KMS key 'projects/1/keys/abc' is invalid (KEY_DISABLED)."
details {
[type.googleapis.com/google.rpc.ErrorInfo] {
reason: "KMS_KEY_INVALID"
domain: "documentai.googleapis.com"
metadata { key: "details" value: "KEY_DISABLED" }
metadata { key: "kms_key_name" value: "projects/1/keys/abc" }
}
}
Changement d'état du processeur
Lorsqu'une demande non valide de modification de l'état d'un processeur est émise.
message: "Processor state cannot be changed to 'DISABLED' since it is 'DISABLED'."
details {
[type.googleapis.com/google.rpc.ErrorInfo] {
reason: "PROCESSOR_STATE_CHANGE_INVALID"
domain: "documentai.googleapis.com"
metadata { key: "current_state" value: "DISABLED" }
metadata { key: "processor_id" value: "xyz" }
metadata { key: "target_state" value: "DISABLED" }
}
}
Changement d'état de la version du processeur
Lorsqu'une demande non valide de modification de l'état d'une version de processeur est émise.
message: "ProcessorVersion state cannot be changed to 'DEPLOYING' since it is 'DEPLOYED'."
details {
[type.googleapis.com/google.rpc.ErrorInfo] {
reason: "PROCESSOR_VERSION_STATE_CHANGE_INVALID"
domain: "documentai.googleapis.com"
metadata { key: "current_state" value: "DEPLOYED" }
metadata { key: "processor_id" value: "abc" }
metadata { key: "target_state" value: "DEPLOYING" }
metadata { key: "version_id" value: "xyz" }
}
}
Processeur non activé
Lorsqu'une requête qui dépend d'un processeur spécifique est émise, mais que le processeur n'est pas activé.
message: "Processor 'xyz' is not enabled."
details {
[type.googleapis.com/google.rpc.ErrorInfo] {
reason: "PROCESSOR_NOT_ENABLED"
domain: "documentai.googleapis.com"
metadata { key: "processor_id" value: "xyz" }
metadata { key: "state" value: "DISABLED" }
}
}
Version de l'outil de traitement non déployée
Lorsqu'une requête qui dépend du déploiement d'une version spécifique du processeur est émise, mais que le processeur n'est pas déployé.
message: "ProcessorVersion 'abc' is not deployed."
details {
[type.googleapis.com/google.rpc.ErrorInfo] {
reason: "PROCESSOR_VERSION_NOT_DEPLOYED"
domain: "documentai.googleapis.com"
metadata { key: "processor_id" value: "xyz" }
metadata { key: "state" value: "TRAINING" }
metadata { key: "version_id" value: "abc" }
}
}
Version par défaut du processeur
Lorsqu'une requête qui dépend d'une version par défaut configurée est émise, mais qu'aucune version n'est configurée.
message: "Processor 'xyz' does not have a default version configured."
details {
[type.googleapis.com/google.rpc.ErrorInfo] {
reason: "PROCESSOR_DEFAULT_VERSION_UNSET"
domain: "documentai.googleapis.com"
metadata { key: "processor_id" value: "xyz" }
}
}
Supprimer la version par défaut du processeur
Lorsqu'une requête visant à annuler le déploiement ou à supprimer une version de processeur est émise, mais que celle-ci est configurée comme version par défaut.
message: "ProcessorVersion 'xyz' cannot be undeployed or deleted as it is the default version."
details {
[type.googleapis.com/google.rpc.ErrorInfo] {
reason: "PROCESSOR_REMOVE_DEFAULT_VERSION"
domain: "documentai.googleapis.com"
metadata { key: "processor_id" value: "abc" }
metadata { key: "version_id" value: "xyz" }
}
}
Ensemble de données non initialisé
Lorsqu'une requête nécessitant l'initialisation d'un ensemble de données est émise, mais que l'ensemble de données n'est pas initialisé.
message: "Dataset is not initialized."
details {
[type.googleapis.com/google.rpc.ErrorInfo] {
reason: "DATASET_NOT_INITIALIZED"
domain: "documentai.googleapis.com"
}
}
Ensemble de données initialisé ou en cours d'initialisation
Lorsqu'une requête nécessitant la désinitialisation d'un ensemble de données est émise, mais que l'ensemble de données est déjà initialisé ou en cours d'initialisation.
message: "Dataset is already initialized or is initializing."
details {
[type.googleapis.com/google.rpc.ErrorInfo] {
reason: "DATASET_INITIALIZED_OR_INITIALIZING"
domain: "documentai.googleapis.com"
}
}
Erreur "L'emplacement de l'ensemble de données n'est pas vide"
Lorsqu'une requête exige qu'un emplacement de stockage d'ensemble de données soit vide, mais que le dossier contient des objets.
message: "Given dataset location is not empty. Please select an empty folder."
details {
[type.googleapis.com/google.rpc.ErrorInfo] {
reason: "DATASET_LOCATION_NOT_EMPTY"
domain: "documentai.googleapis.com"
}
}
Erreur d'opération de blocage
Lorsque d'autres opérations en cours bloquent l'opération requise.
message: "The operation cannot be performed due to an ongoing 'EXAMPLE_OPERATION_TYPE' blocking operation. Try again after the operation finishes."
details {
[type.googleapis.com/google.rpc.ErrorInfo] {
reason: "HAS_BLOCKING_OPERATION_ERROR"
domain: "documentai.googleapis.com"
}
}
Erreur de plage de pages non acceptée
Lorsque le champ page_range
n'est pas compatible avec une opération, par exemple dans un processus par lot.
message: "Page range is not supported."
details {
[type.googleapis.com/google.rpc.ErrorInfo] {
reason: "PAGE_RANGE_UNSUPPORTED"
domain: "documentai.googleapis.com"
}
}
Le dossier Cloud Storage contient une erreur d'ensemble de données
Lorsqu'un dossier Cloud Storage contient déjà un ensemble de données.
message: "The folder 'folder_uri' already has dataset 'dataset-id' under it."
details {
[type.googleapis.com/google.rpc.ErrorInfo] {
reason: "GCS_FOLDER_CONTAINS_DATASET_ERROR"
domain: "documentai.googleapis.com"
}
}
Erreur de miniature manquante
Échec de la récupération de la vignette d'un document de l'ensemble de données.
message: "Failed to get dataset document thumbnail, consider running re-sync on the dataset."
details {
[type.googleapis.com/google.rpc.ErrorInfo] {
reason: "THUMBNAIL_MISSING"
domain: "documentai.googleapis.com"
}
}
Limite de pages de l'ensemble de données dépassée
Lorsque la limite totale de pages d'un ensemble de données a été dépassée.
message: "Dataset page count exceeds the limit of 5. Got 6."
details {
[type.googleapis.com/google.rpc.ErrorInfo] {
reason: "DATASET_PAGE_LIMIT_EXCEEDED"
domain: "documentai.googleapis.com"
}
}
Processeur non compatible avec le traitement synchrone
Lorsqu'une requête est envoyée pour une version de processeur qui n'est plus compatible avec le traitement synchrone.
message: "Processor ${PROCESSOR_ID} version ${VERSION_ID} of type ${TYPE_NAME} is no longer supported for sync processing. Please upgrade to a newer version: https://cloud.google.com/document-ai/docs/manage-processor-versions."
details {
[type.googleapis.com/google.rpc.ErrorInfo] {
reason: "UNSUPPORTED_PROCESSOR"
domain: "documentai.googleapis.com"
}
}
Introuvable
Pour résoudre le problème, vous devez suivre quelques étapes, comme indiqué dans le message d'erreur.
Évaluation introuvable
Lorsqu'aucune évaluation n'est trouvée pour une version de processeur.
message: "Evaluation with ID 'qrs' not found."
details {
[type.googleapis.com/google.rpc.ErrorInfo] {
reason: "EVALUATION_NOT_FOUND"
domain: "documentai.googleapis.com"
metadata { key: "evaluation_id" value: "qrs" }
metadata { key: "processor_id" value: "xyz" }
metadata { key: "version_id" value: "abc" }
}
}
Document introuvable
Lorsqu'un document nécessaire à une opération est introuvable.
message: "Document not found: 'gs://foo'."
details {
[type.googleapis.com/google.rpc.ErrorInfo] {
reason: "DOCUMENT_NOT_FOUND"
domain: "documentai.googleapis.com"
metadata { key: "document" value: "gs://foo" }
}
}
Processeur introuvable
Lorsqu'un processeur nécessaire à une opération est introuvable.
message: "Processor with id 'xyz' not found."
details {
[type.googleapis.com/google.rpc.ErrorInfo] {
reason: "PROCESSOR_NOT_FOUND"
domain: "documentai.googleapis.com"
metadata { key: "processor_id" value: "xyz" }
}
}
Version du processeur introuvable
Lorsqu'une version de processeur requise pour une opération est introuvable.
message: "ProcessorVersion with id 'abc' not found."
details {
[type.googleapis.com/google.rpc.ErrorInfo] {
reason: "PROCESSOR_VERSION_NOT_FOUND"
domain: "documentai.googleapis.com"
metadata { key: "processor_id" value: "xyz" }
metadata { key: "version_id" value: "abc" }
}
}
Job d'étiquetage de données introuvable
Lorsqu'un job d'étiquetage de données est introuvable.
message: "Data labeling job with id 'EXAMPLE_DATA_LABELING_JOB' not found in processor EXAMPLE_PROCESSOR."
Version du schéma introuvable
Lorsqu'une version de schéma est introuvable.
message: "Schema version with id 'EXAMPLE_SCHEMA_VERSION' not found."
Schéma introuvable
Lorsqu'un schéma est introuvable.
message: "Schema with id 'EXAMPLE_SCHEMA' not found."
Existe déjà
Pour résoudre le problème, vous devez suivre quelques étapes, comme indiqué dans le message d'erreur.
Un annotateur avec intervention humaine existe déjà
Lorsque vous créez un pool d'étiqueteurs qui existe déjà.
message: "The labeler pool already exists."
Le nom à afficher de la version du schéma existe déjà
Lorsque vous créez une version de schéma avec un nom à afficher qui existe déjà.
message: "A schema version with the name 'EXAMPLE_SCHEMA_VERSION' already exists."
Le nom à afficher du schéma existe déjà
Lorsque vous créez un schéma avec un nom à afficher qui existe déjà.
message: "A schema with the name 'EXAMPLE_SCHEMA' already exists."
Quotas et limites
Pour résoudre le problème, vous devez suivre quelques étapes, comme indiqué dans le message d'erreur.
Quota dépassé
Si vous recevez ce message :
RESOURCE_EXHAUSTED: Quota exceeded.
Vous avez atteint votre limite de quota par minute ou par jour. Vérifiez les quotas et limites d'utilisation de Document AI.
Vous pouvez demander une augmentation de vos quotas depuis la consoleGoogle Cloud .
Indisponibilités et latence
Pour résoudre le problème, vous devez suivre quelques étapes, comme indiqué dans le message d'erreur.
Délais avant expiration
- Pour le traitement en ligne, le délai avant expiration côté serveur est de deux minutes pour les requêtes.
- Pour le traitement par lot, un délai avant expiration de deux minutes côté serveur est prévu pour générer l'opération de longue durée, mais aucun délai avant expiration n'est prévu pour l'exécution du job par lot.
- Pour en savoir plus, consultez la documentation sur les opérations de longue durée.
L'opération ne s'est pas terminée dans le délai imparti.
Si vous recevez les messages d'erreur suivants (ou des messages similaires) lorsque vous interrogez une opération de longue durée (LRO) :
google.api_core.future.polling._OperationNotComplete
...
google.api_core.exceptions.RetryError: Deadline of 0.0s exceeded while calling target function, last exception:
...
concurrent.futures._base.TimeoutError: Operation did not complete within the designated timeout.
La valeur du délai d'expiration définie par l'utilisateur pour l'exécution de l'opération est trop faible pour le document en cours de traitement. Cette erreur n'indique pas que l'opération de traitement par lot a échoué. L'opération se poursuivra quelle que soit la valeur du délai d'inactivité définie par l'utilisateur.
Erreur du filtre de sécurité
Une erreur interne côté serveur s'est produite, car la requête ou la réponse a été bloquée par les filtres de sécurité du grand modèle de langage (LLM). Vous ne pouvez pas réessayer.
message: "Safety filter error."
Erreur interne
Une erreur interne du serveur s'est produite. Effectuer une nouvelle tentative de connexion.
message: "Internal error encountered."