Class: Google::Cloud::Ces::V1beta::GenerateAppResourceRequest

Inherits:

Object

• Object
• Google::Cloud::Ces::V1beta::GenerateAppResourceRequest

Extended by:

Protobuf::MessageExts::ClassMethods

Includes:

Protobuf::MessageExts

Defined in:

proto_docs/google/cloud/ces/v1beta/agent_service.rb

Overview

Request message for AgentService.GenerateAppResource.

Defined Under Namespace

Classes: AppGenerationConfig, EvaluationGenerationConfig, EvaluationPersonasGenerationConfig, HillClimbingFixConfig, QualityReportGenerationConfig, RefineInstructions, ToolGenerationConfig

Instance Attribute Summary

• #agent ⇒ ::Google::Cloud::Ces::V1beta::Agent

  The agent resource to be used by the LLM assistant, can be empty for generating a new agent.

• #app_generation_config ⇒ ::Google::Cloud::Ces::V1beta::GenerateAppResourceRequest::AppGenerationConfig

  Optional.

• #evaluation_generation_config ⇒ ::Google::Cloud::Ces::V1beta::GenerateAppResourceRequest::EvaluationGenerationConfig

  Optional.

• #evaluation_personas_generation_config ⇒ ::Google::Cloud::Ces::V1beta::GenerateAppResourceRequest::EvaluationPersonasGenerationConfig

  Optional.

• #hill_climbing_fix_config ⇒ ::Google::Cloud::Ces::V1beta::GenerateAppResourceRequest::HillClimbingFixConfig

  Optional.

• #parent ⇒ ::String

  Required.

• #quality_report_generation_config ⇒ ::Google::Cloud::Ces::V1beta::GenerateAppResourceRequest::QualityReportGenerationConfig

  Optional.

• #refine_instructions ⇒ ::Array<::Google::Cloud::Ces::V1beta::GenerateAppResourceRequest::RefineInstructions>

  Optional.

• #tool ⇒ ::Google::Cloud::Ces::V1beta::Tool

  The tool resource to be used by the LLM assistant, can be empty for generating a new tool.

• #tool_generation_config ⇒ ::Google::Cloud::Ces::V1beta::GenerateAppResourceRequest::ToolGenerationConfig

  Optional.

• #toolset ⇒ ::Google::Cloud::Ces::V1beta::Toolset

  The toolset resource to be used by the LLM assistant, can be empty for generating a new toolset.

Instance Attribute Details

#agent ⇒ ::Google::Cloud::Ces::V1beta::Agent

Returns The agent resource to be used by the LLM assistant, can be empty for generating a new agent.

Note: The following fields are mutually exclusive: agent, tool, toolset. If a field in that set is populated, all other fields in the set will automatically be cleared.

Returns:

• (::Google::Cloud::Ces::V1beta::Agent) —

  The agent resource to be used by the LLM assistant, can be empty for generating a new agent.

  Note: The following fields are mutually exclusive: agent, tool, toolset. If a field in that set is populated, all other fields in the set will automatically be cleared.

# File 'proto_docs/google/cloud/ces/v1beta/agent_service.rb', line 1225

class GenerateAppResourceRequest
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # The instructions to be used to refine a part of the resource. The part of
  # the resource can be specified  with a start index, end index and a field
  # mask. For example, if you want to refine a part of the agent instructions
  # you can specify the index of the first character of the instructions, the
  # index of the last character of the instructions and the field mask as
  # "instructions".
  # @!attribute [rw] start_index
  #   @return [::Integer]
  #     Required. The first character (inclusive) of the text to refine.
  # @!attribute [rw] end_index
  #   @return [::Integer]
  #     Required. The last character (inclusive) of the text to refine.
  # @!attribute [rw] field_mask
  #   @return [::Google::Protobuf::FieldMask]
  #     Required. The field of the resource being refined. Only one field is
  #     allowed per RefineInstructions. If refining agent instructions, the field
  #     mask should be "instructions".
  # @!attribute [rw] instructions
  #   @return [::String]
  #     Required. The instructions to refine the resource.
  class RefineInstructions
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The configuration to be used to generate a tool.
  # @!attribute [rw] context
  #   @return [::String]
  #     Optional. The context which describes the tool to be generated. This can
  #     be empty if the tool request & response are provided.
  # @!attribute [rw] file_contexts
  #   @return [::Array<::Google::Cloud::Ces::V1beta::FileContext>]
  #     Optional. The files to be used as context.
  # @!attribute [rw] open_api_toolset_generation_config
  #   @return [::Google::Cloud::Ces::V1beta::GenerateAppResourceRequest::ToolGenerationConfig::OpenApiToolsetGenerationConfig]
  #     Optional. The configuration to be used to generate an Open API schema.
  class ToolGenerationConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # The configuration to be used to generate an Open API schema.
    # @!attribute [rw] uri
    #   @return [::String]
    #     Required. The base uri of the tool.
    # @!attribute [rw] operation_generation_configs
    #   @return [::Array<::Google::Cloud::Ces::V1beta::GenerateAppResourceRequest::ToolGenerationConfig::OpenApiToolsetGenerationConfig::OperationGenerationConfig>]
    #     Required. The list of operations to be added to the Open API schema.
    class OpenApiToolsetGenerationConfig
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # The configuration to be used to generate an operation in the Open API
      # schema.
      # @!attribute [rw] method
      #   @return [::String]
      #     Required. The uri of the tool. This should include query and path
      #     parameters if any.
      # @!attribute [rw] path
      #   @return [::String]
      #     Required. The path of the tool to be appended to the base uri. This
      #     should include query and path parameters if any.
      # @!attribute [rw] request_json
      #   @return [::String]
      #     Required. A sample request to the tool in JSON format. Skip if the
      #     tool does not support request body.
      # @!attribute [rw] response_json
      #   @return [::String]
      #     Required. A sample response from the tool in JSON format.
      class OperationGenerationConfig
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end
    end
  end

  # The configuration to be used to generate the app.
  # @!attribute [rw] context
  #   @return [::String]
  #     Optional. The context which describes the requirements of the agents &
  #     tools to be generated.
  # @!attribute [rw] file_contexts
  #   @return [::Array<::Google::Cloud::Ces::V1beta::FileContext>]
  #     Optional. The files to be used as context.
  # @!attribute [rw] dataset_id
  #   @return [::String]
  #     Optional. The insights dataset to be used to fetch conversation data for
  #     generating the agents & tools.
  #     Format:
  #     `projects/{project}/locations/{location}/datasets/{dataset}`.
  # @!attribute [rw] generate_evaluations
  #   @return [::Boolean]
  #     Optional. Whether to generate the evaluations for the app. If true, the
  #     provided context will be used to generate the evaluations data.
  # @!attribute [rw] gcs_location
  #   @return [::String]
  #     Optional. The Cloud Storage location to store the generated question
  #     answer data to be used by the Datastore tool. This data is generated only
  #     when using conversation data as an input source. The location must be
  #     in the same project as the app.
  #     Format: `gs://...`.
  class AppGenerationConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The configuration to be used to generate the evaluations.
  # @!attribute [rw] dataset_id
  #   @return [::String]
  #     Optional. The insights dataset to be used to fetch conversation data for
  #     generating the evaluations.
  #     Format:
  #     `projects/{project}/locations/{location}/datasets/{dataset}`.
  class EvaluationGenerationConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The configuration to be used to generate the evaluation personas.
  class EvaluationPersonasGenerationConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The configuration to be used for quality report generation.
  # @!attribute [rw] evaluation_run
  #   @return [::String]
  #     Required. The evaluation run used to inform quality report analysis.
  class QualityReportGenerationConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The configuration to be used for hill climbing fixes.
  # @!attribute [rw] quality_report
  #   @return [::Google::Cloud::Ces::V1beta::QualityReport]
  #     Required. The quality report used to inform the instruction following
  #     fix.
  class HillClimbingFixConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end
end

#app_generation_config ⇒ ::Google::Cloud::Ces::V1beta::GenerateAppResourceRequest::AppGenerationConfig

Returns Optional. The configuration to be used to generate the agents and tools.

Returns:

• (::Google::Cloud::Ces::V1beta::GenerateAppResourceRequest::AppGenerationConfig) —

  Optional. The configuration to be used to generate the agents and tools.

# File 'proto_docs/google/cloud/ces/v1beta/agent_service.rb', line 1225

class GenerateAppResourceRequest
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # The instructions to be used to refine a part of the resource. The part of
  # the resource can be specified  with a start index, end index and a field
  # mask. For example, if you want to refine a part of the agent instructions
  # you can specify the index of the first character of the instructions, the
  # index of the last character of the instructions and the field mask as
  # "instructions".
  # @!attribute [rw] start_index
  #   @return [::Integer]
  #     Required. The first character (inclusive) of the text to refine.
  # @!attribute [rw] end_index
  #   @return [::Integer]
  #     Required. The last character (inclusive) of the text to refine.
  # @!attribute [rw] field_mask
  #   @return [::Google::Protobuf::FieldMask]
  #     Required. The field of the resource being refined. Only one field is
  #     allowed per RefineInstructions. If refining agent instructions, the field
  #     mask should be "instructions".
  # @!attribute [rw] instructions
  #   @return [::String]
  #     Required. The instructions to refine the resource.
  class RefineInstructions
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The configuration to be used to generate a tool.
  # @!attribute [rw] context
  #   @return [::String]
  #     Optional. The context which describes the tool to be generated. This can
  #     be empty if the tool request & response are provided.
  # @!attribute [rw] file_contexts
  #   @return [::Array<::Google::Cloud::Ces::V1beta::FileContext>]
  #     Optional. The files to be used as context.
  # @!attribute [rw] open_api_toolset_generation_config
  #   @return [::Google::Cloud::Ces::V1beta::GenerateAppResourceRequest::ToolGenerationConfig::OpenApiToolsetGenerationConfig]
  #     Optional. The configuration to be used to generate an Open API schema.
  class ToolGenerationConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # The configuration to be used to generate an Open API schema.
    # @!attribute [rw] uri
    #   @return [::String]
    #     Required. The base uri of the tool.
    # @!attribute [rw] operation_generation_configs
    #   @return [::Array<::Google::Cloud::Ces::V1beta::GenerateAppResourceRequest::ToolGenerationConfig::OpenApiToolsetGenerationConfig::OperationGenerationConfig>]
    #     Required. The list of operations to be added to the Open API schema.
    class OpenApiToolsetGenerationConfig
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # The configuration to be used to generate an operation in the Open API
      # schema.
      # @!attribute [rw] method
      #   @return [::String]
      #     Required. The uri of the tool. This should include query and path
      #     parameters if any.
      # @!attribute [rw] path
      #   @return [::String]
      #     Required. The path of the tool to be appended to the base uri. This
      #     should include query and path parameters if any.
      # @!attribute [rw] request_json
      #   @return [::String]
      #     Required. A sample request to the tool in JSON format. Skip if the
      #     tool does not support request body.
      # @!attribute [rw] response_json
      #   @return [::String]
      #     Required. A sample response from the tool in JSON format.
      class OperationGenerationConfig
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end
    end
  end

  # The configuration to be used to generate the app.
  # @!attribute [rw] context
  #   @return [::String]
  #     Optional. The context which describes the requirements of the agents &
  #     tools to be generated.
  # @!attribute [rw] file_contexts
  #   @return [::Array<::Google::Cloud::Ces::V1beta::FileContext>]
  #     Optional. The files to be used as context.
  # @!attribute [rw] dataset_id
  #   @return [::String]
  #     Optional. The insights dataset to be used to fetch conversation data for
  #     generating the agents & tools.
  #     Format:
  #     `projects/{project}/locations/{location}/datasets/{dataset}`.
  # @!attribute [rw] generate_evaluations
  #   @return [::Boolean]
  #     Optional. Whether to generate the evaluations for the app. If true, the
  #     provided context will be used to generate the evaluations data.
  # @!attribute [rw] gcs_location
  #   @return [::String]
  #     Optional. The Cloud Storage location to store the generated question
  #     answer data to be used by the Datastore tool. This data is generated only
  #     when using conversation data as an input source. The location must be
  #     in the same project as the app.
  #     Format: `gs://...`.
  class AppGenerationConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The configuration to be used to generate the evaluations.
  # @!attribute [rw] dataset_id
  #   @return [::String]
  #     Optional. The insights dataset to be used to fetch conversation data for
  #     generating the evaluations.
  #     Format:
  #     `projects/{project}/locations/{location}/datasets/{dataset}`.
  class EvaluationGenerationConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The configuration to be used to generate the evaluation personas.
  class EvaluationPersonasGenerationConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The configuration to be used for quality report generation.
  # @!attribute [rw] evaluation_run
  #   @return [::String]
  #     Required. The evaluation run used to inform quality report analysis.
  class QualityReportGenerationConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The configuration to be used for hill climbing fixes.
  # @!attribute [rw] quality_report
  #   @return [::Google::Cloud::Ces::V1beta::QualityReport]
  #     Required. The quality report used to inform the instruction following
  #     fix.
  class HillClimbingFixConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end
end

#evaluation_generation_config ⇒ ::Google::Cloud::Ces::V1beta::GenerateAppResourceRequest::EvaluationGenerationConfig

Returns Optional. The configuration to be used to generate the evaluations.

Returns:

• (::Google::Cloud::Ces::V1beta::GenerateAppResourceRequest::EvaluationGenerationConfig) —

  Optional. The configuration to be used to generate the evaluations.

# File 'proto_docs/google/cloud/ces/v1beta/agent_service.rb', line 1225

class GenerateAppResourceRequest
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # The instructions to be used to refine a part of the resource. The part of
  # the resource can be specified  with a start index, end index and a field
  # mask. For example, if you want to refine a part of the agent instructions
  # you can specify the index of the first character of the instructions, the
  # index of the last character of the instructions and the field mask as
  # "instructions".
  # @!attribute [rw] start_index
  #   @return [::Integer]
  #     Required. The first character (inclusive) of the text to refine.
  # @!attribute [rw] end_index
  #   @return [::Integer]
  #     Required. The last character (inclusive) of the text to refine.
  # @!attribute [rw] field_mask
  #   @return [::Google::Protobuf::FieldMask]
  #     Required. The field of the resource being refined. Only one field is
  #     allowed per RefineInstructions. If refining agent instructions, the field
  #     mask should be "instructions".
  # @!attribute [rw] instructions
  #   @return [::String]
  #     Required. The instructions to refine the resource.
  class RefineInstructions
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The configuration to be used to generate a tool.
  # @!attribute [rw] context
  #   @return [::String]
  #     Optional. The context which describes the tool to be generated. This can
  #     be empty if the tool request & response are provided.
  # @!attribute [rw] file_contexts
  #   @return [::Array<::Google::Cloud::Ces::V1beta::FileContext>]
  #     Optional. The files to be used as context.
  # @!attribute [rw] open_api_toolset_generation_config
  #   @return [::Google::Cloud::Ces::V1beta::GenerateAppResourceRequest::ToolGenerationConfig::OpenApiToolsetGenerationConfig]
  #     Optional. The configuration to be used to generate an Open API schema.
  class ToolGenerationConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # The configuration to be used to generate an Open API schema.
    # @!attribute [rw] uri
    #   @return [::String]
    #     Required. The base uri of the tool.
    # @!attribute [rw] operation_generation_configs
    #   @return [::Array<::Google::Cloud::Ces::V1beta::GenerateAppResourceRequest::ToolGenerationConfig::OpenApiToolsetGenerationConfig::OperationGenerationConfig>]
    #     Required. The list of operations to be added to the Open API schema.
    class OpenApiToolsetGenerationConfig
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # The configuration to be used to generate an operation in the Open API
      # schema.
      # @!attribute [rw] method
      #   @return [::String]
      #     Required. The uri of the tool. This should include query and path
      #     parameters if any.
      # @!attribute [rw] path
      #   @return [::String]
      #     Required. The path of the tool to be appended to the base uri. This
      #     should include query and path parameters if any.
      # @!attribute [rw] request_json
      #   @return [::String]
      #     Required. A sample request to the tool in JSON format. Skip if the
      #     tool does not support request body.
      # @!attribute [rw] response_json
      #   @return [::String]
      #     Required. A sample response from the tool in JSON format.
      class OperationGenerationConfig
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end
    end
  end

  # The configuration to be used to generate the app.
  # @!attribute [rw] context
  #   @return [::String]
  #     Optional. The context which describes the requirements of the agents &
  #     tools to be generated.
  # @!attribute [rw] file_contexts
  #   @return [::Array<::Google::Cloud::Ces::V1beta::FileContext>]
  #     Optional. The files to be used as context.
  # @!attribute [rw] dataset_id
  #   @return [::String]
  #     Optional. The insights dataset to be used to fetch conversation data for
  #     generating the agents & tools.
  #     Format:
  #     `projects/{project}/locations/{location}/datasets/{dataset}`.
  # @!attribute [rw] generate_evaluations
  #   @return [::Boolean]
  #     Optional. Whether to generate the evaluations for the app. If true, the
  #     provided context will be used to generate the evaluations data.
  # @!attribute [rw] gcs_location
  #   @return [::String]
  #     Optional. The Cloud Storage location to store the generated question
  #     answer data to be used by the Datastore tool. This data is generated only
  #     when using conversation data as an input source. The location must be
  #     in the same project as the app.
  #     Format: `gs://...`.
  class AppGenerationConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The configuration to be used to generate the evaluations.
  # @!attribute [rw] dataset_id
  #   @return [::String]
  #     Optional. The insights dataset to be used to fetch conversation data for
  #     generating the evaluations.
  #     Format:
  #     `projects/{project}/locations/{location}/datasets/{dataset}`.
  class EvaluationGenerationConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The configuration to be used to generate the evaluation personas.
  class EvaluationPersonasGenerationConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The configuration to be used for quality report generation.
  # @!attribute [rw] evaluation_run
  #   @return [::String]
  #     Required. The evaluation run used to inform quality report analysis.
  class QualityReportGenerationConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The configuration to be used for hill climbing fixes.
  # @!attribute [rw] quality_report
  #   @return [::Google::Cloud::Ces::V1beta::QualityReport]
  #     Required. The quality report used to inform the instruction following
  #     fix.
  class HillClimbingFixConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end
end

#evaluation_personas_generation_config ⇒ ::Google::Cloud::Ces::V1beta::GenerateAppResourceRequest::EvaluationPersonasGenerationConfig

Returns Optional. The configuration to be used to generate the evaluation personas.

Returns:

• (::Google::Cloud::Ces::V1beta::GenerateAppResourceRequest::EvaluationPersonasGenerationConfig) —

  Optional. The configuration to be used to generate the evaluation personas.

# File 'proto_docs/google/cloud/ces/v1beta/agent_service.rb', line 1225

class GenerateAppResourceRequest
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # The instructions to be used to refine a part of the resource. The part of
  # the resource can be specified  with a start index, end index and a field
  # mask. For example, if you want to refine a part of the agent instructions
  # you can specify the index of the first character of the instructions, the
  # index of the last character of the instructions and the field mask as
  # "instructions".
  # @!attribute [rw] start_index
  #   @return [::Integer]
  #     Required. The first character (inclusive) of the text to refine.
  # @!attribute [rw] end_index
  #   @return [::Integer]
  #     Required. The last character (inclusive) of the text to refine.
  # @!attribute [rw] field_mask
  #   @return [::Google::Protobuf::FieldMask]
  #     Required. The field of the resource being refined. Only one field is
  #     allowed per RefineInstructions. If refining agent instructions, the field
  #     mask should be "instructions".
  # @!attribute [rw] instructions
  #   @return [::String]
  #     Required. The instructions to refine the resource.
  class RefineInstructions
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The configuration to be used to generate a tool.
  # @!attribute [rw] context
  #   @return [::String]
  #     Optional. The context which describes the tool to be generated. This can
  #     be empty if the tool request & response are provided.
  # @!attribute [rw] file_contexts
  #   @return [::Array<::Google::Cloud::Ces::V1beta::FileContext>]
  #     Optional. The files to be used as context.
  # @!attribute [rw] open_api_toolset_generation_config
  #   @return [::Google::Cloud::Ces::V1beta::GenerateAppResourceRequest::ToolGenerationConfig::OpenApiToolsetGenerationConfig]
  #     Optional. The configuration to be used to generate an Open API schema.
  class ToolGenerationConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # The configuration to be used to generate an Open API schema.
    # @!attribute [rw] uri
    #   @return [::String]
    #     Required. The base uri of the tool.
    # @!attribute [rw] operation_generation_configs
    #   @return [::Array<::Google::Cloud::Ces::V1beta::GenerateAppResourceRequest::ToolGenerationConfig::OpenApiToolsetGenerationConfig::OperationGenerationConfig>]
    #     Required. The list of operations to be added to the Open API schema.
    class OpenApiToolsetGenerationConfig
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # The configuration to be used to generate an operation in the Open API
      # schema.
      # @!attribute [rw] method
      #   @return [::String]
      #     Required. The uri of the tool. This should include query and path
      #     parameters if any.
      # @!attribute [rw] path
      #   @return [::String]
      #     Required. The path of the tool to be appended to the base uri. This
      #     should include query and path parameters if any.
      # @!attribute [rw] request_json
      #   @return [::String]
      #     Required. A sample request to the tool in JSON format. Skip if the
      #     tool does not support request body.
      # @!attribute [rw] response_json
      #   @return [::String]
      #     Required. A sample response from the tool in JSON format.
      class OperationGenerationConfig
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end
    end
  end

  # The configuration to be used to generate the app.
  # @!attribute [rw] context
  #   @return [::String]
  #     Optional. The context which describes the requirements of the agents &
  #     tools to be generated.
  # @!attribute [rw] file_contexts
  #   @return [::Array<::Google::Cloud::Ces::V1beta::FileContext>]
  #     Optional. The files to be used as context.
  # @!attribute [rw] dataset_id
  #   @return [::String]
  #     Optional. The insights dataset to be used to fetch conversation data for
  #     generating the agents & tools.
  #     Format:
  #     `projects/{project}/locations/{location}/datasets/{dataset}`.
  # @!attribute [rw] generate_evaluations
  #   @return [::Boolean]
  #     Optional. Whether to generate the evaluations for the app. If true, the
  #     provided context will be used to generate the evaluations data.
  # @!attribute [rw] gcs_location
  #   @return [::String]
  #     Optional. The Cloud Storage location to store the generated question
  #     answer data to be used by the Datastore tool. This data is generated only
  #     when using conversation data as an input source. The location must be
  #     in the same project as the app.
  #     Format: `gs://...`.
  class AppGenerationConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The configuration to be used to generate the evaluations.
  # @!attribute [rw] dataset_id
  #   @return [::String]
  #     Optional. The insights dataset to be used to fetch conversation data for
  #     generating the evaluations.
  #     Format:
  #     `projects/{project}/locations/{location}/datasets/{dataset}`.
  class EvaluationGenerationConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The configuration to be used to generate the evaluation personas.
  class EvaluationPersonasGenerationConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The configuration to be used for quality report generation.
  # @!attribute [rw] evaluation_run
  #   @return [::String]
  #     Required. The evaluation run used to inform quality report analysis.
  class QualityReportGenerationConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The configuration to be used for hill climbing fixes.
  # @!attribute [rw] quality_report
  #   @return [::Google::Cloud::Ces::V1beta::QualityReport]
  #     Required. The quality report used to inform the instruction following
  #     fix.
  class HillClimbingFixConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end
end

#hill_climbing_fix_config ⇒ ::Google::Cloud::Ces::V1beta::GenerateAppResourceRequest::HillClimbingFixConfig

Returns Optional. The configuration to be used for hill climbing fixes.

Returns:

• (::Google::Cloud::Ces::V1beta::GenerateAppResourceRequest::HillClimbingFixConfig) —

  Optional. The configuration to be used for hill climbing fixes.

# File 'proto_docs/google/cloud/ces/v1beta/agent_service.rb', line 1225

class GenerateAppResourceRequest
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # The instructions to be used to refine a part of the resource. The part of
  # the resource can be specified  with a start index, end index and a field
  # mask. For example, if you want to refine a part of the agent instructions
  # you can specify the index of the first character of the instructions, the
  # index of the last character of the instructions and the field mask as
  # "instructions".
  # @!attribute [rw] start_index
  #   @return [::Integer]
  #     Required. The first character (inclusive) of the text to refine.
  # @!attribute [rw] end_index
  #   @return [::Integer]
  #     Required. The last character (inclusive) of the text to refine.
  # @!attribute [rw] field_mask
  #   @return [::Google::Protobuf::FieldMask]
  #     Required. The field of the resource being refined. Only one field is
  #     allowed per RefineInstructions. If refining agent instructions, the field
  #     mask should be "instructions".
  # @!attribute [rw] instructions
  #   @return [::String]
  #     Required. The instructions to refine the resource.
  class RefineInstructions
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The configuration to be used to generate a tool.
  # @!attribute [rw] context
  #   @return [::String]
  #     Optional. The context which describes the tool to be generated. This can
  #     be empty if the tool request & response are provided.
  # @!attribute [rw] file_contexts
  #   @return [::Array<::Google::Cloud::Ces::V1beta::FileContext>]
  #     Optional. The files to be used as context.
  # @!attribute [rw] open_api_toolset_generation_config
  #   @return [::Google::Cloud::Ces::V1beta::GenerateAppResourceRequest::ToolGenerationConfig::OpenApiToolsetGenerationConfig]
  #     Optional. The configuration to be used to generate an Open API schema.
  class ToolGenerationConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # The configuration to be used to generate an Open API schema.
    # @!attribute [rw] uri
    #   @return [::String]
    #     Required. The base uri of the tool.
    # @!attribute [rw] operation_generation_configs
    #   @return [::Array<::Google::Cloud::Ces::V1beta::GenerateAppResourceRequest::ToolGenerationConfig::OpenApiToolsetGenerationConfig::OperationGenerationConfig>]
    #     Required. The list of operations to be added to the Open API schema.
    class OpenApiToolsetGenerationConfig
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # The configuration to be used to generate an operation in the Open API
      # schema.
      # @!attribute [rw] method
      #   @return [::String]
      #     Required. The uri of the tool. This should include query and path
      #     parameters if any.
      # @!attribute [rw] path
      #   @return [::String]
      #     Required. The path of the tool to be appended to the base uri. This
      #     should include query and path parameters if any.
      # @!attribute [rw] request_json
      #   @return [::String]
      #     Required. A sample request to the tool in JSON format. Skip if the
      #     tool does not support request body.
      # @!attribute [rw] response_json
      #   @return [::String]
      #     Required. A sample response from the tool in JSON format.
      class OperationGenerationConfig
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end
    end
  end

  # The configuration to be used to generate the app.
  # @!attribute [rw] context
  #   @return [::String]
  #     Optional. The context which describes the requirements of the agents &
  #     tools to be generated.
  # @!attribute [rw] file_contexts
  #   @return [::Array<::Google::Cloud::Ces::V1beta::FileContext>]
  #     Optional. The files to be used as context.
  # @!attribute [rw] dataset_id
  #   @return [::String]
  #     Optional. The insights dataset to be used to fetch conversation data for
  #     generating the agents & tools.
  #     Format:
  #     `projects/{project}/locations/{location}/datasets/{dataset}`.
  # @!attribute [rw] generate_evaluations
  #   @return [::Boolean]
  #     Optional. Whether to generate the evaluations for the app. If true, the
  #     provided context will be used to generate the evaluations data.
  # @!attribute [rw] gcs_location
  #   @return [::String]
  #     Optional. The Cloud Storage location to store the generated question
  #     answer data to be used by the Datastore tool. This data is generated only
  #     when using conversation data as an input source. The location must be
  #     in the same project as the app.
  #     Format: `gs://...`.
  class AppGenerationConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The configuration to be used to generate the evaluations.
  # @!attribute [rw] dataset_id
  #   @return [::String]
  #     Optional. The insights dataset to be used to fetch conversation data for
  #     generating the evaluations.
  #     Format:
  #     `projects/{project}/locations/{location}/datasets/{dataset}`.
  class EvaluationGenerationConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The configuration to be used to generate the evaluation personas.
  class EvaluationPersonasGenerationConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The configuration to be used for quality report generation.
  # @!attribute [rw] evaluation_run
  #   @return [::String]
  #     Required. The evaluation run used to inform quality report analysis.
  class QualityReportGenerationConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The configuration to be used for hill climbing fixes.
  # @!attribute [rw] quality_report
  #   @return [::Google::Cloud::Ces::V1beta::QualityReport]
  #     Required. The quality report used to inform the instruction following
  #     fix.
  class HillClimbingFixConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end
end

#parent ⇒ ::String

Returns Required. The resource name of the app to generate the resource for.

Returns:

• (::String) —

  Required. The resource name of the app to generate the resource for.

# File 'proto_docs/google/cloud/ces/v1beta/agent_service.rb', line 1225

class GenerateAppResourceRequest
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # The instructions to be used to refine a part of the resource. The part of
  # the resource can be specified  with a start index, end index and a field
  # mask. For example, if you want to refine a part of the agent instructions
  # you can specify the index of the first character of the instructions, the
  # index of the last character of the instructions and the field mask as
  # "instructions".
  # @!attribute [rw] start_index
  #   @return [::Integer]
  #     Required. The first character (inclusive) of the text to refine.
  # @!attribute [rw] end_index
  #   @return [::Integer]
  #     Required. The last character (inclusive) of the text to refine.
  # @!attribute [rw] field_mask
  #   @return [::Google::Protobuf::FieldMask]
  #     Required. The field of the resource being refined. Only one field is
  #     allowed per RefineInstructions. If refining agent instructions, the field
  #     mask should be "instructions".
  # @!attribute [rw] instructions
  #   @return [::String]
  #     Required. The instructions to refine the resource.
  class RefineInstructions
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The configuration to be used to generate a tool.
  # @!attribute [rw] context
  #   @return [::String]
  #     Optional. The context which describes the tool to be generated. This can
  #     be empty if the tool request & response are provided.
  # @!attribute [rw] file_contexts
  #   @return [::Array<::Google::Cloud::Ces::V1beta::FileContext>]
  #     Optional. The files to be used as context.
  # @!attribute [rw] open_api_toolset_generation_config
  #   @return [::Google::Cloud::Ces::V1beta::GenerateAppResourceRequest::ToolGenerationConfig::OpenApiToolsetGenerationConfig]
  #     Optional. The configuration to be used to generate an Open API schema.
  class ToolGenerationConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # The configuration to be used to generate an Open API schema.
    # @!attribute [rw] uri
    #   @return [::String]
    #     Required. The base uri of the tool.
    # @!attribute [rw] operation_generation_configs
    #   @return [::Array<::Google::Cloud::Ces::V1beta::GenerateAppResourceRequest::ToolGenerationConfig::OpenApiToolsetGenerationConfig::OperationGenerationConfig>]
    #     Required. The list of operations to be added to the Open API schema.
    class OpenApiToolsetGenerationConfig
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # The configuration to be used to generate an operation in the Open API
      # schema.
      # @!attribute [rw] method
      #   @return [::String]
      #     Required. The uri of the tool. This should include query and path
      #     parameters if any.
      # @!attribute [rw] path
      #   @return [::String]
      #     Required. The path of the tool to be appended to the base uri. This
      #     should include query and path parameters if any.
      # @!attribute [rw] request_json
      #   @return [::String]
      #     Required. A sample request to the tool in JSON format. Skip if the
      #     tool does not support request body.
      # @!attribute [rw] response_json
      #   @return [::String]
      #     Required. A sample response from the tool in JSON format.
      class OperationGenerationConfig
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end
    end
  end

  # The configuration to be used to generate the app.
  # @!attribute [rw] context
  #   @return [::String]
  #     Optional. The context which describes the requirements of the agents &
  #     tools to be generated.
  # @!attribute [rw] file_contexts
  #   @return [::Array<::Google::Cloud::Ces::V1beta::FileContext>]
  #     Optional. The files to be used as context.
  # @!attribute [rw] dataset_id
  #   @return [::String]
  #     Optional. The insights dataset to be used to fetch conversation data for
  #     generating the agents & tools.
  #     Format:
  #     `projects/{project}/locations/{location}/datasets/{dataset}`.
  # @!attribute [rw] generate_evaluations
  #   @return [::Boolean]
  #     Optional. Whether to generate the evaluations for the app. If true, the
  #     provided context will be used to generate the evaluations data.
  # @!attribute [rw] gcs_location
  #   @return [::String]
  #     Optional. The Cloud Storage location to store the generated question
  #     answer data to be used by the Datastore tool. This data is generated only
  #     when using conversation data as an input source. The location must be
  #     in the same project as the app.
  #     Format: `gs://...`.
  class AppGenerationConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The configuration to be used to generate the evaluations.
  # @!attribute [rw] dataset_id
  #   @return [::String]
  #     Optional. The insights dataset to be used to fetch conversation data for
  #     generating the evaluations.
  #     Format:
  #     `projects/{project}/locations/{location}/datasets/{dataset}`.
  class EvaluationGenerationConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The configuration to be used to generate the evaluation personas.
  class EvaluationPersonasGenerationConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The configuration to be used for quality report generation.
  # @!attribute [rw] evaluation_run
  #   @return [::String]
  #     Required. The evaluation run used to inform quality report analysis.
  class QualityReportGenerationConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The configuration to be used for hill climbing fixes.
  # @!attribute [rw] quality_report
  #   @return [::Google::Cloud::Ces::V1beta::QualityReport]
  #     Required. The quality report used to inform the instruction following
  #     fix.
  class HillClimbingFixConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end
end

#quality_report_generation_config ⇒ ::Google::Cloud::Ces::V1beta::GenerateAppResourceRequest::QualityReportGenerationConfig

Returns Optional. The configuration to be used for quality report generation.

Returns:

• (::Google::Cloud::Ces::V1beta::GenerateAppResourceRequest::QualityReportGenerationConfig) —

  Optional. The configuration to be used for quality report generation.

# File 'proto_docs/google/cloud/ces/v1beta/agent_service.rb', line 1225

class GenerateAppResourceRequest
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # The instructions to be used to refine a part of the resource. The part of
  # the resource can be specified  with a start index, end index and a field
  # mask. For example, if you want to refine a part of the agent instructions
  # you can specify the index of the first character of the instructions, the
  # index of the last character of the instructions and the field mask as
  # "instructions".
  # @!attribute [rw] start_index
  #   @return [::Integer]
  #     Required. The first character (inclusive) of the text to refine.
  # @!attribute [rw] end_index
  #   @return [::Integer]
  #     Required. The last character (inclusive) of the text to refine.
  # @!attribute [rw] field_mask
  #   @return [::Google::Protobuf::FieldMask]
  #     Required. The field of the resource being refined. Only one field is
  #     allowed per RefineInstructions. If refining agent instructions, the field
  #     mask should be "instructions".
  # @!attribute [rw] instructions
  #   @return [::String]
  #     Required. The instructions to refine the resource.
  class RefineInstructions
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The configuration to be used to generate a tool.
  # @!attribute [rw] context
  #   @return [::String]
  #     Optional. The context which describes the tool to be generated. This can
  #     be empty if the tool request & response are provided.
  # @!attribute [rw] file_contexts
  #   @return [::Array<::Google::Cloud::Ces::V1beta::FileContext>]
  #     Optional. The files to be used as context.
  # @!attribute [rw] open_api_toolset_generation_config
  #   @return [::Google::Cloud::Ces::V1beta::GenerateAppResourceRequest::ToolGenerationConfig::OpenApiToolsetGenerationConfig]
  #     Optional. The configuration to be used to generate an Open API schema.
  class ToolGenerationConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # The configuration to be used to generate an Open API schema.
    # @!attribute [rw] uri
    #   @return [::String]
    #     Required. The base uri of the tool.
    # @!attribute [rw] operation_generation_configs
    #   @return [::Array<::Google::Cloud::Ces::V1beta::GenerateAppResourceRequest::ToolGenerationConfig::OpenApiToolsetGenerationConfig::OperationGenerationConfig>]
    #     Required. The list of operations to be added to the Open API schema.
    class OpenApiToolsetGenerationConfig
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # The configuration to be used to generate an operation in the Open API
      # schema.
      # @!attribute [rw] method
      #   @return [::String]
      #     Required. The uri of the tool. This should include query and path
      #     parameters if any.
      # @!attribute [rw] path
      #   @return [::String]
      #     Required. The path of the tool to be appended to the base uri. This
      #     should include query and path parameters if any.
      # @!attribute [rw] request_json
      #   @return [::String]
      #     Required. A sample request to the tool in JSON format. Skip if the
      #     tool does not support request body.
      # @!attribute [rw] response_json
      #   @return [::String]
      #     Required. A sample response from the tool in JSON format.
      class OperationGenerationConfig
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end
    end
  end

  # The configuration to be used to generate the app.
  # @!attribute [rw] context
  #   @return [::String]
  #     Optional. The context which describes the requirements of the agents &
  #     tools to be generated.
  # @!attribute [rw] file_contexts
  #   @return [::Array<::Google::Cloud::Ces::V1beta::FileContext>]
  #     Optional. The files to be used as context.
  # @!attribute [rw] dataset_id
  #   @return [::String]
  #     Optional. The insights dataset to be used to fetch conversation data for
  #     generating the agents & tools.
  #     Format:
  #     `projects/{project}/locations/{location}/datasets/{dataset}`.
  # @!attribute [rw] generate_evaluations
  #   @return [::Boolean]
  #     Optional. Whether to generate the evaluations for the app. If true, the
  #     provided context will be used to generate the evaluations data.
  # @!attribute [rw] gcs_location
  #   @return [::String]
  #     Optional. The Cloud Storage location to store the generated question
  #     answer data to be used by the Datastore tool. This data is generated only
  #     when using conversation data as an input source. The location must be
  #     in the same project as the app.
  #     Format: `gs://...`.
  class AppGenerationConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The configuration to be used to generate the evaluations.
  # @!attribute [rw] dataset_id
  #   @return [::String]
  #     Optional. The insights dataset to be used to fetch conversation data for
  #     generating the evaluations.
  #     Format:
  #     `projects/{project}/locations/{location}/datasets/{dataset}`.
  class EvaluationGenerationConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The configuration to be used to generate the evaluation personas.
  class EvaluationPersonasGenerationConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The configuration to be used for quality report generation.
  # @!attribute [rw] evaluation_run
  #   @return [::String]
  #     Required. The evaluation run used to inform quality report analysis.
  class QualityReportGenerationConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The configuration to be used for hill climbing fixes.
  # @!attribute [rw] quality_report
  #   @return [::Google::Cloud::Ces::V1beta::QualityReport]
  #     Required. The quality report used to inform the instruction following
  #     fix.
  class HillClimbingFixConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end
end

#refine_instructions ⇒ ::Array<::Google::Cloud::Ces::V1beta::GenerateAppResourceRequest::RefineInstructions>

Returns Optional. List of refine instructions to be used to refine the resource.

Returns:

• (::Array<::Google::Cloud::Ces::V1beta::GenerateAppResourceRequest::RefineInstructions>) —

  Optional. List of refine instructions to be used to refine the resource.

# File 'proto_docs/google/cloud/ces/v1beta/agent_service.rb', line 1225

class GenerateAppResourceRequest
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # The instructions to be used to refine a part of the resource. The part of
  # the resource can be specified  with a start index, end index and a field
  # mask. For example, if you want to refine a part of the agent instructions
  # you can specify the index of the first character of the instructions, the
  # index of the last character of the instructions and the field mask as
  # "instructions".
  # @!attribute [rw] start_index
  #   @return [::Integer]
  #     Required. The first character (inclusive) of the text to refine.
  # @!attribute [rw] end_index
  #   @return [::Integer]
  #     Required. The last character (inclusive) of the text to refine.
  # @!attribute [rw] field_mask
  #   @return [::Google::Protobuf::FieldMask]
  #     Required. The field of the resource being refined. Only one field is
  #     allowed per RefineInstructions. If refining agent instructions, the field
  #     mask should be "instructions".
  # @!attribute [rw] instructions
  #   @return [::String]
  #     Required. The instructions to refine the resource.
  class RefineInstructions
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The configuration to be used to generate a tool.
  # @!attribute [rw] context
  #   @return [::String]
  #     Optional. The context which describes the tool to be generated. This can
  #     be empty if the tool request & response are provided.
  # @!attribute [rw] file_contexts
  #   @return [::Array<::Google::Cloud::Ces::V1beta::FileContext>]
  #     Optional. The files to be used as context.
  # @!attribute [rw] open_api_toolset_generation_config
  #   @return [::Google::Cloud::Ces::V1beta::GenerateAppResourceRequest::ToolGenerationConfig::OpenApiToolsetGenerationConfig]
  #     Optional. The configuration to be used to generate an Open API schema.
  class ToolGenerationConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # The configuration to be used to generate an Open API schema.
    # @!attribute [rw] uri
    #   @return [::String]
    #     Required. The base uri of the tool.
    # @!attribute [rw] operation_generation_configs
    #   @return [::Array<::Google::Cloud::Ces::V1beta::GenerateAppResourceRequest::ToolGenerationConfig::OpenApiToolsetGenerationConfig::OperationGenerationConfig>]
    #     Required. The list of operations to be added to the Open API schema.
    class OpenApiToolsetGenerationConfig
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # The configuration to be used to generate an operation in the Open API
      # schema.
      # @!attribute [rw] method
      #   @return [::String]
      #     Required. The uri of the tool. This should include query and path
      #     parameters if any.
      # @!attribute [rw] path
      #   @return [::String]
      #     Required. The path of the tool to be appended to the base uri. This
      #     should include query and path parameters if any.
      # @!attribute [rw] request_json
      #   @return [::String]
      #     Required. A sample request to the tool in JSON format. Skip if the
      #     tool does not support request body.
      # @!attribute [rw] response_json
      #   @return [::String]
      #     Required. A sample response from the tool in JSON format.
      class OperationGenerationConfig
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end
    end
  end

  # The configuration to be used to generate the app.
  # @!attribute [rw] context
  #   @return [::String]
  #     Optional. The context which describes the requirements of the agents &
  #     tools to be generated.
  # @!attribute [rw] file_contexts
  #   @return [::Array<::Google::Cloud::Ces::V1beta::FileContext>]
  #     Optional. The files to be used as context.
  # @!attribute [rw] dataset_id
  #   @return [::String]
  #     Optional. The insights dataset to be used to fetch conversation data for
  #     generating the agents & tools.
  #     Format:
  #     `projects/{project}/locations/{location}/datasets/{dataset}`.
  # @!attribute [rw] generate_evaluations
  #   @return [::Boolean]
  #     Optional. Whether to generate the evaluations for the app. If true, the
  #     provided context will be used to generate the evaluations data.
  # @!attribute [rw] gcs_location
  #   @return [::String]
  #     Optional. The Cloud Storage location to store the generated question
  #     answer data to be used by the Datastore tool. This data is generated only
  #     when using conversation data as an input source. The location must be
  #     in the same project as the app.
  #     Format: `gs://...`.
  class AppGenerationConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The configuration to be used to generate the evaluations.
  # @!attribute [rw] dataset_id
  #   @return [::String]
  #     Optional. The insights dataset to be used to fetch conversation data for
  #     generating the evaluations.
  #     Format:
  #     `projects/{project}/locations/{location}/datasets/{dataset}`.
  class EvaluationGenerationConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The configuration to be used to generate the evaluation personas.
  class EvaluationPersonasGenerationConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The configuration to be used for quality report generation.
  # @!attribute [rw] evaluation_run
  #   @return [::String]
  #     Required. The evaluation run used to inform quality report analysis.
  class QualityReportGenerationConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The configuration to be used for hill climbing fixes.
  # @!attribute [rw] quality_report
  #   @return [::Google::Cloud::Ces::V1beta::QualityReport]
  #     Required. The quality report used to inform the instruction following
  #     fix.
  class HillClimbingFixConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end
end

#tool ⇒ ::Google::Cloud::Ces::V1beta::Tool

Returns The tool resource to be used by the LLM assistant, can be empty for generating a new tool.

Note: The following fields are mutually exclusive: tool, agent, toolset. If a field in that set is populated, all other fields in the set will automatically be cleared.

Returns:

• (::Google::Cloud::Ces::V1beta::Tool) —

  The tool resource to be used by the LLM assistant, can be empty for generating a new tool.

  Note: The following fields are mutually exclusive: tool, agent, toolset. If a field in that set is populated, all other fields in the set will automatically be cleared.

# File 'proto_docs/google/cloud/ces/v1beta/agent_service.rb', line 1225

class GenerateAppResourceRequest
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # The instructions to be used to refine a part of the resource. The part of
  # the resource can be specified  with a start index, end index and a field
  # mask. For example, if you want to refine a part of the agent instructions
  # you can specify the index of the first character of the instructions, the
  # index of the last character of the instructions and the field mask as
  # "instructions".
  # @!attribute [rw] start_index
  #   @return [::Integer]
  #     Required. The first character (inclusive) of the text to refine.
  # @!attribute [rw] end_index
  #   @return [::Integer]
  #     Required. The last character (inclusive) of the text to refine.
  # @!attribute [rw] field_mask
  #   @return [::Google::Protobuf::FieldMask]
  #     Required. The field of the resource being refined. Only one field is
  #     allowed per RefineInstructions. If refining agent instructions, the field
  #     mask should be "instructions".
  # @!attribute [rw] instructions
  #   @return [::String]
  #     Required. The instructions to refine the resource.
  class RefineInstructions
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The configuration to be used to generate a tool.
  # @!attribute [rw] context
  #   @return [::String]
  #     Optional. The context which describes the tool to be generated. This can
  #     be empty if the tool request & response are provided.
  # @!attribute [rw] file_contexts
  #   @return [::Array<::Google::Cloud::Ces::V1beta::FileContext>]
  #     Optional. The files to be used as context.
  # @!attribute [rw] open_api_toolset_generation_config
  #   @return [::Google::Cloud::Ces::V1beta::GenerateAppResourceRequest::ToolGenerationConfig::OpenApiToolsetGenerationConfig]
  #     Optional. The configuration to be used to generate an Open API schema.
  class ToolGenerationConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # The configuration to be used to generate an Open API schema.
    # @!attribute [rw] uri
    #   @return [::String]
    #     Required. The base uri of the tool.
    # @!attribute [rw] operation_generation_configs
    #   @return [::Array<::Google::Cloud::Ces::V1beta::GenerateAppResourceRequest::ToolGenerationConfig::OpenApiToolsetGenerationConfig::OperationGenerationConfig>]
    #     Required. The list of operations to be added to the Open API schema.
    class OpenApiToolsetGenerationConfig
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # The configuration to be used to generate an operation in the Open API
      # schema.
      # @!attribute [rw] method
      #   @return [::String]
      #     Required. The uri of the tool. This should include query and path
      #     parameters if any.
      # @!attribute [rw] path
      #   @return [::String]
      #     Required. The path of the tool to be appended to the base uri. This
      #     should include query and path parameters if any.
      # @!attribute [rw] request_json
      #   @return [::String]
      #     Required. A sample request to the tool in JSON format. Skip if the
      #     tool does not support request body.
      # @!attribute [rw] response_json
      #   @return [::String]
      #     Required. A sample response from the tool in JSON format.
      class OperationGenerationConfig
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end
    end
  end

  # The configuration to be used to generate the app.
  # @!attribute [rw] context
  #   @return [::String]
  #     Optional. The context which describes the requirements of the agents &
  #     tools to be generated.
  # @!attribute [rw] file_contexts
  #   @return [::Array<::Google::Cloud::Ces::V1beta::FileContext>]
  #     Optional. The files to be used as context.
  # @!attribute [rw] dataset_id
  #   @return [::String]
  #     Optional. The insights dataset to be used to fetch conversation data for
  #     generating the agents & tools.
  #     Format:
  #     `projects/{project}/locations/{location}/datasets/{dataset}`.
  # @!attribute [rw] generate_evaluations
  #   @return [::Boolean]
  #     Optional. Whether to generate the evaluations for the app. If true, the
  #     provided context will be used to generate the evaluations data.
  # @!attribute [rw] gcs_location
  #   @return [::String]
  #     Optional. The Cloud Storage location to store the generated question
  #     answer data to be used by the Datastore tool. This data is generated only
  #     when using conversation data as an input source. The location must be
  #     in the same project as the app.
  #     Format: `gs://...`.
  class AppGenerationConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The configuration to be used to generate the evaluations.
  # @!attribute [rw] dataset_id
  #   @return [::String]
  #     Optional. The insights dataset to be used to fetch conversation data for
  #     generating the evaluations.
  #     Format:
  #     `projects/{project}/locations/{location}/datasets/{dataset}`.
  class EvaluationGenerationConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The configuration to be used to generate the evaluation personas.
  class EvaluationPersonasGenerationConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The configuration to be used for quality report generation.
  # @!attribute [rw] evaluation_run
  #   @return [::String]
  #     Required. The evaluation run used to inform quality report analysis.
  class QualityReportGenerationConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The configuration to be used for hill climbing fixes.
  # @!attribute [rw] quality_report
  #   @return [::Google::Cloud::Ces::V1beta::QualityReport]
  #     Required. The quality report used to inform the instruction following
  #     fix.
  class HillClimbingFixConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end
end

#tool_generation_config ⇒ ::Google::Cloud::Ces::V1beta::GenerateAppResourceRequest::ToolGenerationConfig

Returns Optional. The configuration to be used to generate the tool.

Returns:

• (::Google::Cloud::Ces::V1beta::GenerateAppResourceRequest::ToolGenerationConfig) —

  Optional. The configuration to be used to generate the tool.

# File 'proto_docs/google/cloud/ces/v1beta/agent_service.rb', line 1225

class GenerateAppResourceRequest
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # The instructions to be used to refine a part of the resource. The part of
  # the resource can be specified  with a start index, end index and a field
  # mask. For example, if you want to refine a part of the agent instructions
  # you can specify the index of the first character of the instructions, the
  # index of the last character of the instructions and the field mask as
  # "instructions".
  # @!attribute [rw] start_index
  #   @return [::Integer]
  #     Required. The first character (inclusive) of the text to refine.
  # @!attribute [rw] end_index
  #   @return [::Integer]
  #     Required. The last character (inclusive) of the text to refine.
  # @!attribute [rw] field_mask
  #   @return [::Google::Protobuf::FieldMask]
  #     Required. The field of the resource being refined. Only one field is
  #     allowed per RefineInstructions. If refining agent instructions, the field
  #     mask should be "instructions".
  # @!attribute [rw] instructions
  #   @return [::String]
  #     Required. The instructions to refine the resource.
  class RefineInstructions
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The configuration to be used to generate a tool.
  # @!attribute [rw] context
  #   @return [::String]
  #     Optional. The context which describes the tool to be generated. This can
  #     be empty if the tool request & response are provided.
  # @!attribute [rw] file_contexts
  #   @return [::Array<::Google::Cloud::Ces::V1beta::FileContext>]
  #     Optional. The files to be used as context.
  # @!attribute [rw] open_api_toolset_generation_config
  #   @return [::Google::Cloud::Ces::V1beta::GenerateAppResourceRequest::ToolGenerationConfig::OpenApiToolsetGenerationConfig]
  #     Optional. The configuration to be used to generate an Open API schema.
  class ToolGenerationConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # The configuration to be used to generate an Open API schema.
    # @!attribute [rw] uri
    #   @return [::String]
    #     Required. The base uri of the tool.
    # @!attribute [rw] operation_generation_configs
    #   @return [::Array<::Google::Cloud::Ces::V1beta::GenerateAppResourceRequest::ToolGenerationConfig::OpenApiToolsetGenerationConfig::OperationGenerationConfig>]
    #     Required. The list of operations to be added to the Open API schema.
    class OpenApiToolsetGenerationConfig
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # The configuration to be used to generate an operation in the Open API
      # schema.
      # @!attribute [rw] method
      #   @return [::String]
      #     Required. The uri of the tool. This should include query and path
      #     parameters if any.
      # @!attribute [rw] path
      #   @return [::String]
      #     Required. The path of the tool to be appended to the base uri. This
      #     should include query and path parameters if any.
      # @!attribute [rw] request_json
      #   @return [::String]
      #     Required. A sample request to the tool in JSON format. Skip if the
      #     tool does not support request body.
      # @!attribute [rw] response_json
      #   @return [::String]
      #     Required. A sample response from the tool in JSON format.
      class OperationGenerationConfig
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end
    end
  end

  # The configuration to be used to generate the app.
  # @!attribute [rw] context
  #   @return [::String]
  #     Optional. The context which describes the requirements of the agents &
  #     tools to be generated.
  # @!attribute [rw] file_contexts
  #   @return [::Array<::Google::Cloud::Ces::V1beta::FileContext>]
  #     Optional. The files to be used as context.
  # @!attribute [rw] dataset_id
  #   @return [::String]
  #     Optional. The insights dataset to be used to fetch conversation data for
  #     generating the agents & tools.
  #     Format:
  #     `projects/{project}/locations/{location}/datasets/{dataset}`.
  # @!attribute [rw] generate_evaluations
  #   @return [::Boolean]
  #     Optional. Whether to generate the evaluations for the app. If true, the
  #     provided context will be used to generate the evaluations data.
  # @!attribute [rw] gcs_location
  #   @return [::String]
  #     Optional. The Cloud Storage location to store the generated question
  #     answer data to be used by the Datastore tool. This data is generated only
  #     when using conversation data as an input source. The location must be
  #     in the same project as the app.
  #     Format: `gs://...`.
  class AppGenerationConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The configuration to be used to generate the evaluations.
  # @!attribute [rw] dataset_id
  #   @return [::String]
  #     Optional. The insights dataset to be used to fetch conversation data for
  #     generating the evaluations.
  #     Format:
  #     `projects/{project}/locations/{location}/datasets/{dataset}`.
  class EvaluationGenerationConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The configuration to be used to generate the evaluation personas.
  class EvaluationPersonasGenerationConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The configuration to be used for quality report generation.
  # @!attribute [rw] evaluation_run
  #   @return [::String]
  #     Required. The evaluation run used to inform quality report analysis.
  class QualityReportGenerationConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The configuration to be used for hill climbing fixes.
  # @!attribute [rw] quality_report
  #   @return [::Google::Cloud::Ces::V1beta::QualityReport]
  #     Required. The quality report used to inform the instruction following
  #     fix.
  class HillClimbingFixConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end
end

#toolset ⇒ ::Google::Cloud::Ces::V1beta::Toolset

Returns The toolset resource to be used by the LLM assistant, can be empty for generating a new toolset.

Note: The following fields are mutually exclusive: toolset, agent, tool. If a field in that set is populated, all other fields in the set will automatically be cleared.

Returns:

• (::Google::Cloud::Ces::V1beta::Toolset) —

  The toolset resource to be used by the LLM assistant, can be empty for generating a new toolset.

  Note: The following fields are mutually exclusive: toolset, agent, tool. If a field in that set is populated, all other fields in the set will automatically be cleared.

# File 'proto_docs/google/cloud/ces/v1beta/agent_service.rb', line 1225

class GenerateAppResourceRequest
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # The instructions to be used to refine a part of the resource. The part of
  # the resource can be specified  with a start index, end index and a field
  # mask. For example, if you want to refine a part of the agent instructions
  # you can specify the index of the first character of the instructions, the
  # index of the last character of the instructions and the field mask as
  # "instructions".
  # @!attribute [rw] start_index
  #   @return [::Integer]
  #     Required. The first character (inclusive) of the text to refine.
  # @!attribute [rw] end_index
  #   @return [::Integer]
  #     Required. The last character (inclusive) of the text to refine.
  # @!attribute [rw] field_mask
  #   @return [::Google::Protobuf::FieldMask]
  #     Required. The field of the resource being refined. Only one field is
  #     allowed per RefineInstructions. If refining agent instructions, the field
  #     mask should be "instructions".
  # @!attribute [rw] instructions
  #   @return [::String]
  #     Required. The instructions to refine the resource.
  class RefineInstructions
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The configuration to be used to generate a tool.
  # @!attribute [rw] context
  #   @return [::String]
  #     Optional. The context which describes the tool to be generated. This can
  #     be empty if the tool request & response are provided.
  # @!attribute [rw] file_contexts
  #   @return [::Array<::Google::Cloud::Ces::V1beta::FileContext>]
  #     Optional. The files to be used as context.
  # @!attribute [rw] open_api_toolset_generation_config
  #   @return [::Google::Cloud::Ces::V1beta::GenerateAppResourceRequest::ToolGenerationConfig::OpenApiToolsetGenerationConfig]
  #     Optional. The configuration to be used to generate an Open API schema.
  class ToolGenerationConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # The configuration to be used to generate an Open API schema.
    # @!attribute [rw] uri
    #   @return [::String]
    #     Required. The base uri of the tool.
    # @!attribute [rw] operation_generation_configs
    #   @return [::Array<::Google::Cloud::Ces::V1beta::GenerateAppResourceRequest::ToolGenerationConfig::OpenApiToolsetGenerationConfig::OperationGenerationConfig>]
    #     Required. The list of operations to be added to the Open API schema.
    class OpenApiToolsetGenerationConfig
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # The configuration to be used to generate an operation in the Open API
      # schema.
      # @!attribute [rw] method
      #   @return [::String]
      #     Required. The uri of the tool. This should include query and path
      #     parameters if any.
      # @!attribute [rw] path
      #   @return [::String]
      #     Required. The path of the tool to be appended to the base uri. This
      #     should include query and path parameters if any.
      # @!attribute [rw] request_json
      #   @return [::String]
      #     Required. A sample request to the tool in JSON format. Skip if the
      #     tool does not support request body.
      # @!attribute [rw] response_json
      #   @return [::String]
      #     Required. A sample response from the tool in JSON format.
      class OperationGenerationConfig
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end
    end
  end

  # The configuration to be used to generate the app.
  # @!attribute [rw] context
  #   @return [::String]
  #     Optional. The context which describes the requirements of the agents &
  #     tools to be generated.
  # @!attribute [rw] file_contexts
  #   @return [::Array<::Google::Cloud::Ces::V1beta::FileContext>]
  #     Optional. The files to be used as context.
  # @!attribute [rw] dataset_id
  #   @return [::String]
  #     Optional. The insights dataset to be used to fetch conversation data for
  #     generating the agents & tools.
  #     Format:
  #     `projects/{project}/locations/{location}/datasets/{dataset}`.
  # @!attribute [rw] generate_evaluations
  #   @return [::Boolean]
  #     Optional. Whether to generate the evaluations for the app. If true, the
  #     provided context will be used to generate the evaluations data.
  # @!attribute [rw] gcs_location
  #   @return [::String]
  #     Optional. The Cloud Storage location to store the generated question
  #     answer data to be used by the Datastore tool. This data is generated only
  #     when using conversation data as an input source. The location must be
  #     in the same project as the app.
  #     Format: `gs://...`.
  class AppGenerationConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The configuration to be used to generate the evaluations.
  # @!attribute [rw] dataset_id
  #   @return [::String]
  #     Optional. The insights dataset to be used to fetch conversation data for
  #     generating the evaluations.
  #     Format:
  #     `projects/{project}/locations/{location}/datasets/{dataset}`.
  class EvaluationGenerationConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The configuration to be used to generate the evaluation personas.
  class EvaluationPersonasGenerationConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The configuration to be used for quality report generation.
  # @!attribute [rw] evaluation_run
  #   @return [::String]
  #     Required. The evaluation run used to inform quality report analysis.
  class QualityReportGenerationConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # The configuration to be used for hill climbing fixes.
  # @!attribute [rw] quality_report
  #   @return [::Google::Cloud::Ces::V1beta::QualityReport]
  #     Required. The quality report used to inform the instruction following
  #     fix.
  class HillClimbingFixConfig
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end
end