rasa-pro 3.14.0.dev6__py3-none-any.whl → 3.14.0.dev8__py3-none-any.whl

rasa/cli/project_templates/telco/data/billing/flow_understand_bill.yml

@@ -0,0 +1,45 @@
+flows:
+  understand_bill:
+    if: slots.user_authenticated # the user has to be authenticated in order to access this flow
+    description: This flow allows users to check their bill and billing related details.
+    steps:
+      - collect: bill_month
+        ask_before_filling: False
+      - action: action_verify_bill_by_date
+      - collect: breakdown_cost
+        description: |
+          This slot is boolean variable. it holds one of two possible values: true or false
+          (breakdown_cost = True, breakdown_cost = False), and if the user says "yup," it should be considered True, while "nope" should be considered False
+          (e.g., breakdown_cost = True for "yup", breakdown_cost = False for "nope").
+        ask_before_filling: true # This can be useful some LLMs will prefill bool slots here we make it mandatory for the bot to ask the user
+        next:
+          - if: slots.breakdown_cost # it has to be 'slots' with an 's', this means breakdown_cost is True
+            then:
+              - action: action_recap_bill
+              - collect: more_bill_details
+                next:
+                  - if: slots.more_bill_details
+                    then:
+                      - action: utter_provide_bill_sources
+                        next: "END"
+                  - else: issue_solved_section # this will call "issue_solved_section" section
+
+          - else: issue_solved_section
+
+      - id: issue_solved_section # This will help avoid re-writting the same piece of code, this way it can be re-used
+        collect: issue_solved
+        description: |
+          This slot is boolean variable. it holds one of two possible values: true or false
+          (issue_solved = True, issue_solved = False), and if the user says "yup" it should be considered True, while "nope" should be considered False
+          (e.g., issue_solved = True for "yup", issue_solved = False for "nope").
+        ask_before_filling: true
+        next:
+          - if: not slots.issue_solved # this means issue_solved is False
+            then:
+              - action: utter_connect_to_human
+              - action: action_sleep_few_sec
+              -  link: human_handoff
+
+          - else:
+            - action: utter_end_conversation
+              next: "END"

rasa/cli/project_templates/telco/data/data.md

@@ -0,0 +1,11 @@
+## 📂 `data/` – The Agent's Business Logic
+
+This folder holds files that define your telecom agent's skills using "flows". Each flow is a structured sequence of steps that describes the business logic needed to perform a specific goal. 
+
+**What you'll find:**
+- **billing/**: Billing and payment flows (bill inquiries, payment processing)
+- **network/**: Network service flows (troubleshooting, diagnostics, service checks)
+- **general/**: General telecom conversations (greetings, help, support)
+
+**Edit YAML files in this folder** to add new telecom features, modify existing flows, or adjust what the agent asks customers.
+

rasa/cli/project_templates/telco/data/general/bot_challenge.yml

@@ -0,0 +1,6 @@
+flows:
+  bot_challenge:
+    name: bot challenge
+    description: This flow clarifies that the user is talking to a chatbot, when the user ask if they are talking to a chatbot or a human
+    steps:
+      - action: utter_bot_challenge

rasa/cli/project_templates/telco/data/general/feedback.yml

@@ -0,0 +1,20 @@
+# Simple thumbs up/down feedback flow
+flows:
+  leave_feedback:
+    name: leaving feedback
+    description: This flow collects simple thumbs up or thumbs down feedback
+    if: False # Flow guard to prevent direct triggering
+    steps:
+      - collect: feedback_rating
+        description: Ask user for thumbs up or thumbs down feedback
+      - id: feedback_response
+        noop: true
+        next:
+          - if: slots.feedback_rating == "thumbs_up"
+            then: positive_response
+          - else: negative_response
+      - id: positive_response
+        action: utter_thankyou_positive
+        next: END
+      - id: negative_response
+        action: utter_thankyou_negative

rasa/cli/project_templates/telco/data/general/goodbye.yml

@@ -0,0 +1,6 @@
+flows: 
+  goodbye:
+    description: Handle user goodbye messages, say farewell, and collect feedback
+    steps:
+      - action: utter_goodbye
+      - link: leave_feedback

rasa/cli/project_templates/telco/data/general/hello.yml

@@ -0,0 +1,6 @@
+flows:
+  hello:
+    description: Flow for greeting the user hello
+    name: hello
+    steps:
+      - action: utter_hello

rasa/cli/project_templates/telco/data/general/human_handoff.yml

@@ -0,0 +1,16 @@
+version: "3.1"
+flows:
+  human_handoff:
+    description: When you are unable to handle the request or the user is frustrated - offers to hand the user over to a live human agent. 
+    steps:
+      - collect: confirm_human_handoff
+        ask_before_filling: True
+        next:
+          - if: slots.confirm_human_handoff
+            then:
+            - action: utter_transferring_to_human
+            - action: action_human_handoff
+              next: END
+          - else:
+            - action: utter_human_handoff_cancelled
+              next: END

rasa/cli/project_templates/telco/data/general/patterns.yml

@@ -0,0 +1,30 @@
+flows:
+  pattern_completed:
+    description: A flow has been completed and there is nothing else to be done
+    if: False
+    steps:
+      - noop: true
+        next: END
+
+  pattern_correction:
+    description: Handle a correction of a slot value.
+    name: pattern correction
+    steps:
+      - action: action_correct_flow_slot
+        next: "END"
+
+  pattern_search:
+    description: Flow for handling knowledge-based questions
+    name: pattern search
+    steps:
+      - id: 0_action_trigger_search
+        next: END
+        action: action_trigger_search
+
+  pattern_session_start:
+    description: Flow for starting the conversation
+    name: pattern session start
+    nlu_trigger:
+      - intent: session_start
+    steps:
+      - action: utter_greeting

rasa/cli/project_templates/telco/data/network/flow_reboot_router.yml

@@ -0,0 +1,8 @@
+flows:
+  reboot_router: # only reboot/restart the router
+    if: False
+    description: Help user reboot and restart their router, the user will be doing this action
+    steps:
+      - action: utter_explain_reboot_router
+      - collect: reboot_router
+        reset_after_flow_ends: true

rasa/cli/project_templates/telco/data/network/flow_reset_router.yml

@@ -0,0 +1,7 @@
+flows:
+  reset_router: # restet the router rometely
+    if: False
+    description: Help user reset their router, the bot will do this action on behalf of the user
+    steps:
+      - action: utter_explain_reset_router
+      - action: utter_image_reset_router

rasa/cli/project_templates/telco/data/network/flow_solve_internet_issue.yml

@@ -0,0 +1,73 @@
+flows:
+  fix_internet_slow: # flow name mandatory – this defines a conversational flow for running diagnostics.
+    description: Help users solve when internet is slow and provide solutions # description another madatory field this will be sent to CALM
+    steps:
+      - action: utter_acknowledge_issue # an utter a response that the agent will display to the end user.
+      - action: action_sleep_few_sec # Adding sleep time in a chatbot conversation makes interactions feel more natural,
+                                    #improves readability, and simulates processing delays for a better user experience.
+      - call: run_diagnostics # Call a flow, this flow can be re-used multiple times.
+                              # fix_internet_slow will (parent flow) call run_diagnostics (child flow)
+                              # when you call a flow, you go to the child flow and then be back to the parent flow
+                              # first call
+        next:
+          - if: slots.network_speed < 100 # the syntax is important it has to be slots, this slot has to be float as well
+            then:
+              - action: utter_acknowledge_speed_test_not_good
+              - action: action_sleep_few_sec
+              - action: utter_propose_reboot_router_solution
+              - action: action_sleep_few_sec
+              - call: reboot_router
+                next:
+                  - if: slots.reboot_router # this slot is boolean
+                    then:
+                      - call: run_diagnostics # Second call
+                        next:
+                          - if: slots.network_speed > 100
+                            then:
+                              - action: action_sleep_few_sec
+                              - action: utter_speed_issue_resolved
+                                next: "END" # this has to be added, either next END to explain the flow end or point to another section
+                          - else:
+                            - action: action_sleep_few_sec
+                            - action: utter_speed_issue_not_resolved
+                            - call: reset_router
+                            - action: utter_final_diagnistics_run
+                            - call: run_diagnostics # Third call
+                              next:
+                                - if: slots.network_speed < 100
+                                  then:
+                                    - action: utter_acknowledge_speed_test_not_good
+                                    - action: utter_fail_to_find_fix
+                                    - link: human_handoff # when you link a flow, you go to the child flow and then the flow ends there.
+                                - else:
+                                  - action: action_sleep_few_sec
+                                  - action: utter_final_try_worked
+                                  - action: utter_speed_issue_resolved
+                                    next: "END"
+
+
+                  - else:
+                    - link: human_handoff
+          - else:
+            - action: utter_speed_network_not_issue
+            - action: action_sleep_few_sec
+            - action: utter_propose_other_solutions
+            - action: action_sleep_few_sec
+            - collect: more_help_needed
+              next:
+                - if: slots.more_help_needed
+                  then:
+                    - link: human_handoff
+                - else:
+                  - action: action_sleep_few_sec
+                  - action: utter_final_help
+                    next: "END"
+
+
+  run_diagnostics:
+    if: False # Conditional check – this flow will not run unless this condition is verified.
+              #when it is False this means this flow will only be run if it is called by another flow, not the user.
+    description: run diagnostics to check the internet speed for the user
+    steps:
+      - action: utter_communicate_run_diagnosticss
+      - action: actions_run_speed_test

rasa/cli/project_templates/telco/docs/docs.md

@@ -0,0 +1,5 @@
+## 📂 `docs/` – The Agent's Knowledge Base (optional)
+
+If your agent answers knowledge-based questions (FAQs, policies, etc.), you can put markdown, PDFs, or text files in this folder. Rasa can use this content for retrieval-augmented responses if set up with a vector store [2](https://rasa.com/docs/pro/build/retrieval-actions).
+
+**Edit here** to update what your agent can retrieve and summarize for users.

rasa/cli/project_templates/telco/docs/network/reset_vs_rboot_router.txt

@@ -0,0 +1 @@
+Rebooting a router means simply turning it off and back on without changing any settings. This helps resolve temporary issues like slow speeds or dropped connections and is done by pressing the power button or unplugging the device for a few seconds before turning it back on. Resetting a router, on the other hand, restores it to factory settings, erasing all custom configurations such as the Wi-Fi name, password, and advanced settings. This is done by holding the reset button for about 10-30 seconds until the router restarts. While rebooting is a quick fix for minor issues, resetting should only be done as a last resort when troubleshooting persistent problems.

rasa/cli/project_templates/telco/docs/network/restart_router.txt

@@ -0,0 +1,6 @@
+Here are concise summaries of how to turn your router on and off:
+Using the Power Button: Press the power button to turn off the router, wait 30 seconds, then press it again to turn it back on.
+Unplugging Method: Disconnect the power cable, wait 30 seconds, then plug it back in to restart the router.
+Full Restart for Issues: Turn off the router, wait 1 minute, then turn it back on to refresh the connection.
+
+To turn your router off, press the power button (if available) or unplug it from the power source. Wait about 30 seconds to 1 minute before turning it back on by pressing the power button again or plugging it back in. This helps refresh the connection and resolve minor network issues.

rasa/cli/project_templates/telco/docs/network/run_speed_test.txt

@@ -0,0 +1,6 @@
+Speed test is run by a special software to check what is the current speed of your Internet when uploading or downloading files
+You can use "Fast.com", "Speedtest.net", or Google "Internet speed test"
+An internet speed test measures your connection's performance by evaluating download and upload speeds (Mbps), ping (latency in ms), and jitter.
+It helps determine how fast data is sent and received, impacting streaming, gaming, and video calls.
+Speed tests are useful for diagnosing slow connections and verifying ISP performance.
+You can use our App for a speed test. Go to the Home menu, select WLAN speed test and run it.

rasa/cli/project_templates/telco/domain/billing/understand_bill.yml

@@ -0,0 +1,102 @@
+actions:
+  - action_get_customer_info
+  - action_verify_bill_by_date
+  - action_recap_bill
+
+slots:
+  bill_month:
+    type: categorical
+    mappings:
+      - type: from_llm
+    values:
+      - January
+      - February
+      - March
+      - April
+      - May
+      - June
+      - July
+      - August
+      - September
+      - October
+      - November
+      - December
+
+  bill_amount:
+    type: float
+    mappings:
+      - type: controlled
+
+  user_authenticated:
+    type: bool
+    mappings:
+      - type: controlled
+    initial_value: True
+
+  average_bill:
+      type: float
+      mappings:
+        - type: controlled
+
+  difference:
+      type: float
+      mappings:
+        - type: controlled
+
+  breakdown_cost:
+      type: bool
+      mappings:
+        - type: from_llm
+
+  issue_solved:
+      type: bool
+      mappings:
+        - type: from_llm
+
+  more_bill_details:
+      type: bool
+      mappings:
+        - type: from_llm
+
+responses:
+  utter_ask_customer_id:
+    - text: |
+        Can you please provide me your customer id?
+
+  utter_ask_bill_month:
+    - text: |
+        Alright. Could you please specify the month? 📅
+
+  utter_ask_breakdown_cost:
+    - text: |
+        Would you like to see the breakdown of the costs?
+      buttons:
+        - title: "Yes, please"
+          payload: "/SetSlots(breakdown_cost=True)"
+        - title: "No, all good"
+          payload: "/SetSlots(breakdown_cost=False)"
+
+  utter_ask_issue_solved:
+    - text: |
+        Did I manage to provide all the information you need?
+      buttons:
+        - title: "Yes, all good"
+          payload: "/SetSlots(issue_solved=True)"
+        - title: "No, I need further help"
+          payload: "/SetSlots(issue_solved=False)"
+
+  utter_ask_more_bill_details:
+      - text: |
+          You can see more details in your account.
+          Would you like a link to the overview that contains all your bills?
+        buttons:
+        - title: "Yes, please"
+          payload: "/SetSlots(more_bill_details=True)"
+        - title: "No, it's enough"
+          payload: "/SetSlots(more_bill_details=False)"
+
+  utter_provide_bill_sources:
+      - text: |
+          I've provided a quick summary of your bill ⤵️
+          For full details, please log in to your account and check your billing history here:
+          https://companyName/account/your-bills 🔗

rasa/cli/project_templates/telco/domain/domain.md

@@ -0,0 +1,14 @@
+## 📂 `domain/` – The Agent's Brain
+
+This folder contains YAML files that define the telecom agent's:
+- **Slots**: The agent's memory (e.g., customer account, service status, network diagnostics) [1](https://rasa.com/docs/reference/primitives/slots/).
+- **Responses**: The messages your agent can say to customers (e.g., greetings, service confirmations, technical explanations) [2](https://rasa.com/docs/reference/primitives/responses).
+- **Actions**: Custom logic your agent can run (e.g., running network diagnostics, checking service status) [3](https://rasa.com/docs/reference/primitives/custom-actions).
+
+**What you'll find:**
+- **billing/**: Domain configuration for billing and payment features
+- **network/**: Domain setup for network diagnostics and troubleshooting
+- **general/**: General telecom customer service domain configuration
+- `shared.yml`: Shared domain elements across all telecom services
+
+You can organize the domain as one big file or many small ones. Rasa will automatically merge everything during training [1](https://rasa.com/docs/reference/config/domain).

rasa/cli/project_templates/telco/domain/general/bot_challenge.yml

@@ -0,0 +1,4 @@
+
+responses:
+  utter_bot_challenge:
+    - text: "You got it - I’m a virtual agent. I’ll do my best to help with your internet or mobile plan."

rasa/cli/project_templates/telco/domain/general/feedback.yml

@@ -0,0 +1,25 @@
+slots:
+  feedback_rating:
+    type: categorical
+    values: [thumbs_up, thumbs_down]
+    mappings:
+      - type: from_llm
+
+responses:
+  utter_ask_feedback_rating:
+    - text: "We'd love to hear about your experience! How are we doing?"
+      buttons:
+        - title: "👍 Great"
+          payload: "/SetSlots(feedback_rating=thumbs_up)"
+        - title: "👎 Could be better"
+          payload: "/SetSlots(feedback_rating=thumbs_down)"
+
+  utter_thankyou_positive:
+    - text: "That's wonderful to hear! We appreciate you taking the time to provide us with feedback. 🌟"
+    - text: "So glad we could help! Thanks for the positive feedback! 😊"
+    - text: "Amazing! We're thrilled you had a great experience. Thank you for your feedback! 🎉"
+
+  utter_thankyou_negative:
+    - text: "We appreciate you taking the time to provide us with feedback. We're always working to improve our service."
+    - text: "Thank you for your honest feedback. We'll use it to make our service better."
+    - text: "Thanks for letting us know. Your feedback helps us improve our agent."

rasa/cli/project_templates/telco/domain/general/goodbye.yml

@@ -0,0 +1,7 @@
+responses:
+  utter_goodbye:
+    - text: "Thanks for stopping by — take care!"
+    - text: "Thanks for the chat. Have a great day!"
+    - text: "Catch you later! Feel free to reach out anytime."
+    - text: "Goodbye for now — we're here if you need anything."
+    - text: "Take care! Let us know if you have any other questions."

rasa/cli/project_templates/telco/domain/general/hello.yml

@@ -0,0 +1,5 @@
+responses:
+  utter_hello:
+    - text: "Hi there! Nice to meet you!"
+      metadata:
+        rephrase: True

rasa/cli/project_templates/telco/domain/general/human_handoff.yml

@@ -0,0 +1,26 @@
+version: "3.1"
+actions:
+  - "action_human_handoff"
+
+slots: 
+ confirm_human_handoff:
+    type: bool
+    mappings:
+      - type: "from_llm"
+
+responses:
+  utter_ask_confirm_human_handoff:
+    - text: "Do you want to be connected to a human agent?"
+      buttons:
+        - payload: "/SetSlots(confirm_human_handoff=True)"
+          title: "Yes"
+        - payload: "/SetSlots(confirm_human_handoff=False)"
+          title: "No"
+
+  utter_transferring_to_human:
+    - text: "You will be transfered to a human agent in a few moments."
+
+  utter_human_handoff_cancelled:
+    - text: "Ok, I understand you don't want to be connected to a human agent. Is there something else I can help you with?"
+      metadata:
+        rephrase: True

rasa/cli/project_templates/telco/domain/general/patterns.yml

@@ -0,0 +1,33 @@
+slots: 
+  example_questions:
+    type: text
+    initial_value: |
+      - My internet is slow—what can I do?
+      - What is a speed test?
+      - How to reset my router?
+      - Explain my April bill.
+    mappings:
+      - type: controlled
+  agent_name:
+    type: text
+    initial_value: "Telly"
+    mappings:
+      - type: controlled
+      
+responses:
+  utter_more_help_needed_handoff_pattern:
+    - text: "Please hold on while I connect you to our expert 📲"
+  utter_connect_to_human:
+    - text: "Let me connect you to our human support managers. They will help you further!"
+  utter_cannot_handle:
+    - text: "I’m sorry, I can’t help with that."
+      metadata:
+        rephrase: True
+  utter_no_relevant_answer_found:
+    - text: I’m sorry, I can’t help with that.
+      metadata:
+        rephrase: True
+  utter_greeting:
+    - text: "Hi there! I'm {agent_name} 👋. I can help with your internet and mobile plan questions. \n\nHere's a few things you can ask me:\n{example_questions} \n\n How can I help you today?"
+      metadata:
+        rephrase: True

rasa/cli/project_templates/telco/domain/network/reboot_router.yml

@@ -0,0 +1,21 @@
+slots:
+  reboot_router:
+    type: bool
+    mappings:
+      - type: from_llm
+
+responses:
+
+  utter_explain_reboot_router:
+  - text: |
+      Please turn the router off, wait 10 seconds and turn it back on.
+
+  utter_ask_reboot_router:
+  - text: |
+      Let me know when you are done!
+    buttons:
+    - title: "Done"
+      payload: "/SetSlots(reboot_router=True)"
+    - title: "Facing a problem"
+      payload: "/SetSlots(reboot_router=False)"
+

rasa/cli/project_templates/telco/domain/network/reset_router.yml

@@ -0,0 +1,12 @@
+
+responses:
+  utter_explain_reset_router:
+  - text: |
+      I will reset your router remotely to try to fix the issue.
+      No action is needed from your end.
+      It may take a minute. Please hold on ⏳
+  utter_image_reset_router:
+  - text: |
+      Router is reset successfully! 🎉
+    image: "https://www.creativefabrica.com/wp-content/uploads/2022/09/04/Wifi-router-outline-icon-Graphics-37782400-1.jpg"
+

rasa/cli/project_templates/telco/domain/network/run_speed_test.yml

@@ -0,0 +1,25 @@
+slots:
+  how_to_run_speed_test:
+    type: text
+    mappings:
+      - type: from_llm
+
+  run_speed_test:
+    type: bool
+    mappings:
+      - type: from_llm
+
+  download_speed:
+    type: text
+    mappings:
+      - type: from_llm
+
+responses:
+
+  utter_ask_download_speed:
+  - text: |
+      Run it and let me know the download speed.
+  utter_help_run_speed_test:
+    - text: |
+          You can use our Rasacom App, go to the Home menu and select WLAN speed test or use this link https://fast.com/
+

rasa/cli/project_templates/telco/domain/network/solve_internet_issue.yml

@@ -0,0 +1,75 @@
+slots:
+  network_speed:
+    type: float
+    mappings:
+      - type: controlled
+  more_help_needed:
+    type: bool
+    mappings:
+      - type: from_llm
+
+responses:
+
+  utter_acknowledge_issue:
+    - text: |
+        I see.
+        Let me try to identify the root cause of the issue you are facing.
+  utter_communicate_run_diagnosticss:
+    - text: |
+        I will run a network diagnostics for you 🛜
+        Wait a moment please...
+      image: "https://static.vecteezy.com/system/resources/previews/002/785/641/non_2x/speed-test-internet-measure-icon-illustration-free-vector.jpg"
+  utter_acknowledge_speed_test_not_good:
+  - text: |
+      Your network download speed is {network_speed} Mbps.
+      That's definitely not good.
+
+  utter_propose_reboot_router_solution:
+  - text: |
+      Let's reboot your router.
+      It helps resolving most issues with speed.
+  utter_speed_issue_resolved:
+    - text: |
+        {network_speed} Mbps, Awesome! 🚀
+        If the Internet gets slow again, you can always reset the router.
+        If that doesn't help, let me know, and we can try something else. 😊
+  utter_speed_issue_not_resolved:
+    - text: |
+        Your network speed is {network_speed} Mbps.
+        That's too low.
+  utter_speed_network_not_issue:
+    - text: |
+        {network_speed} Mbps sounds right. The speed seems to be in order.
+  utter_propose_other_solutions:
+    - text: |
+        The result of my test shows that there is no technical issues between your home and our core network.
+        However, if you're still experiencing slow browsing or buffering, it could be due to network congestion, too many connected devices, or Wi-Fi interference.
+        Try moving closer to your router or disconnecting unused devices.
+  utter_ask_more_help_needed:
+    - text: |
+        I can connect you to a human agent for further assistance.
+        Would you like me to do that now?
+      buttons:
+        - title: "Yes, please"
+          payload: "/SetSlots(more_help_needed=True)"
+        - title: "Not now"
+          payload: "/SetSlots(more_help_needed=False)"
+  utter_final_help:
+    - text: |
+        No problem! If you need help later, feel free to ask.
+        In the meantime, you might try checking for background apps using bandwidth or reducing the number of connected devices.
+        Let me know if there's anything else I can do for you!
+  utter_final_diagnistics_run:
+    - text: |
+        Final try 🤞
+  utter_fail_to_find_fix:
+    - text: |
+        I am sorry that I could not resolve the problem with your Internet speed.
+        Please don't worry, we will find the exact cause and remedy it.
+  utter_final_try_worked:
+    - text: |
+        third time is a charm
+actions:
+  - actions_run_speed_test
+  - action_sleep_few_sec
+