Mensajes de error
Aprende a solucionar algunos errores que genera Document AI. En este tema, se analizan errores cuyas resoluciones requieren más pasos de los que se pueden describir en un mensaje de error.
Consulta la documentación de la API de Cloud para conocer las prácticas recomendadas de manejo de errores.
Permisos
La resolución requiere que se lleven a cabo algunos pasos, como se indica en el mensaje de error.
Las credenciales predeterminadas de la aplicación no están disponibles
Si recibes este mensaje, haz lo siguiente:
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 usa credenciales predeterminadas de la aplicación para la autenticación.
Debes tener una cuenta de servicio para tu proyecto, descargar la clave (archivo JSON) para tu cuenta de servicio en tu entorno de desarrollo y, luego, establecer la ubicación de ese archivo JSON en una variable de entorno llamada GOOGLE_APPLICATION_CREDENTIALS
.
Además, la variable de entorno GOOGLE_APPLICATION_CREDENTIALS
debe estar disponible dentro del contexto en que llamas a la API de Document AI. Por ejemplo, si configuras la variable a partir de una sesión de terminal, pero ejecutas tu código en el depurador del IDE, el contexto de ejecución del código podría no tener acceso a la variable. En ese caso, tu solicitud a Document AI podría fallar por falta de autenticación adecuada.
Para obtener más información sobre cómo configurar la variable de entorno GOOGLE_APPLICATION_CREDENTIALS
, consulta la guía de inicio rápido de Document AI o la documentación sobre cómo usar las credenciales predeterminadas de la aplicación.
Permiso denegado
Si recibes este mensaje, haz lo siguiente:
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" } }
Verifica que tienes un archivo JSON de clave de cuenta de servicio válido en la ubicación almacenada en la variable de entorno de GOOGLE_APPLICATION_CREDENTIALS
y que la variable apunta al lugar correcto.
Para diagnosticar este error, intenta abrir el archivo de claves de la cuenta de servicio desde la carpeta desde la que intentas llamar a la API de Document AI.
cat $GOOGLE_APPLICATION_CREDENTIALS
Prohibido: 403 POST la API no se usó o está inhabilitada
Si recibes el siguiente mensaje:
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.
- Visita el vínculo especificado en el mensaje de error y habilita la API de Document AI. Espera varios minutos y vuelve a intentarlo.
- Verifica que tienes un archivo JSON de clave de cuenta de servicio válido almacenado en la variable de entorno
GOOGLE_APPLICATION_CREDENTIALS
. Para diagnosticar este error, intenta abrir el archivo de claves de la cuenta de servicio desde la carpeta desde la que intentas llamar a la API de Document AI.cat $GOOGLE_APPLICATION_CREDENTIALS
Se produjo un error al escribir el resultado final
Si recibes un mensaje como el siguiente cuando recibes los resultados de una solicitud de proceso por lotes:
{ "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" } }
Es posible que tu cuenta de servicio no tenga los permisos correctos para crear objetos en tu bucket de Cloud Storage. Asegúrate de haber asignado los permisos correctos a tu cuenta de servicio, como se describe en la guía de inicio rápido.
También es posible que hayas escrito mal el nombre de tu bucket de Cloud Storage. Verifica que exista el bucket al que intentas acceder.
P4SA no tiene acceso a Cloud Storage
Cuando la cuenta de servicio por producto (P4SA) de Document AI no tiene permiso para acceder a algunos recursos de Cloud Storage
message: "Cloud DocumentAI P4SA doesn't have access to this Cloud Storage resource:"
La cuenta de servicio no puede crear objetos en Cloud Storage
Cuando la cuenta de servicio por producto (P4SA) de Document AI no tiene permiso para crear objetos en 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."
Es posible que la cuenta de servicio de Document AI no tenga los permisos correctos para crear objetos en tu bucket de Cloud Storage. Asegúrate de haber asignado los permisos correctos a la cuenta de servicio de Document AI, como se describe en la configuración del acceso a archivos entre proyectos.
También es posible que hayas escrito mal el nombre de tu bucket de Cloud Storage. Verifica que exista el bucket al que intentas acceder.
El llamador no puede obtener objetos en Cloud Storage
Cuando el llamador de la API de Document AI no tiene permiso para obtener objetos en Cloud Storage.
message: "The caller does not have permission storage.objects.get to get Google Cloud Storage objects in bucket gs://foo."
Es posible que el llamador de la API no tenga los permisos correctos para obtener objetos en tu bucket de Cloud Storage. Asegúrate de haber asignado los permisos correctos a la entidad que llama.
También es posible que hayas escrito mal el nombre de tu bucket de Cloud Storage. Verifica que exista el bucket al que intentas acceder.
Argumentos no válidos
La resolución requiere que se lleven a cabo algunos pasos, como se indica en el mensaje de error.
Versión de API no compatible
Cuando se realiza una solicitud a una versión de API que no admite la operación.
message: "The requested operation is unsupported for the API version."
No se admite el tipo de procesador
Cuando se realiza una solicitud a un método de API que no admite el tipo de procesador determinado.
message: "The requested operation is unsupported for the processor type: ${PROCESSOR_TYPE}."
Solicitud incorrecta
Se produce cuando se realiza una solicitud a la API, pero los campos de la solicitud tienen uno o más incumplimientos. Cada incumplimiento se captura como un field_violations
en los detalles de google.rpc.BadRequest
.
message: "Request contains an invalid argument." details { [type.googleapis.com/google.rpc.BadRequest] { field_violations { field: "foo" description: "bar" } } }
No se pudieron procesar todos los documentos por lotes
Se produce cuando no se puede procesar ningún documento en una solicitud de procesamiento por lotes.
message: "Failed to process all documents." details { [type.googleapis.com/google.rpc.ErrorInfo] { reason: "FAILED_TO_PROCESS_ALL_DOCUMENTS" domain: "documentai.googleapis.com" } }
No se encontraron documentos
Cuando se requieren o esperan documentos, pero no se proporciona ninguno, como cuando se importan documentos por URI de 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" } }
Los parámetros gcsUriPrefix
y gcsOutputConfig.gcsUri
deben comenzar con gs://
y terminar con un carácter de barra inversa final (/
). Verifica la configuración de los URI del bucket.
Ejemplo: gs://bucket/directory/
No se admite el entrenamiento
Cuando se realiza una solicitud de versión del procesador de entrenamiento en un tipo de procesador que no admite el entrenamiento.
message: "Training is not supported on processor type: ${DOCUMENT_TYPE}_PROCESSOR."
No se seleccionó ningún documento
Cuando se esperan documentos, pero no se selecciona ninguno en el conjunto de datos, como cuando se crean trabajos de etiquetado de datos.
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" } }
No se encontró el tipo de documento
Cuando la clase de un documento (como licencia, pasaporte o factura) no coincide con la clasificación necesaria para el tipo de procesador. Un ejemplo es cuando el paso del clasificador en el analizador de W2 no encuentra elementos de una factura.
También puede aparecer como Couldn't preview the document: Unable to find a document of type: 'foo'
en la consola de Google Cloud . Este mensaje de error se aplica a los procesadores heredados.
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" } }
Se superó el límite de tamaño del documento
Se superó el límite superior para el tamaño de archivo de un documento durante la importación del conjunto de datos o la ejecución de la predicción.
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" } } }
Se excedió el límite de documentos
Se superó el límite superior para el recuento de documentos.
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" } } }
Tipo de MIME no compatible
Se proporcionó un tipo de MIME no admitido. El sistema verifica el formato de archivo (tipo de MIME) cuando importas un conjunto de datos o realizas una llamada de predicción. Ve a Archivos compatibles (y, para Layout Parser, consulta los tipos de archivos disponibles). Si el formato de archivo no es compatible, verás el siguiente mensaje de error:
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" } } }
No hay páginas
Se proporcionó un documento sin páginas, pero se requiere una o más páginas.
message: "No pages were found in the document." details { [type.googleapis.com/google.rpc.ErrorInfo] { reason: "NO_PAGES" domain: "documentai.googleapis.com" } }
Número de página negativo
Cuando un documento indica un valor negativo para uno de sus números de página
message: "Page number cannot be negative." details { [type.googleapis.com/google.rpc.ErrorInfo] { reason: "NEGATIVE_PAGE_NUMBER" domain: "documentai.googleapis.com" } }
Números de página duplicados
Cuando un documento enumera el mismo número de página una o más veces
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]}]" } } }
Se excedió el límite de páginas
Se supera el límite superior de la cantidad total de páginas de un documento. Te encuentras con este error durante la importación o la predicción del conjunto de datos cuando un documento dentro del conjunto de datos tiene demasiadas páginas, lo que supera los límites del procesador.
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" } } }
Se superó el límite de páginas en el modo sin imágenes
Este error se produce durante la importación o la predicción del conjunto de datos cuando un documento dentro del conjunto de datos tiene demasiadas páginas, lo que supera los límites del procesador. Puedes solicitar que se agregue tu proyecto a una lista de proyectos permitidos para habilitar el modo sin imágenes, lo que aumenta el límite de páginas a 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" } } }
Cambio de estado de la versión del procesador previamente entrenado
Es la fecha y hora en que se emitió una solicitud para cambiar el estado de una versión del procesador previamente entrenado. Encuentras este error cuando intentas borrar una versión de procesador previamente entrenada.
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" } } }
Validación del conjunto de datos
Cuando un conjunto de datos no cumple con los criterios de validación, por ejemplo, debido a la falta de anclajes de página, datos incorrectos o detalles incompletos en algunos atributos del objeto proto del documento.
message: "Invalid dataset. See operation metadata for specific errors." details { [type.googleapis.com/google.rpc.ErrorInfo] { reason: "INVALID_DATASET" domain: "documentai.googleapis.com" } }
Documento con interacción humana no intercalado para su revisión
Se inició una revisión humana para un documento que no se definió de forma intercalada.
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" } }
Tipo de documento no válido
Cuando el tipo de documento no es válido o no es compatible con el procesador. Un tipo de documento hace referencia a la categoría del documento (p.ej., W2), no su formato de archivo o tipo de MIME, como PDF o 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" } } }
El tramo del documento está fuera de los límites.
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" } } }
Extensión del documento no válida
Cuando se proporciona un tramo de documento no válido, por ejemplo, cuando el inicio es posterior al final.
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" } } }
Documento UTF-8 no válido
Cuando se proporciona un documento que incluye caracteres UTF-8 no válidos.
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)" } } }
El esquema del conjunto de datos no es válido
Cuando un procesador no tiene un esquema de unión válido o el esquema de conjunto de datos proporcionado no es válido.
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 no compatible
Se emite una solicitud de procesamiento para un procesador que no admite 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" } }
Configuración de importación no válida
Cuando la configuración de importación no es válida.
message: "The import config is invalid: foo" details { [type.googleapis.com/google.rpc.ErrorInfo] { reason: "INVALID_IMPORT_CONFIG" domain: "documentai.googleapis.com" } }
La versión del procesador de origen no es válida
Cuando se intenta importar una versión del procesador, la versión del procesador fuente no es válida para la importación.
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" } }
Tamaño de fragmento no válido
Se produce cuando la configuración del tamaño del fragmento no es válida.
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" } }
Precondición con errores
La resolución requiere que se lleven a cabo algunos pasos, como se indica en el mensaje de error.
La clave de KMS no es válida
Se proporcionó una clave no válida (p.ej., está inhabilitada).
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" } } }
Cambio de estado del procesador
Se emite cuando se realiza una solicitud no válida para cambiar el estado de un procesador.
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" } } }
Cambio de estado de la versión del procesador
Se emite cuando se realiza una solicitud no válida para cambiar el estado de una versión del procesador.
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" } } }
El procesador no está habilitado
Cuando se emite una solicitud que depende de un procesador específico, pero el procesador no está habilitado.
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" } } }
No se implementó la versión del procesador
Se emite una solicitud que depende de que se implemente una versión específica del procesador, pero el procesador no se implementa.
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" } } }
Versión predeterminada del procesador
Se emite una solicitud que depende de que se configure una versión predeterminada, pero no hay ninguna configurada.
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" } } }
Quita la versión predeterminada del procesador
Cuando se emite una solicitud para anular la implementación o borrar una versión del procesador, pero esta se configuró como la versión predeterminada.
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" } } }
No se inicializó el conjunto de datos
Se emite una solicitud que requiere que se inicialice un conjunto de datos, pero el conjunto de datos no se inicializa.
message: "Dataset is not initialized." details { [type.googleapis.com/google.rpc.ErrorInfo] { reason: "DATASET_NOT_INITIALIZED" domain: "documentai.googleapis.com" } }
El conjunto de datos se inicializó o se está inicializando
Se emite una solicitud que requiere que un conjunto de datos no se inicialice, pero el conjunto de datos ya se inicializó o se está inicializando.
message: "Dataset is already initialized or is initializing." details { [type.googleapis.com/google.rpc.ErrorInfo] { reason: "DATASET_INITIALIZED_OR_INITIALIZING" domain: "documentai.googleapis.com" } }
Error: La ubicación del conjunto de datos no está vacía
Cuando una solicitud requiere que la ubicación de almacenamiento de un conjunto de datos esté vacía, pero la carpeta contiene objetos.
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" } }
Tiene un error de operación de bloqueo
Cuando hay otras operaciones en ejecución que bloquean la operación requerida
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" } }
Error de intervalo de páginas no admitido
Cuando el campo page_range
no se admite en alguna operación, como en un proceso por lotes.
message: "Page range is not supported." details { [type.googleapis.com/google.rpc.ErrorInfo] { reason: "PAGE_RANGE_UNSUPPORTED" domain: "documentai.googleapis.com" } }
La carpeta de Cloud Storage contiene un error del conjunto de datos
Cuando una carpeta de Cloud Storage ya contiene un conjunto de datos
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" } }
Error de falta de miniatura
Se activa cuando no se puede recuperar la miniatura de un documento del conjunto de datos.
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" } }
Se excedió el límite de páginas del conjunto de datos
Se superó el límite total de páginas de un conjunto de datos.
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" } }
Procesador no compatible con el procesamiento síncrono
Cuando se realiza una solicitud para una versión del procesador que ya no se admite para el procesamiento síncrono.
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" } }
No encontrado
La resolución requiere que se lleven a cabo algunos pasos, como se indica en el mensaje de error.
No se encontró la evaluación
Cuando no se puede encontrar una evaluación para una versión del procesador.
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" } } }
No se encontró el documento
Cuando no se encuentra un documento necesario para una operación.
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" } } }
No se encontró el procesador
Se produce cuando no se puede encontrar un procesador necesario para una operación.
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" } } }
No se encontró la versión del procesador
Cuando no se puede encontrar una versión del procesador necesaria para una operación.
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" } } }
No se encontró el trabajo de etiquetado de datos
Cuando no se puede encontrar un trabajo de etiquetado de datos.
message: "Data labeling job with id 'EXAMPLE_DATA_LABELING_JOB' not found in processor EXAMPLE_PROCESSOR."
No se encontró la versión del esquema
Se produce cuando no se puede encontrar una versión del esquema.
message: "Schema version with id 'EXAMPLE_SCHEMA_VERSION' not found."
No se encontró el esquema
Cuando no se puede encontrar un esquema.
message: "Schema with id 'EXAMPLE_SCHEMA' not found."
Ya existe
La resolución requiere que se lleven a cabo algunos pasos, como se indica en el mensaje de error.
Ya existe un etiquetador humano en el circuito
Cuando se crea un grupo de etiquetadores que ya existe.
message: "The labeler pool already exists."
Ya existe un nombre visible para la versión del esquema
Cuando se crea una versión del esquema con un nombre visible que ya existe.
message: "A schema version with the name 'EXAMPLE_SCHEMA_VERSION' already exists."
Ya existe un nombre visible del esquema
Cuando se crea un esquema con un nombre visible que ya existe.
message: "A schema with the name 'EXAMPLE_SCHEMA' already exists."
Cuotas y límites
La resolución requiere que se lleven a cabo algunos pasos, como se indica en el mensaje de error.
Se superó la cuota
Si recibes este mensaje, haz lo siguiente:
RESOURCE_EXHAUSTED: Quota exceeded.
Alcanzaste el límite de tu cuota diaria o por minuto. Revisa las cuotas y límites para usar Document AI.
Puedes solicitar un aumento de las cuotas desde la consola deGoogle Cloud .
Interrupciones y latencia
La resolución requiere que se lleven a cabo algunos pasos, como se indica en el mensaje de error.
Tiempos de espera
- En el caso del procesamiento en línea, hay un tiempo de espera de 2 minutos del servidor para las solicitudes.
- En el caso del procesamiento por lotes, hay un tiempo de espera del servidor de 2 minutos para generar la operación de larga duración, pero no hay tiempo de espera para la finalización del trabajo por lotes.
- Para obtener más información, consulta la documentación de Operaciones de larga duración.
La operación no se completó dentro del tiempo de espera designado.
Si recibes los siguientes mensajes de error (o similares) cuando sondeos una operación de larga duración (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.
Entonces, el valor de tiempo de espera establecido por el usuario para completar la operación es demasiado bajo para el documento que se está procesando. Este error no indica que falló la operación del proceso por lotes. La operación continuará independientemente del valor de tiempo de espera establecido por el usuario.
Error del filtro de seguridad
Se produjo un error interno del servidor porque los filtros de seguridad del modelo de lenguaje grande (LLM) bloquearon la solicitud o la respuesta. No se puede volver a intentar corregir este error.
message: "Safety filter error."
Error interno
Se produjo un error interno del servidor. Vuelve a intentar la conexión.
message: "Internal error encountered."