Package com.google.cloud.dialogflow.v2

Class HumanAgentAssistantConfig.SuggestionConfig.Builder

java.lang.Object
com.google.protobuf.AbstractMessageLite.Builder
com.google.protobuf.AbstractMessage.Builder<BuilderT>
com.google.protobuf.GeneratedMessage.Builder<HumanAgentAssistantConfig.SuggestionConfig.Builder>
com.google.cloud.dialogflow.v2.HumanAgentAssistantConfig.SuggestionConfig.Builder
All Implemented Interfaces:
HumanAgentAssistantConfig.SuggestionConfigOrBuilder, com.google.protobuf.Message.Builder, com.google.protobuf.MessageLite.Builder, com.google.protobuf.MessageLiteOrBuilder, com.google.protobuf.MessageOrBuilder, Cloneable
Enclosing class:
HumanAgentAssistantConfig.SuggestionConfig
public static final class HumanAgentAssistantConfig.SuggestionConfig.Builder extends com.google.protobuf.GeneratedMessage.Builder<HumanAgentAssistantConfig.SuggestionConfig.Builder> implements HumanAgentAssistantConfig.SuggestionConfigOrBuilder
 Detail human agent assistant config.
Protobuf type google.cloud.dialogflow.v2.HumanAgentAssistantConfig.SuggestionConfig

  • Method Details

    • getDescriptor

      public static final com.google.protobuf.Descriptors.Descriptor getDescriptor()

    • internalGetFieldAccessorTable

      protected com.google.protobuf.GeneratedMessage.FieldAccessorTable internalGetFieldAccessorTable()
      Specified by:
      internalGetFieldAccessorTable in class com.google.protobuf.GeneratedMessage.Builder<HumanAgentAssistantConfig.SuggestionConfig.Builder>

    • clear

      public HumanAgentAssistantConfig.SuggestionConfig.Builder clear()
      Specified by:
      clear in interface com.google.protobuf.Message.Builder
      Specified by:
      clear in interface com.google.protobuf.MessageLite.Builder
      Overrides:
      clear in class com.google.protobuf.GeneratedMessage.Builder<HumanAgentAssistantConfig.SuggestionConfig.Builder>

    • getDescriptorForType

      public com.google.protobuf.Descriptors.Descriptor getDescriptorForType()
      Specified by:
      getDescriptorForType in interface com.google.protobuf.Message.Builder
      Specified by:
      getDescriptorForType in interface com.google.protobuf.MessageOrBuilder
      Overrides:
      getDescriptorForType in class com.google.protobuf.GeneratedMessage.Builder<HumanAgentAssistantConfig.SuggestionConfig.Builder>

    • getDefaultInstanceForType

      public HumanAgentAssistantConfig.SuggestionConfig getDefaultInstanceForType()
      Specified by:
      getDefaultInstanceForType in interface com.google.protobuf.MessageLiteOrBuilder
      Specified by:
      getDefaultInstanceForType in interface com.google.protobuf.MessageOrBuilder

    • build

      public HumanAgentAssistantConfig.SuggestionConfig build()
      Specified by:
      build in interface com.google.protobuf.Message.Builder
      Specified by:
      build in interface com.google.protobuf.MessageLite.Builder

    • buildPartial

      public HumanAgentAssistantConfig.SuggestionConfig buildPartial()
      Specified by:
      buildPartial in interface com.google.protobuf.Message.Builder
      Specified by:
      buildPartial in interface com.google.protobuf.MessageLite.Builder

    • mergeFrom

      public HumanAgentAssistantConfig.SuggestionConfig.Builder mergeFrom(com.google.protobuf.Message other)
      Specified by:
      mergeFrom in interface com.google.protobuf.Message.Builder
      Overrides:
      mergeFrom in class com.google.protobuf.AbstractMessage.Builder<HumanAgentAssistantConfig.SuggestionConfig.Builder>

    • mergeFrom

      public HumanAgentAssistantConfig.SuggestionConfig.Builder mergeFrom(HumanAgentAssistantConfig.SuggestionConfig other)

    • isInitialized

      public final boolean isInitialized()
      Specified by:
      isInitialized in interface com.google.protobuf.MessageLiteOrBuilder
      Overrides:
      isInitialized in class com.google.protobuf.GeneratedMessage.Builder<HumanAgentAssistantConfig.SuggestionConfig.Builder>

    • mergeFrom

      public HumanAgentAssistantConfig.SuggestionConfig.Builder mergeFrom(com.google.protobuf.CodedInputStream input, com.google.protobuf.ExtensionRegistryLite extensionRegistry) throws IOException
      Specified by:
      mergeFrom in interface com.google.protobuf.Message.Builder
      Specified by:
      mergeFrom in interface com.google.protobuf.MessageLite.Builder
      Overrides:
      mergeFrom in class com.google.protobuf.AbstractMessage.Builder<HumanAgentAssistantConfig.SuggestionConfig.Builder>
      Throws:
      IOException

    • getFeatureConfigsList

      public List<HumanAgentAssistantConfig.SuggestionFeatureConfig> getFeatureConfigsList()
       Configuration of different suggestion features. One feature can have only
 one config.
      repeated .google.cloud.dialogflow.v2.HumanAgentAssistantConfig.SuggestionFeatureConfig feature_configs = 2;
      Specified by:
      getFeatureConfigsList in interface HumanAgentAssistantConfig.SuggestionConfigOrBuilder

    • getFeatureConfigsCount

      public int getFeatureConfigsCount()
       Configuration of different suggestion features. One feature can have only
 one config.
      repeated .google.cloud.dialogflow.v2.HumanAgentAssistantConfig.SuggestionFeatureConfig feature_configs = 2;
      Specified by:
      getFeatureConfigsCount in interface HumanAgentAssistantConfig.SuggestionConfigOrBuilder

    • getFeatureConfigs

      public HumanAgentAssistantConfig.SuggestionFeatureConfig getFeatureConfigs(int index)
       Configuration of different suggestion features. One feature can have only
 one config.
      repeated .google.cloud.dialogflow.v2.HumanAgentAssistantConfig.SuggestionFeatureConfig feature_configs = 2;
      Specified by:
      getFeatureConfigs in interface HumanAgentAssistantConfig.SuggestionConfigOrBuilder

    • setFeatureConfigs

      public HumanAgentAssistantConfig.SuggestionConfig.Builder setFeatureConfigs(int index, HumanAgentAssistantConfig.SuggestionFeatureConfig value)
       Configuration of different suggestion features. One feature can have only
 one config.
      repeated .google.cloud.dialogflow.v2.HumanAgentAssistantConfig.SuggestionFeatureConfig feature_configs = 2;

    • setFeatureConfigs

      public HumanAgentAssistantConfig.SuggestionConfig.Builder setFeatureConfigs(int index, HumanAgentAssistantConfig.SuggestionFeatureConfig.Builder builderForValue)
       Configuration of different suggestion features. One feature can have only
 one config.
      repeated .google.cloud.dialogflow.v2.HumanAgentAssistantConfig.SuggestionFeatureConfig feature_configs = 2;

    • addFeatureConfigs

      public HumanAgentAssistantConfig.SuggestionConfig.Builder addFeatureConfigs(HumanAgentAssistantConfig.SuggestionFeatureConfig value)
       Configuration of different suggestion features. One feature can have only
 one config.
      repeated .google.cloud.dialogflow.v2.HumanAgentAssistantConfig.SuggestionFeatureConfig feature_configs = 2;

    • addFeatureConfigs

      public HumanAgentAssistantConfig.SuggestionConfig.Builder addFeatureConfigs(int index, HumanAgentAssistantConfig.SuggestionFeatureConfig value)
       Configuration of different suggestion features. One feature can have only
 one config.
      repeated .google.cloud.dialogflow.v2.HumanAgentAssistantConfig.SuggestionFeatureConfig feature_configs = 2;

    • addFeatureConfigs

      public HumanAgentAssistantConfig.SuggestionConfig.Builder addFeatureConfigs(HumanAgentAssistantConfig.SuggestionFeatureConfig.Builder builderForValue)
       Configuration of different suggestion features. One feature can have only
 one config.
      repeated .google.cloud.dialogflow.v2.HumanAgentAssistantConfig.SuggestionFeatureConfig feature_configs = 2;

    • addFeatureConfigs

      public HumanAgentAssistantConfig.SuggestionConfig.Builder addFeatureConfigs(int index, HumanAgentAssistantConfig.SuggestionFeatureConfig.Builder builderForValue)
       Configuration of different suggestion features. One feature can have only
 one config.
      repeated .google.cloud.dialogflow.v2.HumanAgentAssistantConfig.SuggestionFeatureConfig feature_configs = 2;

    • addAllFeatureConfigs

      public HumanAgentAssistantConfig.SuggestionConfig.Builder addAllFeatureConfigs(Iterable<? extends HumanAgentAssistantConfig.SuggestionFeatureConfig> values)
       Configuration of different suggestion features. One feature can have only
 one config.
      repeated .google.cloud.dialogflow.v2.HumanAgentAssistantConfig.SuggestionFeatureConfig feature_configs = 2;

    • clearFeatureConfigs

      public HumanAgentAssistantConfig.SuggestionConfig.Builder clearFeatureConfigs()
       Configuration of different suggestion features. One feature can have only
 one config.
      repeated .google.cloud.dialogflow.v2.HumanAgentAssistantConfig.SuggestionFeatureConfig feature_configs = 2;

    • removeFeatureConfigs

      public HumanAgentAssistantConfig.SuggestionConfig.Builder removeFeatureConfigs(int index)
       Configuration of different suggestion features. One feature can have only
 one config.
      repeated .google.cloud.dialogflow.v2.HumanAgentAssistantConfig.SuggestionFeatureConfig feature_configs = 2;

    • getFeatureConfigsBuilder

      public HumanAgentAssistantConfig.SuggestionFeatureConfig.Builder getFeatureConfigsBuilder(int index)
       Configuration of different suggestion features. One feature can have only
 one config.
      repeated .google.cloud.dialogflow.v2.HumanAgentAssistantConfig.SuggestionFeatureConfig feature_configs = 2;

    • getFeatureConfigsOrBuilder

      public HumanAgentAssistantConfig.SuggestionFeatureConfigOrBuilder getFeatureConfigsOrBuilder(int index)
       Configuration of different suggestion features. One feature can have only
 one config.
      repeated .google.cloud.dialogflow.v2.HumanAgentAssistantConfig.SuggestionFeatureConfig feature_configs = 2;
      Specified by:
      getFeatureConfigsOrBuilder in interface HumanAgentAssistantConfig.SuggestionConfigOrBuilder

    • getFeatureConfigsOrBuilderList

      public List<? extends HumanAgentAssistantConfig.SuggestionFeatureConfigOrBuilder> getFeatureConfigsOrBuilderList()
       Configuration of different suggestion features. One feature can have only
 one config.
      repeated .google.cloud.dialogflow.v2.HumanAgentAssistantConfig.SuggestionFeatureConfig feature_configs = 2;
      Specified by:
      getFeatureConfigsOrBuilderList in interface HumanAgentAssistantConfig.SuggestionConfigOrBuilder

    • addFeatureConfigsBuilder

      public HumanAgentAssistantConfig.SuggestionFeatureConfig.Builder addFeatureConfigsBuilder()
       Configuration of different suggestion features. One feature can have only
 one config.
      repeated .google.cloud.dialogflow.v2.HumanAgentAssistantConfig.SuggestionFeatureConfig feature_configs = 2;

    • addFeatureConfigsBuilder

      public HumanAgentAssistantConfig.SuggestionFeatureConfig.Builder addFeatureConfigsBuilder(int index)
       Configuration of different suggestion features. One feature can have only
 one config.
      repeated .google.cloud.dialogflow.v2.HumanAgentAssistantConfig.SuggestionFeatureConfig feature_configs = 2;

    • getFeatureConfigsBuilderList

      public List<HumanAgentAssistantConfig.SuggestionFeatureConfig.Builder> getFeatureConfigsBuilderList()
       Configuration of different suggestion features. One feature can have only
 one config.
      repeated .google.cloud.dialogflow.v2.HumanAgentAssistantConfig.SuggestionFeatureConfig feature_configs = 2;

    • getGroupSuggestionResponses

      public boolean getGroupSuggestionResponses()
       If `group_suggestion_responses` is false, and there are multiple
 `feature_configs` in `event based suggestion` or
 StreamingAnalyzeContent, we will try to deliver suggestions to customers
 as soon as we get new suggestion. Different type of suggestions based on
 the same context will be in  separate Pub/Sub event or
 `StreamingAnalyzeContentResponse`.

 If `group_suggestion_responses` set to true. All the suggestions to the
 same participant based on the same context will be grouped into a single
 Pub/Sub event or StreamingAnalyzeContentResponse.
      bool group_suggestion_responses = 3;
      Specified by:
      getGroupSuggestionResponses in interface HumanAgentAssistantConfig.SuggestionConfigOrBuilder
      Returns:
      The groupSuggestionResponses.

    • setGroupSuggestionResponses

      public HumanAgentAssistantConfig.SuggestionConfig.Builder setGroupSuggestionResponses(boolean value)
       If `group_suggestion_responses` is false, and there are multiple
 `feature_configs` in `event based suggestion` or
 StreamingAnalyzeContent, we will try to deliver suggestions to customers
 as soon as we get new suggestion. Different type of suggestions based on
 the same context will be in  separate Pub/Sub event or
 `StreamingAnalyzeContentResponse`.

 If `group_suggestion_responses` set to true. All the suggestions to the
 same participant based on the same context will be grouped into a single
 Pub/Sub event or StreamingAnalyzeContentResponse.
      bool group_suggestion_responses = 3;
      Parameters:
      value - The groupSuggestionResponses to set.
      Returns:
      This builder for chaining.

    • clearGroupSuggestionResponses

      public HumanAgentAssistantConfig.SuggestionConfig.Builder clearGroupSuggestionResponses()
       If `group_suggestion_responses` is false, and there are multiple
 `feature_configs` in `event based suggestion` or
 StreamingAnalyzeContent, we will try to deliver suggestions to customers
 as soon as we get new suggestion. Different type of suggestions based on
 the same context will be in  separate Pub/Sub event or
 `StreamingAnalyzeContentResponse`.

 If `group_suggestion_responses` set to true. All the suggestions to the
 same participant based on the same context will be grouped into a single
 Pub/Sub event or StreamingAnalyzeContentResponse.
      bool group_suggestion_responses = 3;
      Returns:
      This builder for chaining.

    • getGeneratorsList

      public com.google.protobuf.ProtocolStringList getGeneratorsList()
       Optional. List of various generator resource names used in the
 conversation profile.
      repeated string generators = 4 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { ... }
      Specified by:
      getGeneratorsList in interface HumanAgentAssistantConfig.SuggestionConfigOrBuilder
      Returns:
      A list containing the generators.

    • getGeneratorsCount

      public int getGeneratorsCount()
       Optional. List of various generator resource names used in the
 conversation profile.
      repeated string generators = 4 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { ... }
      Specified by:
      getGeneratorsCount in interface HumanAgentAssistantConfig.SuggestionConfigOrBuilder
      Returns:
      The count of generators.

    • getGenerators

      public String getGenerators(int index)
       Optional. List of various generator resource names used in the
 conversation profile.
      repeated string generators = 4 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { ... }
      Specified by:
      getGenerators in interface HumanAgentAssistantConfig.SuggestionConfigOrBuilder
      Parameters:
      index - The index of the element to return.
      Returns:
      The generators at the given index.

    • getGeneratorsBytes

      public com.google.protobuf.ByteString getGeneratorsBytes(int index)
       Optional. List of various generator resource names used in the
 conversation profile.
      repeated string generators = 4 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { ... }
      Specified by:
      getGeneratorsBytes in interface HumanAgentAssistantConfig.SuggestionConfigOrBuilder
      Parameters:
      index - The index of the value to return.
      Returns:
      The bytes of the generators at the given index.

    • setGenerators

      public HumanAgentAssistantConfig.SuggestionConfig.Builder setGenerators(int index, String value)
       Optional. List of various generator resource names used in the
 conversation profile.
      repeated string generators = 4 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { ... }
      Parameters:
      index - The index to set the value at.
      value - The generators to set.
      Returns:
      This builder for chaining.

    • addGenerators

      public HumanAgentAssistantConfig.SuggestionConfig.Builder addGenerators(String value)
       Optional. List of various generator resource names used in the
 conversation profile.
      repeated string generators = 4 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { ... }
      Parameters:
      value - The generators to add.
      Returns:
      This builder for chaining.

    • addAllGenerators

      public HumanAgentAssistantConfig.SuggestionConfig.Builder addAllGenerators(Iterable<String> values)
       Optional. List of various generator resource names used in the
 conversation profile.
      repeated string generators = 4 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { ... }
      Parameters:
      values - The generators to add.
      Returns:
      This builder for chaining.

    • clearGenerators

      public HumanAgentAssistantConfig.SuggestionConfig.Builder clearGenerators()
       Optional. List of various generator resource names used in the
 conversation profile.
      repeated string generators = 4 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { ... }
      Returns:
      This builder for chaining.

    • addGeneratorsBytes

      public HumanAgentAssistantConfig.SuggestionConfig.Builder addGeneratorsBytes(com.google.protobuf.ByteString value)
       Optional. List of various generator resource names used in the
 conversation profile.
      repeated string generators = 4 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { ... }
      Parameters:
      value - The bytes of the generators to add.
      Returns:
      This builder for chaining.

    • getDisableHighLatencyFeaturesSyncDelivery

      public boolean getDisableHighLatencyFeaturesSyncDelivery()
       Optional. When disable_high_latency_features_sync_delivery is true and
 using the AnalyzeContent API, we will not deliver the responses from high
 latency features in the API response. The
 human_agent_assistant_config.notification_config must be configured and
 enable_event_based_suggestion must be set to true to receive the
 responses from high latency features in Pub/Sub. High latency feature(s):
 KNOWLEDGE_ASSIST
      bool disable_high_latency_features_sync_delivery = 5 [(.google.api.field_behavior) = OPTIONAL];
      Specified by:
      getDisableHighLatencyFeaturesSyncDelivery in interface HumanAgentAssistantConfig.SuggestionConfigOrBuilder
      Returns:
      The disableHighLatencyFeaturesSyncDelivery.

    • setDisableHighLatencyFeaturesSyncDelivery

      public HumanAgentAssistantConfig.SuggestionConfig.Builder setDisableHighLatencyFeaturesSyncDelivery(boolean value)
       Optional. When disable_high_latency_features_sync_delivery is true and
 using the AnalyzeContent API, we will not deliver the responses from high
 latency features in the API response. The
 human_agent_assistant_config.notification_config must be configured and
 enable_event_based_suggestion must be set to true to receive the
 responses from high latency features in Pub/Sub. High latency feature(s):
 KNOWLEDGE_ASSIST
      bool disable_high_latency_features_sync_delivery = 5 [(.google.api.field_behavior) = OPTIONAL];
      Parameters:
      value - The disableHighLatencyFeaturesSyncDelivery to set.
      Returns:
      This builder for chaining.

    • clearDisableHighLatencyFeaturesSyncDelivery

      public HumanAgentAssistantConfig.SuggestionConfig.Builder clearDisableHighLatencyFeaturesSyncDelivery()
       Optional. When disable_high_latency_features_sync_delivery is true and
 using the AnalyzeContent API, we will not deliver the responses from high
 latency features in the API response. The
 human_agent_assistant_config.notification_config must be configured and
 enable_event_based_suggestion must be set to true to receive the
 responses from high latency features in Pub/Sub. High latency feature(s):
 KNOWLEDGE_ASSIST
      bool disable_high_latency_features_sync_delivery = 5 [(.google.api.field_behavior) = OPTIONAL];
      Returns:
      This builder for chaining.

    • getSkipEmptyEventBasedSuggestion

      public boolean getSkipEmptyEventBasedSuggestion()
       Optional. Enable skipping event based suggestion if the suggestion is
 empty.

 For example, with this field disabled, Knowledge Assist feature sends
 a Pub/Sub message when there are no suggestions. Enabling this field
 will change the behavior to skip the Pub/Sub message in this situation.
      bool skip_empty_event_based_suggestion = 6 [(.google.api.field_behavior) = OPTIONAL];
      Specified by:
      getSkipEmptyEventBasedSuggestion in interface HumanAgentAssistantConfig.SuggestionConfigOrBuilder
      Returns:
      The skipEmptyEventBasedSuggestion.

    • setSkipEmptyEventBasedSuggestion

      public HumanAgentAssistantConfig.SuggestionConfig.Builder setSkipEmptyEventBasedSuggestion(boolean value)
       Optional. Enable skipping event based suggestion if the suggestion is
 empty.

 For example, with this field disabled, Knowledge Assist feature sends
 a Pub/Sub message when there are no suggestions. Enabling this field
 will change the behavior to skip the Pub/Sub message in this situation.
      bool skip_empty_event_based_suggestion = 6 [(.google.api.field_behavior) = OPTIONAL];
      Parameters:
      value - The skipEmptyEventBasedSuggestion to set.
      Returns:
      This builder for chaining.

    • clearSkipEmptyEventBasedSuggestion

      public HumanAgentAssistantConfig.SuggestionConfig.Builder clearSkipEmptyEventBasedSuggestion()
       Optional. Enable skipping event based suggestion if the suggestion is
 empty.

 For example, with this field disabled, Knowledge Assist feature sends
 a Pub/Sub message when there are no suggestions. Enabling this field
 will change the behavior to skip the Pub/Sub message in this situation.
      bool skip_empty_event_based_suggestion = 6 [(.google.api.field_behavior) = OPTIONAL];
      Returns:
      This builder for chaining.

    • getUseUnredactedConversationData

      public boolean getUseUnredactedConversationData()
       Optional. If true,
 use unredacted transcript data (Supported features: AI_COACH) and
 use unredacted ingested context (Supported features: All Agent Assist
 features)
      bool use_unredacted_conversation_data = 8 [(.google.api.field_behavior) = OPTIONAL];
      Specified by:
      getUseUnredactedConversationData in interface HumanAgentAssistantConfig.SuggestionConfigOrBuilder
      Returns:
      The useUnredactedConversationData.

    • setUseUnredactedConversationData

      public HumanAgentAssistantConfig.SuggestionConfig.Builder setUseUnredactedConversationData(boolean value)
       Optional. If true,
 use unredacted transcript data (Supported features: AI_COACH) and
 use unredacted ingested context (Supported features: All Agent Assist
 features)
      bool use_unredacted_conversation_data = 8 [(.google.api.field_behavior) = OPTIONAL];
      Parameters:
      value - The useUnredactedConversationData to set.
      Returns:
      This builder for chaining.

    • clearUseUnredactedConversationData

      public HumanAgentAssistantConfig.SuggestionConfig.Builder clearUseUnredactedConversationData()
       Optional. If true,
 use unredacted transcript data (Supported features: AI_COACH) and
 use unredacted ingested context (Supported features: All Agent Assist
 features)
      bool use_unredacted_conversation_data = 8 [(.google.api.field_behavior) = OPTIONAL];
      Returns:
      This builder for chaining.

    • getEnableAsyncToolCall

      public boolean getEnableAsyncToolCall()
       Optional. If true, enable asynchronous execution of tools.
      bool enable_async_tool_call = 9 [(.google.api.field_behavior) = OPTIONAL];
      Specified by:
      getEnableAsyncToolCall in interface HumanAgentAssistantConfig.SuggestionConfigOrBuilder
      Returns:
      The enableAsyncToolCall.

    • setEnableAsyncToolCall

      public HumanAgentAssistantConfig.SuggestionConfig.Builder setEnableAsyncToolCall(boolean value)
       Optional. If true, enable asynchronous execution of tools.
      bool enable_async_tool_call = 9 [(.google.api.field_behavior) = OPTIONAL];
      Parameters:
      value - The enableAsyncToolCall to set.
      Returns:
      This builder for chaining.

    • clearEnableAsyncToolCall

      public HumanAgentAssistantConfig.SuggestionConfig.Builder clearEnableAsyncToolCall()
       Optional. If true, enable asynchronous execution of tools.
      bool enable_async_tool_call = 9 [(.google.api.field_behavior) = OPTIONAL];
      Returns:
      This builder for chaining.