rasa form的中断形式 自然机器语言学习 人工智能

Forms形式

最常见的对话模式之一是从用户那里收集一些信息以便做某事（预订餐厅、调用 API、搜索数据库等）。这也称为**槽填充**。

用法#

要在 Rasa Open Source 中使用表单，您需要确保将 规则策略添加到您的策略配置中。例如：

policies:
- name: RulePolicy

　　

定义表单#

通过将表单添加到域中的forms部分来定义表单。表单的名称也是您可以在 故事或规则中用于处理表单执行的操作的名称。您还需要为表单应填写的每个插槽定义插槽映射。您可以为要填充的每个插槽指定一个或多个插槽映射。

下面的示例形式restaurant_form将填充槽 cuisine从所提取的实体cuisine和槽num_people从实体number。

1 forms:
2   restaurant_form:
3     required_slots:
4         cuisine:
5           - type: from_entity
6             entity: cuisine
7         num_people:
8           - type: from_entity
9             entity: number

一旦第一次调用表单操作，表单就会被激活并提示用户输入下一个所需的槽值。它通过查找调用 的响应utter_ask_<form_name>_<slot_name>或未utter_ask_<slot_name>找到前者来实现此目的。确保在您的域文件中为每个必需的槽定义这些响应。

激活表格#

要激活表单，您需要添加故事或规则，其中描述了助手应何时运行该表单。在特定意图触发表单的情况下，您可以例如使用以下规则：

1 rules:
2 - rule: Activate form
3   steps:
4   - intent: request_restaurant
5   - action: restaurant_form
6   - active_loop: restaurant_form

该active_loop: restaurant_form步骤表示应在restaurant_form运行后激活该表单 。

停用表格#

填满所有必需的空位后，表单将自动停用。您可以使用规则或故事来描述助手在表单结尾处的行为。如果您不添加适用的故事或规则，则助手将在表单完成后自动收听下一条用户消息。以下示例utter_all_slots_filled在表单your_form填满所有必需的插槽后立即 运行话语。

 1 rules:
 2 - rule: Submit form
 3   condition:
 4   # Condition that form is active.
 5   - active_loop: restaurant_form
 6   steps:
 7   # Form is deactivated
 8   - action: restaurant_form
 9   - active_loop: null
10   - slot_was_set:
11     - requested_slot: null
12   # The actions we want to run when the form is submitted.
13   - action: utter_submit
14   - action: utter_slots_values

用户可能希望尽早退出表单。有关如何为这种情况编写故事或规则的信息，请参阅 编写不愉快形式路径的故事/规则。

插槽映射#

Rasa 开源带有四个预定义的映射，用于根据最新的用户消息填充表单的插槽。如果您需要自定义函数来提取所需信息，请参阅 自定义插槽映射。

来自_实体#

的from_entity映射填充基于提取的实体槽。它将寻找一个被称为entity_name填充 slot的实体slot_name。如果intent_name是None，则无论意图名称如何，都将填充插槽。否则，仅当用户的意图为 时才会填充该插槽intent_name。

如果role_name和/或group_name提供，实体的角色/组标签也需要匹配给定的值。如果消息的意图是 ，则槽映射将不适用excluded_intent。请注意，您还可以为参数intent和定义意图列表not_intent。

 1 forms:
 2   your_form:
 3     required_slots:
 4         slot_name:
 5         - type: from_entity
 6           entity: entity_name
 7           role: role_name
 8           group: group name
 9           intent: intent_name
10           not_intent: excluded_intent

在from_entity映射中，当提取的实体唯一地映射到插槽时，即使表单没有请求该插槽，该插槽也会被填充。如果映射不是唯一的，则提取的实体将被忽略。

forms:
  your_form:
    required_slots:
        departure_city:
          - type: from_entity
            entity: city
            role: from
          - type: from_entity
            entity: city
        arrival_city:
          - type: from_entity
            entity: city
            role: to
          - type: from_entity
            entity: city
        arrival_date:
          - type: from_entity
            entity: date

在上面的例子中，实体date唯一地设置槽arrival_date，一个实体city与角色from唯一地设置狭槽departure_city和一个实体city与角色to唯一地设置狭槽arrival_city，因此它们可被用于拟合即使未要求这些时隙对应的狭槽。但是，city没有角色的实体可以同时填充departure_city和arrival_city 插槽，具体取决于请求的是哪个，因此如果city在arrival_date请求插槽时提取了实体，则表单将忽略它。

from_text #

该from_text映射将使用下一个使用者说话的文本，以填补插槽 slot_name。如果intent_name是None，则无论意图名称如何，都将填充插槽。否则，仅当用户的意图为 时才会填充该插槽intent_name。

如果消息的意图是 ，则槽映射将不适用excluded_intent。请注意，您可以为参数intent和定义意图列表not_intent。

1 forms:
2   your_form:
3     required_slots:
4         slot_name:
5         - type: from_text
6           intent: intent_name
7           not_intent: excluded_intent

from_intent #

该from_intent映射将填充槽slot_name用值my_value如果用户意图是intent_name或None。如果消息的意图是 ，则槽映射将不适用excluded_intent。请注意，您还可以为参数intent和定义意图列表not_intent。

的from_intent形式的初始激活期间插槽映射将不适用。要根据激活表单的意图填充插槽，请使用from_trigger_intent 映射。

1 forms:
2   your_form:
3     required_slots:
4         slot_name:
5         - type: from_intent
6           value: my_value
7           intent: intent_name
8           not_intent: excluded_intent

from_trigger_intent #

该from_trigger_intent映射将填充槽slot_name用值my_value 如果窗体通过用意图用户消息激活intent_name。如果消息的意图是 ，则槽映射将不适用 excluded_intent。请注意，您还可以为参数intent和定义意图列表not_intent。

1 forms:
2   your_form:
3     required_slots:
4         slot_name:
5         - type: from_trigger_intent
6           value: my_value
7           intent: intent_name
8           not_intent: excluded_intent

为不愉快的表单路径写故事/规则#

您的用户不会总是回复您询问他们的信息。通常，用户会提出问题、闲聊、改变主意或以其他方式偏离快乐的道路。

当表单处于活动状态时，如果用户的输入未填充请求的插槽，则表单操作的执行将被拒绝，即表单将自动引发ActionExecutionRejection. 这些是表单将引发的特定场景ActionExecutionRejection：

• 请求了一个插槽，但用户没有用他们的最后一条消息填充该插槽，并且您没有定义用于验证插槽或 提取插槽的自定义操作 。
• 请求了一个插槽，但您用于验证插槽或 提取插槽的自定义操作 未返回任何SlotSet事件。

要故意拒绝表单执行，您还可以返回一个ActionExecutionRejected事件作为自定义验证或槽映射的一部分。

要处理可能导致表单执行被拒绝的情况，您可以编写包含预期中断的规则或故事。例如，如果您希望您的用户与您的机器人聊天，您可以添加一个规则来处理这个问题：

 1 rules:
 2 - rule: Example of an unhappy path
 3   condition:
 4   # Condition that form is active.
 5   - active_loop: restaurant_form
 6   steps:
 7   # This unhappy path handles the case of an intent `chitchat`.
 8   - intent: chitchat
 9   - action: utter_chitchat
10   # Return to form after handling the `chitchat` intent
11   - action: restaurant_form
12   - active_loop: restaurant_form

在某些情况下，用户可能会在表单操作的中间改变主意，并决定不继续他们的初始请求。在这种情况下，助手应该停止请求请求的插槽。

您可以使用默认操作优雅地处理此类情况，该操作action_deactivate_loop将停用表单并重置请求的插槽。此类对话的示例故事如下所示：

 1 stories:
 2 - story: User interrupts the form and doesn't want to continue
 3   steps:
 4   - intent: request_restaurant
 5   - action: restaurant_form
 6   - active_loop: restaurant_form
 7   - intent: stop
 8   - action: utter_ask_continue
 9   - intent: stop
10   - action: action_deactivate_loop
11   - active_loop: null

这是强烈建议你建立一个使用这些规则或故事， 互动学习。如果您手写这些规则/故事，您可能会错过重要的事情。

高级用法#

使用自定义操作可以完全自定义表单。

验证表单输入#

从用户输入中提取槽值后，您可以验证提取的槽。默认情况下，Rasa Open Source 仅验证在请求插槽后是否填充了任何插槽。

您可以实施自定义操作 validate_<form_name> 来验证任何提取的插槽。确保将此操作添加到actions 域的部分：

actions:
- validate_restaurant_form

执行表单时，它将运行您的自定义操作。

此自定义操作可以扩展FormValidationAction类以简化验证提取槽的过程。在这种情况下，您需要编写validate_<slot_name>为每个提取的插槽命名的函数。

以下示例显示了自定义操作的实现，该操作验证指定的插槽cuisine是否有效。

 1 from typing import Text, List, Any, Dict
 2
 3 from rasa_sdk import Tracker, FormValidationAction
 4 from rasa_sdk.executor import CollectingDispatcher
 5 from rasa_sdk.types import DomainDict
 6
 7
 8 class ValidateRestaurantForm(FormValidationAction):
 9     def name(self) -> Text:
10         return "validate_restaurant_form"
11
12     @staticmethod
13     def cuisine_db() -> List[Text]:
14         """Database of supported cuisines"""
15
16         return ["caribbean", "chinese", "french"]
17
18     def validate_cuisine(
19         self,
20         slot_value: Any,
21         dispatcher: CollectingDispatcher,
22         tracker: Tracker,
23         domain: DomainDict,
24     ) -> Dict[Text, Any]:
25         """Validate cuisine value."""
26
27         if slot_value.lower() in self.cuisine_db():
28             # validation succeeded, set the value of the "cuisine" slot to value
29             return {"cuisine": slot_value}
30         else:
31             # validation failed, set this slot to None so that the
32             # user will be asked for the slot again
33             return {"cuisine": None}

您还可以扩展Action类并检索提取的插槽tracker.slots_to_validate 以完全自定义验证过程。

自定义插槽映射#

如果没有预定义的插槽映射适合您的用例，您可以使用 自定义操作 validate_<form_name>来编写您自己的提取代码。Rasa Open Source 会在表单运行时触发这个动作。

如果您使用的是 Rasa SDK，我们建议您扩展提供的 FormValidationAction. 使用FormValidationAction时，提取海关槽位需要三个步骤：

1. extract_<slot_name>为每个应该以自定义方式映射的插槽定义一个方法。
2. 确保在域文件中为表单只列出那些使用预定义映射的插槽 。
3. 覆盖required_slots以将具有自定义映射的所有插槽添加到表单应请求的插槽列表中。

下面的示例展示了一个表单的实现outdoor_seating，除了使用预定义映射的插槽之外，它还以自定义方式 提取插槽 。该方法根据关键字是否出现在最后一条用户消息中来extract_outdoor_seating设置槽。outdoor_seatingoutdoor

 1 from typing import Dict, Text, List, Optional, Any
 2
 3 from rasa_sdk import Tracker
 4 from rasa_sdk.executor import CollectingDispatcher
 5 from rasa_sdk.forms import FormValidationAction
 6
 7
 8 class ValidateRestaurantForm(FormValidationAction):
 9     def name(self) -> Text:
10         return "validate_restaurant_form"
11
12     async def required_slots(
13         self,
14         slots_mapped_in_domain: List[Text],
15         dispatcher: "CollectingDispatcher",
16         tracker: "Tracker",
17         domain: "DomainDict",
18     ) -> Optional[List[Text]]:
19         required_slots = slots_mapped_in_domain + ["outdoor_seating"]
20         return required_slots
21
22     async def extract_outdoor_seating(
23         self, dispatcher: CollectingDispatcher, tracker: Tracker, domain: Dict
24     ) -> Dict[Text, Any]:
25         text_of_last_user_message = tracker.latest_message.get("text")
26         sit_outside = "outdoor" in text_of_last_user_message
27
28         return {"outdoor_seating": sit_outside}

默认情况下，FormValidationAction 将自动将 设置为未填充requested_slot的第一个插槽required_slots。

动态表单行为#

默认情况下，Rasa Open Source 会从域文件中为您的表单列出的插槽中请求下一个空插槽。如果您使用 自定义插槽映射和FormValidationAction，它将要求该required_slots方法返回的第一个空插槽。如果required_slots填写了所有插槽，则该表格将被停用。

如果需要，您可以动态更新表单所需的插槽。例如，当您需要基于前一个槽的填充方式的更多详细信息时，或者您想更改请求槽的顺序时，这很有用。

如果您使用的是 Rasa SDK，我们建议您使用FormValidationAction和 覆盖required_slots来适应您的动态行为。您应该extract_<slot name>为每个不使用预定义映射的插槽实现一个方法，如自定义插槽映射 中所述。下面的示例将询问用户是否想坐在阴凉处或阳光下，以防他们说他们想坐在外面。

 1 from typing import Text, List, Optional
 2
 3 from rasa_sdk.forms import FormValidationAction
 4
 5 class ValidateRestaurantForm(FormValidationAction):
 6     def name(self) -> Text:
 7         return "validate_restaurant_form"
 8
 9     async def required_slots(
10         self,
11         slots_mapped_in_domain: List[Text],
12         dispatcher: "CollectingDispatcher",
13         tracker: "Tracker",
14         domain: "DomainDict",
15     ) -> Optional[List[Text]]:
16         additional_slots = ["outdoor_seating"]
17         if tracker.slots.get("outdoor_seating") is True:
18             # If the user wants to sit outside, ask
19             # if they want to sit in the shade or in the sun.
20             additional_slots.append("shade_or_sun")
21
22         return additional_slots + slots_mapped_in_domain

request_slot 插槽#

该插槽requested_slot将作为类型为 的插槽自动添加到域中text。的值requested_slot将在对话期间被忽略。如果你想改变这个行为，你需要将 加入requested_slot 到你的域文件中作为一个分类槽， influence_conversation设置为true。如果您想以不同的方式处理不愉快的路径，您可能想要这样做，具体取决于用户当前询问的插槽。例如，如果您的用户用另一个问题来回答机器人的一个问题，比如您为什么需要知道这一点？ 对此explain意图的反应取决于我们在故事中的位置。在餐厅案例中，您的故事将如下所示：

 1 stories:
 2 - story: explain cuisine slot
 3   steps:
 4   - intent: request_restaurant
 5   - action: restaurant_form
 6   - active_loop: restaurant
 7   - slot_was_set:
 8     - requested_slot: cuisine
 9   - intent: explain
10   - action: utter_explain_cuisine
11   - action: restaurant_form
12   - active_loop: null
13
14 - story: explain num_people slot
15   steps:
16   - intent: request_restaurant
17   - action: restaurant_form
18   - active_loop: restaurant
19   - slot_was_set:
20     - requested_slot: cuisine
21   - slot_was_set:
22     - requested_slot: num_people
23   - intent: explain
24   - action: utter_explain_num_people
25   - action: restaurant_form
26   - active_loop: null

同样，强烈建议您使用 交互式学习来构建这些故事。

使用自定义操作请求下一个插槽#

一旦表单确定用户接下来必须填充哪个位置，它就会执行操作utter_ask_<form_name>_<slot_name>或utter_ask_<slot_name> 要求用户提供必要的信息。如果常规话语还不够，您还可以使用自定义操作action_ask_<form_name>_<slot_name>或 action_ask_<slot_name>要求下一个槽。

 1 from typing import Dict, Text, List
 2
 3 from rasa_sdk import Tracker
 4 from rasa_sdk.events import EventType
 5 from rasa_sdk.executor import CollectingDispatcher
 6 from rasa_sdk import Action
 7
 8
 9 class AskForSlotAction(Action):
10     def name(self) -> Text:
11         return "action_ask_cuisine"
12
13     def run(
14         self, dispatcher: CollectingDispatcher, tracker: Tracker, domain: Dict
15     ) -> List[EventType]:
16         dispatcher.utter_message(text="What cuisine?")
17         return []