Class: Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3Flow

Inherits:
Object
  • Object
show all
Includes:
Core::Hashable, Core::JsonObjectSupport
Defined in:
lib/google/apis/dialogflow_v3/classes.rb,
lib/google/apis/dialogflow_v3/representations.rb,
lib/google/apis/dialogflow_v3/representations.rb

Overview

Flows represents the conversation flows when you build your chatbot agent. A flow consists of many pages connected by the transition routes. Conversations always start with the built-in Start Flow (with an all-0 ID). Transition routes can direct the conversation session from the current flow (parent flow) to another flow (sub flow). When the sub flow is finished, Dialogflow will bring the session back to the parent flow, where the sub flow is started. Usually, when a transition route is followed by a matched intent, the intent will be "consumed". This means the intent won't activate more transition routes. However, when the followed transition route moves the conversation session into a different flow, the matched intent can be carried over and to be consumed in the target flow.

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(**args) ⇒ GoogleCloudDialogflowCxV3Flow

Returns a new instance of GoogleCloudDialogflowCxV3Flow.



3037
3038
3039
 
# File 'lib/google/apis/dialogflow_v3/classes.rb', line 3037

def initialize(**args)
   update!(**args)
end

Instance Attribute Details

#advanced_settings ⇒ Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3AdvancedSettings

Hierarchical advanced settings for agent/flow/page/fulfillment/parameter. Settings exposed at lower level overrides the settings exposed at higher level. Overriding occurs at the sub-setting level. For example, the playback_interruption_settings at fulfillment level only overrides the playback_interruption_settings at the agent level, leaving other settings at the agent level unchanged. DTMF settings does not override each other. DTMF settings set at different levels define DTMF detections running in parallel. Hierarchy: Agent->Flow->Page->Fulfillment/Parameter. Corresponds to the JSON property advancedSettings

Returns:



2960
2961
2962
 
# File 'lib/google/apis/dialogflow_v3/classes.rb', line 2960

def advanced_settings
  @advanced_settings
end

#description ⇒ String

The description of the flow. The maximum length is 500 characters. If exceeded, the request is rejected. Corresponds to the JSON property description

Returns:

  • (String) 


2966
2967
2968
 
# File 'lib/google/apis/dialogflow_v3/classes.rb', line 2966

def description
  @description
end

#display_name ⇒ String

Required. The human-readable name of the flow. Corresponds to the JSON property displayName

Returns:

  • (String) 


2971
2972
2973
 
# File 'lib/google/apis/dialogflow_v3/classes.rb', line 2971

def display_name
  @display_name
end

#event_handlers ⇒ Array<Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3EventHandler>

A flow's event handlers serve two purposes: * They are responsible for handling events (e.g. no match, webhook errors) in the flow. * They are inherited by every page's event handlers, which can be used to handle common events regardless of the current page. Event handlers defined in the page have higher priority than those defined in the flow. Unlike transition_routes, these handlers are evaluated on a first-match basis. The first one that matches the event get executed, with the rest being ignored. Corresponds to the JSON property eventHandlers

Returns:



2982
2983
2984
 
# File 'lib/google/apis/dialogflow_v3/classes.rb', line 2982

def event_handlers
  @event_handlers
end

#knowledge_connector_settings ⇒ Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3KnowledgeConnectorSettings

The Knowledge Connector settings for this page or flow. This includes information such as the attached Knowledge Bases, and the way to execute fulfillment. Corresponds to the JSON property knowledgeConnectorSettings

Returns:



2989
2990
2991
 
# File 'lib/google/apis/dialogflow_v3/classes.rb', line 2989

def knowledge_connector_settings
  @knowledge_connector_settings
end

#locked ⇒ Boolean Also known as: locked?

Indicates whether the flow is locked for changes. If the flow is locked, modifications to the flow will be rejected. Corresponds to the JSON property locked

Returns:

  • (Boolean) 


2995
2996
2997
 
# File 'lib/google/apis/dialogflow_v3/classes.rb', line 2995

def locked
  @locked
end

#multi_language_settings ⇒ Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3FlowMultiLanguageSettings

Settings for multi-lingual agents. Corresponds to the JSON property multiLanguageSettings

Returns:



3001
3002
3003
 
# File 'lib/google/apis/dialogflow_v3/classes.rb', line 3001

def multi_language_settings
  @multi_language_settings
end

#name ⇒ String

The unique identifier of the flow. Format: projects//locations//agents//flows/ . Corresponds to the JSON property name

Returns:

  • (String) 


3007
3008
3009
 
# File 'lib/google/apis/dialogflow_v3/classes.rb', line 3007

def name
  @name
end

#nlu_settings ⇒ Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3NluSettings

Settings related to NLU. Corresponds to the JSON property nluSettings

Returns:



3012
3013
3014
 
# File 'lib/google/apis/dialogflow_v3/classes.rb', line 3012

def nlu_settings
  @nlu_settings
end

#transition_route_groups ⇒ Array<String>

A flow's transition route group serve two purposes: * They are responsible for matching the user's first utterances in the flow. * They are inherited by every page's transition route groups. Transition route groups defined in the page have higher priority than those defined in the flow. Format: projects// locations//agents//flows//transitionRouteGroups/ or projects//locations// agents//transitionRouteGroups/ for agent-level groups. Corresponds to the JSON property transitionRouteGroups

Returns:

  • (Array<String>) 


3022
3023
3024
 
# File 'lib/google/apis/dialogflow_v3/classes.rb', line 3022

def transition_route_groups
  @transition_route_groups
end

#transition_routes ⇒ Array<Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3TransitionRoute>

A flow's transition routes serve two purposes: * They are responsible for matching the user's first utterances in the flow. * They are inherited by every page's transition routes and can support use cases such as the user saying "help" or "can I talk to a human?", which can be handled in a common way regardless of the current page. Transition routes defined in the page have higher priority than those defined in the flow. TransitionRoutes are evalauted in the following order: * TransitionRoutes with intent specified. * TransitionRoutes with only condition specified. TransitionRoutes with intent specified are inherited by pages in the flow. Corresponds to the JSON property transitionRoutes

Returns:



3035
3036
3037
 
# File 'lib/google/apis/dialogflow_v3/classes.rb', line 3035

def transition_routes
  @transition_routes
end

Instance Method Details

#update!(**args) ⇒ Object

Update properties of this object



3042
3043
3044
3045
3046
3047
3048
3049
3050
3051
3052
3053
3054
 
# File 'lib/google/apis/dialogflow_v3/classes.rb', line 3042

def update!(**args)
  @advanced_settings = args[:advanced_settings] if args.key?(:advanced_settings)
  @description = args[:description] if args.key?(:description)
  @display_name = args[:display_name] if args.key?(:display_name)
  @event_handlers = args[:event_handlers] if args.key?(:event_handlers)
  @knowledge_connector_settings = args[:knowledge_connector_settings] if args.key?(:knowledge_connector_settings)
  @locked = args[:locked] if args.key?(:locked)
  @multi_language_settings = args[:multi_language_settings] if args.key?(:multi_language_settings)
  @name = args[:name] if args.key?(:name)
  @nlu_settings = args[:nlu_settings] if args.key?(:nlu_settings)
  @transition_route_groups = args[:transition_route_groups] if args.key?(:transition_route_groups)
  @transition_routes = args[:transition_routes] if args.key?(:transition_routes)
end