From 69cfd7927fc1360ca3f78d223877217e010f4722 Mon Sep 17 00:00:00 2001 From: "gcf-owl-bot[bot]" <78513119+gcf-owl-bot[bot]@users.noreply.github.com> Date: Wed, 17 Apr 2024 10:16:18 -0400 Subject: [PATCH] feat: [google-cloud-documentai] A new message `FoundationModelTuningOptions` is added (#12585) - [ ] Regenerate this pull request now. BEGIN_COMMIT_OVERRIDE feat: A new message `FoundationModelTuningOptions` is added feat: A new field `foundation_model_tuning_options` is added to message `TrainProcessorVersionRequest` docs: updated comments END_COMMIT_OVERRIDE PiperOrigin-RevId: 625415406 Source-Link: https://github.com/googleapis/googleapis/commit/caa099d272fdf00be53d2328259fcbdaab3a3b20 Source-Link: https://github.com/googleapis/googleapis-gen/commit/91684486cc850c8564792720694a20b8c04c5061 Copy-Tag: eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLWRvY3VtZW50YWkvLk93bEJvdC55YW1sIiwiaCI6IjkxNjg0NDg2Y2M4NTBjODU2NDc5MjcyMDY5NGEyMGI4YzA0YzUwNjEifQ== --------- Co-authored-by: Owl Bot Co-authored-by: Anthonios Partheniou --- .../google/cloud/documentai/gapic_version.py | 2 +- .../cloud/documentai_v1/gapic_version.py | 2 +- .../cloud/documentai_v1/types/document.py | 3 +- .../types/document_processor_service.py | 40 +++++++++++++++++++ .../cloud/documentai_v1beta2/gapic_version.py | 2 +- .../cloud/documentai_v1beta3/gapic_version.py | 2 +- ...t_metadata_google.cloud.documentai.v1.json | 2 +- ...adata_google.cloud.documentai.v1beta2.json | 2 +- ...adata_google.cloud.documentai.v1beta3.json | 2 +- .../scripts/fixup_documentai_v1_keywords.py | 2 +- 10 files changed, 49 insertions(+), 10 deletions(-) diff --git a/packages/google-cloud-documentai/google/cloud/documentai/gapic_version.py b/packages/google-cloud-documentai/google/cloud/documentai/gapic_version.py index b501783accc6..558c8aab67c5 100644 --- a/packages/google-cloud-documentai/google/cloud/documentai/gapic_version.py +++ b/packages/google-cloud-documentai/google/cloud/documentai/gapic_version.py @@ -13,4 +13,4 @@ # See the License for the specific language governing permissions and # limitations under the License. # -__version__ = "2.25.0" # {x-release-please-version} +__version__ = "0.0.0" # {x-release-please-version} diff --git a/packages/google-cloud-documentai/google/cloud/documentai_v1/gapic_version.py b/packages/google-cloud-documentai/google/cloud/documentai_v1/gapic_version.py index b501783accc6..558c8aab67c5 100644 --- a/packages/google-cloud-documentai/google/cloud/documentai_v1/gapic_version.py +++ b/packages/google-cloud-documentai/google/cloud/documentai_v1/gapic_version.py @@ -13,4 +13,4 @@ # See the License for the specific language governing permissions and # limitations under the License. # -__version__ = "2.25.0" # {x-release-please-version} +__version__ = "0.0.0" # {x-release-please-version} diff --git a/packages/google-cloud-documentai/google/cloud/documentai_v1/types/document.py b/packages/google-cloud-documentai/google/cloud/documentai_v1/types/document.py index a416236bb7f8..6222554302aa 100644 --- a/packages/google-cloud-documentai/google/cloud/documentai_v1/types/document.py +++ b/packages/google-cloud-documentai/google/cloud/documentai_v1/types/document.py @@ -611,8 +611,7 @@ class StyleInfo(proto.Message): pixel_font_size (float): Font size in pixels, equal to *unrounded [font_size][google.cloud.documentai.v1.Document.Page.Token.StyleInfo.font_size]* - - - *resolution* ÷ ``72.0``. + \* *resolution* ÷ ``72.0``. letter_spacing (float): Letter spacing in points. font_type (str): diff --git a/packages/google-cloud-documentai/google/cloud/documentai_v1/types/document_processor_service.py b/packages/google-cloud-documentai/google/cloud/documentai_v1/types/document_processor_service.py index 11245036461d..4946d4528c0f 100644 --- a/packages/google-cloud-documentai/google/cloud/documentai_v1/types/document_processor_service.py +++ b/packages/google-cloud-documentai/google/cloud/documentai_v1/types/document_processor_service.py @@ -1155,6 +1155,10 @@ class TrainProcessorVersionRequest(proto.Message): [TrainProcessorVersion][google.cloud.documentai.v1.DocumentProcessorService.TrainProcessorVersion] method. + This message has `oneof`_ fields (mutually exclusive fields). + For each oneof, at most one member field can be set at the same time. + Setting any member of the oneof automatically clears all other + members. .. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields @@ -1163,6 +1167,11 @@ class TrainProcessorVersionRequest(proto.Message): Options to control Custom Document Extraction (CDE) Processor. + This field is a member of `oneof`_ ``processor_flags``. + foundation_model_tuning_options (google.cloud.documentai_v1.types.TrainProcessorVersionRequest.FoundationModelTuningOptions): + Options to control foundation model tuning of + a processor. + This field is a member of `oneof`_ ``processor_flags``. parent (str): Required. The parent (project, location and processor) to @@ -1239,12 +1248,43 @@ class TrainingMethod(proto.Enum): enum="TrainProcessorVersionRequest.CustomDocumentExtractionOptions.TrainingMethod", ) + class FoundationModelTuningOptions(proto.Message): + r"""Options to control foundation model tuning of the processor. + + Attributes: + train_steps (int): + Optional. The number of steps to run for + model tuning. Valid values are between 1 and + 400. If not provided, recommended steps will be + used. + learning_rate_multiplier (float): + Optional. The multiplier to apply to the + recommended learning rate. Valid values are + between 0.1 and 10. If not provided, recommended + learning rate will be used. + """ + + train_steps: int = proto.Field( + proto.INT32, + number=2, + ) + learning_rate_multiplier: float = proto.Field( + proto.FLOAT, + number=3, + ) + custom_document_extraction_options: CustomDocumentExtractionOptions = proto.Field( proto.MESSAGE, number=5, oneof="processor_flags", message=CustomDocumentExtractionOptions, ) + foundation_model_tuning_options: FoundationModelTuningOptions = proto.Field( + proto.MESSAGE, + number=12, + oneof="processor_flags", + message=FoundationModelTuningOptions, + ) parent: str = proto.Field( proto.STRING, number=1, diff --git a/packages/google-cloud-documentai/google/cloud/documentai_v1beta2/gapic_version.py b/packages/google-cloud-documentai/google/cloud/documentai_v1beta2/gapic_version.py index b501783accc6..558c8aab67c5 100644 --- a/packages/google-cloud-documentai/google/cloud/documentai_v1beta2/gapic_version.py +++ b/packages/google-cloud-documentai/google/cloud/documentai_v1beta2/gapic_version.py @@ -13,4 +13,4 @@ # See the License for the specific language governing permissions and # limitations under the License. # -__version__ = "2.25.0" # {x-release-please-version} +__version__ = "0.0.0" # {x-release-please-version} diff --git a/packages/google-cloud-documentai/google/cloud/documentai_v1beta3/gapic_version.py b/packages/google-cloud-documentai/google/cloud/documentai_v1beta3/gapic_version.py index b501783accc6..558c8aab67c5 100644 --- a/packages/google-cloud-documentai/google/cloud/documentai_v1beta3/gapic_version.py +++ b/packages/google-cloud-documentai/google/cloud/documentai_v1beta3/gapic_version.py @@ -13,4 +13,4 @@ # See the License for the specific language governing permissions and # limitations under the License. # -__version__ = "2.25.0" # {x-release-please-version} +__version__ = "0.0.0" # {x-release-please-version} diff --git a/packages/google-cloud-documentai/samples/generated_samples/snippet_metadata_google.cloud.documentai.v1.json b/packages/google-cloud-documentai/samples/generated_samples/snippet_metadata_google.cloud.documentai.v1.json index 161ce5f3cfed..96d60af285a2 100644 --- a/packages/google-cloud-documentai/samples/generated_samples/snippet_metadata_google.cloud.documentai.v1.json +++ b/packages/google-cloud-documentai/samples/generated_samples/snippet_metadata_google.cloud.documentai.v1.json @@ -8,7 +8,7 @@ ], "language": "PYTHON", "name": "google-cloud-documentai", - "version": "2.25.0" + "version": "0.1.0" }, "snippets": [ { diff --git a/packages/google-cloud-documentai/samples/generated_samples/snippet_metadata_google.cloud.documentai.v1beta2.json b/packages/google-cloud-documentai/samples/generated_samples/snippet_metadata_google.cloud.documentai.v1beta2.json index 8204c15c57a1..ef56bd7e3eb3 100644 --- a/packages/google-cloud-documentai/samples/generated_samples/snippet_metadata_google.cloud.documentai.v1beta2.json +++ b/packages/google-cloud-documentai/samples/generated_samples/snippet_metadata_google.cloud.documentai.v1beta2.json @@ -8,7 +8,7 @@ ], "language": "PYTHON", "name": "google-cloud-documentai", - "version": "2.25.0" + "version": "0.1.0" }, "snippets": [ { diff --git a/packages/google-cloud-documentai/samples/generated_samples/snippet_metadata_google.cloud.documentai.v1beta3.json b/packages/google-cloud-documentai/samples/generated_samples/snippet_metadata_google.cloud.documentai.v1beta3.json index 450647d888ae..f47545a8ed3e 100644 --- a/packages/google-cloud-documentai/samples/generated_samples/snippet_metadata_google.cloud.documentai.v1beta3.json +++ b/packages/google-cloud-documentai/samples/generated_samples/snippet_metadata_google.cloud.documentai.v1beta3.json @@ -8,7 +8,7 @@ ], "language": "PYTHON", "name": "google-cloud-documentai", - "version": "2.25.0" + "version": "0.1.0" }, "snippets": [ { diff --git a/packages/google-cloud-documentai/scripts/fixup_documentai_v1_keywords.py b/packages/google-cloud-documentai/scripts/fixup_documentai_v1_keywords.py index 022c18fa1d3e..6f1be661e967 100644 --- a/packages/google-cloud-documentai/scripts/fixup_documentai_v1_keywords.py +++ b/packages/google-cloud-documentai/scripts/fixup_documentai_v1_keywords.py @@ -59,7 +59,7 @@ class documentaiCallTransformer(cst.CSTTransformer): 'process_document': ('name', 'inline_document', 'raw_document', 'gcs_document', 'skip_human_review', 'field_mask', 'process_options', 'labels', ), 'review_document': ('human_review_config', 'inline_document', 'enable_schema_validation', 'priority', 'document_schema', ), 'set_default_processor_version': ('processor', 'default_processor_version', ), - 'train_processor_version': ('parent', 'processor_version', 'custom_document_extraction_options', 'document_schema', 'input_data', 'base_processor_version', ), + 'train_processor_version': ('parent', 'processor_version', 'custom_document_extraction_options', 'foundation_model_tuning_options', 'document_schema', 'input_data', 'base_processor_version', ), 'undeploy_processor_version': ('name', ), }