google-cloud-ces-v1beta 0.a → 0.2.0

data/proto_docs/google/cloud/ces/v1beta/example.rb

@@ -0,0 +1,245 @@
+# 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 Ces
+      module V1beta
+        # An example represents a sample conversation between the user and the
+        # agent(s).
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Identifier. The unique identifier of the example.
+        #     Format:
+        #     `projects/{project}/locations/{location}/apps/{app}/examples/{example}`
+        # @!attribute [rw] display_name
+        #   @return [::String]
+        #     Required. Display name of the example.
+        # @!attribute [rw] description
+        #   @return [::String]
+        #     Optional. Human-readable description of the example.
+        # @!attribute [rw] entry_agent
+        #   @return [::String]
+        #     Optional. The agent that initially handles the conversation. If not
+        #     specified, the example represents a conversation that is handled by the
+        #     root agent. Format:
+        #     `projects/{project}/locations/{location}/apps/{app}/agents/{agent}`
+        # @!attribute [rw] messages
+        #   @return [::Array<::Google::Cloud::Ces::V1beta::Message>]
+        #     Optional. The collection of messages that make up the conversation.
+        # @!attribute [r] create_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. Timestamp when the example was created.
+        # @!attribute [r] update_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. Timestamp when the example was last updated.
+        # @!attribute [r] invalid
+        #   @return [::Boolean]
+        #     Output only. The example may become invalid if referencing resources are
+        #     deleted. Invalid examples will not be used as few-shot examples.
+        # @!attribute [rw] etag
+        #   @return [::String]
+        #     Etag used to ensure the object hasn't changed during a read-modify-write
+        #     operation. If the etag is empty, the update will overwrite any concurrent
+        #     changes.
+        class Example
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # A message within a conversation.
+        # @!attribute [rw] role
+        #   @return [::String]
+        #     Optional. The role within the conversation, e.g., user, agent.
+        # @!attribute [rw] chunks
+        #   @return [::Array<::Google::Cloud::Ces::V1beta::Chunk>]
+        #     Optional. Content of the message as a series of chunks.
+        # @!attribute [rw] event_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Optional. Timestamp when the message was sent or received. Should not be
+        #     used if the message is part of an
+        #     {::Google::Cloud::Ces::V1beta::Example example}.
+        class Message
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # A chunk of content within a message.
+        # @!attribute [rw] text
+        #   @return [::String]
+        #     Optional. Text data.
+        #
+        #     Note: The following fields are mutually exclusive: `text`, `transcript`, `blob`, `payload`, `image`, `tool_call`, `tool_response`, `agent_transfer`, `updated_variables`, `default_variables`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] transcript
+        #   @return [::String]
+        #     Optional. Transcript associated with the audio.
+        #
+        #     Note: The following fields are mutually exclusive: `transcript`, `text`, `blob`, `payload`, `image`, `tool_call`, `tool_response`, `agent_transfer`, `updated_variables`, `default_variables`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] blob
+        #   @return [::Google::Cloud::Ces::V1beta::Blob]
+        #     Optional. Blob data.
+        #
+        #     Note: The following fields are mutually exclusive: `blob`, `text`, `transcript`, `payload`, `image`, `tool_call`, `tool_response`, `agent_transfer`, `updated_variables`, `default_variables`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] payload
+        #   @return [::Google::Protobuf::Struct]
+        #     Optional. Custom payload data.
+        #
+        #     Note: The following fields are mutually exclusive: `payload`, `text`, `transcript`, `blob`, `image`, `tool_call`, `tool_response`, `agent_transfer`, `updated_variables`, `default_variables`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] image
+        #   @return [::Google::Cloud::Ces::V1beta::Image]
+        #     Optional. Image data.
+        #
+        #     Note: The following fields are mutually exclusive: `image`, `text`, `transcript`, `blob`, `payload`, `tool_call`, `tool_response`, `agent_transfer`, `updated_variables`, `default_variables`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] tool_call
+        #   @return [::Google::Cloud::Ces::V1beta::ToolCall]
+        #     Optional. Tool execution request.
+        #
+        #     Note: The following fields are mutually exclusive: `tool_call`, `text`, `transcript`, `blob`, `payload`, `image`, `tool_response`, `agent_transfer`, `updated_variables`, `default_variables`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] tool_response
+        #   @return [::Google::Cloud::Ces::V1beta::ToolResponse]
+        #     Optional. Tool execution response.
+        #
+        #     Note: The following fields are mutually exclusive: `tool_response`, `text`, `transcript`, `blob`, `payload`, `image`, `tool_call`, `agent_transfer`, `updated_variables`, `default_variables`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] agent_transfer
+        #   @return [::Google::Cloud::Ces::V1beta::AgentTransfer]
+        #     Optional. Agent transfer event.
+        #
+        #     Note: The following fields are mutually exclusive: `agent_transfer`, `text`, `transcript`, `blob`, `payload`, `image`, `tool_call`, `tool_response`, `updated_variables`, `default_variables`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] updated_variables
+        #   @return [::Google::Protobuf::Struct]
+        #     A struct represents variables that were updated in the conversation,
+        #     keyed by variable names.
+        #
+        #     Note: The following fields are mutually exclusive: `updated_variables`, `text`, `transcript`, `blob`, `payload`, `image`, `tool_call`, `tool_response`, `agent_transfer`, `default_variables`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] default_variables
+        #   @return [::Google::Protobuf::Struct]
+        #     A struct represents default variables at the start of the conversation,
+        #     keyed by variable names.
+        #
+        #     Note: The following fields are mutually exclusive: `default_variables`, `text`, `transcript`, `blob`, `payload`, `image`, `tool_call`, `tool_response`, `agent_transfer`, `updated_variables`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        class Chunk
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Represents a blob input or output in the conversation.
+        # @!attribute [rw] mime_type
+        #   @return [::String]
+        #     Required. The IANA standard MIME type of the source data.
+        # @!attribute [rw] data
+        #   @return [::String]
+        #     Required. Raw bytes of the blob.
+        class Blob
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Represents an image input or output in the conversation.
+        # @!attribute [rw] mime_type
+        #   @return [::String]
+        #     Required. The IANA standard MIME type of the source data.
+        #     Supported image types includes:
+        #      * image/png
+        #      * image/jpeg
+        #      * image/webp
+        # @!attribute [rw] data
+        #   @return [::String]
+        #     Required. Raw bytes of the image.
+        class Image
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request for the client or the agent to execute the specified tool.
+        # @!attribute [rw] tool
+        #   @return [::String]
+        #     Optional. The name of the tool to execute.
+        #     Format: `projects/{project}/locations/{location}/apps/{app}/tools/{tool}`
+        #
+        #     Note: The following fields are mutually exclusive: `tool`, `toolset_tool`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] toolset_tool
+        #   @return [::Google::Cloud::Ces::V1beta::ToolsetTool]
+        #     Optional. The toolset tool to execute.
+        #
+        #     Note: The following fields are mutually exclusive: `toolset_tool`, `tool`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] id
+        #   @return [::String]
+        #     Optional. The unique identifier of the tool call. If populated, the client
+        #     should return the execution result with the matching ID in
+        #     {::Google::Cloud::Ces::V1beta::ToolResponse#id ToolResponse}.
+        # @!attribute [r] display_name
+        #   @return [::String]
+        #     Output only. Display name of the tool.
+        # @!attribute [rw] args
+        #   @return [::Google::Protobuf::Struct]
+        #     Optional. The input parameters and values for the tool in JSON object
+        #     format.
+        class ToolCall
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The execution result of a specific tool from the client or the agent.
+        # @!attribute [rw] tool
+        #   @return [::String]
+        #     Optional. The name of the tool to execute.
+        #     Format: `projects/{project}/locations/{location}/apps/{app}/tools/{tool}`
+        #
+        #     Note: The following fields are mutually exclusive: `tool`, `toolset_tool`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] toolset_tool
+        #   @return [::Google::Cloud::Ces::V1beta::ToolsetTool]
+        #     Optional. The toolset tool that got executed.
+        #
+        #     Note: The following fields are mutually exclusive: `toolset_tool`, `tool`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] id
+        #   @return [::String]
+        #     Optional. The matching ID of the [tool
+        #     call][google.cloud.ces.v1beta.ToolCall] the response is for.
+        # @!attribute [r] display_name
+        #   @return [::String]
+        #     Output only. Display name of the tool.
+        # @!attribute [rw] response
+        #   @return [::Google::Protobuf::Struct]
+        #     Required. The tool execution result in JSON object format.
+        #     Use "output" key to specify tool response and "error" key to specify
+        #     error details (if any). If "output" and "error" keys are not specified,
+        #     then whole "response" is treated as tool execution result.
+        class ToolResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Represents an event indicating the transfer of a conversation to a different
+        # agent.
+        # @!attribute [rw] target_agent
+        #   @return [::String]
+        #     Required. The agent to which the conversation is being transferred. The
+        #     agent will handle the conversation from this point forward. Format:
+        #     `projects/{project}/locations/{location}/apps/{app}/agents/{agent}`
+        # @!attribute [r] display_name
+        #   @return [::String]
+        #     Output only. Display name of the agent.
+        class AgentTransfer
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/cloud/ces/v1beta/fakes.rb

@@ -0,0 +1,67 @@
+# 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 Ces
+      module V1beta
+        # A code block to be executed instead of a real tool call.
+        # @!attribute [rw] python_code
+        #   @return [::String]
+        #     Required. Python code which will be invoked in tool fake mode.
+        #     Expected Python function signature -
+        #     To catch all tool calls:
+        #       def fake_tool_call(tool: Tool, input: dict[str, Any],
+        #         callback_context: CallbackContext) -> Optional[dict[str, Any]]:
+        #     To catch a specific tool call:
+        #       def fake_\\{tool_id}(tool: Tool, input: dict[str, Any],
+        #         callback_context: CallbackContext) -> Optional[dict[str, Any]]:
+        #     If the function returns None, the real tool will be invoked instead.
+        class CodeBlock
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Configuration for tool behavior in fake mode.
+        # @!attribute [rw] code_block
+        #   @return [::Google::Cloud::Ces::V1beta::CodeBlock]
+        #     Optional. Code block which will be executed instead of a real tool call.
+        # @!attribute [rw] enable_fake_mode
+        #   @return [::Boolean]
+        #     Optional. Whether the tool is using fake mode.
+        class ToolFakeConfig
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Configures the tool call behaviour for evaluation runs.
+        module EvaluationToolCallBehaviour
+          # Unspecified tool call behavior. Will default to real tool calls.
+          EVALUATION_TOOL_CALL_BEHAVIOUR_UNSPECIFIED = 0
+
+          # Use real tool calls.
+          REAL = 1
+
+          # Use fake tool calls.
+          FAKE = 2
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/cloud/ces/v1beta/file_context.rb

@@ -0,0 +1,50 @@
+# 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 Ces
+      module V1beta
+        # Files to be used as context. Files can be provided as raw bytes.
+        # @!attribute [rw] file_bytes
+        #   @return [::Google::Cloud::Ces::V1beta::FileContext::FileBytes]
+        #     Optional. File provided as raw bytes.
+        class FileContext
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # File provided as raw bytes.
+          # @!attribute [rw] file_name
+          #   @return [::String]
+          #     Required. The name of the file provided as raw bytes.
+          # @!attribute [rw] mime_type
+          #   @return [::String]
+          #     Required. The IANA standard MIME type of the source data.
+          # @!attribute [rw] data
+          #   @return [::String]
+          #     Required. Raw bytes of the file.
+          class FileBytes
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/cloud/ces/v1beta/file_search_tool.rb

@@ -0,0 +1,60 @@
+# 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 Ces
+      module V1beta
+        # The file search tool allows the agent to search across the files uploaded by
+        # the app/agent developer. It has presets to give relatively good quality
+        # search over the uploaded files and summarization of the retrieved results.
+        # @!attribute [rw] corpus_type
+        #   @return [::Google::Cloud::Ces::V1beta::FileSearchTool::CorpusType]
+        #     Optional. The type of the corpus. Default is FULLY_MANAGED.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The tool name.
+        # @!attribute [rw] description
+        #   @return [::String]
+        #     Optional. The tool description.
+        # @!attribute [rw] file_corpus
+        #   @return [::String]
+        #     Optional. The corpus where files are stored.
+        #     Format:
+        #     projects/\\{project}/locations/\\{location}/ragCorpora/\\{rag_corpus}
+        class FileSearchTool
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # The type of the Vertex RAG corpus.
+          module CorpusType
+            # Unspecified corpus type.
+            CORPUS_TYPE_UNSPECIFIED = 0
+
+            # The corpus is created and owned by the user.
+            USER_OWNED = 1
+
+            # The corpus is created by the agent.
+            FULLY_MANAGED = 2
+          end
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/cloud/ces/v1beta/golden_run.rb

@@ -0,0 +1,40 @@
+# 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 Ces
+      module V1beta
+        # The method used to run the evaluation.
+        module GoldenRunMethod
+          # Run method is not specified.
+          GOLDEN_RUN_METHOD_UNSPECIFIED = 0
+
+          # Run the evaluation as stable replay, where each turn is a unique session
+          # with the previous expected turns injected as context.
+          STABLE = 1
+
+          # Run the evaluation as naive replay, where the run is a single
+          # session with no context injected.
+          NAIVE = 2
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/cloud/ces/v1beta/google_search_tool.rb

@@ -0,0 +1,76 @@
+# 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 Ces
+      module V1beta
+        # Represents a tool to perform Google web searches for grounding.
+        # See
+        # https://cloud.google.com/customer-engagement-ai/conversational-agents/ps/tool#google-search.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The name of the tool.
+        # @!attribute [rw] description
+        #   @return [::String]
+        #     Optional. Description of the tool's purpose.
+        # @!attribute [rw] context_urls
+        #   @return [::Array<::String>]
+        #     Optional. Content will be fetched directly from these URLs for context and
+        #     grounding. Example: "https://example.com/path.html". A maximum of 20 URLs
+        #     are allowed.
+        # @!attribute [rw] preferred_domains
+        #   @return [::Array<::String>]
+        #     Optional. Specifies domains to restrict search results to.
+        #     Example: "example.com", "another.site". A maximum of 20 domains can be
+        #     specified.
+        # @!attribute [rw] exclude_domains
+        #   @return [::Array<::String>]
+        #     Optional. List of domains to be excluded from the search results.
+        #     Example: "example.com".
+        #     A maximum of 2000 domains can be excluded.
+        # @!attribute [rw] prompt_config
+        #   @return [::Google::Cloud::Ces::V1beta::GoogleSearchTool::PromptConfig]
+        #     Optional. Prompt instructions passed to planner on how the search results
+        #     should be processed for text and voice.
+        class GoogleSearchTool
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # Prompt settings used by the model when processing or summarizing the
+          # google search results.
+          # @!attribute [rw] text_prompt
+          #   @return [::String]
+          #     Optional. Defines the prompt used for the system instructions when
+          #     interacting with the agent in chat conversations. If not set, default
+          #     prompt will be used.
+          # @!attribute [rw] voice_prompt
+          #   @return [::String]
+          #     Optional. Defines the prompt used for the system instructions when
+          #     interacting with the agent in voice conversations. If not set, default
+          #     prompt will be used.
+          class PromptConfig
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+        end
+      end
+    end
+  end
+end