Consulta cómo solucionar algunos errores que genera Document AI. En este tema se tratan los errores cuya resolución requiere más pasos de los que se pueden describir en un mensaje de error.
Consulta las prácticas recomendadas para gestionar errores en la documentación de la API Cloud.
Permisos
Para solucionarlo, debes seguir los pasos que se indican en el mensaje de error.
Las credenciales de aplicación predeterminadas no están disponibles
Si recibes este mensaje:
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 de aplicación predeterminadas para la autenticación.
Debes tener una cuenta de servicio para tu proyecto, descargar la clave (archivo JSON) de tu cuenta de servicio en tu entorno de desarrollo y, a continuación, definir 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 en el contexto en el que llames a la API Document AI. Por ejemplo, si defines la variable desde una sesión de terminal, pero ejecutas el código en el depurador de tu IDE, es posible que el contexto de ejecución del código no tenga acceso a la variable. En ese caso, es posible que tu solicitud a Document AI falle por falta de autenticación adecuada.
Para obtener más información sobre cómo definir 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:
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" } }
Comprueba que tienes un archivo JSON de clave de cuenta de servicio válido en la ubicación almacenada en la variable de entorno GOOGLE_APPLICATION_CREDENTIALS
y que la variable apunta al lugar correcto.
Para diagnosticar este error, prueba a abrir el archivo de clave de cuenta de servicio desde la carpeta desde la que intentas llamar a la API Document AI.
cat $GOOGLE_APPLICATION_CREDENTIALS
Prohibido: no se ha usado la API POST 403 o está inhabilitada
Si recibes el 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 enlace especificado en el mensaje de error y habilita la API Document AI. Espera varios minutos y vuelve a intentarlo.
- Comprueba 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, prueba a abrir el archivo de clave de cuenta de servicio desde la carpeta desde la que intentas llamar a la API Document AI.cat $GOOGLE_APPLICATION_CREDENTIALS
Error al escribir la salida final
Si recibes un mensaje como el siguiente al recibir 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 segmento de Cloud Storage. Asegúrate de haber asignado los permisos correctos a tu cuenta de servicio, tal como se describe en la guía de inicio rápido.
También es posible que hayas escrito mal el nombre del segmento de Cloud Storage. Verifica que el segmento al que intentas acceder existe.
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 adecuados para crear objetos en tu segmento de Cloud Storage. Asegúrate de haber asignado los permisos correctos a la cuenta de servicio de Document AI, tal como se describe en la configuración de acceso a archivos entre proyectos.
También es posible que hayas escrito mal el nombre del segmento de Cloud Storage. Verifica que el segmento al que intentas acceder existe.
El llamador no puede obtener objetos de Cloud Storage
Cuando el llamante 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 llamante de la API no tenga los permisos correctos para obtener objetos de tu segmento de Cloud Storage. Asegúrate de haber asignado los permisos correctos a la persona que llama.
También es posible que hayas escrito mal el nombre del segmento de Cloud Storage. Verifica que el segmento al que intentas acceder existe.
Argumentos no válidos
Para solucionarlo, debes seguir los pasos que se indican en el mensaje de error.
Versión de la API no compatible
Cuando se hace una solicitud a una versión de la API que no admite la operación.
message: "The requested operation is unsupported for the API version."
Tipo de procesador no admitido
Cuando se hace una solicitud a un método de API que no admite el tipo de procesador proporcionado.
message: "The requested operation is unsupported for the processor type: ${PROCESSOR_TYPE}."
Bad Request
Cuando se envía una solicitud a la API, pero los campos de la solicitud tienen una o varias infracciones.
Cada infracción se registra como un field_violations
en los google.rpc.BadRequest
detalles.
message: "Request contains an invalid argument."
details {
[type.googleapis.com/google.rpc.BadRequest] {
field_violations { field: "foo" description: "bar" }
}
}
No se ha podido procesar por lotes todos los documentos
Cuando no se puede procesar ningún documento de 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"
}
}
Ningún documento coincide con la búsqueda
Cuando se requieren o se esperan documentos, pero no se proporciona ninguno, como cuando se importan documentos mediante un 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 empezar por gs://
y terminar con una barra invertida (/
). Comprueba la configuración de los URIs del segmento.
Ejemplo: gs://bucket/directory/
No se admite la formación
Cuando se hace 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 ha seleccionado ningún documento
Cuando se esperan documentos, pero no se selecciona ninguno en el conjunto de datos, como cuando se crean tareas 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 ha encontrado el tipo de documento
Cuando la clase de un documento (como un carné de conducir, un pasaporte o una factura) no coincide con la clasificación necesaria para el tipo de procesador. Por ejemplo, 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 Google Cloud consola.
Este mensaje de error se aplica a los procesadores antiguos.
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 ha superado el límite de tamaño del documento
Cuando se supera el límite superior del tamaño de archivo de un documento al importar un conjunto de datos o al ejecutar una 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 ha superado el límite de documentos
Cuando se ha superado el límite superior del número 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 MIME no admitido
Cuando se ha proporcionado un tipo de MIME no admitido. El sistema verifica el formato de archivo (tipo MIME) cuando importas un conjunto de datos o haces una llamada de predicción. Ve a Archivos admitidos (y a Analizador de diseño) para ver los tipos de archivo 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
Cuando se ha proporcionado un documento sin páginas, pero se requieren una o varias 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 incluye el mismo número de página una o varias 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 ha superado el límite de páginas
Cuando se supera el límite superior del número total de páginas de un documento. Este error se produce durante la importación o la predicción de un conjunto de datos cuando un documento 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 ha superado el límite de páginas en el modo sin imágenes
Este error se produce durante la importación de un conjunto de datos o la predicción cuando un documento del conjunto de datos tiene demasiadas páginas, lo que supera los límites del procesador. Puedes solicitar que tu proyecto se añada a una lista de permitidas 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 de un procesador preentrenado
Cuando se emitió una solicitud para cambiar el estado de una versión de procesador preentrenada. Este error se produce al intentar eliminar una versión de un procesador preentrenado.
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 de conjuntos de datos
Cuando un conjunto de datos no cumple los criterios de validación, por ejemplo, porque faltan anclas de página, los datos son incorrectos o los detalles de algunos atributos del objeto proto del documento están incompletos.
message: "Invalid dataset. See operation metadata for specific errors."
details {
[type.googleapis.com/google.rpc.ErrorInfo] {
reason: "INVALID_DATASET"
domain: "documentai.googleapis.com"
}
}
Documento sin insertar con intervención humana para su revisión
Cuando se ha iniciado una revisión humana de un documento que no se ha definido de forma insertada.
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 (por ejemplo, W2), no su formato de archivo o tipo 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 intervalo 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" }
}
}
Intervalo de documento no válido
Cuando se proporciona un intervalo de documento no válido, como 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 Unsupported
Cuando 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
Al intentar importar una versión del procesador, la versión del procesador de origen no es válida para importarse.
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
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"
}
}
No se cumple la condición previa
Para solucionarlo, debes seguir los pasos que se indican en el mensaje de error.
Clave KMS no válida
Cuando se ha proporcionado una clave no válida (por ejemplo, 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
Cuando se emite 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
Cuando se envía una solicitud no válida para cambiar el estado de una versión de 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" }
}
}
Procesador no 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" }
}
}
Versión del procesador no implementada
Cuando se envía una solicitud que depende de que se haya implementado una versión específica del procesador, pero el procesador no se ha implementado.
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
Cuando se envía una solicitud que depende de que se haya configurado una versión predeterminada, pero no se ha configurado ninguna.
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" }
}
}
Processor remove default version
Cuando se envía una solicitud para retirar o eliminar una versión de un procesador, pero esta se ha configurado 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" }
}
}
Conjunto de datos no inicializado
Cuando se envía una solicitud que requiere que se inicialice un conjunto de datos, pero no se ha inicializado.
message: "Dataset is not initialized."
details {
[type.googleapis.com/google.rpc.ErrorInfo] {
reason: "DATASET_NOT_INITIALIZED"
domain: "documentai.googleapis.com"
}
}
Conjunto de datos inicializado o en proceso de inicialización
Cuando se envía una solicitud que requiere que un conjunto de datos no esté inicializado, pero el conjunto de datos ya está inicializado 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 Dataset Location Not Empty
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"
}
}
Has Blocking Operation Error
Cuando hay otras operaciones en curso que bloquean la operación necesaria.
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 en el 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
Cuando no se puede obtener la miniatura de un documento de 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 ha superado el límite de páginas del conjunto de datos
Cuando se ha superado 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 admitido para el procesamiento síncrono
Cuando se hace 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 se ha encontrado
Para solucionarlo, debes seguir los pasos que se indican en el mensaje de error.
No se ha encontrado la evaluación
Cuando no se encuentra una evaluación de 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" }
}
}
Documento no encontrado
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 ha encontrado el procesador
Cuando no se encuentra 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 ha encontrado la versión del procesador
Cuando no se encuentra 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 ha encontrado la tarea de etiquetado de datos
Cuando no se encuentra una tarea de etiquetado de datos.
message: "Data labeling job with id 'EXAMPLE_DATA_LABELING_JOB' not found in processor EXAMPLE_PROCESSOR."
No se ha encontrado la versión del esquema
Cuando no se encuentra una versión del esquema.
message: "Schema version with id 'EXAMPLE_SCHEMA_VERSION' not found."
No se ha encontrado el esquema
Cuando no se encuentra un esquema.
message: "Schema with id 'EXAMPLE_SCHEMA' not found."
Ya existe
Para solucionarlo, debes seguir los pasos que se indican en el mensaje de error.
Ya existe un etiquetador con intervención humana
Cuando se crea un grupo de etiquetadores que ya existe.
message: "The labeler pool already exists."
El nombre visible de la versión del esquema ya existe
Cuando se crea una versión de un esquema con un nombre visible que ya existe.
message: "A schema version with the name 'EXAMPLE_SCHEMA_VERSION' already exists."
El nombre visible del esquema ya existe
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
Para solucionarlo, debes seguir los pasos que se indican en el mensaje de error.
Se ha superado la cuota
Si recibes este mensaje:
RESOURCE_EXHAUSTED: Quota exceeded.
Has alcanzado el límite de tu cuota por minuto o diaria. Consulta las cuotas y los límites de uso de Document AI.
Puedes solicitar que te aumentemos las cuotas desde la Google Cloud consola.
Interrupciones y latencia
Para solucionarlo, debes seguir los pasos que se indican en el mensaje de error.
Tiempos de espera
- En el caso del procesamiento online, las solicitudes tienen un tiempo de espera de 2 minutos en el servidor.
- En el procesamiento por lotes, hay un tiempo de espera de 2 minutos del lado del servidor para generar la operación de larga duración, pero no hay ningún tiempo de espera para completar la tarea por lotes.
- Para obtener más información, consulta la documentación sobre operaciones de larga duración.
La operación no se ha completado en el tiempo de espera designado.
Si recibes los siguientes mensajes de error (o similares) al sondear 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.
A continuación, el valor de tiempo de espera definido por el usuario para completar la operación es demasiado bajo para el documento que se está procesando. Este error no indica que la operación del proceso por lotes haya fallado. La operación continuará independientemente del valor de tiempo de espera definido por el usuario.
Error del filtro de seguridad
Se ha producido un error interno del lado del servidor porque los filtros de seguridad del modelo de lenguaje extenso (LLM) han bloqueado la solicitud o la respuesta. Este error no se puede volver a intentar.
message: "Safety filter error."
Error interno
Se ha producido un error interno del lado del servidor. Vuelve a intentar la conexión.
message: "Internal error encountered."