rasa-pro 3.14.0rc2__py3-none-any.whl → 3.14.0rc3__py3-none-any.whl

rasa/builder/copilot/prompts/latest_user_message_context_prompt.jinja2

@@ -1,30 +1,33 @@
-# Context Available to You
-Treat everything **below** as **current-turn context** to apply under those rules. You
-have access to:
+# Context Priority
+When interpreting user questions (especially vague ones like *"What's this?"*), follow
+this order of priority:
 
-{% if current_conversation %}
-## Current Conversation and Conversation State between the user and the assistant
+| Priority | Context Source | Usage |
+|----------|----------------|-------|
+| 1 | **Attachments** | Highest priority. If attachments exist, assume the user's question refers to them. Always ground explanations in attachment content first. |
+| 2 | **Assistant State / Current Conversation** | Use this when attachments are not present. Supplement attachment knowledge with state info if needed. |
+| 3 | **Assistant Files** | Use when neither attachments nor state provide enough context. |
+| 4 | **Documentation Results** | Use to explain Rasa features and validate facts. Must always be cited inline. |
+| 5 | **Assistant Logs** | Lowest priority. Use only if directly relevant to the user’s issue. |
 
-**Conversation History:**
-```json
-{{ current_conversation }}
-```
+---
 
-**Assistant's State:**
-```json
-{{ current_state }}
-```
-{% endif %}
+# Remember!
+- Focus on accessibility and efficiency. Give guidance users can act on right away.
+- Keep answers concise, cut any fluff.
+- Never impersonate or role-play as the assistant being built. You are the **Rasa assistant development expert**.
+- Cite documentation inline frequently — every factual statement about Rasa features, concepts, or capabilities MUST be cited.
+- Only cite from current turn documentation — never from previous conversation turns.
+- NEVER add a separate list of URLs or sources — only use inline citations.
+- NEVER start your response with a ``` or """ or any other quoting characters.
 
-{% if assistant_logs %}
-***
+---
 
-## Assistant Logs
-```
-{{ assistant_logs }}
-```
-{% endif %}
+# Context Available to You
+Treat everything **below** as context for the user's current request.  
+You have access to:
 
+***
 
 ## Assistant Files (Configuration, Domain, Flows)
 {% if assistant_files %}
@@ -51,11 +54,38 @@ numbers (1, 2, 3, etc.) for inline citations:
 No relevant documentation source found.
 {% endif %}
 
-# Remember!
-- Focus on accessibility and efficiency. Give guidance users can act on right away.
-- Keep answers concise, cut any fluff.
-- Never impersonate or role-play as the assistant being built. You are the **Rasa assistant development expert**.
-- Cite documentation inline frequently - every factual statement about Rasa features, concepts, or capabilities MUST be cited.
-- Only cite from current turn documentation - never from previous conversation turns
-- NEVER add a separate list of URLs or sources - only use inline citations.
-- NEVER start your response with a ``` or """ or any other quoting characters.
+{% if current_conversation %}
+***
+
+## Current Conversation and Conversation State between the user and the assistant
+
+**Conversation History:**
+```json
+{{ current_conversation }}
+```
+
+**Assistant's State:**
+```json
+{{ current_state }}
+```
+{% endif %}
+
+{% if assistant_logs %}
+***
+
+## Assistant Logs
+```
+{{ assistant_logs }}
+```
+{% endif %}
+
+{% if attachments %}
+***
+
+## Attachments
+The user clicked **Ask Copilot** in the **Inspect Mode** and included additional context
+as attachments:
+```json
+{{ attachments }}
+```
+{% endif %}

rasa/builder/copilot/telemetry.py

@@ -8,6 +8,7 @@ import structlog
 from rasa import telemetry
 from rasa.builder.copilot.constants import COPILOT_SEGMENT_WRITE_KEY_ENV_VAR
 from rasa.builder.copilot.copilot_response_handler import CopilotResponseHandler
+from rasa.builder.copilot.models import EventContent
 from rasa.builder.document_retrieval.models import Document
 from rasa.telemetry import (
     SEGMENT_TRACK_ENDPOINT,
@@ -100,6 +101,7 @@ class CopilotTelemetry:
         system_message: Optional[dict[str, Any]] = None,
         chat_history: Optional[list[dict[str, Any]]] = None,
         last_user_message: Optional[str] = None,
+        tracker_event_attachments: Optional[list[dict[str, Any]]] = None,
     ) -> None:
         """Track a copilot message in the conversation.
 
@@ -115,6 +117,7 @@ class CopilotTelemetry:
             system_message: The system message used (optional).
             chat_history: The chat history messages used (optional).
             last_user_message: The last user message used (optional).
+            tracker_event_attachments: The tracker event attachments used (optional).
         """
         structlogger.debug("builder.telemetry.log_copilot_turn", text=text)
 
@@ -136,6 +139,7 @@ class CopilotTelemetry:
             "total_tokens": total_tokens,
             "chat_history": chat_history,
             "last_user_message": last_user_message,
+            "tracker_event_attachments": tracker_event_attachments,
             "timestamp": dt.datetime.utcnow().isoformat(),
         }
 
@@ -194,6 +198,7 @@ class CopilotTelemetry:
         system_message: dict[str, Any],
         chat_history: list[dict[str, Any]],
         last_user_message: Optional[str],
+        tracker_event_attachments: list[EventContent],
     ) -> None:
         """Log a copilot message from the response handler.
 
@@ -223,4 +228,7 @@ class CopilotTelemetry:
             system_message=system_message,
             chat_history=chat_history,
             last_user_message=last_user_message,
+            tracker_event_attachments=[
+                attachment.model_dump() for attachment in tracker_event_attachments
+            ],
         )

rasa/builder/service.py

@@ -1176,6 +1176,7 @@ async def copilot(request: Request) -> None:
                     if (req.last_message and req.last_message.role == ROLE_USER)
                     else None
                 ),
+                tracker_event_attachments=generation_context.tracker_event_attachments,
                 **copilot_client.usage_statistics.model_dump(),
             )
         )

rasa/cli/dialogue_understanding_test.py

@@ -214,6 +214,7 @@ def execute_dialogue_understanding_tests(args: argparse.Namespace) -> None:
 
     # initialization of endpoints
     endpoints = set_up_available_endpoints(args)
+    Configuration.initialise_sub_agents(args.sub_agents)
 
     # set up the test runner, e.g. start the agent
     try:

rasa/cli/e2e_test.py

@@ -160,6 +160,7 @@ def execute_e2e_tests(args: argparse.Namespace) -> None:
     endpoints = Configuration.initialise_endpoints(
         endpoints_path=EndpointsConfigPath.validate(args.endpoints)
     ).endpoints
+    Configuration.initialise_sub_agents(args.sub_agents)
 
     # Ignore all endpoints apart from action server, model, nlu and nlg
     # to ensure InMemoryTrackerStore is being used instead of production

rasa/cli/inspect.py

@@ -93,6 +93,7 @@ def inspect(args: argparse.Namespace) -> None:
     # it can be used safely throughout the codebase with
     # `Configuration.get_instance().endpoints`
     Configuration.initialise_endpoints(endpoints_path=Path(args.endpoints))
+    Configuration.initialise_sub_agents(args.sub_agents)
 
     try:
         model = get_local_model(model)

rasa/cli/project_templates/basic/tests/e2e_test_cases/without_stub/general/feedback.yml

@@ -0,0 +1,46 @@
+test_cases:
+  - test_case: positive feedback
+    steps:
+    - user: "goodbye"
+      assertions:
+        - flow_started: "goodbye_flow"
+        - bot_uttered:
+            utter_name: "utter_goodbye"
+        - flow_started: "leave_feedback"
+        - bot_uttered:
+            utter_name: "utter_ask_feedback_rating"
+            buttons:
+              - title: "👍 Great"
+                payload: "/SetSlots(feedback_rating=thumbs_up)"
+              - title: "👎 Could be better"
+                payload: "/SetSlots(feedback_rating=thumbs_down)"
+    - user: "/SetSlots(feedback_rating=thumbs_up)"
+      assertions:
+        - slot_was_set:
+            - name: "feedback_rating"
+              value: "thumbs_up"
+        - bot_uttered:
+            utter_name: "utter_thankyou_positive"
+# 
+  - test_case: negative feedback
+    steps:
+    - user: "goodbye"
+      assertions:
+        - flow_started: "goodbye_flow"
+        - bot_uttered:
+            utter_name: "utter_goodbye"
+        - flow_started: "leave_feedback"
+        - bot_uttered:
+            utter_name: "utter_ask_feedback_rating"
+            buttons:
+              - title: "👍 Great"
+                payload: "/SetSlots(feedback_rating=thumbs_up)"
+              - title: "👎 Could be better"
+                payload: "/SetSlots(feedback_rating=thumbs_down)"
+    - user: "/SetSlots(feedback_rating=thumbs_down)"
+      assertions:
+        - slot_was_set:
+            - name: "feedback_rating"
+              value: "thumbs_down"
+        - bot_uttered:
+            utter_name: "utter_thankyou_negative"

rasa/cli/project_templates/basic/tests/e2e_test_cases/without_stub/general/goodbye.yml

@@ -0,0 +1,9 @@
+test_cases:
+  - test_case: goodbye
+    steps:
+    - user: "goodbye"
+      assertions:
+        - flow_started: "goodbye_flow"
+        - bot_uttered:
+            utter_name: "utter_goodbye"
+        - flow_started: "leave_feedback"

rasa/cli/project_templates/basic/tests/e2e_test_cases/without_stub/general/help.yml

@@ -0,0 +1,8 @@
+test_cases:
+  - test_case: help
+    steps:
+    - user: "help"
+      assertions:
+        - flow_started: "help"
+        - bot_uttered:
+            utter_name: "utter_what_can_you_do"

rasa/cli/project_templates/basic/tests/e2e_test_cases/without_stub/general/human_handoff.yml

@@ -0,0 +1,41 @@
+test_cases:
+  - test_case: human handoff happy path
+    steps:
+    - user: "I would like to speak with a human"
+      assertions:
+        - flow_started: "human_handoff"
+        - bot_uttered:
+            utter_name: "utter_ask_confirm_human_handoff"
+            buttons:
+              - payload: "/SetSlots(confirm_human_handoff=Yes)"
+                title: "Yes"
+              - payload: "/SetSlots(confirm_human_handoff=No)"
+                title: "No"
+    - user: "/SetSlots(confirm_human_handoff=Yes)"
+      assertions:
+        - slot_was_set:
+            - name: "confirm_human_handoff"
+              value: "Yes"
+        - bot_uttered:
+            utter_name: "utter_transferring_to_human"
+        - action_executed: action_human_handoff
+# ====================================================>
+  - test_case: human handoff unhappy path
+    steps:
+    - user: "I would like to speak with a human"
+      assertions:
+        - flow_started: "human_handoff"
+        - bot_uttered:
+            utter_name: "utter_ask_confirm_human_handoff"
+            buttons:
+              - payload: "/SetSlots(confirm_human_handoff=Yes)"
+                title: "Yes"
+              - payload: "/SetSlots(confirm_human_handoff=No)"
+                title: "No"
+    - user: "/SetSlots(confirm_human_handoff=No)"
+      assertions:
+        - slot_was_set:
+            - name: "confirm_human_handoff"
+              value: "No"
+        - bot_uttered:
+            utter_name: "utter_human_handoff_cancelled"

rasa/cli/project_templates/basic/tests/e2e_test_cases/without_stub/general/patterns.yml

@@ -0,0 +1,32 @@
+test_cases:
+- test_case: test pattern session start
+  steps:
+    - user: "/session_start"
+      assertions:
+        - flow_started: "pattern_session_start"
+        - bot_uttered:
+            utter_name: "utter_welcome"
+#
+- test_case: test basic conversation flow
+  steps:
+    - user: "hello"
+      assertions:
+        - flow_started: "hello"
+        - bot_uttered:
+            utter_name: "utter_hello"
+    - user: "what can you help me with?"
+      assertions:
+        - flow_started: "help"
+        - bot_uttered:
+            utter_name: "utter_what_can_you_do"
+    - user: "show me faqs"
+      assertions:
+        - flow_started: "show_faqs"
+        - bot_uttered:
+            utter_name: "utter_top_faqs"
+    - user: "goodbye"
+      assertions:
+        - flow_started: "goodbye_flow"
+        - bot_uttered:
+            utter_name: "utter_goodbye"
+        - flow_started: "leave_feedback"

rasa/cli/project_templates/basic/tests/e2e_test_cases/without_stub/general/show_faqs.yml

@@ -0,0 +1,8 @@
+test_cases:
+  - test_case: show faqs
+    steps:
+    - user: "show me the faqs"
+      assertions:
+        - flow_started: "show_faqs"
+        - bot_uttered:
+            utter_name: "utter_top_faqs"

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

@@ -69,5 +69,5 @@ flows:
               #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
+      - action: utter_communicate_run_diagnostics
+      - action: actions_run_speed_test

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

@@ -14,7 +14,7 @@ responses:
     - text: |
         I see.
         Let me try to identify the root cause of the issue you are facing.
-  utter_communicate_run_diagnosticss:
+  utter_communicate_run_diagnostics:
     - text: |
         I will run a network diagnostics for you 🛜
         Wait a moment please...
@@ -72,4 +72,3 @@ responses:
 actions:
   - actions_run_speed_test
   - action_sleep_few_sec
-

rasa/cli/project_templates/telco/tests/e2e_test_cases/with_stub/network/solve_internet_not_slow.yml

@@ -0,0 +1,33 @@
+stub_custom_actions:
+  actions_run_speed_test:
+    events:
+      - event: slot
+        name: network_speed
+        value: 150.0
+    responses:
+      - text: "Thank you for waiting... ✅ "
+  action_sleep_few_sec:
+    events: []
+    responses: []
+
+test_cases:
+  - test_case: Solving Internet issue not slow
+    steps:
+      - user: "Hey, my internet is very slow. What's going on?"
+        assertions:
+          - flow_started: "fix_internet_slow"
+          - bot_uttered:
+              utter_name: "utter_acknowledge_issue"
+          - action_executed: action_sleep_few_sec
+          - flow_started: "run_diagnostics"
+          - bot_uttered:
+              utter_name: "utter_speed_network_not_issue"
+          - action_executed: "actions_run_speed_test"
+          - bot_uttered:
+              utter_name: "utter_propose_other_solutions"
+          - action_executed: "action_sleep_few_sec"
+          - bot_uttered:
+              utter_name: "utter_ask_more_help_needed"
+      - user: "/SetSlots(more_help_needed=True)"
+        assertions:
+          - flow_started: "human_handoff"

rasa/cli/project_templates/telco/tests/e2e_test_cases/with_stub/network/solve_internet_slow.yml

@@ -0,0 +1,47 @@
+stub_custom_actions:
+  actions_run_speed_test:
+    events:
+      - event: slot
+        name: network_speed
+        value: 50.0
+    responses:
+      - text: "Thank you for waiting... ✅ "
+  action_sleep_few_sec:
+    events: []
+    responses: []
+
+test_cases:
+  - test_case: Solving Internet slow issue
+    steps:
+      - user: "Hey, my internet is very slow. What's going on?"
+        assertions:
+          - flow_started: "fix_internet_slow"
+          - bot_uttered:
+              utter_name: "utter_acknowledge_issue"
+          - action_executed: action_sleep_few_sec
+          - flow_started: "run_diagnostics"
+          - bot_uttered:
+              utter_name: "utter_communicate_run_diagnostics"
+          - action_executed: "actions_run_speed_test"
+          - bot_uttered:
+              utter_name: "utter_acknowledge_speed_test_not_good"
+          - action_executed: "action_sleep_few_sec"
+          - bot_uttered:
+              utter_name: "utter_propose_reboot_router_solution"
+          - action_executed: "action_sleep_few_sec"
+          - flow_started: "reboot_router"
+          - bot_uttered:
+              utter_name: "utter_explain_reboot_router"
+          - bot_uttered:
+              utter_name: "utter_ask_reboot_router"
+              buttons:
+                - title: "Done"
+                  payload: "/SetSlots(reboot_router=True)"
+                - title: "Facing a problem"
+                  payload: "/SetSlots(reboot_router=False)"
+      - user: "/SetSlots(reboot_router=False)"
+        assertions:
+          - slot_was_set:
+              - name: "reboot_router"
+                value: False
+          - flow_started: "human_handoff"

rasa/cli/project_templates/telco/tests/e2e_test_cases/without_stub/general/hello.yml

@@ -0,0 +1,8 @@
+test_cases:
+  - test_case: hello
+    steps:
+    - user: "hello"
+      assertions:
+        - flow_started: "hello"
+        - bot_uttered:
+            utter_name: "utter_hello"

rasa/cli/run.py

@@ -88,7 +88,7 @@ def run(args: argparse.Namespace) -> None:
     """
     Configuration.initialise_endpoints(
         args.endpoints,
-    ).initialise_credentials(
+    ).initialise_sub_agents(args.sub_agents).initialise_credentials(
         args.credentials,
     )
 
@@ -108,7 +108,6 @@ def run(args: argparse.Namespace) -> None:
     # configured
 
     import rasa.model
-    from rasa.core.available_agents import AvailableAgents
 
     # start server if remote storage is configured
     if args.remote_storage is not None:
@@ -122,9 +121,6 @@ def run(args: argparse.Namespace) -> None:
         rasa_run(**vars(args))
         return
 
-    # load sub-agents
-    AvailableAgents.get_instance(args.sub_agents)
-
     # start server if local model found
     args.model = _validate_model_path(args.model, "model", DEFAULT_MODELS_PATH)
     local_model_set = True

rasa/cli/shell.py

@@ -115,6 +115,7 @@ def shell(args: argparse.Namespace) -> None:
     # it can be used safely throughout the codebase with
     # `Configuration.get_instance().endpoints`
     Configuration.initialise_endpoints(endpoints_path=Path(args.endpoints))
+    Configuration.initialise_sub_agents(args.sub_agents)
     model = get_validated_path(args.model, "model", DEFAULT_MODELS_PATH)
 
     try:

rasa/cli/train.py

@@ -128,6 +128,7 @@ def run_training(args: argparse.Namespace, can_exit: bool = False) -> Optional[T
     # Validates and loads endpoints with proper endpoint file location
     # TODO(Radovan): this should be probably be done in Configuration
     _check_nlg_endpoint_validity(args.endpoints)
+    Configuration.initialise_sub_agents(args.sub_agents)
 
     training_files = [
         get_validated_path(f, "data", DEFAULT_DATA_PATH, none_is_valid=True)

rasa/cli/validation/bot_config.py

@@ -5,6 +5,7 @@ from typing import TYPE_CHECKING, Optional
 import structlog
 
 from rasa import telemetry
+from rasa.core.constants import DEFAULT_SUB_AGENTS
 from rasa.exceptions import ValidationError
 from rasa.shared.importers.importer import TrainingDataImporter
 from rasa.shared.utils.common import display_research_study_prompt
@@ -194,8 +195,12 @@ def validate_files(
             valid_translations = True
         valid_CALM_slot_mappings = validator.validate_CALM_slot_mappings()
 
-        # Validate sub-agents if specified
-        valid_sub_agents = _validate_sub_agents(sub_agents) if sub_agents else True
+        # Validate sub-agents
+        sub_agents_path = sub_agents or DEFAULT_SUB_AGENTS
+        valid_sub_agents = _validate_sub_agents(sub_agents_path)
+
+        if valid_sub_agents:
+            valid_sub_agents = validator.validate_agent_flow_conflicts(sub_agents_path)
 
         all_good = (
             valid_domain