@google-cloud/discoveryengine 3.0.0 → 3.1.0

package/build/protos/google/cloud/discoveryengine/v1/assistant_service.proto

@@ -63,6 +63,22 @@ message AssistUserMetadata {
 // [AssistantService.StreamAssist][google.cloud.discoveryengine.v1.AssistantService.StreamAssist]
 // method.
 message StreamAssistRequest {
+  // Specification of agents that are used to serve the request.
+  message AgentsSpec {
+    // Specification of an agent.
+    message AgentSpec {
+      // Required. ID to identify the agent resource serving the request.
+      //
+      // This field must conform to
+      // [RFC-1034](https://tools.ietf.org/html/rfc1034)
+      // with a length limit of 63 characters.
+      string agent_id = 1 [(google.api.field_behavior) = REQUIRED];
+    }
+
+    // Optional. Specification of agents that are used to serve the request.
+    repeated AgentSpec agent_specs = 1 [(google.api.field_behavior) = OPTIONAL];
+  }
+
   // Specification of tools that are used to serve the request.
   message ToolsSpec {
     // Specification of the Vertex AI Search tool.
@@ -167,6 +183,9 @@ message StreamAssistRequest {
   // Optional. Information about the user initiating the query.
   AssistUserMetadata user_metadata = 6 [(google.api.field_behavior) = OPTIONAL];
 
+  // Optional. Specification of agents that are used to serve the request.
+  AgentsSpec agents_spec = 22 [(google.api.field_behavior) = OPTIONAL];
+
   // Optional. Specification of tools that are used to serve the request.
   ToolsSpec tools_spec = 18 [(google.api.field_behavior) = OPTIONAL];
 

package/build/protos/google/cloud/discoveryengine/v1beta/assistant_service.proto

@@ -111,6 +111,22 @@ message AssistUserMetadata {
 // [AssistantService.StreamAssist][google.cloud.discoveryengine.v1beta.AssistantService.StreamAssist]
 // method.
 message StreamAssistRequest {
+  // Specification of agents that are used to serve the request.
+  message AgentsSpec {
+    // Specification of an agent.
+    message AgentSpec {
+      // Required. ID to identify the agent resource serving the request.
+      //
+      // This field must conform to
+      // [RFC-1034](https://tools.ietf.org/html/rfc1034)
+      // with a length limit of 63 characters.
+      string agent_id = 1 [(google.api.field_behavior) = REQUIRED];
+    }
+
+    // Optional. Specification of agents that are used to serve the request.
+    repeated AgentSpec agent_specs = 1 [(google.api.field_behavior) = OPTIONAL];
+  }
+
   // Specification of tools that are used to serve the request.
   message ToolsSpec {
     // Specification of the Vertex AI Search tool.
@@ -218,6 +234,9 @@ message StreamAssistRequest {
   // Optional. Information about the user initiating the query.
   AssistUserMetadata user_metadata = 6 [(google.api.field_behavior) = OPTIONAL];
 
+  // Optional. Specification of agents that are used to serve the request.
+  AgentsSpec agents_spec = 22 [(google.api.field_behavior) = OPTIONAL];
+
   // Optional. Specification of tools that are used to serve the request.
   ToolsSpec tools_spec = 18 [(google.api.field_behavior) = OPTIONAL];
 

package/build/protos/protos.d.ts

@@ -4019,6 +4019,9 @@ export namespace google {
                     /** StreamAssistRequest userMetadata */
                     userMetadata?: (google.cloud.discoveryengine.v1.IAssistUserMetadata|null);
 
+                    /** StreamAssistRequest agentsSpec */
+                    agentsSpec?: (google.cloud.discoveryengine.v1.StreamAssistRequest.IAgentsSpec|null);
+
                     /** StreamAssistRequest toolsSpec */
                     toolsSpec?: (google.cloud.discoveryengine.v1.StreamAssistRequest.IToolsSpec|null);
 
@@ -4047,6 +4050,9 @@ export namespace google {
                     /** StreamAssistRequest userMetadata. */
                     public userMetadata?: (google.cloud.discoveryengine.v1.IAssistUserMetadata|null);
 
+                    /** StreamAssistRequest agentsSpec. */
+                    public agentsSpec?: (google.cloud.discoveryengine.v1.StreamAssistRequest.IAgentsSpec|null);
+
                     /** StreamAssistRequest toolsSpec. */
                     public toolsSpec?: (google.cloud.discoveryengine.v1.StreamAssistRequest.IToolsSpec|null);
 
@@ -4133,6 +4139,203 @@ export namespace google {
 
                 namespace StreamAssistRequest {
 
+                    /** Properties of an AgentsSpec. */
+                    interface IAgentsSpec {
+
+                        /** AgentsSpec agentSpecs */
+                        agentSpecs?: (google.cloud.discoveryengine.v1.StreamAssistRequest.AgentsSpec.IAgentSpec[]|null);
+                    }
+
+                    /** Represents an AgentsSpec. */
+                    class AgentsSpec implements IAgentsSpec {
+
+                        /**
+                         * Constructs a new AgentsSpec.
+                         * @param [properties] Properties to set
+                         */
+                        constructor(properties?: google.cloud.discoveryengine.v1.StreamAssistRequest.IAgentsSpec);
+
+                        /** AgentsSpec agentSpecs. */
+                        public agentSpecs: google.cloud.discoveryengine.v1.StreamAssistRequest.AgentsSpec.IAgentSpec[];
+
+                        /**
+                         * Creates a new AgentsSpec instance using the specified properties.
+                         * @param [properties] Properties to set
+                         * @returns AgentsSpec instance
+                         */
+                        public static create(properties?: google.cloud.discoveryengine.v1.StreamAssistRequest.IAgentsSpec): google.cloud.discoveryengine.v1.StreamAssistRequest.AgentsSpec;
+
+                        /**
+                         * Encodes the specified AgentsSpec message. Does not implicitly {@link google.cloud.discoveryengine.v1.StreamAssistRequest.AgentsSpec.verify|verify} messages.
+                         * @param message AgentsSpec message or plain object to encode
+                         * @param [writer] Writer to encode to
+                         * @returns Writer
+                         */
+                        public static encode(message: google.cloud.discoveryengine.v1.StreamAssistRequest.IAgentsSpec, writer?: $protobuf.Writer): $protobuf.Writer;
+
+                        /**
+                         * Encodes the specified AgentsSpec message, length delimited. Does not implicitly {@link google.cloud.discoveryengine.v1.StreamAssistRequest.AgentsSpec.verify|verify} messages.
+                         * @param message AgentsSpec message or plain object to encode
+                         * @param [writer] Writer to encode to
+                         * @returns Writer
+                         */
+                        public static encodeDelimited(message: google.cloud.discoveryengine.v1.StreamAssistRequest.IAgentsSpec, writer?: $protobuf.Writer): $protobuf.Writer;
+
+                        /**
+                         * Decodes an AgentsSpec message from the specified reader or buffer.
+                         * @param reader Reader or buffer to decode from
+                         * @param [length] Message length if known beforehand
+                         * @returns AgentsSpec
+                         * @throws {Error} If the payload is not a reader or valid buffer
+                         * @throws {$protobuf.util.ProtocolError} If required fields are missing
+                         */
+                        public static decode(reader: ($protobuf.Reader|Uint8Array), length?: number): google.cloud.discoveryengine.v1.StreamAssistRequest.AgentsSpec;
+
+                        /**
+                         * Decodes an AgentsSpec message from the specified reader or buffer, length delimited.
+                         * @param reader Reader or buffer to decode from
+                         * @returns AgentsSpec
+                         * @throws {Error} If the payload is not a reader or valid buffer
+                         * @throws {$protobuf.util.ProtocolError} If required fields are missing
+                         */
+                        public static decodeDelimited(reader: ($protobuf.Reader|Uint8Array)): google.cloud.discoveryengine.v1.StreamAssistRequest.AgentsSpec;
+
+                        /**
+                         * Verifies an AgentsSpec message.
+                         * @param message Plain object to verify
+                         * @returns `null` if valid, otherwise the reason why it is not
+                         */
+                        public static verify(message: { [k: string]: any }): (string|null);
+
+                        /**
+                         * Creates an AgentsSpec message from a plain object. Also converts values to their respective internal types.
+                         * @param object Plain object
+                         * @returns AgentsSpec
+                         */
+                        public static fromObject(object: { [k: string]: any }): google.cloud.discoveryengine.v1.StreamAssistRequest.AgentsSpec;
+
+                        /**
+                         * Creates a plain object from an AgentsSpec message. Also converts values to other types if specified.
+                         * @param message AgentsSpec
+                         * @param [options] Conversion options
+                         * @returns Plain object
+                         */
+                        public static toObject(message: google.cloud.discoveryengine.v1.StreamAssistRequest.AgentsSpec, options?: $protobuf.IConversionOptions): { [k: string]: any };
+
+                        /**
+                         * Converts this AgentsSpec to JSON.
+                         * @returns JSON object
+                         */
+                        public toJSON(): { [k: string]: any };
+
+                        /**
+                         * Gets the default type url for AgentsSpec
+                         * @param [typeUrlPrefix] your custom typeUrlPrefix(default "type.googleapis.com")
+                         * @returns The default type url
+                         */
+                        public static getTypeUrl(typeUrlPrefix?: string): string;
+                    }
+
+                    namespace AgentsSpec {
+
+                        /** Properties of an AgentSpec. */
+                        interface IAgentSpec {
+
+                            /** AgentSpec agentId */
+                            agentId?: (string|null);
+                        }
+
+                        /** Represents an AgentSpec. */
+                        class AgentSpec implements IAgentSpec {
+
+                            /**
+                             * Constructs a new AgentSpec.
+                             * @param [properties] Properties to set
+                             */
+                            constructor(properties?: google.cloud.discoveryengine.v1.StreamAssistRequest.AgentsSpec.IAgentSpec);
+
+                            /** AgentSpec agentId. */
+                            public agentId: string;
+
+                            /**
+                             * Creates a new AgentSpec instance using the specified properties.
+                             * @param [properties] Properties to set
+                             * @returns AgentSpec instance
+                             */
+                            public static create(properties?: google.cloud.discoveryengine.v1.StreamAssistRequest.AgentsSpec.IAgentSpec): google.cloud.discoveryengine.v1.StreamAssistRequest.AgentsSpec.AgentSpec;
+
+                            /**
+                             * Encodes the specified AgentSpec message. Does not implicitly {@link google.cloud.discoveryengine.v1.StreamAssistRequest.AgentsSpec.AgentSpec.verify|verify} messages.
+                             * @param message AgentSpec message or plain object to encode
+                             * @param [writer] Writer to encode to
+                             * @returns Writer
+                             */
+                            public static encode(message: google.cloud.discoveryengine.v1.StreamAssistRequest.AgentsSpec.IAgentSpec, writer?: $protobuf.Writer): $protobuf.Writer;
+
+                            /**
+                             * Encodes the specified AgentSpec message, length delimited. Does not implicitly {@link google.cloud.discoveryengine.v1.StreamAssistRequest.AgentsSpec.AgentSpec.verify|verify} messages.
+                             * @param message AgentSpec message or plain object to encode
+                             * @param [writer] Writer to encode to
+                             * @returns Writer
+                             */
+                            public static encodeDelimited(message: google.cloud.discoveryengine.v1.StreamAssistRequest.AgentsSpec.IAgentSpec, writer?: $protobuf.Writer): $protobuf.Writer;
+
+                            /**
+                             * Decodes an AgentSpec message from the specified reader or buffer.
+                             * @param reader Reader or buffer to decode from
+                             * @param [length] Message length if known beforehand
+                             * @returns AgentSpec
+                             * @throws {Error} If the payload is not a reader or valid buffer
+                             * @throws {$protobuf.util.ProtocolError} If required fields are missing
+                             */
+                            public static decode(reader: ($protobuf.Reader|Uint8Array), length?: number): google.cloud.discoveryengine.v1.StreamAssistRequest.AgentsSpec.AgentSpec;
+
+                            /**
+                             * Decodes an AgentSpec message from the specified reader or buffer, length delimited.
+                             * @param reader Reader or buffer to decode from
+                             * @returns AgentSpec
+                             * @throws {Error} If the payload is not a reader or valid buffer
+                             * @throws {$protobuf.util.ProtocolError} If required fields are missing
+                             */
+                            public static decodeDelimited(reader: ($protobuf.Reader|Uint8Array)): google.cloud.discoveryengine.v1.StreamAssistRequest.AgentsSpec.AgentSpec;
+
+                            /**
+                             * Verifies an AgentSpec message.
+                             * @param message Plain object to verify
+                             * @returns `null` if valid, otherwise the reason why it is not
+                             */
+                            public static verify(message: { [k: string]: any }): (string|null);
+
+                            /**
+                             * Creates an AgentSpec message from a plain object. Also converts values to their respective internal types.
+                             * @param object Plain object
+                             * @returns AgentSpec
+                             */
+                            public static fromObject(object: { [k: string]: any }): google.cloud.discoveryengine.v1.StreamAssistRequest.AgentsSpec.AgentSpec;
+
+                            /**
+                             * Creates a plain object from an AgentSpec message. Also converts values to other types if specified.
+                             * @param message AgentSpec
+                             * @param [options] Conversion options
+                             * @returns Plain object
+                             */
+                            public static toObject(message: google.cloud.discoveryengine.v1.StreamAssistRequest.AgentsSpec.AgentSpec, options?: $protobuf.IConversionOptions): { [k: string]: any };
+
+                            /**
+                             * Converts this AgentSpec to JSON.
+                             * @returns JSON object
+                             */
+                            public toJSON(): { [k: string]: any };
+
+                            /**
+                             * Gets the default type url for AgentSpec
+                             * @param [typeUrlPrefix] your custom typeUrlPrefix(default "type.googleapis.com")
+                             * @returns The default type url
+                             */
+                            public static getTypeUrl(typeUrlPrefix?: string): string;
+                        }
+                    }
+
                     /** Properties of a ToolsSpec. */
                     interface IToolsSpec {
 
@@ -108032,6 +108235,9 @@ export namespace google {
                     /** StreamAssistRequest userMetadata */
                     userMetadata?: (google.cloud.discoveryengine.v1beta.IAssistUserMetadata|null);
 
+                    /** StreamAssistRequest agentsSpec */
+                    agentsSpec?: (google.cloud.discoveryengine.v1beta.StreamAssistRequest.IAgentsSpec|null);
+
                     /** StreamAssistRequest toolsSpec */
                     toolsSpec?: (google.cloud.discoveryengine.v1beta.StreamAssistRequest.IToolsSpec|null);
 
@@ -108060,6 +108266,9 @@ export namespace google {
                     /** StreamAssistRequest userMetadata. */
                     public userMetadata?: (google.cloud.discoveryengine.v1beta.IAssistUserMetadata|null);
 
+                    /** StreamAssistRequest agentsSpec. */
+                    public agentsSpec?: (google.cloud.discoveryengine.v1beta.StreamAssistRequest.IAgentsSpec|null);
+
                     /** StreamAssistRequest toolsSpec. */
                     public toolsSpec?: (google.cloud.discoveryengine.v1beta.StreamAssistRequest.IToolsSpec|null);
 
@@ -108146,6 +108355,203 @@ export namespace google {
 
                 namespace StreamAssistRequest {
 
+                    /** Properties of an AgentsSpec. */
+                    interface IAgentsSpec {
+
+                        /** AgentsSpec agentSpecs */
+                        agentSpecs?: (google.cloud.discoveryengine.v1beta.StreamAssistRequest.AgentsSpec.IAgentSpec[]|null);
+                    }
+
+                    /** Represents an AgentsSpec. */
+                    class AgentsSpec implements IAgentsSpec {
+
+                        /**
+                         * Constructs a new AgentsSpec.
+                         * @param [properties] Properties to set
+                         */
+                        constructor(properties?: google.cloud.discoveryengine.v1beta.StreamAssistRequest.IAgentsSpec);
+
+                        /** AgentsSpec agentSpecs. */
+                        public agentSpecs: google.cloud.discoveryengine.v1beta.StreamAssistRequest.AgentsSpec.IAgentSpec[];
+
+                        /**
+                         * Creates a new AgentsSpec instance using the specified properties.
+                         * @param [properties] Properties to set
+                         * @returns AgentsSpec instance
+                         */
+                        public static create(properties?: google.cloud.discoveryengine.v1beta.StreamAssistRequest.IAgentsSpec): google.cloud.discoveryengine.v1beta.StreamAssistRequest.AgentsSpec;
+
+                        /**
+                         * Encodes the specified AgentsSpec message. Does not implicitly {@link google.cloud.discoveryengine.v1beta.StreamAssistRequest.AgentsSpec.verify|verify} messages.
+                         * @param message AgentsSpec message or plain object to encode
+                         * @param [writer] Writer to encode to
+                         * @returns Writer
+                         */
+                        public static encode(message: google.cloud.discoveryengine.v1beta.StreamAssistRequest.IAgentsSpec, writer?: $protobuf.Writer): $protobuf.Writer;
+
+                        /**
+                         * Encodes the specified AgentsSpec message, length delimited. Does not implicitly {@link google.cloud.discoveryengine.v1beta.StreamAssistRequest.AgentsSpec.verify|verify} messages.
+                         * @param message AgentsSpec message or plain object to encode
+                         * @param [writer] Writer to encode to
+                         * @returns Writer
+                         */
+                        public static encodeDelimited(message: google.cloud.discoveryengine.v1beta.StreamAssistRequest.IAgentsSpec, writer?: $protobuf.Writer): $protobuf.Writer;
+
+                        /**
+                         * Decodes an AgentsSpec message from the specified reader or buffer.
+                         * @param reader Reader or buffer to decode from
+                         * @param [length] Message length if known beforehand
+                         * @returns AgentsSpec
+                         * @throws {Error} If the payload is not a reader or valid buffer
+                         * @throws {$protobuf.util.ProtocolError} If required fields are missing
+                         */
+                        public static decode(reader: ($protobuf.Reader|Uint8Array), length?: number): google.cloud.discoveryengine.v1beta.StreamAssistRequest.AgentsSpec;
+
+                        /**
+                         * Decodes an AgentsSpec message from the specified reader or buffer, length delimited.
+                         * @param reader Reader or buffer to decode from
+                         * @returns AgentsSpec
+                         * @throws {Error} If the payload is not a reader or valid buffer
+                         * @throws {$protobuf.util.ProtocolError} If required fields are missing
+                         */
+                        public static decodeDelimited(reader: ($protobuf.Reader|Uint8Array)): google.cloud.discoveryengine.v1beta.StreamAssistRequest.AgentsSpec;
+
+                        /**
+                         * Verifies an AgentsSpec message.
+                         * @param message Plain object to verify
+                         * @returns `null` if valid, otherwise the reason why it is not
+                         */
+                        public static verify(message: { [k: string]: any }): (string|null);
+
+                        /**
+                         * Creates an AgentsSpec message from a plain object. Also converts values to their respective internal types.
+                         * @param object Plain object
+                         * @returns AgentsSpec
+                         */
+                        public static fromObject(object: { [k: string]: any }): google.cloud.discoveryengine.v1beta.StreamAssistRequest.AgentsSpec;
+
+                        /**
+                         * Creates a plain object from an AgentsSpec message. Also converts values to other types if specified.
+                         * @param message AgentsSpec
+                         * @param [options] Conversion options
+                         * @returns Plain object
+                         */
+                        public static toObject(message: google.cloud.discoveryengine.v1beta.StreamAssistRequest.AgentsSpec, options?: $protobuf.IConversionOptions): { [k: string]: any };
+
+                        /**
+                         * Converts this AgentsSpec to JSON.
+                         * @returns JSON object
+                         */
+                        public toJSON(): { [k: string]: any };
+
+                        /**
+                         * Gets the default type url for AgentsSpec
+                         * @param [typeUrlPrefix] your custom typeUrlPrefix(default "type.googleapis.com")
+                         * @returns The default type url
+                         */
+                        public static getTypeUrl(typeUrlPrefix?: string): string;
+                    }
+
+                    namespace AgentsSpec {
+
+                        /** Properties of an AgentSpec. */
+                        interface IAgentSpec {
+
+                            /** AgentSpec agentId */
+                            agentId?: (string|null);
+                        }
+
+                        /** Represents an AgentSpec. */
+                        class AgentSpec implements IAgentSpec {
+
+                            /**
+                             * Constructs a new AgentSpec.
+                             * @param [properties] Properties to set
+                             */
+                            constructor(properties?: google.cloud.discoveryengine.v1beta.StreamAssistRequest.AgentsSpec.IAgentSpec);
+
+                            /** AgentSpec agentId. */
+                            public agentId: string;
+
+                            /**
+                             * Creates a new AgentSpec instance using the specified properties.
+                             * @param [properties] Properties to set
+                             * @returns AgentSpec instance
+                             */
+                            public static create(properties?: google.cloud.discoveryengine.v1beta.StreamAssistRequest.AgentsSpec.IAgentSpec): google.cloud.discoveryengine.v1beta.StreamAssistRequest.AgentsSpec.AgentSpec;
+
+                            /**
+                             * Encodes the specified AgentSpec message. Does not implicitly {@link google.cloud.discoveryengine.v1beta.StreamAssistRequest.AgentsSpec.AgentSpec.verify|verify} messages.
+                             * @param message AgentSpec message or plain object to encode
+                             * @param [writer] Writer to encode to
+                             * @returns Writer
+                             */
+                            public static encode(message: google.cloud.discoveryengine.v1beta.StreamAssistRequest.AgentsSpec.IAgentSpec, writer?: $protobuf.Writer): $protobuf.Writer;
+
+                            /**
+                             * Encodes the specified AgentSpec message, length delimited. Does not implicitly {@link google.cloud.discoveryengine.v1beta.StreamAssistRequest.AgentsSpec.AgentSpec.verify|verify} messages.
+                             * @param message AgentSpec message or plain object to encode
+                             * @param [writer] Writer to encode to
+                             * @returns Writer
+                             */
+                            public static encodeDelimited(message: google.cloud.discoveryengine.v1beta.StreamAssistRequest.AgentsSpec.IAgentSpec, writer?: $protobuf.Writer): $protobuf.Writer;
+
+                            /**
+                             * Decodes an AgentSpec message from the specified reader or buffer.
+                             * @param reader Reader or buffer to decode from
+                             * @param [length] Message length if known beforehand
+                             * @returns AgentSpec
+                             * @throws {Error} If the payload is not a reader or valid buffer
+                             * @throws {$protobuf.util.ProtocolError} If required fields are missing
+                             */
+                            public static decode(reader: ($protobuf.Reader|Uint8Array), length?: number): google.cloud.discoveryengine.v1beta.StreamAssistRequest.AgentsSpec.AgentSpec;
+
+                            /**
+                             * Decodes an AgentSpec message from the specified reader or buffer, length delimited.
+                             * @param reader Reader or buffer to decode from
+                             * @returns AgentSpec
+                             * @throws {Error} If the payload is not a reader or valid buffer
+                             * @throws {$protobuf.util.ProtocolError} If required fields are missing
+                             */
+                            public static decodeDelimited(reader: ($protobuf.Reader|Uint8Array)): google.cloud.discoveryengine.v1beta.StreamAssistRequest.AgentsSpec.AgentSpec;
+
+                            /**
+                             * Verifies an AgentSpec message.
+                             * @param message Plain object to verify
+                             * @returns `null` if valid, otherwise the reason why it is not
+                             */
+                            public static verify(message: { [k: string]: any }): (string|null);
+
+                            /**
+                             * Creates an AgentSpec message from a plain object. Also converts values to their respective internal types.
+                             * @param object Plain object
+                             * @returns AgentSpec
+                             */
+                            public static fromObject(object: { [k: string]: any }): google.cloud.discoveryengine.v1beta.StreamAssistRequest.AgentsSpec.AgentSpec;
+
+                            /**
+                             * Creates a plain object from an AgentSpec message. Also converts values to other types if specified.
+                             * @param message AgentSpec
+                             * @param [options] Conversion options
+                             * @returns Plain object
+                             */
+                            public static toObject(message: google.cloud.discoveryengine.v1beta.StreamAssistRequest.AgentsSpec.AgentSpec, options?: $protobuf.IConversionOptions): { [k: string]: any };
+
+                            /**
+                             * Converts this AgentSpec to JSON.
+                             * @returns JSON object
+                             */
+                            public toJSON(): { [k: string]: any };
+
+                            /**
+                             * Gets the default type url for AgentSpec
+                             * @param [typeUrlPrefix] your custom typeUrlPrefix(default "type.googleapis.com")
+                             * @returns The default type url
+                             */
+                            public static getTypeUrl(typeUrlPrefix?: string): string;
+                        }
+                    }
+
                     /** Properties of a ToolsSpec. */
                     interface IToolsSpec {