chore: librarian generate pull request: 20251217T081427Z

[cloud-sdk-librarian-robot]

PR created by the Librarian CLI to generate Cloud Client Libraries code from protos.

BEGIN_COMMIT

BEGIN_NESTED_COMMIT
chore: Correctly escape comment in DefaultServiceAccount

PiperOrigin-RevId: 845430981
Library-IDs: cloudbuild
Source-link: googleapis/googleapis@ba1f5de3
END_NESTED_COMMIT

BEGIN_NESTED_COMMIT
docs: A comment for field restart_job_on_worker_restart in message .google.cloud.aiplatform.v1beta1.Scheduling is changed

PiperOrigin-RevId: 845354898
Library-IDs: aiplatform
Source-link: googleapis/googleapis@a8e146aa
END_NESTED_COMMIT

BEGIN_NESTED_COMMIT
docs: A comment for field timeout in message .google.cloud.aiplatform.v1beta1.Scheduling is changed

PiperOrigin-RevId: 845354898
Library-IDs: aiplatform
Source-link: googleapis/googleapis@a8e146aa
END_NESTED_COMMIT

BEGIN_NESTED_COMMIT
feat: Add Lustre support to the Vertex Training Custom Job API

PiperOrigin-RevId: 845354898
Library-IDs: aiplatform
Source-link: googleapis/googleapis@a8e146aa
END_NESTED_COMMIT

BEGIN_NESTED_COMMIT
docs: Improve documentation of attachment.proto, event_payload.proto and space.proto

PiperOrigin-RevId: 845227338
Library-IDs: chat
Source-link: googleapis/googleapis@1a9d00be
END_NESTED_COMMIT

BEGIN_NESTED_COMMIT
feat: Add accessory widget support for private messages

PiperOrigin-RevId: 845227338
Library-IDs: chat
Source-link: googleapis/googleapis@1a9d00be
END_NESTED_COMMIT

BEGIN_NESTED_COMMIT
feat: Add app authorization support to space APIs

PiperOrigin-RevId: 845227338
Library-IDs: chat
Source-link: googleapis/googleapis@1a9d00be
END_NESTED_COMMIT

BEGIN_NESTED_COMMIT
docs: specify the data sources supported only by the QueryData API

PiperOrigin-RevId: 845011245
Library-IDs: geminidataanalytics
Source-link: googleapis/googleapis@4149dbdc
END_NESTED_COMMIT

BEGIN_NESTED_COMMIT
feat: A new field satisfies_pzi is added to message .google.cloud.memorystore.v1.Instance

PiperOrigin-RevId: 844938993
Library-IDs: memorystore
Source-link: googleapis/googleapis@b60f5a57
END_NESTED_COMMIT

BEGIN_NESTED_COMMIT
feat: A new field total_backup_size_bytes is added to message .google.cloud.memorystore.v1.BackupCollection

PiperOrigin-RevId: 844938993
Library-IDs: memorystore
Source-link: googleapis/googleapis@b60f5a57
END_NESTED_COMMIT

BEGIN_NESTED_COMMIT
feat: A new field effective_maintenance_version is added to message .google.cloud.memorystore.v1.Instance

PiperOrigin-RevId: 844938993
Library-IDs: memorystore
Source-link: googleapis/googleapis@b60f5a57
END_NESTED_COMMIT

BEGIN_NESTED_COMMIT
feat: A new field encryption_info is added to message .google.cloud.memorystore.v1.Backup

PiperOrigin-RevId: 844938993
Library-IDs: memorystore
Source-link: googleapis/googleapis@b60f5a57
END_NESTED_COMMIT

BEGIN_NESTED_COMMIT
feat: A new field available_maintenance_versions is added to message .google.cloud.memorystore.v1.Instance

PiperOrigin-RevId: 844938993
Library-IDs: memorystore
Source-link: googleapis/googleapis@b60f5a57
END_NESTED_COMMIT

BEGIN_NESTED_COMMIT
feat: A new field total_backup_count is added to message .google.cloud.memorystore.v1.BackupCollection

PiperOrigin-RevId: 844938993
Library-IDs: memorystore
Source-link: googleapis/googleapis@b60f5a57
END_NESTED_COMMIT

BEGIN_NESTED_COMMIT
feat: A new field last_backup_time is added to message .google.cloud.memorystore.v1.BackupCollection

PiperOrigin-RevId: 844938993
Library-IDs: memorystore
Source-link: googleapis/googleapis@b60f5a57
END_NESTED_COMMIT

BEGIN_NESTED_COMMIT
feat: A new field encryption_info is added to message .google.cloud.memorystore.v1.Instance

PiperOrigin-RevId: 844938993
Library-IDs: memorystore
Source-link: googleapis/googleapis@b60f5a57
END_NESTED_COMMIT

BEGIN_NESTED_COMMIT
feat: A new field allow_fewer_zones_deployment is added to message .google.cloud.memorystore.v1.Instance

PiperOrigin-RevId: 844938993
Library-IDs: memorystore
Source-link: googleapis/googleapis@b60f5a57
END_NESTED_COMMIT

BEGIN_NESTED_COMMIT
feat: A new field Instance.simulate_maintenance_event is added to message .google.cloud.memorystore.v1.

PiperOrigin-RevId: 844938993
Library-IDs: memorystore
Source-link: googleapis/googleapis@b60f5a57
END_NESTED_COMMIT

BEGIN_NESTED_COMMIT
feat: A new message EncryptionInfo is added

PiperOrigin-RevId: 844938993
Library-IDs: memorystore
Source-link: googleapis/googleapis@b60f5a57
END_NESTED_COMMIT

BEGIN_NESTED_COMMIT
feat: A new field satisfies_pzs is added to message .google.cloud.memorystore.v1.Instance

PiperOrigin-RevId: 844938993
Library-IDs: memorystore
Source-link: googleapis/googleapis@b60f5a57
END_NESTED_COMMIT

BEGIN_NESTED_COMMIT
feat: A new field maintenance_version is added to message .google.cloud.memorystore.v1.Instance

PiperOrigin-RevId: 844938993
Library-IDs: memorystore
Source-link: googleapis/googleapis@b60f5a57
END_NESTED_COMMIT

BEGIN_NESTED_COMMIT
feat: A new field kms_key is added to message .google.cloud.memorystore.v1.Instance

PiperOrigin-RevId: 844938993
Library-IDs: memorystore
Source-link: googleapis/googleapis@b60f5a57
END_NESTED_COMMIT

BEGIN_NESTED_COMMIT
docs: A comment for field discovery_endpoints in message .google.cloud.memorystore.v1.Instance is changed

PiperOrigin-RevId: 844938993
Library-IDs: memorystore
Source-link: googleapis/googleapis@b60f5a57
END_NESTED_COMMIT

BEGIN_NESTED_COMMIT
feat: Addition of GMAIL_MESSAGE value for RichLinkType enum in the RichLinkMetadata proto

PiperOrigin-RevId: 844825126
Library-IDs: chat
Source-link: googleapis/googleapis@4eccddb5
END_NESTED_COMMIT

BEGIN_NESTED_COMMIT
feat: Update Compute Engine v1beta API to revision 20251202

PiperOrigin-RevId:
Library-IDs: compute
Source-link: googleapis/googleapis@a11bbeb4
END_NESTED_COMMIT

BEGIN_NESTED_COMMIT
feat: add LookerGoldenQuery to Context

PiperOrigin-RevId: 844667700
Library-IDs: geminidataanalytics
Source-link: googleapis/googleapis@7ddafd82
END_NESTED_COMMIT

BEGIN_NESTED_COMMIT
feat: Add phone_authentication_event to AnnotateAssessmentRequest. This new field allows you to indicate the phone number associated with a multi-factor authentication event, i.e. INITIATED_TWO_FACTOR, PASSED_TWO_FACTOR, FAILED_TWO_FACTOR reasons, and the time of such an event

PiperOrigin-RevId: 844437009
Library-IDs: recaptchaenterprise
Source-link: googleapis/googleapis@23c58988
END_NESTED_COMMIT

BEGIN_NESTED_COMMIT
docs: document domain, package name and bundle id limits and validation

PiperOrigin-RevId: 844437009
Library-IDs: recaptchaenterprise
Source-link: googleapis/googleapis@23c58988
END_NESTED_COMMIT

BEGIN_NESTED_COMMIT
feat: add verifiedBots field to RiskAnalysis and definitions for a Bot object to store metadata for a detected bot

PiperOrigin-RevId: 844437009
Library-IDs: recaptchaenterprise
Source-link: googleapis/googleapis@23c58988
END_NESTED_COMMIT

BEGIN_NESTED_COMMIT
docs: clarify that WafFeature.EXPRESS is deprecated

PiperOrigin-RevId: 844437009
Library-IDs: recaptchaenterprise
Source-link: googleapis/googleapis@23c58988
END_NESTED_COMMIT

BEGIN_NESTED_COMMIT
feat: add a POLICY_BASED_CHALLENGE IntegrationType and associated settings

PiperOrigin-RevId: 844437009
Library-IDs: recaptchaenterprise
Source-link: googleapis/googleapis@23c58988
END_NESTED_COMMIT

BEGIN_NESTED_COMMIT
feat: add risk reasons to FraudPreventionAssessment

PiperOrigin-RevId: 844437009
Library-IDs: recaptchaenterprise
Source-link: googleapis/googleapis@23c58988
END_NESTED_COMMIT

BEGIN_NESTED_COMMIT
feat: Add support for creating Job resource in dry-run mode

PiperOrigin-RevId: 843787937
Library-IDs: storagebatchoperations
Source-link: googleapis/googleapis@8f3e57f0
END_NESTED_COMMIT

BEGIN_NESTED_COMMIT
feat: Add inclusion scopes

PiperOrigin-RevId: 843787937
Library-IDs: storagebatchoperations
Source-link: googleapis/googleapis@8f3e57f0
END_NESTED_COMMIT

BEGIN_NESTED_COMMIT
feat: Launch storagebatchoperations resource permissions to GA

PiperOrigin-RevId: 843787937
Library-IDs: storagebatchoperations
Source-link: googleapis/googleapis@8f3e57f0
END_NESTED_COMMIT

BEGIN_NESTED_COMMIT
chore: Add Tag Manager IAM permissions for multiple GCP services
Clients can now create Job in dry-run mode, returning the total object count and, if the object configuration is a prefix list, the bytes found from source. No transformations will be performed.

PiperOrigin-RevId: 843787937
Library-IDs: storagebatchoperations
Source-link: googleapis/googleapis@8f3e57f0
END_NESTED_COMMIT

BEGIN_NESTED_COMMIT
docs: Fix comment formatting

PiperOrigin-RevId: 843787937
Library-IDs: storagebatchoperations
Source-link: googleapis/googleapis@8f3e57f0
END_NESTED_COMMIT

BEGIN_NESTED_COMMIT
feat: Launch StorageBatchOperations permissions and roles to GA

PiperOrigin-RevId: 843787937
Library-IDs: storagebatchoperations
Source-link: googleapis/googleapis@8f3e57f0
END_NESTED_COMMIT

BEGIN_NESTED_COMMIT
feat: Add object retention setting to StorageBatchOperations API

PiperOrigin-RevId: 843787937
Library-IDs: storagebatchoperations
Source-link: googleapis/googleapis@8f3e57f0
END_NESTED_COMMIT

BEGIN_NESTED_COMMIT
feat: updated v2beta1 dialogflow client libraries

PiperOrigin-RevId: 843755897
Library-IDs: dialogflow
Source-link: googleapis/googleapis@55ab9c62
END_NESTED_COMMIT

BEGIN_NESTED_COMMIT
feat: updated v3beta1 dialogflow client libraries

PiperOrigin-RevId: 843704214
Library-IDs: dialogflow
Source-link: googleapis/googleapis@3784b368
END_NESTED_COMMIT

BEGIN_NESTED_COMMIT
feat: updated v2 dialogflow client libraries

PiperOrigin-RevId: 843703774
Library-IDs: dialogflow
Source-link: googleapis/googleapis@7a595fde
END_NESTED_COMMIT

BEGIN_NESTED_COMMIT
feat: A new message QueryDataContext is added

PiperOrigin-RevId: 842905100
Library-IDs: geminidataanalytics
Source-link: googleapis/googleapis@b32495a7
END_NESTED_COMMIT

BEGIN_NESTED_COMMIT
feat: A new field alloy_db_reference is added to message .google.cloud.geminidataanalytics.v1beta.Datasource

PiperOrigin-RevId: 842905100
Library-IDs: geminidataanalytics
Source-link: googleapis/googleapis@b32495a7
END_NESTED_COMMIT

BEGIN_NESTED_COMMIT
feat: A new message SpannerReference is added

PiperOrigin-RevId: 842905100
Library-IDs: geminidataanalytics
Source-link: googleapis/googleapis@b32495a7
END_NESTED_COMMIT

BEGIN_NESTED_COMMIT
feat: A new field cloud_sql_reference is added to message .google.cloud.geminidataanalytics.v1beta.Datasource

PiperOrigin-RevId: 842905100
Library-IDs: geminidataanalytics
Source-link: googleapis/googleapis@b32495a7
END_NESTED_COMMIT

BEGIN_NESTED_COMMIT
feat: A new method QueryData is added to service DataChatService

PiperOrigin-RevId: 842905100
Library-IDs: geminidataanalytics
Source-link: googleapis/googleapis@b32495a7
END_NESTED_COMMIT

BEGIN_NESTED_COMMIT
feat: add a QueryData API for NL2SQL conversion

PiperOrigin-RevId: 842905100
Library-IDs: geminidataanalytics
Source-link: googleapis/googleapis@b32495a7
END_NESTED_COMMIT

BEGIN_NESTED_COMMIT
feat: A new message AlloyDbDatabaseReference is added

PiperOrigin-RevId: 842905100
Library-IDs: geminidataanalytics
Source-link: googleapis/googleapis@b32495a7
END_NESTED_COMMIT

BEGIN_NESTED_COMMIT
feat: A new message CloudSqlReference is added

PiperOrigin-RevId: 842905100
Library-IDs: geminidataanalytics
Source-link: googleapis/googleapis@b32495a7
END_NESTED_COMMIT

BEGIN_NESTED_COMMIT
feat: A new message ExecutedQueryResult is added

PiperOrigin-RevId: 842905100
Library-IDs: geminidataanalytics
Source-link: googleapis/googleapis@b32495a7
END_NESTED_COMMIT

BEGIN_NESTED_COMMIT
feat: A new message AgentContextReference is added

PiperOrigin-RevId: 842905100
Library-IDs: geminidataanalytics
Source-link: googleapis/googleapis@b32495a7
END_NESTED_COMMIT

BEGIN_NESTED_COMMIT
feat: A new field spanner_reference is added to message .google.cloud.geminidataanalytics.v1beta.Datasource

PiperOrigin-RevId: 842905100
Library-IDs: geminidataanalytics
Source-link: googleapis/googleapis@b32495a7
END_NESTED_COMMIT

BEGIN_NESTED_COMMIT
feat: A new message AlloyDbReference is added

PiperOrigin-RevId: 842905100
Library-IDs: geminidataanalytics
Source-link: googleapis/googleapis@b32495a7
END_NESTED_COMMIT

BEGIN_NESTED_COMMIT
feat: A new message GenerationOptions is added

PiperOrigin-RevId: 842905100
Library-IDs: geminidataanalytics
Source-link: googleapis/googleapis@b32495a7
END_NESTED_COMMIT

BEGIN_NESTED_COMMIT
feat: A new message SpannerDatabaseReference is added

PiperOrigin-RevId: 842905100
Library-IDs: geminidataanalytics
Source-link: googleapis/googleapis@b32495a7
END_NESTED_COMMIT

BEGIN_NESTED_COMMIT
feat: A new field spanner_reference is added to message .google.cloud.geminidataanalytics.v1beta.DatasourceReferences

PiperOrigin-RevId: 842905100
Library-IDs: geminidataanalytics
Source-link: googleapis/googleapis@b32495a7
END_NESTED_COMMIT

BEGIN_NESTED_COMMIT
feat: A new message CloudSqlDatabaseReference is added

PiperOrigin-RevId: 842905100
Library-IDs: geminidataanalytics
Source-link: googleapis/googleapis@b32495a7
END_NESTED_COMMIT

BEGIN_NESTED_COMMIT
feat: A new message QueryDataResponse is added

PiperOrigin-RevId: 842905100
Library-IDs: geminidataanalytics
Source-link: googleapis/googleapis@b32495a7
END_NESTED_COMMIT

BEGIN_NESTED_COMMIT
feat: A new field cloud_sql_reference is added to message .google.cloud.geminidataanalytics.v1beta.DatasourceReferences

PiperOrigin-RevId: 842905100
Library-IDs: geminidataanalytics
Source-link: googleapis/googleapis@b32495a7
END_NESTED_COMMIT

BEGIN_NESTED_COMMIT
feat: A new message QueryDataRequest is added

PiperOrigin-RevId: 842905100
Library-IDs: geminidataanalytics
Source-link: googleapis/googleapis@b32495a7
END_NESTED_COMMIT

BEGIN_NESTED_COMMIT
feat: A new field alloydb is added to message .google.cloud.geminidataanalytics.v1beta.DatasourceReferences

PiperOrigin-RevId: 842905100
Library-IDs: geminidataanalytics
Source-link: googleapis/googleapis@b32495a7
END_NESTED_COMMIT

BEGIN_NESTED_COMMIT
docs: add messages stating that Data Catalog actions are deprecated

PiperOrigin-RevId: 842872738
Library-IDs: dlp
Source-link: googleapis/googleapis@dba08635
END_NESTED_COMMIT

BEGIN_NESTED_COMMIT
docs: add example resource name to VertexDatasetResourceReference

PiperOrigin-RevId: 842872738
Library-IDs: dlp
Source-link: googleapis/googleapis@dba08635
END_NESTED_COMMIT

END_COMMIT

This pull request is generated with proto changes between
googleapis/googleapis@effe5c4f
(exclusive) and
googleapis/googleapis@ba1f5de3
(inclusive).

Librarian Version: v0.0.0-20251120153138-6e4de1e6ca60
Language Image: us-central1-docker.pkg.dev/cloud-sdk-librarian-prod/images-prod/librarian-go@sha256:718167d5c23ed389b41f617b3a00ac839bdd938a6bd2d48ae0c2f1fa51ab1c3d

[snippet-bot]

Here is the summary of changes.

You are about to add 33 region tags.

• internal/generated/snippets/compute/apiv1/AdviceClient/CalendarMode/main.go:17, tag compute_v1_generated_Advice_CalendarMode_sync
• internal/generated/snippets/compute/apiv1beta/NetworksClient/CancelRequestRemovePeering/main.go:17, tag compute_v1beta_generated_Networks_CancelRequestRemovePeering_sync
• internal/generated/snippets/compute/apiv1beta/RegionInstanceGroupManagersClient/AdoptInstances/main.go:17, tag compute_v1beta_generated_RegionInstanceGroupManagers_AdoptInstances_sync
• internal/generated/snippets/dialogflow/apiv2/GeneratorEvaluationsClient/CancelOperation/main.go:17, tag dialogflow_v2_generated_GeneratorEvaluations_CancelOperation_sync
• internal/generated/snippets/dialogflow/apiv2/GeneratorEvaluationsClient/CreateGeneratorEvaluation/main.go:17, tag dialogflow_v2_generated_GeneratorEvaluations_CreateGeneratorEvaluation_sync
• internal/generated/snippets/dialogflow/apiv2/GeneratorEvaluationsClient/DeleteGeneratorEvaluation/main.go:17, tag dialogflow_v2_generated_GeneratorEvaluations_DeleteGeneratorEvaluation_sync
• internal/generated/snippets/dialogflow/apiv2/GeneratorEvaluationsClient/GetGeneratorEvaluation/main.go:17, tag dialogflow_v2_generated_GeneratorEvaluations_GetGeneratorEvaluation_sync
• internal/generated/snippets/dialogflow/apiv2/GeneratorEvaluationsClient/GetLocation/main.go:17, tag dialogflow_v2_generated_GeneratorEvaluations_GetLocation_sync
• internal/generated/snippets/dialogflow/apiv2/GeneratorEvaluationsClient/GetOperation/main.go:17, tag dialogflow_v2_generated_GeneratorEvaluations_GetOperation_sync
• internal/generated/snippets/dialogflow/apiv2/GeneratorEvaluationsClient/ListGeneratorEvaluations/main.go:17, tag dialogflow_v2_generated_GeneratorEvaluations_ListGeneratorEvaluations_sync
• internal/generated/snippets/dialogflow/apiv2/GeneratorEvaluationsClient/ListLocations/main.go:17, tag dialogflow_v2_generated_GeneratorEvaluations_ListLocations_sync
• internal/generated/snippets/dialogflow/apiv2/GeneratorEvaluationsClient/ListOperations/main.go:17, tag dialogflow_v2_generated_GeneratorEvaluations_ListOperations_sync
• internal/generated/snippets/dialogflow/apiv2/SipTrunksClient/CancelOperation/main.go:17, tag dialogflow_v2_generated_SipTrunks_CancelOperation_sync
• internal/generated/snippets/dialogflow/apiv2/SipTrunksClient/CreateSipTrunk/main.go:17, tag dialogflow_v2_generated_SipTrunks_CreateSipTrunk_sync
• internal/generated/snippets/dialogflow/apiv2/SipTrunksClient/DeleteSipTrunk/main.go:17, tag dialogflow_v2_generated_SipTrunks_DeleteSipTrunk_sync
• internal/generated/snippets/dialogflow/apiv2/SipTrunksClient/GetLocation/main.go:17, tag dialogflow_v2_generated_SipTrunks_GetLocation_sync
• internal/generated/snippets/dialogflow/apiv2/SipTrunksClient/GetOperation/main.go:17, tag dialogflow_v2_generated_SipTrunks_GetOperation_sync
• internal/generated/snippets/dialogflow/apiv2/SipTrunksClient/GetSipTrunk/main.go:17, tag dialogflow_v2_generated_SipTrunks_GetSipTrunk_sync
• internal/generated/snippets/dialogflow/apiv2/SipTrunksClient/ListLocations/main.go:17, tag dialogflow_v2_generated_SipTrunks_ListLocations_sync
• internal/generated/snippets/dialogflow/apiv2/SipTrunksClient/ListOperations/main.go:17, tag dialogflow_v2_generated_SipTrunks_ListOperations_sync
• internal/generated/snippets/dialogflow/apiv2/SipTrunksClient/ListSipTrunks/main.go:17, tag dialogflow_v2_generated_SipTrunks_ListSipTrunks_sync
• internal/generated/snippets/dialogflow/apiv2/SipTrunksClient/UpdateSipTrunk/main.go:17, tag dialogflow_v2_generated_SipTrunks_UpdateSipTrunk_sync
• internal/generated/snippets/dialogflow/apiv2/ToolsClient/CancelOperation/main.go:17, tag dialogflow_v2_generated_Tools_CancelOperation_sync
• internal/generated/snippets/dialogflow/apiv2/ToolsClient/CreateTool/main.go:17, tag dialogflow_v2_generated_Tools_CreateTool_sync
• internal/generated/snippets/dialogflow/apiv2/ToolsClient/DeleteTool/main.go:17, tag dialogflow_v2_generated_Tools_DeleteTool_sync
• internal/generated/snippets/dialogflow/apiv2/ToolsClient/GetLocation/main.go:17, tag dialogflow_v2_generated_Tools_GetLocation_sync
• internal/generated/snippets/dialogflow/apiv2/ToolsClient/GetOperation/main.go:17, tag dialogflow_v2_generated_Tools_GetOperation_sync
• internal/generated/snippets/dialogflow/apiv2/ToolsClient/GetTool/main.go:17, tag dialogflow_v2_generated_Tools_GetTool_sync
• internal/generated/snippets/dialogflow/apiv2/ToolsClient/ListLocations/main.go:17, tag dialogflow_v2_generated_Tools_ListLocations_sync
• internal/generated/snippets/dialogflow/apiv2/ToolsClient/ListOperations/main.go:17, tag dialogflow_v2_generated_Tools_ListOperations_sync
• internal/generated/snippets/dialogflow/apiv2/ToolsClient/ListTools/main.go:17, tag dialogflow_v2_generated_Tools_ListTools_sync
• internal/generated/snippets/dialogflow/apiv2/ToolsClient/UpdateTool/main.go:17, tag dialogflow_v2_generated_Tools_UpdateTool_sync
• internal/generated/snippets/geminidataanalytics/apiv1beta/DataChatClient/QueryData/main.go:17, tag geminidataanalytics_v1beta_generated_DataChatService_QueryData_sync

---

This comment is generated by snippet-bot.
If you find problems with this result, please file an issue at:
https://github.com/googleapis/repo-automation-bots/issues.
To update this comment, add snippet-bot:force-run label or use the checkbox below:

• Refresh this comment

[gemini-code-assist]

Note

The number of changes in this pull request is too large for Gemini Code Assist to generate a summary.