google-cloud-discovery_engine-v1beta 0.27.0 → 0.28.0

data/proto_docs/google/cloud/discoveryengine/v1beta/assistant.rb

@@ -0,0 +1,253 @@
+# frozen_string_literal: true
+
+# Copyright 2026 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module DiscoveryEngine
+      module V1beta
+        # Discovery Engine Assistant resource.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Immutable. Resource name of the assistant.
+        #     Format:
+        #     `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/assistants/{assistant}`
+        #
+        #     It must be a UTF-8 encoded string with a length limit of 1024 characters.
+        # @!attribute [rw] display_name
+        #   @return [::String]
+        #     Required. The assistant display name.
+        #
+        #     It must be a UTF-8 encoded string with a length limit of 128 characters.
+        # @!attribute [rw] description
+        #   @return [::String]
+        #     Optional. Description for additional information. Expected to be shown on
+        #     the configuration UI, not to the users of the assistant.
+        # @!attribute [rw] generation_config
+        #   @return [::Google::Cloud::DiscoveryEngine::V1beta::Assistant::GenerationConfig]
+        #     Optional. Configuration for the generation of the assistant response.
+        # @!attribute [rw] web_grounding_type
+        #   @return [::Google::Cloud::DiscoveryEngine::V1beta::Assistant::WebGroundingType]
+        #     Optional. The type of web grounding to use.
+        # @!attribute [rw] default_web_grounding_toggle_off
+        #   @return [::Boolean]
+        #     Optional. This field controls the default web grounding toggle for end
+        #     users if `web_grounding_type` is set to `WEB_GROUNDING_TYPE_GOOGLE_SEARCH`
+        #     or `WEB_GROUNDING_TYPE_ENTERPRISE_WEB_SEARCH`. By default, this field is
+        #     set to false. If `web_grounding_type` is `WEB_GROUNDING_TYPE_GOOGLE_SEARCH`
+        #     or `WEB_GROUNDING_TYPE_ENTERPRISE_WEB_SEARCH`, end users will have web
+        #     grounding enabled by default on UI. If true, grounding toggle will be
+        #     disabled by default on UI. End users can still enable web grounding in
+        #     the UI if web grounding is enabled.
+        # @!attribute [rw] enabled_tools
+        #   @return [::Google::Protobuf::Map{::String => ::Google::Cloud::DiscoveryEngine::V1beta::Assistant::ToolList}]
+        #     Optional. Note: not implemented yet. Use
+        #     [enabled_actions][google.cloud.discoveryengine.v1beta.Assistant.enabled_actions]
+        #     instead. The enabled tools on this assistant. The keys are connector name,
+        #     for example
+        #     "projects/\\{projectId}/locations/\\{locationId}/collections/\\{collectionId}/dataconnector
+        #     The values consist of admin enabled tools towards the connector
+        #     instance. Admin can selectively enable multiple tools on any of the
+        #     connector instances that they created in the project. For example
+        #     {"jira1ConnectorName": [(toolId1, "createTicket"), (toolId2,
+        #     "transferTicket")],
+        #      "gmail1ConnectorName": [(toolId3, "sendEmail"),..] }
+        # @!attribute [rw] customer_policy
+        #   @return [::Google::Cloud::DiscoveryEngine::V1beta::Assistant::CustomerPolicy]
+        #     Optional. Customer policy for the assistant.
+        # @!attribute [r] create_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. Represents the time when this Assistant was created.
+        # @!attribute [r] update_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. Represents the time when this Assistant was most recently
+        #     updated.
+        class Assistant
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # Configuration for the generation of the assistant response.
+          # @!attribute [rw] default_model_id
+          #   @return [::String]
+          #     Optional. The default model to use for assistant.
+          # @!attribute [rw] allowed_model_ids
+          #   @return [::Array<::String>]
+          #     Optional. The list of models that are allowed to be used for assistant.
+          # @!attribute [rw] system_instruction
+          #   @return [::Google::Cloud::DiscoveryEngine::V1beta::Assistant::GenerationConfig::SystemInstruction]
+          #     System instruction, also known as the prompt preamble for LLM calls.
+          #     See also
+          #     https://cloud.google.com/vertex-ai/generative-ai/docs/learn/prompts/system-instructions
+          # @!attribute [rw] default_language
+          #   @return [::String]
+          #     The default language to use for the generation of the assistant
+          #     response.
+          #     Use an ISO 639-1 language code such as `en`.
+          #     If not specified, the language will be automatically detected.
+          class GenerationConfig
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # System instruction, also known as the prompt preamble for LLM calls.
+            # @!attribute [rw] additional_system_instruction
+            #   @return [::String]
+            #     Optional. Additional system instruction that will be added to the
+            #     default system instruction.
+            class SystemInstruction
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
+          end
+
+          # Information to identify a tool.
+          # @!attribute [rw] tool_name
+          #   @return [::String]
+          #     The name of the tool as defined by
+          #     DataConnectorService.QueryAvailableActions.
+          #     Note: it's using `action` in the DataConnectorService apis, but they are
+          #     the same as the `tool` here.
+          # @!attribute [rw] tool_display_name
+          #   @return [::String]
+          #     The display name of the tool.
+          class ToolInfo
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # The enabled tools on a connector
+          # @!attribute [rw] tool_info
+          #   @return [::Array<::Google::Cloud::DiscoveryEngine::V1beta::Assistant::ToolInfo>]
+          #     The list of tools with corresponding tool information.
+          class ToolList
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Customer-defined policy for the assistant.
+          # @!attribute [rw] banned_phrases
+          #   @return [::Array<::Google::Cloud::DiscoveryEngine::V1beta::Assistant::CustomerPolicy::BannedPhrase>]
+          #     Optional. List of banned phrases.
+          # @!attribute [rw] model_armor_config
+          #   @return [::Google::Cloud::DiscoveryEngine::V1beta::Assistant::CustomerPolicy::ModelArmorConfig]
+          #     Optional. Model Armor configuration to be used for sanitizing user
+          #     prompts and assistant responses.
+          class CustomerPolicy
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # Definition of a customer-defined banned phrase. A banned phrase is not
+            # allowed to appear in the user query or the LLM response, or else the
+            # answer will be refused.
+            # @!attribute [rw] phrase
+            #   @return [::String]
+            #     Required. The raw string content to be banned.
+            # @!attribute [rw] match_type
+            #   @return [::Google::Cloud::DiscoveryEngine::V1beta::Assistant::CustomerPolicy::BannedPhrase::BannedPhraseMatchType]
+            #     Optional. Match type for the banned phrase.
+            # @!attribute [rw] ignore_diacritics
+            #   @return [::Boolean]
+            #     Optional. If true, diacritical marks (e.g., accents, umlauts) are
+            #     ignored when matching banned phrases. For example, "cafe" would match
+            #     "café".
+            class BannedPhrase
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+
+              # The matching method for the banned phrase.
+              module BannedPhraseMatchType
+                # Defaults to SIMPLE_STRING_MATCH.
+                BANNED_PHRASE_MATCH_TYPE_UNSPECIFIED = 0
+
+                # The banned phrase matches if it is found anywhere in the text as an
+                # exact substring.
+                SIMPLE_STRING_MATCH = 1
+
+                # Banned phrase only matches if the pattern found in the text is
+                # surrounded by word delimiters. The phrase itself may still contain
+                # word delimiters.
+                WORD_BOUNDARY_STRING_MATCH = 2
+              end
+            end
+
+            # Configuration for customer defined Model Armor templates to be used for
+            # sanitizing user prompts and assistant responses.
+            # @!attribute [rw] user_prompt_template
+            #   @return [::String]
+            #     Optional. The resource name of the Model Armor template for sanitizing
+            #     user prompts. Format:
+            #     `projects/{project}/locations/{location}/templates/{template_id}`
+            #
+            #     If not specified, no sanitization will be applied to the user prompt.
+            # @!attribute [rw] response_template
+            #   @return [::String]
+            #     Optional. The resource name of the Model Armor template for sanitizing
+            #     assistant responses. Format:
+            #     `projects/{project}/locations/{location}/templates/{template_id}`
+            #
+            #     If not specified, no sanitization will be applied to the assistant
+            #     response.
+            # @!attribute [rw] failure_mode
+            #   @return [::Google::Cloud::DiscoveryEngine::V1beta::Assistant::CustomerPolicy::ModelArmorConfig::FailureMode]
+            #     Optional. Defines the failure mode for Model Armor sanitization.
+            class ModelArmorConfig
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+
+              # Determines the behavior when Model Armor fails to process a request.
+              module FailureMode
+                # Unspecified failure mode, default behavior is `FAIL_CLOSED`.
+                FAILURE_MODE_UNSPECIFIED = 0
+
+                # In case of a Model Armor processing failure, the request is allowed
+                # to proceed without any changes.
+                FAIL_OPEN = 1
+
+                # In case of a Model Armor processing failure, the request is rejected.
+                FAIL_CLOSED = 2
+              end
+            end
+          end
+
+          # @!attribute [rw] key
+          #   @return [::String]
+          # @!attribute [rw] value
+          #   @return [::Google::Cloud::DiscoveryEngine::V1beta::Assistant::ToolList]
+          class EnabledToolsEntry
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # The type of web grounding to use.
+          module WebGroundingType
+            # Default, unspecified setting. This is the same as disabled.
+            WEB_GROUNDING_TYPE_UNSPECIFIED = 0
+
+            # Web grounding is disabled.
+            WEB_GROUNDING_TYPE_DISABLED = 1
+
+            # Grounding with Google Search is enabled.
+            WEB_GROUNDING_TYPE_GOOGLE_SEARCH = 2
+
+            # Grounding with Enterprise Web Search is enabled.
+            WEB_GROUNDING_TYPE_ENTERPRISE_WEB_SEARCH = 3
+          end
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/cloud/discoveryengine/v1beta/assistant_service.rb

@@ -0,0 +1,368 @@
+# frozen_string_literal: true
+
+# Copyright 2026 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module DiscoveryEngine
+      module V1beta
+        # User metadata of the request.
+        # @!attribute [rw] time_zone
+        #   @return [::String]
+        #     Optional. IANA time zone, e.g. Europe/Budapest.
+        # @!attribute [rw] preferred_language_code
+        #   @return [::String]
+        #     Optional. Preferred language to be used for answering if language detection
+        #     fails. Also used as the language of error messages created by actions,
+        #     regardless of language detection results.
+        class AssistUserMetadata
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request for the
+        # {::Google::Cloud::DiscoveryEngine::V1beta::AssistantService::Client#stream_assist AssistantService.StreamAssist}
+        # method.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The resource name of the
+        #     {::Google::Cloud::DiscoveryEngine::V1beta::Assistant Assistant}. Format:
+        #     `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/assistants/{assistant}`
+        # @!attribute [rw] query
+        #   @return [::Google::Cloud::DiscoveryEngine::V1beta::Query]
+        #     Optional. Current user query.
+        #
+        #     Empty query is only supported if `file_ids` are provided. In this case, the
+        #     answer will be generated based on those context files.
+        # @!attribute [rw] session
+        #   @return [::String]
+        #     Optional. The session to use for the request. If specified, the assistant
+        #     has access to the session history, and the query and the answer are stored
+        #     there.
+        #
+        #     If `-` is specified as the session ID, or it is left empty, then a new
+        #     session is created with an automatically generated ID.
+        #
+        #     Format:
+        #     `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/sessions/{session}`
+        # @!attribute [rw] user_metadata
+        #   @return [::Google::Cloud::DiscoveryEngine::V1beta::AssistUserMetadata]
+        #     Optional. Information about the user initiating the query.
+        # @!attribute [rw] tools_spec
+        #   @return [::Google::Cloud::DiscoveryEngine::V1beta::StreamAssistRequest::ToolsSpec]
+        #     Optional. Specification of tools that are used to serve the request.
+        # @!attribute [rw] generation_spec
+        #   @return [::Google::Cloud::DiscoveryEngine::V1beta::StreamAssistRequest::GenerationSpec]
+        #     Optional. Specification of the generation configuration for the request.
+        class StreamAssistRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # Specification of tools that are used to serve the request.
+          # @!attribute [rw] vertex_ai_search_spec
+          #   @return [::Google::Cloud::DiscoveryEngine::V1beta::StreamAssistRequest::ToolsSpec::VertexAiSearchSpec]
+          #     Optional. Specification of the Vertex AI Search tool.
+          # @!attribute [rw] web_grounding_spec
+          #   @return [::Google::Cloud::DiscoveryEngine::V1beta::StreamAssistRequest::ToolsSpec::WebGroundingSpec]
+          #     Optional. Specification of the web grounding tool.
+          #     If field is present, enables grounding with web search. Works only if
+          #     {::Google::Cloud::DiscoveryEngine::V1beta::Assistant#web_grounding_type Assistant.web_grounding_type}
+          #     is
+          #     {::Google::Cloud::DiscoveryEngine::V1beta::Assistant::WebGroundingType::WEB_GROUNDING_TYPE_GOOGLE_SEARCH WEB_GROUNDING_TYPE_GOOGLE_SEARCH}
+          #     or
+          #     {::Google::Cloud::DiscoveryEngine::V1beta::Assistant::WebGroundingType::WEB_GROUNDING_TYPE_ENTERPRISE_WEB_SEARCH WEB_GROUNDING_TYPE_ENTERPRISE_WEB_SEARCH}.
+          # @!attribute [rw] image_generation_spec
+          #   @return [::Google::Cloud::DiscoveryEngine::V1beta::StreamAssistRequest::ToolsSpec::ImageGenerationSpec]
+          #     Optional. Specification of the image generation tool.
+          # @!attribute [rw] video_generation_spec
+          #   @return [::Google::Cloud::DiscoveryEngine::V1beta::StreamAssistRequest::ToolsSpec::VideoGenerationSpec]
+          #     Optional. Specification of the video generation tool.
+          class ToolsSpec
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # Specification of the Vertex AI Search tool.
+            # @!attribute [rw] data_store_specs
+            #   @return [::Array<::Google::Cloud::DiscoveryEngine::V1beta::SearchRequest::DataStoreSpec>]
+            #     Optional. Specs defining
+            #     {::Google::Cloud::DiscoveryEngine::V1beta::DataStore DataStore}s to filter
+            #     on in a search call and configurations for those data stores. This is
+            #     only considered for
+            #     {::Google::Cloud::DiscoveryEngine::V1beta::Engine Engine}s with multiple
+            #     data stores.
+            # @!attribute [rw] filter
+            #   @return [::String]
+            #     Optional. The filter syntax consists of an expression language for
+            #     constructing a predicate from one or more fields of the documents being
+            #     filtered. Filter expression is case-sensitive.
+            #
+            #     If this field is unrecognizable, an  `INVALID_ARGUMENT`  is returned.
+            #
+            #     Filtering in Vertex AI Search is done by mapping the LHS filter key to
+            #     a key property defined in the Vertex AI Search backend -- this mapping
+            #     is defined by the customer in their schema. For example a media
+            #     customer might have a field 'name' in their schema. In this case the
+            #     filter would look like this: filter --> name:'ANY("king kong")'
+            #
+            #     For more information about filtering including syntax and filter
+            #     operators, see
+            #     [Filter](https://cloud.google.com/generative-ai-app-builder/docs/filter-search-metadata)
+            class VertexAiSearchSpec
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
+
+            # Specification of the web grounding tool.
+            class WebGroundingSpec
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
+
+            # Specification of the image generation tool.
+            class ImageGenerationSpec
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
+
+            # Specification of the video generation tool.
+            class VideoGenerationSpec
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
+          end
+
+          # Assistant generation specification for the request.
+          # This allows to override the default generation configuration at the engine
+          # level.
+          # @!attribute [rw] model_id
+          #   @return [::String]
+          #     Optional. The Vertex AI model_id used for the generative model. If not
+          #     set, the default Assistant model will be used.
+          class GenerationSpec
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+        end
+
+        # Response for the
+        # {::Google::Cloud::DiscoveryEngine::V1beta::AssistantService::Client#stream_assist AssistantService.StreamAssist}
+        # method.
+        # @!attribute [rw] answer
+        #   @return [::Google::Cloud::DiscoveryEngine::V1beta::AssistAnswer]
+        #     Assist answer resource object containing parts of the assistant's final
+        #     answer for the user's query.
+        #
+        #     Not present if the current response doesn't add anything to previously
+        #     sent
+        #     {::Google::Cloud::DiscoveryEngine::V1beta::AssistAnswer#replies AssistAnswer.replies}.
+        #
+        #     Observe
+        #     {::Google::Cloud::DiscoveryEngine::V1beta::AssistAnswer#state AssistAnswer.state}
+        #     to see if more parts are to be expected. While the state is `IN_PROGRESS`,
+        #     the
+        #     {::Google::Cloud::DiscoveryEngine::V1beta::AssistAnswer#replies AssistAnswer.replies}
+        #     field in each response will contain replies (reply fragments) to be
+        #     appended to the ones received in previous responses.
+        #     {::Google::Cloud::DiscoveryEngine::V1beta::AssistAnswer#name AssistAnswer.name}
+        #     won't be filled.
+        #
+        #     If the state is `SUCCEEDED`, `FAILED` or `SKIPPED`, the response
+        #     is the last response and
+        #     {::Google::Cloud::DiscoveryEngine::V1beta::AssistAnswer#name AssistAnswer.name}
+        #     will have a value.
+        # @!attribute [rw] session_info
+        #   @return [::Google::Cloud::DiscoveryEngine::V1beta::StreamAssistResponse::SessionInfo]
+        #     Session information. Only included in the final StreamAssistResponse of the
+        #     response stream.
+        # @!attribute [rw] assist_token
+        #   @return [::String]
+        #     A global unique ID that identifies the current pair of request and stream
+        #     of responses. Used for feedback and support.
+        # @!attribute [rw] invocation_tools
+        #   @return [::Array<::String>]
+        #     The tool names of the tools that were invoked.
+        # @!attribute [rw] invoked_skills
+        #   @return [::Array<::Google::Cloud::DiscoveryEngine::V1beta::StreamAssistResponse::InvokedSkill>]
+        #     The skills executed during the turn.
+        class StreamAssistResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # Information about the session.
+          # @!attribute [rw] session
+          #   @return [::String]
+          #     Name of the newly generated or continued session.
+          #
+          #     Format:
+          #     `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/sessions/{session}`.
+          class SessionInfo
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Represents a skill used during the assist call.
+          # @!attribute [rw] name
+          #   @return [::String]
+          #     The resource name of the skill.
+          # @!attribute [rw] display_name
+          #   @return [::String]
+          #     The display name of the skill.
+          class InvokedSkill
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+        end
+
+        # Request for the
+        # {::Google::Cloud::DiscoveryEngine::V1beta::AssistantService::Client#create_assistant AssistantService.CreateAssistant}
+        # method.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The parent resource name.
+        #     Format:
+        #     `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}`
+        # @!attribute [rw] assistant
+        #   @return [::Google::Cloud::DiscoveryEngine::V1beta::Assistant]
+        #     Required. The {::Google::Cloud::DiscoveryEngine::V1beta::Assistant Assistant} to
+        #     create.
+        # @!attribute [rw] assistant_id
+        #   @return [::String]
+        #     Required. The ID to use for the
+        #     {::Google::Cloud::DiscoveryEngine::V1beta::Assistant Assistant}, which will
+        #     become the final component of the
+        #     {::Google::Cloud::DiscoveryEngine::V1beta::Assistant Assistant}'s resource name.
+        #
+        #     This field must conform to [RFC-1034](https://tools.ietf.org/html/rfc1034)
+        #     with a length limit of 63 characters.
+        class CreateAssistantRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for the
+        # {::Google::Cloud::DiscoveryEngine::V1beta::AssistantService::Client#delete_assistant AssistantService.DeleteAssistant}
+        # method.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. Resource name of
+        #     {::Google::Cloud::DiscoveryEngine::V1beta::Assistant Assistant}. Format:
+        #     `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/assistants/{assistant}`
+        #
+        #     If the caller does not have permission to delete the
+        #     {::Google::Cloud::DiscoveryEngine::V1beta::Assistant Assistant}, regardless of
+        #     whether or not it exists, a PERMISSION_DENIED error is returned.
+        #
+        #     If the {::Google::Cloud::DiscoveryEngine::V1beta::Assistant Assistant} to delete
+        #     does not exist, a NOT_FOUND error is returned.
+        class DeleteAssistantRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for the
+        # {::Google::Cloud::DiscoveryEngine::V1beta::AssistantService::Client#get_assistant AssistantService.GetAssistant}
+        # method.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. Resource name of
+        #     {::Google::Cloud::DiscoveryEngine::V1beta::Assistant Assistant}. Format:
+        #     `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/assistants/{assistant}`
+        class GetAssistantRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for the
+        # {::Google::Cloud::DiscoveryEngine::V1beta::AssistantService::Client#list_assistants AssistantService.ListAssistants}
+        # method.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The parent resource name.
+        #     Format:
+        #     `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}`
+        # @!attribute [rw] page_size
+        #   @return [::Integer]
+        #     Maximum number of
+        #     {::Google::Cloud::DiscoveryEngine::V1beta::Assistant Assistant}s to return. If
+        #     unspecified, defaults to 100. The maximum allowed value is 1000; anything
+        #     above that will be coerced down to 1000.
+        # @!attribute [rw] page_token
+        #   @return [::String]
+        #     A page token
+        #     {::Google::Cloud::DiscoveryEngine::V1beta::ListAssistantsResponse#next_page_token ListAssistantsResponse.next_page_token},
+        #     received from a previous
+        #     {::Google::Cloud::DiscoveryEngine::V1beta::AssistantService::Client#list_assistants AssistantService.ListAssistants}
+        #     call. Provide this to retrieve the subsequent page.
+        #
+        #     When paginating, all other parameters provided to
+        #     {::Google::Cloud::DiscoveryEngine::V1beta::AssistantService::Client#list_assistants ListAssistants}
+        #     must match the call that provided the page token.
+        class ListAssistantsRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Response message for the
+        # {::Google::Cloud::DiscoveryEngine::V1beta::AssistantService::Client#list_assistants AssistantService.ListAssistants}
+        # method.
+        # @!attribute [rw] assistants
+        #   @return [::Array<::Google::Cloud::DiscoveryEngine::V1beta::Assistant>]
+        #     All the customer's
+        #     {::Google::Cloud::DiscoveryEngine::V1beta::Assistant Assistant}s.
+        # @!attribute [rw] next_page_token
+        #   @return [::String]
+        #     A token that can be sent as
+        #     {::Google::Cloud::DiscoveryEngine::V1beta::ListAssistantsRequest#page_token ListAssistantsRequest.page_token}
+        #     to retrieve the next page. If this field is omitted, there are no
+        #     subsequent pages.
+        class ListAssistantsResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for the
+        # {::Google::Cloud::DiscoveryEngine::V1beta::AssistantService::Client#update_assistant AssistantService.UpdateAssistant}
+        # method.
+        # @!attribute [rw] assistant
+        #   @return [::Google::Cloud::DiscoveryEngine::V1beta::Assistant]
+        #     Required. The {::Google::Cloud::DiscoveryEngine::V1beta::Assistant Assistant} to
+        #     update.
+        #
+        #     The {::Google::Cloud::DiscoveryEngine::V1beta::Assistant Assistant}'s `name`
+        #     field is used to identify the
+        #     {::Google::Cloud::DiscoveryEngine::V1beta::Assistant Assistant} to update.
+        #     Format:
+        #     `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/assistants/{assistant}`
+        #
+        #     If the caller does not have permission to update the
+        #     {::Google::Cloud::DiscoveryEngine::V1beta::Assistant Assistant}, regardless of
+        #     whether or not it exists, a PERMISSION_DENIED error is returned.
+        #
+        #     If the {::Google::Cloud::DiscoveryEngine::V1beta::Assistant Assistant} to update
+        #     does not exist, a NOT_FOUND error is returned.
+        # @!attribute [rw] update_mask
+        #   @return [::Google::Protobuf::FieldMask]
+        #     The list of fields to update.
+        class UpdateAssistantRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+      end
+    end
+  end
+end