google-cloud-gemini_data_analytics-v1beta 0.3.1 → 0.5.0

data/proto_docs/google/cloud/geminidataanalytics/v1beta/context.rb

@@ -40,14 +40,78 @@ module Google
         #   @return [::Array<::Google::Cloud::GeminiDataAnalytics::V1beta::ExampleQuery>]
         #     Optional. A list of example queries, providing examples of relevant and
         #     commonly used SQL queries and their corresponding natural language queries
-        #     optionally present.
+        #     optionally present. Currently only used for BigQuery data sources.
+        # @!attribute [rw] glossary_terms
+        #   @return [::Array<::Google::Cloud::GeminiDataAnalytics::V1beta::GlossaryTerm>]
+        #     Optional. Term definitions (currently, only user authored)
+        # @!attribute [rw] schema_relationships
+        #   @return [::Array<::Google::Cloud::GeminiDataAnalytics::V1beta::Context::SchemaRelationship>]
+        #     Optional. Relationships between table schema, including referencing and
+        #     referenced columns.
         class Context
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # The relationship between two tables, including referencing and referenced
+          # columns. This is a derived context retrieved from Dataplex Dataset
+          # Insights.
+          # @!attribute [rw] left_schema_paths
+          #   @return [::Google::Cloud::GeminiDataAnalytics::V1beta::Context::SchemaRelationship::SchemaPaths]
+          #     An ordered list of fields for the join from the first table.
+          #     The size of this list must be the same as `right_schema_paths`.
+          #     Each field at index i in this list must correspond to a field at the same
+          #     index in the `right_schema_paths` list.
+          # @!attribute [rw] right_schema_paths
+          #   @return [::Google::Cloud::GeminiDataAnalytics::V1beta::Context::SchemaRelationship::SchemaPaths]
+          #     An ordered list of fields for the join from the second table.
+          #     The size of this list must be the same as `left_schema_paths`.
+          #     Each field at index i in this list must correspond to a field at the same
+          #     index in the `left_schema_paths` list.
+          # @!attribute [rw] sources
+          #   @return [::Array<::Google::Cloud::GeminiDataAnalytics::V1beta::Context::SchemaRelationship::Source>]
+          #     Sources which generated the schema relation edge.
+          # @!attribute [rw] confidence_score
+          #   @return [::Float]
+          #     A confidence score for the suggested relationship.
+          #     Manually added edges have the highest confidence score.
+          class SchemaRelationship
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # Represents an ordered set of paths within the table schema.
+            # @!attribute [rw] table_fqn
+            #   @return [::String]
+            #     The service-qualified full resource name of the table
+            #     Ex:
+            #     bigquery.googleapis.com/projects/PROJECT_ID/datasets/DATASET_ID/tables/TABLE_ID
+            # @!attribute [rw] paths
+            #   @return [::Array<::String>]
+            #     The ordered list of paths within the table schema.
+            class SchemaPaths
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
+
+            # Source which generated the schema relation edge.
+            module Source
+              # The source of the schema relationship is unspecified.
+              SOURCE_UNSPECIFIED = 0
+
+              # The source of the schema relationship is BigQuery job history.
+              BIGQUERY_JOB_HISTORY = 1
+
+              # The source of the schema relationship is LLM suggested.
+              LLM_SUGGESTED = 2
+
+              # The source of the schema relationship is BigQuery table constraints.
+              BIGQUERY_TABLE_CONSTRAINTS = 3
+            end
+          end
         end
 
         # Example of relevant and commonly used SQL query and its corresponding natural
-        # language queries optionally present.
+        # language queries optionally present. Currently only used for BigQuery data
+        # sources.
         # @!attribute [rw] sql_query
         #   @return [::String]
         #     Optional. The SQL query that should be generated to answer the natural
@@ -62,6 +126,25 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Definition of a term within a specific domain.
+        # @!attribute [rw] display_name
+        #   @return [::String]
+        #     Required. User friendly display name of the glossary term being defined.
+        #     For example: "CTR", "conversion rate", "pending"
+        # @!attribute [rw] description
+        #   @return [::String]
+        #     Required. The description or meaning of the term.
+        #     For example: "Click-through rate", "The percentage of users who complete a
+        #     desired action", "An order that is waiting to be processed."
+        # @!attribute [rw] labels
+        #   @return [::Array<::String>]
+        #     Optional. A list of general purpose labels associated to this term.
+        #     For example: ["click rate", "clickthrough", "waiting"]
+        class GlossaryTerm
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # Options for the conversation.
         # @!attribute [rw] chart
         #   @return [::Google::Cloud::GeminiDataAnalytics::V1beta::ChartOptions]
@@ -69,11 +152,26 @@ module Google
         # @!attribute [rw] analysis
         #   @return [::Google::Cloud::GeminiDataAnalytics::V1beta::AnalysisOptions]
         #     Optional. Options for analysis.
+        # @!attribute [rw] datasource
+        #   @return [::Google::Cloud::GeminiDataAnalytics::V1beta::DatasourceOptions]
+        #     Optional. Options for datasources.
         class ConversationOptions
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Options for datasources configurations.
+        # @!attribute [rw] big_query_max_billed_bytes
+        #   @return [::Google::Protobuf::Int64Value]
+        #     Optional. This option applies to datasources that require BigQuery queries
+        #     only. Limits the bytes billed for each BQ query job. Queries that will have
+        #     bytes billed beyond this limit will fail (without incurring a charge).
+        #     If unspecified, no limit will be applied.
+        class DatasourceOptions
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # Options for chart generation.
         # @!attribute [rw] image
         #   @return [::Google::Cloud::GeminiDataAnalytics::V1beta::ChartOptions::ImageOptions]

data/proto_docs/google/cloud/geminidataanalytics/v1beta/conversation.rb

@@ -31,7 +31,7 @@ module Google
         #     https://google.aip.dev/122#resource-id-segments
         #
         #     Example:
-        #     `projects/1234567890/locations/us-central1/conversations/my-conversation`.
+        #     `projects/1234567890/locations/global/conversations/my-conversation`.
         #
         #     It is recommended to skip setting this field during conversation creation
         #     as it will be inferred automatically and overwritten with the
@@ -120,7 +120,7 @@ module Google
         #   @return [::String]
         #     Optional. Returned conversations will match criteria specified within the
         #     filter. ListConversations allows filtering by:
-        #      * agent_id
+        #      * agents
         #      * labels
         class ListConversationsRequest
           include ::Google::Protobuf::MessageExts
@@ -138,6 +138,17 @@ module Google
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
+
+        # Request for deleting a conversation based on parent and conversation id.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. Name of the resource.
+        #     Format:
+        #     `projects/{project}/locations/{location}/conversations/{conversation}`
+        class DeleteConversationRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
       end
     end
   end

data/proto_docs/google/cloud/geminidataanalytics/v1beta/data_agent.rb

@@ -34,7 +34,7 @@ module Google
         #     must match the format described in
         #     https://google.aip.dev/122#resource-id-segments
         #
-        #     Example: `projects/1234567890/locations/us-central1/dataAgents/my-agent`.
+        #     Example: `projects/1234567890/locations/global/dataAgents/my-agent`.
         #
         #     It is recommended to skip setting this field during agent creation as it
         #     will be inferred automatically and overwritten with the

data/proto_docs/google/cloud/geminidataanalytics/v1beta/data_chat_service.rb

@@ -21,6 +21,148 @@ module Google
   module Cloud
     module GeminiDataAnalytics
       module V1beta
+        # Request to query data from a natural language query.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The parent resource to generate the query for.
+        #     Format: projects/\\{project}/locations/\\{location}
+        # @!attribute [rw] prompt
+        #   @return [::String]
+        #     Required. The natural language query for which to generate query.
+        #     Example: "What are the top 5 best selling products this month?"
+        # @!attribute [rw] context
+        #   @return [::Google::Cloud::GeminiDataAnalytics::V1beta::QueryDataContext]
+        #     Required. The context for the data query, including the data sources to
+        #     use.
+        # @!attribute [rw] generation_options
+        #   @return [::Google::Cloud::GeminiDataAnalytics::V1beta::GenerationOptions]
+        #     Optional. Options to control query generation and execution behavior.
+        class QueryDataRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Options to control query generation, execution, and response format.
+        # @!attribute [rw] generate_query_result
+        #   @return [::Boolean]
+        #     Optional. If true, the generated query will be executed, and the result
+        #     data will be returned in the response.
+        # @!attribute [rw] generate_natural_language_answer
+        #   @return [::Boolean]
+        #     Optional. If true, a natural language answer based on the query execution
+        #     result will be generated and returned in the response.
+        # @!attribute [rw] generate_explanation
+        #   @return [::Boolean]
+        #     Optional. If true, an explanation of the generated query will be returned
+        #     in the response.
+        # @!attribute [rw] generate_disambiguation_question
+        #   @return [::Boolean]
+        #     Optional. If true (default to false), the service may return a
+        #     clarifying_question if the input query is ambiguous.
+        class GenerationOptions
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # References to data sources and context to use for the query.
+        # @!attribute [rw] datasource_references
+        #   @return [::Google::Cloud::GeminiDataAnalytics::V1beta::DatasourceReferences]
+        #     Required. The datasource references to use for the query.
+        class QueryDataContext
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Response containing the generated query and related information.
+        # @!attribute [rw] generated_query
+        #   @return [::String]
+        #     Generated query for the given user prompt.
+        # @!attribute [rw] intent_explanation
+        #   @return [::String]
+        #     A natural language explanation of the generated query.
+        #     Populated if options.generate_explanation was true in the request.
+        # @!attribute [rw] query_result
+        #   @return [::Google::Cloud::GeminiDataAnalytics::V1beta::ExecutedQueryResult]
+        #     The result of executing the query.
+        #     Populated if options.generate_query_result or
+        #     options.generate_natural_language_answer was true in the request, and
+        #     execution was successful or attempted.
+        # @!attribute [rw] natural_language_answer
+        #   @return [::String]
+        #     A natural language answer to the query, based on the query_result.
+        #     Populated if options.generate_natural_language_answer was true in the
+        #     request and query execution was successful based in the response from
+        #     executeSql API.
+        # @!attribute [rw] disambiguation_question
+        #   @return [::Array<::String>]
+        #     If ambiguity was detected in the natural language query and
+        #     options.generate_disambiguation_question was true, this field contains a
+        #     question to the user for clarification. The returned represents the
+        #     service's best effort based on the ambiguous input.
+        class QueryDataResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The result of a query execution. The design is generic for all dialects.
+        # @!attribute [rw] columns
+        #   @return [::Array<::Google::Cloud::GeminiDataAnalytics::V1beta::ExecutedQueryResult::Column>]
+        #     The columns in the result set, in order.
+        # @!attribute [rw] rows
+        #   @return [::Array<::Google::Cloud::GeminiDataAnalytics::V1beta::ExecutedQueryResult::Row>]
+        #     The rows returned by the query.
+        # @!attribute [rw] total_row_count
+        #   @return [::Integer]
+        #     The total number of rows in the full result set, if known.
+        #     This may be an estimate or an exact count.
+        # @!attribute [rw] partial_result
+        #   @return [::Boolean]
+        #     Set to true if the returned rows in `query_result` are a subset of the
+        #     full result. This can happen, for example, if the query execution hits a
+        #     row limit. When true, the `query_result` does not contain all
+        #     rows. To retrieve the complete result, consider using the
+        #     `generated_query` in `QueryDataResponse` and executing it in your own
+        #     environment.
+        # @!attribute [rw] query_execution_error
+        #   @return [::String]
+        #     The error message if the query execution failed.
+        class ExecutedQueryResult
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # Describes a single column in the result set.
+          # @!attribute [rw] name
+          #   @return [::String]
+          #     The name of the column.
+          # @!attribute [rw] type
+          #   @return [::String]
+          #     The type of the column (e.g., "VARCHAR", "INT64", "TIMESTAMP").
+          class Column
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Represents a single value within a row.
+          # @!attribute [rw] value
+          #   @return [::String]
+          #     The cell value, represented in a string format.
+          #     Timestamps could be formatted, for example, using RFC3339Nano.
+          #     This field is used if the value is not null.
+          class Value
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Represents a single row in the result set.
+          # @!attribute [rw] values
+          #   @return [::Array<::Google::Cloud::GeminiDataAnalytics::V1beta::ExecutedQueryResult::Value>]
+          #     The values in the row, corresponding positionally to the columns.
+          class Row
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+        end
+
         # Request for listing chat messages based on parent and conversation_id.
         # @!attribute [rw] parent
         #   @return [::String]
@@ -79,19 +221,27 @@ module Google
         #     statelessly (without managed conversation persistence and without an
         #     Agent) by passing all context inline.
         #
-        #     Note: The following fields are mutually exclusive: `inline_context`, `conversation_reference`, `data_agent_context`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        #     Note: The following fields are mutually exclusive: `inline_context`, `conversation_reference`, `data_agent_context`, `client_managed_resource_context`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] conversation_reference
         #   @return [::Google::Cloud::GeminiDataAnalytics::V1beta::ConversationReference]
         #     Optional. Reference to a persisted conversation and agent context.
         #     Use this to chat with an Agent using managed conversation persistence.
         #
-        #     Note: The following fields are mutually exclusive: `conversation_reference`, `inline_context`, `data_agent_context`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        #     Note: The following fields are mutually exclusive: `conversation_reference`, `inline_context`, `data_agent_context`, `client_managed_resource_context`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] data_agent_context
         #   @return [::Google::Cloud::GeminiDataAnalytics::V1beta::DataAgentContext]
         #     Optional. Context for the chat request. Use this to chat with an Agent
         #     statelessly, without managed conversation persistence.
         #
-        #     Note: The following fields are mutually exclusive: `data_agent_context`, `inline_context`, `conversation_reference`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        #     Note: The following fields are mutually exclusive: `data_agent_context`, `inline_context`, `conversation_reference`, `client_managed_resource_context`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] client_managed_resource_context
+        #   @return [::Google::Cloud::GeminiDataAnalytics::V1beta::ClientManagedResourceContext]
+        #     Optional. Context with client managed resources.
+        #     Some clients may not use GDA managed resources including
+        #     conversations and agents, instead they create and manage their own
+        #     conversations and agents resources.
+        #
+        #     Note: The following fields are mutually exclusive: `client_managed_resource_context`, `inline_context`, `conversation_reference`, `data_agent_context`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] project
         #   @deprecated This field is deprecated and may be removed in the next major version update.
         #   @return [::String]
@@ -158,6 +308,25 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Context with client managed resources.
+        # Some clients may not use GDA managed resources including
+        # conversations and agents, instead they create and manage their own
+        # conversations and agents resources.
+        # @!attribute [rw] inline_context
+        #   @return [::Google::Cloud::GeminiDataAnalytics::V1beta::Context]
+        #     Required. Context for the chat request. Use this to chat without GDA API
+        #     managed conversation and agent persistence by passing all context inline.
+        # @!attribute [rw] conversation_id
+        #   @return [::String]
+        #     Optional. The client managed conversation id.
+        # @!attribute [rw] agent_id
+        #   @return [::String]
+        #     Optional. The client managed agent id.
+        class ClientManagedResourceContext
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # A message from an interaction between the user and the system.
         # @!attribute [rw] user_message
         #   @return [::Google::Cloud::GeminiDataAnalytics::V1beta::UserMessage]
@@ -198,32 +367,37 @@ module Google
         #   @return [::Google::Cloud::GeminiDataAnalytics::V1beta::TextMessage]
         #     A direct natural language response to the user message.
         #
-        #     Note: The following fields are mutually exclusive: `text`, `schema`, `data`, `analysis`, `chart`, `error`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        #     Note: The following fields are mutually exclusive: `text`, `schema`, `data`, `analysis`, `chart`, `error`, `example_queries`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] schema
         #   @return [::Google::Cloud::GeminiDataAnalytics::V1beta::SchemaMessage]
         #     A message produced during schema resolution.
         #
-        #     Note: The following fields are mutually exclusive: `schema`, `text`, `data`, `analysis`, `chart`, `error`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        #     Note: The following fields are mutually exclusive: `schema`, `text`, `data`, `analysis`, `chart`, `error`, `example_queries`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] data
         #   @return [::Google::Cloud::GeminiDataAnalytics::V1beta::DataMessage]
         #     A message produced during data retrieval.
         #
-        #     Note: The following fields are mutually exclusive: `data`, `text`, `schema`, `analysis`, `chart`, `error`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        #     Note: The following fields are mutually exclusive: `data`, `text`, `schema`, `analysis`, `chart`, `error`, `example_queries`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] analysis
         #   @return [::Google::Cloud::GeminiDataAnalytics::V1beta::AnalysisMessage]
         #     A message produced during analysis.
         #
-        #     Note: The following fields are mutually exclusive: `analysis`, `text`, `schema`, `data`, `chart`, `error`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        #     Note: The following fields are mutually exclusive: `analysis`, `text`, `schema`, `data`, `chart`, `error`, `example_queries`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] chart
         #   @return [::Google::Cloud::GeminiDataAnalytics::V1beta::ChartMessage]
         #     A message produced during chart generation.
         #
-        #     Note: The following fields are mutually exclusive: `chart`, `text`, `schema`, `data`, `analysis`, `error`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        #     Note: The following fields are mutually exclusive: `chart`, `text`, `schema`, `data`, `analysis`, `error`, `example_queries`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] error
         #   @return [::Google::Cloud::GeminiDataAnalytics::V1beta::ErrorMessage]
         #     An error message.
         #
-        #     Note: The following fields are mutually exclusive: `error`, `text`, `schema`, `data`, `analysis`, `chart`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        #     Note: The following fields are mutually exclusive: `error`, `text`, `schema`, `data`, `analysis`, `chart`, `example_queries`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] example_queries
+        #   @return [::Google::Cloud::GeminiDataAnalytics::V1beta::ExampleQueries]
+        #     Optional. A message containing example queries.
+        #
+        #     Note: The following fields are mutually exclusive: `example_queries`, `text`, `schema`, `data`, `analysis`, `chart`, `error`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] group_id
         #   @return [::Integer]
         #     Identifies the group that the event belongs to. Similar events are deemed
@@ -238,9 +412,31 @@ module Google
         # @!attribute [rw] parts
         #   @return [::Array<::String>]
         #     Optional. The parts of the message.
+        # @!attribute [rw] text_type
+        #   @return [::Google::Cloud::GeminiDataAnalytics::V1beta::TextMessage::TextType]
+        #     Optional. The type of the text message.
         class TextMessage
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # The type of the text message.
+          module TextType
+            # The default text type.
+            TEXT_TYPE_UNSPECIFIED = 0
+
+            # The text is a final response to the user question.
+            FINAL_RESPONSE = 1
+
+            # The text is a thinking plan generated by the thinking tool.
+            THOUGHT = 2
+
+            # The text is an informational message about the agent's progress, such as
+            # a tool being invoked. This is distinct from the agent's internal thought
+            # process (`THOUGHT`) and the final answer to the user
+            # (`FINAL_RESPONSE`). These messages provide insight into the agent's
+            # actions.
+            PROGRESS = 3
+          end
         end
 
         # A message produced during schema resolution.
@@ -294,8 +490,10 @@ module Google
         #
         #     Note: The following fields are mutually exclusive: `result`, `query`, `generated_sql`, `generated_looker_query`, `big_query_job`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] generated_looker_query
+        #   @deprecated This field is deprecated and may be removed in the next major version update.
         #   @return [::Google::Cloud::GeminiDataAnalytics::V1beta::LookerQuery]
         #     Looker Query generated by the system to retrieve data.
+        #     DEPRECATED: generated looker query is now under DataQuery.looker.
         #
         #     Note: The following fields are mutually exclusive: `generated_looker_query`, `query`, `generated_sql`, `result`, `big_query_job`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] big_query_job
@@ -347,6 +545,9 @@ module Google
         end
 
         # A query for retrieving data.
+        # @!attribute [rw] looker
+        #   @return [::Google::Cloud::GeminiDataAnalytics::V1beta::LookerQuery]
+        #     Optional. A query for retrieving data from a Looker explore.
         # @!attribute [rw] question
         #   @return [::String]
         #     Optional. A natural language question to answer.
@@ -550,7 +751,20 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # An error message.
+        # An error message from a tool call.
+        # This message is used to represent an error that occurred while an agent was
+        # trying to use a tool. It's important to note that not all errors are
+        # terminal. Many are recoverable, and the agent may use the information from
+        # this error message to self-correct and retry the tool call or try a
+        # different approach.
+        #
+        # For example, if a data query fails, the agent might receive an
+        # `ErrorMessage`, analyze it, and then generate a corrected query.
+        #
+        # Clients should be cautious about interpreting this message as a definitive
+        # failure. It can be part of the agent's normal, iterative process of
+        # completing a task. Surfacing these errors directly to end-users without
+        # context (e.g., as a "hard failure") may be misleading.
         # @!attribute [r] text
         #   @return [::String]
         #     Output only. The text of the error.
@@ -559,6 +773,18 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # A message containing derived and authored example queries.
+        # @!attribute [rw] example_queries
+        #   @return [::Array<::Google::Cloud::GeminiDataAnalytics::V1beta::ExampleQuery>]
+        #     Optional. A list of derived and authored example queries, providing
+        #     examples of relevant and commonly used SQL queries and their corresponding
+        #     natural language queries optionally present. Currently only used for
+        #     BigQuery data sources.
+        class ExampleQueries
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # A blob of data with a MIME type.
         # @!attribute [rw] mime_type
         #   @return [::String]