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

rasa/cli/project_templates/finance/domain/transfers/transfer_money.yml

@@ -0,0 +1,79 @@
+version: "3.1"
+
+slots:
+  account_from:
+    type: text
+  payee_name:
+    type: text
+  payee_exists:
+    type: bool
+  amount:
+    type: float
+  sufficient_funds:
+    type: bool
+  timing:
+    type: categorical
+    values:
+      - now
+      - future
+  payment_date:
+    type: text
+  confirm_immediate_payment:
+    type: bool
+  confirm_future_payment:
+    type: bool
+  payment_processed:
+    type: bool
+  payment_scheduled:
+    type: bool
+  valid_payment_date:
+    type: bool
+  future_payment_date:
+    type: bool
+
+responses:
+  utter_transfer_money_understand:
+    - text: "Okay lets transfer money"
+      metadata:
+        rephrase: True
+  utter_ask_payee_name:
+    - text: "Which payee would you like to send money to?"
+  utter_ask_amount:
+    - text: "How much money would you like to transfer?"
+  utter_insufficient_funds:
+    - text: "I'm sorry, but you have insufficient funds for this transfer. Please enter a different amount"
+  utter_ask_timing:
+    - text: "When would you like this transfer to be made?"
+      buttons:
+        - title: Immediate
+          payload: "/SetSlots(timing=now)"
+        - title: Future
+          payload: "/SetSlots(timing=future)"
+  utter_ask_payment_date:
+    - text: "On which date would you like this payment to be made?"
+  utter_ask_confirm_future_payment:
+    - text: "A payment of ${amount} to {payee_name} will be scheduled for {payment_date}. Is this correct?"
+  utter_payment_scheduled:
+    - text: "Your payment of ${amount} to {payee_name} has been successfully scheduled for {payment_date}"
+  utter_ask_confirm_immediate_payment:
+    - text: "An immediate payment of ${amount} to {payee_name} will be processed. Is this correct?"
+  utter_transfer_successful:
+    - text: "Your transfer of ${amount} to {payee_name} has been successfully processed"
+  utter_cancel_transfer:
+    - text: "No problem. I will cancel this transfer"
+  utter_invalid_amount:
+    - text: "You have to enter an amount greater than 0"
+      metadata:
+        rephrase: True
+  utter_past_payment_date:
+    - text: "A future payment date cannot be in the past!"
+      metadata:
+        rephrase: True
+
+actions:
+  - action_ask_account_from
+  - action_check_payee_existence
+  - action_check_sufficient_funds
+  - action_schedule_payment
+  - action_process_immediate_payment
+  - action_validate_payment_date

rasa/cli/project_templates/finance/endpoints.yml

@@ -0,0 +1,66 @@
+# This file contains the different endpoints your bot can use.
+
+# Server where the models are pulled from.
+# https://rasa.com/docs/rasa-pro/production/model-storage#fetching-models-from-a-server
+
+#models:
+#  url: http://my-server.com/models/default_core@latest
+#  wait_time_between_pulls:  10   # [optional](default: 100)
+
+# Server which runs your custom actions.
+# https://rasa.com/docs/rasa-pro/concepts/custom-actions
+
+action_endpoint:
+  actions_module: "actions"
+
+# Tracker store which is used to store the conversations.
+# By default the conversations are stored in memory.
+# https://rasa.com/docs/rasa-pro/production/tracker-stores
+
+#tracker_store:
+#    type: redis
+#    url: <host of the redis instance, e.g. localhost>
+#    port: <port of your redis instance, usually 6379>
+#    db: <number of your database within redis, e.g. 0>
+#    password: <password used for authentication>
+#    use_ssl: <whether or not the communication is encrypted, default false>
+
+#tracker_store:
+#    type: mongod
+#    url: <url to your mongo instance, e.g. mongodb://localhost:27017>
+#    db: <name of the db within your mongo instance, e.g. rasa>
+#    username: <username used for authentication>
+#    password: <password used for authentication>
+
+# Event broker which all conversation events should be streamed to.
+# https://rasa.com/docs/rasa-pro/production/event-brokers
+
+#event_broker:
+#  url: localhost
+#  username: username
+#  password: password
+#  queue: queue
+
+# The lines below activate contextual rephrasing, using the default OpenAI language model.
+# Ensure the OPENAI_API_KEY is set to prevent any missing API key errors.
+# For more details, refer to the documentation:
+# https://rasa.com/docs/rasa-pro/concepts/contextual-response-rephraser
+# To enable the rephraser, remove the comment symbols in the lines below.
+nlg:
+  type: rephrase
+  llm:
+    model_group: openai-gpt-4o
+  prompt: prompts/rephraser_demo_personality_prompt.jinja2
+  rephrase_all: False
+
+model_groups:
+  - id: openai-gpt-4o
+    models:
+      - provider: openai
+        model: gpt-4o-2024-11-20
+        request_timeout: 7
+        max_completion_tokens: 256
+  - id: openai-embeddings
+    models:
+      - provider: openai
+        model: text-embedding-3-large

rasa/cli/project_templates/finance/prompts/rephraser_demo_personality_prompt.jinja2

@@ -0,0 +1,19 @@
+The following is a conversation with an AI agent.
+The agent is professional, calm, and highly attentive to detail.
+Its main priorities are efficiency, speed, and accuracy when handling user requests.
+
+Please rephrase the suggested AI response, staying close to the original meaning while
+ensuring the agent's tone remains formal yet empathetic, friendly, and reassuring.
+It should convey patience, even with vague or repetitive questions, and be clear,
+informative, and slightly humorous where appropriate.
+
+Write your responses in English
+
+Context / previous conversation with the user:
+{{history}}
+
+{{current_input}}
+
+Suggested AI Response: {{suggested_response}}
+
+Rephrased AI Response:

rasa/cli/project_templates/telco/README.md

@@ -0,0 +1,25 @@
+# Telecom Customer Service Agent Template
+
+A lightweight telecommunications customer service agent template that handles network support, billing inquiries, and technical troubleshooting.
+
+## 🚀 What's Included
+
+This template provides a complete telecom customer service assistant with:
+- **Network Diagnostics**: Automated troubleshooting and service status checking
+- **Billing Support**: Account management, bill inquiries, and payment assistance
+- **Technical Support**: Issue resolution, service guidance, and escalation management
+- **Knowledge Base**: Technical documentation and common issue solutions
+- **Customer Management**: Account verification and personalized service interactions
+
+## 📁 Directory Structure
+
+```
+├── actions/         # Custom Python logic for telecom operations
+├── data/            # Telecom conversation flows and training data
+├── domain/          # Telecom agent configuration
+├── csvs/            # Mock database for testing
+├── docs/            # Basic knowledge base and documentation
+├── tests/           # End-to-end test cases for telecom scenarios
+├── prompts/         # LLM prompts for enhanced technical responses
+└── config.yml       # Training pipeline configuration
+```

rasa/cli/project_templates/telco/actions/actions.md

@@ -0,0 +1,12 @@
+## 📂 `actions/` – The Agent's Toolkit
+
+This folder contains Python files that define custom telecom actions your agent can perform. Actions handle technical diagnostics, service management, and customer support operations specific to telecommunications.
+
+**What you'll find:**
+- **billing/**: Billing-related actions (bill inquiries, payment processing, account management)
+- **network/**: Network service actions (diagnostics, data retrieval, service status checks)
+- **general/**: General support actions (human handoff, session management)
+
+**Edit Python files in this folder** to add new telecom features, integrate with network management systems, or extend customer service capabilities.
+
+Learn more about custom actions in the [Rasa documentation](https://rasa.com/docs/pro/build/custom-actions).

rasa/cli/project_templates/telco/actions/billing/actions_billing.py

@@ -0,0 +1,204 @@
+import csv
+import logging
+from datetime import datetime
+from typing import Any, Dict, List
+
+from rasa_sdk import Action
+from rasa_sdk.events import SlotSet
+from rasa_sdk.executor import CollectingDispatcher
+from rasa_sdk.interfaces import Tracker
+from rasa_sdk.types import DomainDict
+
+
+class ActionVerifyBillByDate(Action):
+    def name(self) -> str:
+        return "action_verify_bill_by_date"
+
+    @staticmethod
+    def text_to_date(month_text: str) -> str:
+        try:
+            # Get the current year
+            current_year = datetime.now().year
+
+            # Combine user input with the current year
+            full_text = f"{month_text} {current_year}"
+
+            # Parse the text format (e.g., "March 2025")
+            date_obj = datetime.strptime(full_text, "%B %Y")
+
+            # Format as DD/MM/YYYY (defaults to the first day of the month)
+            formatted_date = date_obj.strftime("01/%m/%Y")
+            logging.info(f"This is an info message: formatted_date: {formatted_date}")
+            return formatted_date
+        except ValueError:
+            return "Invalid format. Please use a full month name (e.g., 'March')."
+
+    def run(
+        self, dispatcher: CollectingDispatcher, tracker: Tracker, domain: DomainDict
+    ) -> List[Dict[str, Any]]:
+        # Get customer ID and date from slots
+        customer_id = tracker.get_slot("customer_id")
+        bill_month = tracker.get_slot("bill_month")
+
+        bill_date = ActionVerifyBillByDate.text_to_date(bill_month)
+
+        if not customer_id:
+            dispatcher.utter_message(
+                "I couldn't find your customer ID. Please provide it."
+            )
+            return []
+
+        if not bill_date:
+            dispatcher.utter_message(
+                "Please specify the date for the bill you want to check."
+            )
+            return []
+
+        try:
+            # Load CSV file with billing data
+            with open("csvs/billing.csv", "r", newline="") as csvfile:
+                reader = csv.DictReader(csvfile)
+
+                # Convert bill_date to datetime for comparison
+                bill_date_obj = datetime.strptime(bill_date, "%d/%m/%Y")
+
+                # Filter data for the given customer and date
+                customer_bills = []
+                specific_bill = None
+
+                for row in reader:
+                    if row["customer_id"] == str(customer_id):
+                        # Parse the date from CSV
+                        row_date = datetime.strptime(row["date"], "%d/%m/%Y")
+                        row["amount"] = float(row["amount"])
+                        customer_bills.append(row)
+
+                        # Check if this is the specific bill we're looking for
+                        if row_date.date() == bill_date_obj.date():
+                            specific_bill = row
+
+                if specific_bill is None:
+                    dispatcher.utter_message(
+                        f"No bill found for {bill_date_obj.date()}."
+                    )
+                    return []
+
+                bill_amount = float(specific_bill["amount"])
+
+                # Calculate average
+                if customer_bills:
+                    average_bill = sum(
+                        float(bill["amount"]) for bill in customer_bills
+                    ) / len(customer_bills)
+                else:
+                    average_bill = 0.0
+
+                difference = bill_amount - average_bill
+
+                # Generate response
+                response = (
+                    f"Your bill for {bill_month} {bill_date_obj.date().year} is "
+                    f"${bill_amount:.2f}. \n"
+                    f"The average of your past bills is ${average_bill:.2f}. \n"
+                    f"This bill is {'higher' if difference > 0 else 'lower'} than "
+                    f"your average by ${abs(difference):.2f}."
+                )
+
+                dispatcher.utter_message(response)
+                return [
+                    SlotSet("bill_amount", float(bill_amount)),
+                    SlotSet("average_bill", float(average_bill)),
+                    SlotSet("difference", float(difference)),
+                ]
+
+        except FileNotFoundError:
+            dispatcher.utter_message("Billing data file not found.")
+            return []
+        except Exception:
+            dispatcher.utter_message("Error retrieving billing information.")
+            return []
+
+
+class ActionRecapBill(Action):
+    def name(self) -> str:
+        return "action_recap_bill"
+
+    def run(
+        self, dispatcher: CollectingDispatcher, tracker: Tracker, domain: DomainDict
+    ) -> List[Dict[str, Any]]:
+        # Get customer_id and bill_date from slots
+        customer_id = tracker.get_slot("customer_id")
+        bill_month = tracker.get_slot("bill_month")
+
+        bill_date = ActionVerifyBillByDate.text_to_date(bill_month)
+
+        if not customer_id:
+            dispatcher.utter_message(
+                "I need your customer ID to fetch your bill recap."
+            )
+            return []
+
+        if not bill_date:
+            dispatcher.utter_message(
+                "I need a date to fetch your bill recap. Can you provide one?"
+            )
+            return []
+
+        # Convert customer_id to int if needed
+        try:
+            customer_id = int(customer_id)
+        except ValueError:
+            dispatcher.utter_message("Invalid customer ID format.")
+            return []
+
+        try:
+            # Load CSV file
+            with open("csvs/billing.csv", "r", newline="") as csvfile:
+                reader = csv.DictReader(csvfile)
+
+                bill_date_obj = datetime.strptime(bill_date, "%d/%m/%Y")
+
+                # Filter records for the given customer_id
+                filtered_records: List[Dict[str, Any]] = []
+                for row in reader:
+                    if row["customer_id"] == str(customer_id):
+                        # Parse date and add to filtered records
+                        row_date: datetime = datetime.strptime(row["date"], "%d/%m/%Y")
+                        filtered_records.append(
+                            {
+                                "date": row_date.date(),
+                                "amount": float(row["amount"]),
+                                "source": row["source"],
+                            }
+                        )
+
+                if not filtered_records:
+                    dispatcher.utter_message(
+                        f"No transactions found for customer {customer_id} on "
+                        f"{bill_date_obj.date().strftime('%B %Y')}."
+                    )
+                    return []
+
+                # Format the output
+                response1 = "Here is a summary of your costs :"
+                dispatcher.utter_message(response1)
+                response = "\n".join(
+                    [
+                        (
+                            f"{record['date']} | {record['amount']} $ "
+                            f"| {record['source']}"
+                        )
+                        for record in filtered_records
+                    ]
+                )
+
+                # Send response to user
+                dispatcher.utter_message(response)
+                return []
+
+        except FileNotFoundError:
+            dispatcher.utter_message("Billing data file not found.")
+            return []
+        except Exception:
+            dispatcher.utter_message("Error retrieving billing information.")
+            return []

rasa/cli/project_templates/telco/actions/general/action_human_handoff.py

@@ -0,0 +1,49 @@
+from typing import Any, Dict, List, Text
+
+from openai import AsyncOpenAI
+from rasa_sdk import Action, Tracker
+from rasa_sdk.events import BotUttered
+from rasa_sdk.executor import CollectingDispatcher
+from rasa_sdk.types import DomainDict
+
+
+class ActionHumanHandoff(Action):
+    def __init__(self) -> None:
+        super().__init__()
+        self.client = AsyncOpenAI()
+
+    def name(self) -> Text:
+        return "action_human_handoff"
+
+    async def run(
+        self, dispatcher: CollectingDispatcher, tracker: Tracker, domain: DomainDict
+    ) -> List[Dict[Text, Any]]:
+        # Collect conversation
+        convo = []
+        for event in tracker.events:
+            if event.get("event") == "user":
+                user_text = "{}".format(event.get("text"))
+                user_text2 = "user - " + user_text
+                convo.append(user_text2)
+            if event.get("event") == "bot":
+                bot_text = "{}".format(event.get("text"))
+                bot_text2 = "bot - " + bot_text
+                # print(bot_text)
+                convo.append(bot_text2)
+        prompt = (
+            f"The following is a conversation between a bot and a human user, "
+            f"please summarise so that a human agent can easily understand "
+            f"the important context. Conversation: {convo}"
+        )
+        response = await self.client.chat.completions.create(
+            model="gpt-4",  # or "gpt-3.5-turbo"
+            messages=[{"role": "user", "content": prompt}],
+        )
+        summarised_conversation = response.choices[0].message.content or ""
+        return [
+            BotUttered(
+                f"I will transfer the following summary of our conversation "
+                f"to the Callback Manager:\n"
+                f"{summarised_conversation}"
+            )
+        ]

rasa/cli/project_templates/telco/actions/network/actions_get_data_from_db.py

@@ -0,0 +1,48 @@
+import csv
+from typing import Dict, List
+
+from rasa_sdk import Action
+from rasa_sdk.events import SlotSet
+from rasa_sdk.executor import CollectingDispatcher
+from rasa_sdk.interfaces import Tracker
+from rasa_sdk.types import DomainDict
+
+
+class ActionGetCustomerInfo(Action):
+    def name(self) -> str:
+        return "action_get_customer_info"
+
+    def run(
+        self, dispatcher: CollectingDispatcher, tracker: Tracker, domain: DomainDict
+    ) -> List[Dict]:
+        # Load CSV file
+        file_path = "csvs/customers.csv"  # get information from your DBs
+        customer_id = tracker.get_slot("customer_id")
+
+        try:
+            with open(file_path, "r", newline="") as csvfile:
+                reader = csv.DictReader(csvfile)
+
+                # Filter data for the given customer ID
+                customer_info = None
+                for row in reader:
+                    if row["customer_id"] == str(customer_id):
+                        customer_info = row
+                        break
+
+                if customer_info is None:
+                    dispatcher.utter_message("No customer found with this ID.")
+                    return []
+
+                # Extract customer details
+                first_name = customer_info["first_name"]
+
+                # Set the retrieved name in a slot
+                return [SlotSet("customer_first_name", first_name)]
+
+        except FileNotFoundError:
+            dispatcher.utter_message("Customer database file not found.")
+            return []
+        except Exception:
+            dispatcher.utter_message("Error retrieving customer information.")
+            return []

rasa/cli/project_templates/telco/actions/network/actions_run_diagnostics.py

@@ -0,0 +1,28 @@
+import asyncio
+import random
+
+from rasa_sdk import Action
+from rasa_sdk.events import EventType, SlotSet
+from rasa_sdk.executor import CollectingDispatcher
+from rasa_sdk.interfaces import Tracker
+from rasa_sdk.types import DomainDict
+
+
+class ActionSleepAndRespond(Action):
+    def name(self) -> str:
+        return "actions_run_speed_test"
+
+    async def run(
+        self, dispatcher: CollectingDispatcher, tracker: Tracker, domain: DomainDict
+    ) -> list[EventType]:
+        await asyncio.sleep(10)
+        dispatcher.utter_message(
+            text="Thank you for waiting... ✅ "
+        )  # Send to the user
+
+        random_number = random.randint(
+            50, 150
+        )  # we will pick randomly the internet speed here
+        # for local testing purposes you can define the number
+        # for Production testing connect to the API to get this data
+        return [SlotSet("network_speed", random_number)]

rasa/cli/project_templates/telco/actions/network/actions_session_start.py

@@ -0,0 +1,18 @@
+import asyncio
+
+from rasa_sdk import Action
+from rasa_sdk.events import EventType
+from rasa_sdk.executor import CollectingDispatcher
+from rasa_sdk.interfaces import Tracker
+from rasa_sdk.types import DomainDict
+
+
+class ActionSleepAndRespond(Action):
+    def name(self) -> str:
+        return "action_sleep_few_sec"
+
+    async def run(
+        self, dispatcher: CollectingDispatcher, tracker: Tracker, domain: DomainDict
+    ) -> list[EventType]:
+        await asyncio.sleep(3)
+        return []

rasa/cli/project_templates/telco/config.yml

@@ -0,0 +1,29 @@
+# Rasa Agent Configuration
+# This file controls your agent's language, message processing pipeline, and conversation policies.
+# For full documentation, see: https://rasa.com/docs/pro/build/configuring-assistant
+recipe: default.v1
+language: en
+
+# The agent project unique identifier
+# This default value must be replaced with a unique agent name within your deployment
+assistant_id: placeholder_default
+
+pipeline:
+- name: SearchReadyLLMCommandGenerator
+  llm:
+    model_group: openai-gpt-4o
+  flow_retrieval:
+    active: false
+
+
+policies:
+- name: FlowPolicy
+- name: EnterpriseSearchPolicy
+  vector_store:
+    type: "faiss"
+    source: "./docs"
+  llm:
+    model_group: openai-gpt-4o
+  embeddings:
+    model_group: openai-embeddings
+  check_relevancy: true

rasa/cli/project_templates/telco/credentials.yml

@@ -0,0 +1,33 @@
+# This file contains the credentials for the voice & chat platforms
+# which your bot is using.
+# https://rasa.com/docs/rasa-pro/connectors/messaging-and-voice-channels/
+
+rest:
+#  # you don't need to provide anything here - this channel doesn't
+#  # require any credentials
+
+
+#facebook:
+#  verify: "<verify>"
+#  secret: "<your secret>"
+#  page-access-token: "<your page access token>"
+
+#slack:
+#  slack_token: "<your slack token>"
+#  slack_channel: "<the slack channel>"
+#  slack_signing_secret: "<your slack signing secret>"
+
+#socketio:
+#  user_message_evt: <event name for user message>
+#  bot_message_evt: <event name for bot messages>
+#  session_persistence: <true/false>
+
+#mattermost:
+#  url: "https://<mattermost instance>/api/v4"
+#  token: "<bot token>"
+#  webhook_url: "<callback URL>"
+
+# This entry is needed if you are using Rasa Enterprise. The entry represents credentials
+# for the Rasa Enterprise "channel", i.e. Talk to your bot and Share with guest testers.
+rasa:
+  url: "http://localhost:5002/api"

rasa/cli/project_templates/telco/csvs/billing.csv

@@ -0,0 +1,19 @@
+customer_id,date,amount,source
+123,01/01/2025,150.50,Internet
+123,01/02/2025,55.00,Internet
+123,01/03/2025,60.00,Internet
+123,01/04/2025,65.00,Internet
+123,01/05/2025,70.00,Internet
+123,01/06/2025,75.00,Internet
+123,01/07/2025,80.00,Internet
+123,01/08/2025,85.00,Internet
+123,01/09/2025,90.00,Internet
+123,01/10/2025,95.00,Internet
+123,01/11/2025,100.00,Internet
+123,01/12/2025,105.00,Internet
+124,01/01/2025,53.00,TV
+124,01/02/2025,53.00,TV
+124,01/03/2025,53.00,TV
+125,01/01/2025,89.75,Mobile
+125,01/02/2025,89.75,Mobile
+125,01/03/2025,89.75,Mobile

rasa/cli/project_templates/telco/csvs/customers.csv

@@ -0,0 +1,5 @@
+customer_id,first_name,last_name
+123,Serena,Williams
+124,Lionel, Messi
+125,Tom, Cruise
+456,Beyoncé, Knowles