Add `Flow > eventHandlers > triggerFulfillment > enableGenerativeFall… (#13897) (#22671)

[upstream:44d76e995ff42eef2679a4324a06febf6cae215a]

Signed-off-by: Modular Magician <[email protected]>

Author: modular-magician

.changelog/13897.txt

@@ -0,0 +1,3 @@
+```release-note:enhancement
+dialogflowcx: added `eventHandlers > triggerFulfillment > enableGenerativeFallback` field to `google_dialogflow_cx_flow` resource
+```

google/services/dialogflowcx/resource_dialogflow_cx_flow.go

@@ -239,6 +239,13 @@ See [Case](https://cloud.google.com/dialogflow/cx/docs/reference/rest/v3/Fulfill
 											},
 										},
 									},
+									"enable_generative_fallback": {
+										Type:     schema.TypeBool,
+										Optional: true,
+										Description: `If the flag is true, the agent will utilize LLM to generate a text response.
+If LLM generation fails, the defined responses in the fulfillment will be respected.
+This flag is only useful for fulfillments associated with no-match event handlers.`,
+									},
 									"messages": {
 										Type:        schema.TypeList,
 										Optional:    true,
@@ -2093,6 +2100,8 @@ func flattenDialogflowCXFlowEventHandlersTriggerFulfillment(v interface{}, d *sc
 		flattenDialogflowCXFlowEventHandlersTriggerFulfillmentSetParameterActions(original["setParameterActions"], d, config)
 	transformed["conditional_cases"] =
 		flattenDialogflowCXFlowEventHandlersTriggerFulfillmentConditionalCases(original["conditionalCases"], d, config)
+	transformed["enable_generative_fallback"] =
+		flattenDialogflowCXFlowEventHandlersTriggerFulfillmentEnableGenerativeFallback(original["enableGenerativeFallback"], d, config)
 	return []interface{}{transformed}
 }
 func flattenDialogflowCXFlowEventHandlersTriggerFulfillmentMessages(v interface{}, d *schema.ResourceData, config *transport_tpg.Config) interface{} {
@@ -2355,6 +2364,10 @@ func flattenDialogflowCXFlowEventHandlersTriggerFulfillmentConditionalCasesCases
 	return string(b)
 }
 
+func flattenDialogflowCXFlowEventHandlersTriggerFulfillmentEnableGenerativeFallback(v interface{}, d *schema.ResourceData, config *transport_tpg.Config) interface{} {
+	return v
+}
+
 func flattenDialogflowCXFlowEventHandlersTargetPage(v interface{}, d *schema.ResourceData, config *transport_tpg.Config) interface{} {
 	return v
 }
@@ -3719,6 +3732,13 @@ func expandDialogflowCXFlowEventHandlersTriggerFulfillment(v interface{}, d tpgr
 		transformed["conditionalCases"] = transformedConditionalCases
 	}
 
+	transformedEnableGenerativeFallback, err := expandDialogflowCXFlowEventHandlersTriggerFulfillmentEnableGenerativeFallback(original["enable_generative_fallback"], d, config)
+	if err != nil {
+		return nil, err
+	} else if val := reflect.ValueOf(transformedEnableGenerativeFallback); val.IsValid() && !tpgresource.IsEmptyValue(val) {
+		transformed["enableGenerativeFallback"] = transformedEnableGenerativeFallback
+	}
+
 	return transformed, nil
 }
 
@@ -4098,6 +4118,10 @@ func expandDialogflowCXFlowEventHandlersTriggerFulfillmentConditionalCasesCases(
 	return j, nil
 }
 
+func expandDialogflowCXFlowEventHandlersTriggerFulfillmentEnableGenerativeFallback(v interface{}, d tpgresource.TerraformResourceData, config *transport_tpg.Config) (interface{}, error) {
+	return v, nil
+}
+
 func expandDialogflowCXFlowEventHandlersTargetPage(v interface{}, d tpgresource.TerraformResourceData, config *transport_tpg.Config) (interface{}, error) {
 	return v, nil
 }

google/services/dialogflowcx/resource_dialogflow_cx_flow_generated_meta.yaml

@@ -23,6 +23,7 @@ fields:
   - field: 'event_handlers.target_flow'
   - field: 'event_handlers.target_page'
   - field: 'event_handlers.trigger_fulfillment.conditional_cases.cases'
+  - field: 'event_handlers.trigger_fulfillment.enable_generative_fallback'
   - field: 'event_handlers.trigger_fulfillment.messages.channel'
   - field: 'event_handlers.trigger_fulfillment.messages.conversation_success.metadata'
   - field: 'event_handlers.trigger_fulfillment.messages.live_agent_handoff.metadata'

google/services/dialogflowcx/resource_dialogflow_cx_flow_generated_test.go

@@ -315,6 +315,8 @@ resource "google_dialogflow_cx_flow" "basic_flow" {
           },
         ])
       }
+
+      enable_generative_fallback = true
     }
   }
 

google/services/dialogflowcx/resource_dialogflowcx_flow_test.go

@@ -236,6 +236,8 @@ func testAccDialogflowCXFlow_full(context map[string]interface{}) string {
             },
           ])
         }
+
+        enable_generative_fallback = true
       }
     }
 

website/docs/r/dialogflow_cx_flow.html.markdown

@@ -277,6 +277,8 @@ resource "google_dialogflow_cx_flow" "basic_flow" {
           },
         ])
       }
+
+      enable_generative_fallback = true
     }
   }
 
@@ -854,6 +856,12 @@ The Default Start Flow cannot be deleted; deleting the `google_dialogflow_cx_flo
   Conditional cases for this fulfillment.
   Structure is [documented below](#nested_event_handlers_event_handlers_trigger_fulfillment_conditional_cases).
 
+* `enable_generative_fallback` -
+  (Optional)
+  If the flag is true, the agent will utilize LLM to generate a text response.
+  If LLM generation fails, the defined responses in the fulfillment will be respected.
+  This flag is only useful for fulfillments associated with no-match event handlers.
+
 
 <a name="nested_event_handlers_event_handlers_trigger_fulfillment_messages"></a>The `messages` block supports: