2.4.x _utter_responses should handle template and response

changelog/8223.bugfix.md

@@ -0,0 +1 @@
+In Rasa 2.4.0, support for using `template` in `utter_message` when handling a custom action was wrongly deprecated. Both `template` and `response` are now supported, though note that `template` will be deprecated at Rasa 3.0.0.

examples/formbot/actions/actions.py

@@ -48,7 +48,7 @@ def validate_cuisine(
             # validation succeeded, set the value of the "cuisine" slot to value
             return {"cuisine": value}
         else:
-            dispatcher.utter_message(template="utter_wrong_cuisine")
+            dispatcher.utter_message(response="utter_wrong_cuisine")
             # validation failed, set this slot to None, meaning the
             # user will be asked for the slot again
             return {"cuisine": None}
@@ -65,7 +65,7 @@ def validate_num_people(
         if self.is_int(value) and int(value) > 0:
             return {"num_people": value}
         else:
-            dispatcher.utter_message(template="utter_wrong_num_people")
+            dispatcher.utter_message(response="utter_wrong_num_people")
             # validation failed, set slot to None
             return {"num_people": None}
 
@@ -86,7 +86,7 @@ def validate_outdoor_seating(
                 # convert "in..." to False
                 return {"outdoor_seating": False}
             else:
-                dispatcher.utter_message(template="utter_wrong_outdoor_seating")
+                dispatcher.utter_message(response="utter_wrong_outdoor_seating")
                 # validation failed, set slot to None
                 return {"outdoor_seating": None}
 

rasa/core/actions/action.py

@@ -625,7 +625,17 @@ async def _utter_responses(
         """Use the responses generated by the action endpoint and utter them."""
         bot_messages = []
         for response in responses:
+            generated_response = None
             generated_response = response.pop("response", None)
+            if not generated_response:
+                generated_response = response.pop("template", None)
+                rasa.shared.utils.io.raise_deprecation_warning(
+                    "The terminology 'template' is deprecated and replaced by "
+                    "'response', use the `response` parameter instead of "
+                    "`template` in `dispatcher.utter_message`. You can do that "
+                    "by upgrading to Rasa SDK 2.4.1 or adapting your custom SDK.",
+                    docs=f"{rasa.shared.constants.DOCS_BASE_URL_ACTION_SERVER}/sdk-dispatcher",
+                )
             if generated_response:
                 draft = await nlg.generate(
                     generated_response, tracker, output_channel.name(), **response

rasa/shared/constants.py

@@ -25,6 +25,7 @@
 )
 DOCS_URL_TELEMETRY = DOCS_BASE_URL + "/telemetry/telemetry"
 DOCS_BASE_URL_RASA_X = "https://rasa.com/docs/rasa-x"
+DOCS_BASE_URL_ACTION_SERVER = "https://rasa.com/docs/action-server"
 
 INTENT_MESSAGE_PREFIX = "/"
 

tests/core/test_actions.py

@@ -288,6 +288,55 @@ async def test_remote_action_utterances_with_none_values(
     ]
 
 
+async def test_remote_action_with_template_param(
+    default_channel, default_tracker, default_domain
+):
+    endpoint = EndpointConfig("https://example.com/webhooks/actions")
+    remote_action = action.RemoteAction("my_action", endpoint)
+
+    response = {
+        "events": [
+            {"event": "form", "name": "restaurant_form", "timestamp": None},
+            {
+                "event": "slot",
+                "timestamp": None,
+                "name": "requested_slot",
+                "value": "cuisine",
+            },
+        ],
+        "responses": [
+            {
+                "text": None,
+                "buttons": [],
+                "elements": [],
+                "custom": {},
+                "template": "utter_ask_cuisine",
+                "image": None,
+                "attachment": None,
+            }
+        ],
+    }
+
+    nlg = TemplatedNaturalLanguageGenerator(
+        {"utter_ask_cuisine": [{"text": "what dou want to eat?"}]}
+    )
+    with aioresponses() as mocked:
+        mocked.post("https://example.com/webhooks/actions", payload=response)
+
+        with pytest.warns(FutureWarning):
+            events = await remote_action.run(
+                default_channel, nlg, default_tracker, default_domain
+            )
+
+    assert events == [
+        BotUttered(
+            "what dou want to eat?", metadata={"utter_action": "utter_ask_cuisine"}
+        ),
+        ActiveLoop("restaurant_form"),
+        SlotSet("requested_slot", "cuisine"),
+    ]
+
+
 async def test_remote_action_without_endpoint(
     default_channel, default_nlg, default_tracker, default_domain
 ):