Mensagens de erro
Aprenda a resolver alguns erros relacionados à Document AI. Neste tópico, falamos sobre erros com resoluções que exigem etapas além do que pode ser descrito em uma mensagem de erro.
Consulte a documentação da API Cloud para ver as práticas recomendadas de tratamento de erros.
Permissões
A resolução exige algumas etapas, conforme descrito na mensagem de erro.
O Application Default Credentials não está disponível
Se você recebeu esta mensagem:
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.
A Document AI usa Application Default Credentials para autenticação.
É necessário ter uma conta de serviço para seu projeto, fazer o download da chave (arquivo JSON) da sua conta de serviço no ambiente de desenvolvimento e definir o local desse arquivo JSON em uma variável de ambiente denominada GOOGLE_APPLICATION_CREDENTIALS.
Além disso, a variável de ambiente GOOGLE_APPLICATION_CREDENTIALS
precisa estar disponível no
contexto que você chama a API Document AI. Por exemplo, se você definir
a variável a partir de uma sessão do terminal, mas executou seu código no
depurador do ambiente de desenvolvimento integrado, o contexto de execução do seu código poderá não
ter acesso à variável. Nesse caso, sua solicitação para a Document AI pode falhar por falta de autenticação adequada.
Para mais informações sobre como definir a variável de ambiente GOOGLE_APPLICATION_CREDENTIALS, consulte o guia de início rápido da Document AI ou a documentação sobre como usar as Application Default Credentials.
Permissão negada
Se você recebeu esta mensagem:
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"
}
}
Verifique se você tem um arquivo JSON de chave de conta de serviço válido no local armazenado na variável de ambiente GOOGLE_APPLICATION_CREDENTIALS e se a variável aponta para o local correto.
Para diagnosticar esse erro, tente abrir o arquivo de chave da conta de serviço na pasta que você quer chamar a API Document AI.
cat $GOOGLE_APPLICATION_CREDENTIALS
Proibido: a API 403 POST não foi usada ou está desativada
Se você receber a mensagem:
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.
- Acesse o link especificado na mensagem de erro e ative a API Document AI. Aguarde alguns minutos e tente novamente.
- Verifique se você tem um arquivo JSON de chave de conta de serviço válido armazenado na
variável de ambiente
GOOGLE_APPLICATION_CREDENTIALS. Para diagnosticar esse erro, tente abrir o arquivo de chave da conta de serviço na pasta que você quer chamar a API Document AI.cat $GOOGLE_APPLICATION_CREDENTIALS
Erro ao gravar a saída final
Se você receber uma mensagem como esta ao receber os resultados de uma solicitação de processo em lote:
{
"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"
}
}
Sua conta de serviço pode não ter as permissões corretas para criar objetos no bucket do Cloud Storage. Confira se você atribuiu as permissões corretas à sua conta de serviço, conforme descrito no guia de início rápido.
Você também pode ter digitado errado o nome do bucket do Cloud Storage. Verifique se o bucket que você está tentando acessar existe.
P4SA sem acesso ao Cloud Storage
Quando a conta de serviço por produto (P4SA) da Document AI não tem permissão para acessar alguns recursos do Cloud Storage.
message: "Cloud DocumentAI P4SA doesn't have access to this Cloud Storage resource:"
A conta de serviço não pode criar um objeto no Cloud Storage
Quando a conta de serviço por produto (P4SA) da Document AI não tem permissão para criar um objeto no 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."
A conta de serviço da Document AI pode não ter as permissões corretas para criar objetos no bucket do Cloud Storage. Confira se você atribuiu as permissões corretas à conta de serviço da Document AI, conforme descrito na configuração de acesso a arquivos entre projetos.
Você também pode ter digitado errado o nome do bucket do Cloud Storage. Verifique se o bucket que você está tentando acessar existe.
O usuário não pode receber objetos no Cloud Storage
Quando o autor da chamada da API Document AI não tem permissão para receber objetos no Cloud Storage.
message: "The caller does not have permission storage.objects.get to get Google
Cloud Storage objects in bucket gs://foo."
O usuário que chama a API talvez não tenha as permissões corretas para receber objetos no bucket do Cloud Storage. Verifique se você atribuiu as permissões corretas ao caller.
Você também pode ter digitado errado o nome do bucket do Cloud Storage. Verifique se o bucket que você está tentando acessar existe.
Argumentos inválidos
A resolução exige algumas etapas, conforme descrito na mensagem de erro.
Versão da API não aceita
Quando uma solicitação é feita para uma versão da API que não oferece suporte à operação.
message: "The requested operation is unsupported for the API version."
Tipo de processador incompatível
Quando uma solicitação é feita para um método de API que não é compatível com o tipo de processador especificado.
message: "The requested operation is unsupported for the processor type: ${PROCESSOR_TYPE}."
Bad Request (Solicitação inválida)
Quando uma solicitação de API é feita, mas os campos têm uma ou mais violações.
Cada violação é capturada como um field_violations nos detalhes de google.rpc.BadRequest.
message: "Request contains an invalid argument."
details {
[type.googleapis.com/google.rpc.BadRequest] {
field_violations { field: "foo" description: "bar" }
}
}
Falha no processamento em lote de todos os documentos
Quando todos os documentos em uma solicitação de processamento em lote não são processados.
message: "Failed to process all documents."
details {
[type.googleapis.com/google.rpc.ErrorInfo] {
reason: "FAILED_TO_PROCESS_ALL_DOCUMENTS"
domain: "documentai.googleapis.com"
}
}
Nenhum documento encontrado
Quando documentos são necessários ou esperados, mas nenhum é fornecido, como ao importar documentos por URI do 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"
}
}
Os parâmetros gcsUriPrefix e gcsOutputConfig.gcsUri precisam começar com gs:// e terminar com uma barra invertida (/). Verifique a configuração dos URIs do bucket.
Exemplo: gs://bucket/directory/
O treinamento não é compatível
Quando uma solicitação de treinamento de versão do processador é feita em um tipo de processador que não oferece suporte ao treinamento.
message: "Training is not supported on processor type: ${DOCUMENT_TYPE}_PROCESSOR."
Nenhum documento selecionado
Quando documentos são esperados, mas nenhum é selecionado no conjunto de dados, como ao criar jobs de rotulagem de dados.
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"
}
}
Tipo de documento não encontrado
Quando a classe de um documento (como carteira de habilitação, passaporte ou fatura) não corresponde à classificação necessária para o tipo de processador. Por exemplo, quando a etapa de classificação no analisador W2 não encontra elementos de uma fatura.
Ele também pode aparecer como Couldn't preview the document: Unable to find a document of type: 'foo' no console Google Cloud .
Essa mensagem de erro é aplicável a processadores legados.
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"
}
}
O limite de tamanho do documento foi excedido
Quando o limite superior do tamanho de arquivo de um documento é excedido durante a importação do conjunto de dados ou a execução da previsão.
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 documentos excedido
Quando o limite superior da contagem de documentos é excedido.
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 sem suporte
Quando um tipo MIME incompatível foi fornecido. O sistema verifica o formato do arquivo (tipo MIME) quando você importa um conjunto de dados ou faz uma chamada de previsão. Acesse Arquivos compatíveis (e Layout Parser) para conferir os tipos de arquivo disponíveis. Se o formato de arquivo não for compatível, você vai receber a seguinte mensagem de erro:
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" }
}
}
Nenhuma página
Quando um documento sem páginas foi fornecido, mas uma ou mais páginas são necessárias.
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
Quando um documento lista um valor negativo para um dos 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
Quando um documento lista o mesmo número de página uma ou mais vezes.
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 páginas excedido
Quando o limite superior do número total de páginas de um documento é excedido. Esse erro ocorre durante a importação ou previsão de um conjunto de dados quando um documento tem muitas páginas, excedendo os limites do processador.
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" }
}
}
O limite de páginas foi excedido no modo sem imagens
Esse erro ocorre durante a importação ou previsão de um conjunto de dados quando um documento tem muitas páginas, excedendo os limites do processador. Você pode solicitar a adição do seu projeto a uma lista de permissões para ativar o modo sem imagens, o que aumenta o limite de páginas para 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" }
}
}
Mudança de estado da versão do processador pré-treinado
Quando uma solicitação para mudar o estado de uma versão de processador pré-treinado foi emitida. Esse erro aparece ao tentar excluir uma versão pré-treinada de um processador.
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" }
}
}
Validação de conjunto de dados
Quando um conjunto de dados não atende aos critérios de validação, por exemplo, devido a âncoras de página ausentes, dados incorretos ou detalhes incompletos em alguns atributos do objeto proto do 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 não inline para revisão do Human in the Loop
Quando uma revisão humana foi iniciada para um documento que não foi definido inline.
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 inválido
Quando o tipo de documento é inválido ou não é compatível com o processador. Um tipo de documento se refere à categoria do documento (por exemplo, W2), não o formato do arquivo ou o tipo MIME, como 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" }
}
}
Intervalo do documento fora dos 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" }
}
}
Intervalo de documento inválido
Quando um período de documento inválido, como o início sendo posterior ao fim, é fornecido.
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 inválido
Quando um documento que inclui UTF-8 inválido é fornecido.
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)" }
}
}
O esquema do conjunto de dados é inválido
Quando um processador não tem um esquema de união válido ou o esquema de conjunto de dados fornecido não é 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 sem suporte
Quando uma solicitação de processamento é emitida para um processador que não oferece suporte a 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"
}
}
Configuração de importação inválida
Quando a configuração de importação é inválida.
message: "The import config is invalid: foo"
details {
[type.googleapis.com/google.rpc.ErrorInfo] {
reason: "INVALID_IMPORT_CONFIG"
domain: "documentai.googleapis.com"
}
}
A versão do processador de origem é inválida
Ao tentar importar uma versão do processador, a versão de origem não é válida para importação.
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"
}
}
Tamanho do bloco inválido
Quando a configuração de tamanho do bloco é invá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"
}
}
Falha na pré-condição
A resolução exige algumas etapas, conforme descrito na mensagem de erro.
Chave KMS inválida
Quando uma chave inválida (por exemplo, desativada) foi fornecida.
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" }
}
}
Mudança no estado do processador
Quando uma solicitação inválida para mudar o estado de um processador é emitida.
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" }
}
}
Mudança de estado da versão do processador
Quando uma solicitação inválida para mudar o estado de uma versão do processador é emitida.
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" }
}
}
O processador não está ativado
Quando uma solicitação que depende de um processador específico é emitida, mas o processador não está ativado.
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" }
}
}
A versão do processador não foi implantada
Quando uma solicitação que depende da implantação de uma versão específica do processador é emitida, mas o processador não está implantado.
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" }
}
}
Versão padrão do processador
Quando uma solicitação que depende de uma versão padrão configurada é emitida, mas não há uma 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" }
}
}
Remover versão padrão do processador
Quando uma solicitação para cancelar a implantação ou excluir uma versão do processador é emitida, mas ela está configurada como a versão padrão.
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" }
}
}
O conjunto de dados não foi inicializado
Quando uma solicitação que exige a inicialização de um conjunto de dados é emitida, mas o conjunto não é inicializado.
message: "Dataset is not initialized."
details {
[type.googleapis.com/google.rpc.ErrorInfo] {
reason: "DATASET_NOT_INITIALIZED"
domain: "documentai.googleapis.com"
}
}
O conjunto de dados foi inicializado ou está sendo inicializado
Quando uma solicitação que exige que um conjunto de dados seja desinicializado é emitida, mas o conjunto de dados já está inicializado ou em processo de inicialização.
message: "Dataset is already initialized or is initializing."
details {
[type.googleapis.com/google.rpc.ErrorInfo] {
reason: "DATASET_INITIALIZED_OR_INITIALIZING"
domain: "documentai.googleapis.com"
}
}
Erro "Dataset Location Not Empty"
Quando uma solicitação exige que um local de armazenamento de conjunto de dados esteja vazio, mas a pasta contém 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"
}
}
Tem erro de operação de bloqueio
Quando há outras operações em execução que estão bloqueando a operação necessária.
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"
}
}
Erro de intervalo de páginas não compatível
Quando o campo page_range não é compatível com alguma operação, como em um processo em lote.
message: "Page range is not supported."
details {
[type.googleapis.com/google.rpc.ErrorInfo] {
reason: "PAGE_RANGE_UNSUPPORTED"
domain: "documentai.googleapis.com"
}
}
A pasta do Cloud Storage contém um erro no conjunto de dados
Quando uma pasta do Cloud Storage já contém um conjunto de dados.
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"
}
}
Erro de miniatura ausente
Quando não é possível buscar a miniatura de um documento do conjunto de dados.
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 páginas do conjunto de dados excedido
Quando o limite total de páginas de um conjunto de dados é excedido.
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"
}
}
Processador incompatível com o processamento síncrono
Quando uma solicitação é feita para uma versão de processador que não é mais compatível com o processamento 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"
}
}
Não encontrado
A resolução exige algumas etapas, conforme descrito na mensagem de erro.
Avaliação não encontrada
Quando não é possível encontrar uma avaliação para uma versão do processador.
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 não encontrado
Quando um documento necessário para uma operação não é encontrado.
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" }
}
}
Processador não encontrado
Quando um processador necessário para uma operação não é encontrado.
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" }
}
}
Versão do processador não encontrada
Quando uma versão do processador necessária para uma operação não é encontrada.
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 de rotulagem de dados não encontrado
Quando não é possível encontrar um job de rotulagem de dados.
message: "Data labeling job with id 'EXAMPLE_DATA_LABELING_JOB' not found in processor EXAMPLE_PROCESSOR."
Versão do esquema não encontrada
Quando uma versão do esquema não é encontrada.
message: "Schema version with id 'EXAMPLE_SCHEMA_VERSION' not found."
Esquema não encontrado
Quando um esquema não é encontrado.
message: "Schema with id 'EXAMPLE_SCHEMA' not found."
Já existe
A resolução exige algumas etapas, conforme descrito na mensagem de erro.
O rotulador humano já existe
Ao criar um pool de rotuladores que já existe.
message: "The labeler pool already exists."
O nome de exibição da versão do esquema já existe
Ao criar uma versão de esquema com um nome de exibição que já existe.
message: "A schema version with the name 'EXAMPLE_SCHEMA_VERSION' already exists."
O nome de exibição do esquema já existe
Ao criar um esquema com um nome de exibição que já existe.
message: "A schema with the name 'EXAMPLE_SCHEMA' already exists."
Cotas e limites
A resolução exige algumas etapas, conforme descrito na mensagem de erro.
Cota excedida
Se você recebeu esta mensagem:
RESOURCE_EXHAUSTED: Quota exceeded.
Você atingiu o limite de sua cota diária ou por minuto. Revise as cotas e limites para usar a Document AI.
Solicite um aumento das suas cotas pelo consoleGoogle Cloud .
Interrupções e latência
A resolução exige algumas etapas, conforme descrito na mensagem de erro.
Tempo limite
- Para o processamento on-line, há um tempo limite de dois minutos do lado do servidor para solicitações.
- Para o processamento em lote, há um tempo limite de dois minutos do lado do servidor para gerar a operação de longa duração, mas não há tempo limite para a conclusão do job em lote.
- Para mais informações, consulte a documentação de Operações de longa duração.
A operação não foi concluída dentro do tempo limite designado.
Se você receber as seguintes mensagens de erro (ou semelhantes) ao fazer uma pesquisa em uma operação de longa duração (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.
Então, o valor de tempo limite definido pelo usuário para a conclusão da operação está muito baixo para o documento que está sendo processado. Esse erro não indica que a operação de processo em lote falhou. Ela vai continuar independente do valor de tempo limite definido pelo usuário.
Erro do filtro de segurança
Ocorreu um erro interno do lado do servidor porque a solicitação ou resposta foi bloqueada pelos filtros de segurança do modelo de linguagem grande (LLM). Não é possível repetir esse erro.
message: "Safety filter error."
Erro interno
Ocorreu um erro interno do lado do servidor. Tente estabelecer conexão novamente.
message: "Internal error encountered."