rasa 如何写一个故事

设计故事

在设计故事时，需要考虑两组对话交互：快乐路径和不快乐路径。快乐路径描述用户何时按照您的预期遵循对话流程，并在出现提示时始终提供必要的信息。然而，用户经常会因为问题、闲聊或其他问题而偏离愉快的道路。我们称这些为不幸的道路。

对你的机器人来说，优雅地处理不愉快的路径很重要，但也无法预测给定用户可能采取的路径。通常，开发人员在设计不愉快的路径时会尝试考虑所有可能的分歧路径。为状态机中的每个可能状态（其中许多永远不会达到）进行规划需要大量额外工作并显着增加训练时间。

相反，我们建议 在设计不愉快的路径时采用对话驱动的开发方法。对话驱动开发促进尽早与测试用户共享您的机器人，并收集真实的对话数据，这些数据可以准确地告诉您用户如何偏离快乐路径。从这些数据中，您可以创建故事来完成用户的请求，并开始思考如何引导他们回到快乐的道路上。

对于多回合交互，您应该定义一个故事，例如：

1 stories:
2  - story: Greeting and ask user how they're doing
3    steps:
4    - intent: greet
5    - action: utter_greet
6    - action: utter_ask_how_doing
7    - intent: doing_great
8    - action: utter_happy

管理对话流程

以下是管理故事中对话流程的一些技巧：

何时使用插槽来影响对话

插槽充当机器人的内存。定义槽时，您可以定义槽是否 应影响对话。属性influence_conversation设置为 的插槽false只能存储信息。属性influence_conversation设置为 的插槽true可以根据其中存储的信息影响对话流程。

需要将影响对话的插槽添加到您的故事或规则中。这也适用于插槽是由自定义操作设置的情况。例如，您可以使用由自定义操作设置的布尔槽来根据其值使用以下故事控制对话流：

 1 stories:
 2 - story: Welcome message, premium user
 3   steps:
 4    - intent: greet
 5    - action: action_check_profile
 6    - slot_was_set:
 7      - premium_account: true
 8    - action: utter_welcome_premium
 9
10 - story: Welcome message, basic user
11   steps:
12    - intent: greet
13    - action: action_check_profile
14    - slot_was_set:
15      - premium_account: false
16    - action: utter_welcome_basic
17    - action: utter_ask_upgrade

如果您不希望槽影响对话流，则应将槽的属性设置influence_conversation为false。您不需要slot_was_set在故事中包含不影响对话的插槽事件。

实现分支逻辑

在编写故事时，有时下一个操作将取决于您的自定义操作之一中返回的值。在这些情况下，重要的是在返回插槽和直接使用自定义操作代码来影响机器人接下来的操作之间找到正确的平衡。

如果某个值仅用于确定机器人的响应，请考虑将决策逻辑嵌入自定义操作中，而不是在您的故事中使用特征化槽。这有助于降低整体复杂性并使您的故事更易于管理。

例如，您可以转换这些故事：

 1 stories:
 2 - story: It's raining now
 3   steps:
 4   - intent: check_for_rain
 5   - action: action_check_for_rain
 6   - slot_was_set:
 7     - raining: true
 8   - action: utter_is_raining
 9   - action: utter_bring_umbrella
10
11 - story: It isn't raining now
12   steps:
13   - intent: check_for_rain
14   - action: action_check_for_rain
15   - slot_was_set:
16     - raining: false
17   - action: utter_not_raining
18   - action: utter_no_umbrella_needed

合成一个故事是：

1 stories:
2 - story: check for rain
3   steps:
4   - intent: check_for_rain
5   - action: action_check_for_rain

在actions文件里定义：

1 def run(self, dispatcher, tracker, domain):
2     is_raining = check_rain()
3     if is_raining:
4         dispatcher.utter_message(template="utter_is_raining")
5         dispatcher.utter_message(template="utter_bring_umbrella")
6     else:
7         dispatcher.utter_message(template="utter_not_raining")
8         dispatcher.utter_message(template="utter_no_umbrella_needed")
9     return []

如果该值用于影响前进的动作流，请返回一个特征化槽来确定故事。例如，如果您想收集有关新用户的信息，但不收集回访用户的信息，您的故事可能如下所示：

 1 stories:
 2 - story: greet new user
 3   steps:
 4   - intent: greet
 5   - action: check_user_status
 6   - slot_was_set:
 7     - new_user: true
 8   - action: utter_greet
 9   - action: new_user_form
10   - active_loop: new_user_form
11   - active_loop: null
12
13 - story: greet returning user
14   steps:
15   - intent: greet
16   - action: check_user_status
17   - slot_was_set:
18     - new_user: false
19   - action: utter_greet
20   - action: utter_how_can_help

使用 OR 语句和检查点

OR 语句和检查点 可用于减少您必须编写的故事数量。但是，应谨慎使用它们。过度使用 OR 语句或检查点会减慢训练速度，创建过多的检查点会使您的故事难以理解。

OR 语句

在机器人以相同方式处理不同意图的故事中，您可以使用 OR 语句作为创建新故事的替代方法。

例如，您可以合并这两个故事：

 1 stories:
 2 - story: newsletter signup
 3   steps:
 4   - intent: signup_newsletter
 5   - action: utter_ask_confirm_signup
 6   - intent: affirm
 7   - action: action_signup_newsletter
 8
 9 - story: newsletter signup, confirm via thanks
10   steps:
11   - intent: signup_newsletter
12   - action: utter_ask_confirm_signup
13   - intent: thanks
14   - action: action_signup_newsletter

用 OR 语句合并成一个故事：

1 stories:
2 - story: newsletter signup with OR
3   steps:
4   - intent: signup_newsletter
5   - action: utter_ask_confirm_signup
6   - or:
7     - intent: affirm
8     - intent: thanks
9   - action: action_signup_newsletter

检查点

检查点对于将您的故事模块化为经常重复的单独块很有用。例如，如果您希望您的机器人在每个对话流程结束时询问用户反馈，您可以使用检查点来避免在每个故事结束时包含反馈交互：

 1 stories:
 2 - story: beginning of conversation
 3   steps:
 4   - intent: greet
 5   - action: utter_greet
 6   - intent: goodbye
 7   - action: utter_goodbye
 8   - checkpoint: ask_feedback
 9
10 - story: user provides feedback
11   steps:
12   - checkpoint: ask_feedback
13   - action: utter_ask_feedback
14   - intent: inform
15   - action: utter_thank_you
16   - action: utter_anything_else
17
18 - story: user doesn't have feedback
19   steps:
20   - checkpoint: ask_feedback
21   - action: utter_ask_feedback
22   - intent: deny
23   - action: utter_no_problem
24   - action: utter_anything_else

检查点旨在使在许多不同的故事中重用某些对话部分变得更容易。强烈建议不要在现有检查点内使用检查点，因为这会显着增加训练时间并使故事难以理解。

在故事中创造逻辑中断

在设计对话流程时，通常很想创建长篇故事示例，以捕捉从头到尾的完整对话交互。在许多情况下，这将增加解释分支路径所需的训练故事的数量。相反，考虑将较长的故事分成处理子任务的较小对话块。

处理丢失信用卡的快乐路径故事可能如下所示：

stories:
- story: Customer loses a credit card, reviews transactions, and gets a new card
  steps:
  - intent: card_lost
  - action: check_transactions
  - slot_was_set:
    - reviewed_transactions: ["starbucks"]
  - action: utter_ask_fraudulent_transactions
  - intent: inform
  - action: action_update_transactions
  - intent: affirm
  - action: utter_confirm_transaction_dispute
  - action: utter_replace_card
  - action: mailing_address_form
  - active_loop: mailing_address
  - active_loop: null
  - action: utter_sent_replacement
  - action: utter_anything_else
  - intent: affirm
  - action: utter_help

处理丢失的信用卡涉及一系列子任务，即检查欺诈交易的消费历史，确认更换卡的邮寄地址，然后跟进用户的任何额外请求。在此对话弧中，机器人会在多个位置提示用户输入，从而创建需要考虑的分支路径。

例如，当提示“utter_ask_fraudulent_transactions”时，如果没有任何适用，用户可能会以“拒绝”意图进行响应。当被问及机器人是否可以帮助他们做任何其他事情时，用户还可以选择以“拒绝”意图进行响应。

我们可以将这个长故事分成几个小故事：

 1 stories:
 2 - story: Customer loses a credit card
 3   steps:
 4   - intent: card_lost
 5   - action: utter_card_locked
 6   - action: spending_history_form
 7   - active_loop: spending_history_form
 8   - active_loop: null
 9   - slot_was_set:
10     - reviewed_transactions: ["starbucks"]
11   - action: utter_ask_fraudulent_transactions
12
13 - story: Customer reviews transactions and gets a new card
14   steps:
15   - action: utter_ask_fraudulent_transactions
16   - intent: inform
17   - action: action_update_transactions
18   - slot_was_set:
19     - reviewed_transactions: ["target", "starbucks"]
20   - intent: affirm
21   - action: utter_confirm_transaction_dispute
22   - action: utter_replace_card
23   - action: mailing_address_form
24   - active_loop: mailing_address
25   - active_loop: null
26   - action: utter_sent_replacement
27   - action: utter_anything_else
28
29 - story: Customer has something else they need help with
30   steps:
31   - action: utter_anything_else
32   - intent: affirm
33   - action: utter_help