Custom Models
Troubleshoot common problems with custom models in Document Understanding.
- Job Run Couldn't be Started because of Service Issues
- Parsing Records Returns an Error
- Not Enough Samples to Split Dataset into Train, Validation, and Test Sets
- Error while Loading the Visual Model
- Compute Resource not Available to Train Model
- Create Model Failed
- Invalid DLS Dataset Annotation Type
- Error Occurred during Dataset File () Validation
- Fail to Export the Annotation File for DLS Dataset
- Failed in DLS Snapshot Wait Step
- Create Model Failed while Querying Job Shapes
- Model-Count or Project-Count Limit Exceeded
- Deployment Failed for Model
- All Classes should have at Least {MIN_REQUIRED_SAMPLES} Samples for Data Split
Job Run Couldn't be Started because of Service Issues
A job run doesn't start and the following error message is shown: Job run could not be started due to service issues. Please try again later.
This is a service issue.
- Wait a few minutes and try again.
-
If the job run still fails, send an email to
contact_document_understanding_ww_grp@oracle.com
with the model ocid and region details for further help.
Parsing Records Returns an Error
While parsing records, the following error is returned: Please ensure you are not using an empty dataset, and that your dataset matches the type of model you are trying to train.
- Missing a label
- The labeled data has a different annotation class to the custom model you're trying to train.
- The document is smaller than 32 x 32 pixels.
- A file is password-protected.
- A file is corrupt.
Not Enough Samples to Split Dataset into Train, Validation, and Test Sets
Training a dataset fails with the error: Not enough samples to split dataset into Train, Validation and Test sets. Ensure the required number of samples for each class are in the dataset.
The error might also include information the number of records for each label. For example: {'a': {'val': 1, 'test': 1, 'train': 3}, 'b': {'val': 0, 'test': 0, 'train': 3}}
There aren't enough valid records for each label. In the example error, there aren't enough records for label "b" (only three documents are labeled). Label two more records with label b to resolve the issue.
Error while Loading the Visual Model
While loading the model you get the following error: Error while loading the visual model. Please check the base model version.
This is a service issue.
contact_document_understanding_ww_grp@oracle.com
with the model ocid and region details for further help.
Compute Resource not Available to Train Model
While training a custom model, you get the following error: Compute resource not available to train model. Please try again later.
This is a service issue.
- Wait a few minutes and try again.
-
If the job run still fails, send an email to
contact_document_understanding_ww_grp@oracle.com
with the model ocid and region details for further help.
Create Model Failed
Creating a custom model fails with the following error: Create Model failed because the given training dataset with OCID does not exist, or has too few Records or Annotations.
The dataset is incomplete or doesn't exist.
- Make the dataset available.
- Give it the required number of records and annotations.
Invalid DLS Dataset Annotation Type
When using a dataset from Data Labeling, you get the following error: Invalid dls dataset annotation type. There is a mismatch in the model type and dls dataset annotation type. Please select a dataset with <> annotation type for <> model type.
Status Code: 400
The dataset format and model type don't match.
Error Occurred during Dataset File () Validation
When using a custom model, you get the error:
Error occurred during dataset file () validation. Invalid annotationFormat: <> Please check annotationFormat inside dataset file. Expected annotationFormat is <>
Status Code: 400
The dataset format and model type don't match.
Fail to Export the Annotation File for DLS Dataset
When using a dataset from Data Labeling, you get the following error: Fail to export the annotation file for dls dataset.
This is a service issue.
- Wait a few minutes and try again.
-
If the job run still fails, send an email to
contact_document_understanding_ww_grp@oracle.com
with the model ocid and region details for further help.
Failed in DLS Snapshot Wait Step
When using a custom model based on a Data Labeling dataset, you get the following error: Failed in DLS snapshot wait step.
This is a service issue.
- Wait a few minutes and try again.
-
If the job run still fails, send an email to
contact_document_understanding_ww_grp@oracle.com
with the model ocid and region details for further help.
Create Model Failed while Querying Job Shapes
While creating a custom model, you get the error: Create model failed while querying job shapes.
This is a service issue.
- Wait a few minutes and try again.
-
If the job run still fails, send an email to
contact_document_understanding_ww_grp@oracle.com
with the model ocid and region details for further help.
Model-Count or Project-Count Limit Exceeded
While using a custom model, you get the error: model-count/project-count limit exceeded.
The limits for models or projects have been exceeded.
- Rasie a request to increate the model or project count for Document Understanding.
- Delete any models or projects that are no longer needed.
Deployment Failed for Model
Using a custom model, you get the error: Deployment failed for model <model_ocid>.
This is a service issue.
contact_document_understanding_ww_grp@oracle.com
with
the model ocid and region details for further help. All Classes should have at Least {MIN_REQUIRED_SAMPLES} Samples for Data Split
When using a custom model, you get the error: All classes should have at least {MIN_REQUIRED_SAMPLES} samples for data split. Classes ["a", "b"] have less than required number of samples.
The input dataset is missing records for the labels mentioned. In the example, the labels a and b are missing records.