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

rasa/builder/copilot/prompts/copilot_system_prompt.jinja2

@@ -86,9 +86,9 @@ and panels.
 ***
 
 ## Layout
-- **Left Panel – Copilot Chat:** Where the user asks you for help, guidance, or troubleshooting.
-- **Center Panel – Playground Preview:** Main workspace with Chat Mode (default) or Inspect Mode.
-- **Right Panel – Inspector Visualization:** Real-time diagram of conversation logic (only in Inspect Mode).
+- **Left Panel - Copilot Chat:** Where the user asks you for help, guidance, or troubleshooting.
+- **Center Panel - Playground Preview:** Main workspace with Chat Mode (default) or Inspect Mode.
+- **Right Panel - Inspector Visualization:** Real-time diagram of conversation logic (only in Inspect Mode).
 
 ***
 
@@ -140,19 +140,40 @@ response.
 
 ***
 
+### 5. Sharing Attachments
+
+Users can share additional context with Copilot by clicking the "Ask Copilot" button
+while "Inspect Mode" is open. This sends selected conversation state as an attachment
+together with their question.
+
+The attachments are typically tracker events, which can be:
+- User messages - what the user typed or said.
+- Assistant messages - what the assistant responded with.
+- Actions - operations the assistant executed, including how they were chosen.
+- Slots - what slots were set or updated during the exchange.
+- Flows - when a flow starts, is interrupted, resumes, or completes.
+- Sessions - the beginning or end of a conversation session.
+
+**Tip:** Encourage users to use attachments to get to know the Rasa workings better. If 
+user is facing issues, these attachments will give Copilot a ground-truth trace of what
+actually happened in the assistant, making attachments a powerful tool for debugging.
+
+***
+
 ## Rasa CLI to Hello Rasa UI Mapping
 
 Map available features to **Rasa CLI** to the **Hello Rasa Action**, so users see
 continuity. 
 
-| Feature              | Rasa CLI          | Hello Rasa Action         |
-|----------------------|-----------------------|---------------------------|
-| Train assistant      | `rasa train`          | Apply Changes             |
-| Test conversation    | `rasa shell`          | Chat Mode                 |
-| Debug conversation   | `rasa shell --debug`  | Inspect Mode              |
-| Run custom actions   | `rasa run actions`    | Code Mode + Apply Changes |
-| Export project files | —                     | Download button           |
-| Edit project files   | —                     | Code Mode                 |
+| Feature                  | Rasa CLI              | Hello Rasa Action                  |
+|--------------------------|-----------------------|------------------------------------|
+| Train assistant          | `rasa train`          | Apply Changes                      |
+| Test conversation        | `rasa shell`          | Chat Mode                          |
+| Debug conversation       | `rasa shell --debug`  | Inspect Mode                       |
+| Run custom actions       | `rasa run actions`    | Code Mode + Apply Changes          |
+| Export project files     | —                     | Download button                    |
+| Edit project files       | —                     | Code Mode                          |
+| Share conversation trace | `rasa shell --debug`  | Ask Copilot button in Inspect Mode |
 
 **Note:** Ignore any references to *Rasa Studio*.
 
@@ -181,7 +202,7 @@ code change, or reference). It should be:
 - **Friendly, but Focused**: Use a warm and conversational style, but stay precise and technically correct.  
 - **Confident & Trustworthy**: Present guidance as clear and reliable; avoid hedging unless there's genuine uncertainty (in which case, ask clarifying questions).
 - **Brand-Positive**: Highlight the strengths of **Rasa** and **Hello Rasa**, when appropriate, framing them as powerful and easy to use.
-- **Code-style references** – You MUST wrap all flow names, slot names, variables, and any part of the user's code in backticks (e.g., `slot_name`, `flow_name`, `variable_name`). This is mandatory formatting.
+- **Code-style references**: You MUST wrap all flow names, slot names, variables, and any part of the user's code in backticks (e.g., `slot_name`, `flow_name`, `variable_name`). This is mandatory formatting.
 
 ***
 

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/copilot/templated_messages/copilot_templated_responses.yml

@@ -36,3 +36,6 @@ responses:
   guardrail_blocked_project_response: |
     Your Copilot access has been temporarily blocked due to repeated policy violations.
     If you believe this is an error or would like to request a review, please reach out to support@rasa.com.
+
+  training_success_response: |
+    Your changes have been saved successfully.

rasa/builder/copilot/templated_messages/copilot_welcome_messages.yml

@@ -0,0 +1,56 @@
+welcome_messages:
+  copilot_intro: |
+    👋 Welcome to Hello Rasa!
+
+    I'm your **Copilot** — here to help you explore Rasa and start customizing your agent.
+    You can ask me how your agent works, how to add new skills, or how to connect integrations.
+
+  finance: |
+    👋 Welcome to Hello Rasa!
+
+    I'm your **Copilot** — here to help you explore Rasa and start customizing your agent.
+    You can ask me how your agent works, how to add new skills, or how to connect integrations.
+
+    Your **Banking Agent template** is now live.
+
+    ### ▶️ **First step: try it out**
+    Ask your agent (in the chat preview on the right):
+    - *What's my current balance?*
+    - *Send 100 dollars to James.*
+
+  telco: |
+    👋 Welcome to Hello Rasa!
+
+    I'm your **Copilot** — here to help you explore Rasa and start customizing your agent.
+    You can ask me how your agent works, how to add new skills, or how to connect integrations.
+
+    Your **Telecom Support Agent template** is now live.
+
+    ### ▶️ **First step: try it out**
+    Ask your agent (in the chat preview on the right):
+    - *Why is my internet slow?*
+    - *How do i reboot my router?*
+
+  basic: |
+    👋 Welcome to Hello Rasa!
+
+    I'm your **Copilot** — here to help you explore Rasa and start customizing your agent.
+    You can ask me how your agent works, how to add new skills, or how to connect integrations.
+
+    Your **Starter Agent template** is now live.
+
+    ### ▶️ **First step: try it out**
+    Ask your agent (in the chat preview on the right):
+    - *What can you do?*
+    - *Can I talk to a human?*
+
+  prompt_to_bot: |
+    👋 Welcome to Hello Rasa!
+
+    I'm your **Copilot** — here to help you explore Rasa and start customizing your agent.
+    You can ask me how your agent works, how to add new skills, or how to connect integrations.
+
+    Your custom agent has been created and trained successfully.
+
+    ### ▶️ **First step: try it out**
+    Test your agent in the chat preview on the right to see how it responds to your users.

rasa/builder/jobs.py

@@ -4,6 +4,13 @@ import structlog
 from sanic import Sanic
 
 from rasa.builder import config
+from rasa.builder.copilot.constants import (
+    PROMPT_TO_BOT_KEY,
+)
+from rasa.builder.copilot.copilot_templated_message_provider import (
+    load_copilot_handler_default_responses,
+    load_copilot_welcome_messages,
+)
 from rasa.builder.copilot.models import (
     CopilotContext,
     FileContent,
@@ -80,11 +87,20 @@ async def run_prompt_to_bot_job(
         update_agent(agent, app)
         await push_job_status_event(job, JobStatus.train_success)
 
+        # 3. Create copilot welcome message job
+        copilot_welcome_job = job_manager.create_job()
+        app.add_task(run_copilot_welcome_message_job(app, copilot_welcome_job))
+
         structlogger.info(
             "bot_builder_service.prompt_to_bot.success",
             files_generated=list(bot_files.keys()),
+            copilot_welcome_job_id=copilot_welcome_job.id,
+        )
+        await push_job_status_event(
+            job=job,
+            status=JobStatus.done,
+            payload={"copilot_welcome_job_id": copilot_welcome_job.id},
         )
-        await push_job_status_event(job, JobStatus.done)
         job_manager.mark_done(job)
 
     except TrainingError as exc:
@@ -165,12 +181,23 @@ async def run_template_to_bot_job(
         update_agent(agent, app)
         await push_job_status_event(job, JobStatus.train_success)
 
-        # 3) Done
+        # 3) Create copilot welcome message job
+        copilot_welcome_job = job_manager.create_job()
+        app.add_task(
+            run_copilot_welcome_message_job(app, copilot_welcome_job, template_name)
+        )
+
+        # 4) Done - include welcome job ID in payload
         structlogger.info(
             "bot_builder_service.template_to_bot.success",
             files_generated=list(bot_files.keys()),
+            copilot_welcome_job_id=copilot_welcome_job.id,
+        )
+        await push_job_status_event(
+            job=job,
+            status=JobStatus.done,
+            payload={"copilot_welcome_job_id": copilot_welcome_job.id},
         )
-        await push_job_status_event(job, JobStatus.done)
         job_manager.mark_done(job)
 
     except TrainingError as exc:
@@ -256,8 +283,19 @@ async def run_replace_all_files_job(
         update_agent(agent, app)
         await push_job_status_event(job, JobStatus.train_success)
 
-        # Send final done event
-        await push_job_status_event(job, JobStatus.done)
+        # Send final done event with copilot training success response job ID
+        copilot_training_success_job = job_manager.create_job()
+        app.add_task(
+            run_copilot_training_success_job(app, copilot_training_success_job)
+        )
+
+        await push_job_status_event(
+            job=job,
+            status=JobStatus.done,
+            payload={
+                "copilot_training_success_job_id": copilot_training_success_job.id
+            },
+        )
         job_manager.mark_done(job)
 
     except ValidationError as exc:
@@ -450,3 +488,122 @@ async def run_copilot_training_error_analysis_job(
             job, JobStatus.copilot_analysis_error, message=str(exc)
         )
         job_manager.mark_done(job, error=str(exc))
+
+
+async def run_copilot_welcome_message_job(
+    app: "Sanic",
+    job: JobInfo,
+    template_name: Optional[ProjectTemplateName] = None,
+) -> None:
+    """Run the welcome message job in the background.
+
+    This job sends a welcome message to the user after successful bot creation.
+    For template-based bots, it sends a predefined message.
+    For prompt-based bots, it can be extended to stream generated messages.
+
+    Args:
+        app: The Sanic application instance.
+        job: The job information instance.
+        template_name: The template name for template-based bots, None for prompt-based.
+    """
+    try:
+        # Load welcome messages from YAML
+        welcome_messages = load_copilot_welcome_messages()
+
+        # Get the appropriate welcome message
+        if template_name:
+            welcome_message = welcome_messages.get(
+                template_name.value,
+                welcome_messages.get(PROMPT_TO_BOT_KEY),
+            )
+        else:
+            welcome_message = welcome_messages.get(PROMPT_TO_BOT_KEY)
+
+        # Send the welcome message as a single event
+        await push_job_status_event(
+            job,
+            JobStatus.copilot_welcome_message,
+            payload={
+                "content": welcome_message,
+                "response_category": "copilot",
+                "completeness": "complete",
+            },
+        )
+
+        # Mark job as done
+        await push_job_status_event(job, JobStatus.done)
+        job_manager.mark_done(job)
+
+        structlogger.info(
+            "copilot_welcome_message_job.success",
+            job_id=job.id,
+            template=template_name.value if template_name else PROMPT_TO_BOT_KEY,
+        )
+
+    except Exception as exc:
+        structlogger.exception(
+            "welcome_message_job.error",
+            job_id=job.id,
+            error=str(exc),
+        )
+        await push_job_status_event(job, JobStatus.error, message=str(exc))
+        job_manager.mark_done(job, error=str(exc))
+
+
+async def run_copilot_training_success_job(
+    app: "Sanic",
+    job: JobInfo,
+) -> None:
+    """Run the training success job in the background.
+
+    This job sends a training success message to the user after successful bot training.
+
+    Args:
+        app: The Sanic application instance.
+        job: The job information instance.
+    """
+    try:
+        # Load copilot default messages from YAML
+        internal_messages = load_copilot_handler_default_responses()
+
+        # Get the appropriate training success message
+        training_success_message = internal_messages.get("training_success_response")
+
+        # Send the training success message
+        await push_job_status_event(
+            job,
+            JobStatus.train_success_message,
+            payload={
+                "content": training_success_message,
+                "response_category": "copilot",
+                "completeness": "complete",
+            },
+        )
+
+        # Send the training success category
+        await push_job_status_event(
+            job,
+            JobStatus.train_success_message,
+            payload={
+                "response_category": "copilot_training_success",
+                "completeness": "complete",
+            },
+        )
+
+        # Mark job as done
+        await push_job_status_event(job, JobStatus.done)
+        job_manager.mark_done(job)
+
+        structlogger.info(
+            "copilot_training_success_job.success",
+            job_id=job.id,
+        )
+
+    except Exception as exc:
+        structlogger.exception(
+            "copilot_training_success_job.error",
+            job_id=job.id,
+            error=str(exc),
+        )
+        await push_job_status_event(job, JobStatus.error, message=str(exc))
+        job_manager.mark_done(job, error=str(exc))

rasa/builder/models.py

@@ -191,6 +191,7 @@ class JobStatus(str, Enum):
 
     training = "training"
     train_success = "train_success"
+    train_success_message = "train_success_message"
     train_error = "train_error"
 
     validating = "validating"
@@ -202,6 +203,8 @@ class JobStatus(str, Enum):
     copilot_analysis_success = "copilot_analysis_success"
     copilot_analysis_error = "copilot_analysis_error"
 
+    copilot_welcome_message = "copilot_welcome_message"
+
 
 class JobCreateResponse(BaseModel):
     job_id: str = Field(...)

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"