rasa-pro 3.13.7__py3-none-any.whl → 3.14.0.dev2__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.


This version of rasa-pro might be problematic. Click here for more details.

Files changed (179) hide show
  1. rasa/agents/__init__.py +0 -0
  2. rasa/agents/agent_factory.py +122 -0
  3. rasa/agents/agent_manager.py +162 -0
  4. rasa/agents/constants.py +31 -0
  5. rasa/agents/core/__init__.py +0 -0
  6. rasa/agents/core/agent_protocol.py +108 -0
  7. rasa/agents/core/types.py +70 -0
  8. rasa/agents/exceptions.py +8 -0
  9. rasa/agents/protocol/__init__.py +5 -0
  10. rasa/agents/protocol/a2a/__init__.py +0 -0
  11. rasa/agents/protocol/a2a/a2a_agent.py +51 -0
  12. rasa/agents/protocol/mcp/__init__.py +0 -0
  13. rasa/agents/protocol/mcp/mcp_base_agent.py +697 -0
  14. rasa/agents/protocol/mcp/mcp_open_agent.py +275 -0
  15. rasa/agents/protocol/mcp/mcp_task_agent.py +447 -0
  16. rasa/agents/schemas/__init__.py +6 -0
  17. rasa/agents/schemas/agent_input.py +24 -0
  18. rasa/agents/schemas/agent_output.py +26 -0
  19. rasa/agents/schemas/agent_tool_result.py +51 -0
  20. rasa/agents/schemas/agent_tool_schema.py +112 -0
  21. rasa/agents/templates/__init__.py +0 -0
  22. rasa/agents/templates/mcp_open_agent_prompt_template.jinja2 +15 -0
  23. rasa/agents/templates/mcp_task_agent_prompt_template.jinja2 +13 -0
  24. rasa/agents/utils.py +72 -0
  25. rasa/api.py +5 -0
  26. rasa/cli/arguments/default_arguments.py +12 -0
  27. rasa/cli/arguments/run.py +2 -0
  28. rasa/cli/dialogue_understanding_test.py +4 -0
  29. rasa/cli/e2e_test.py +4 -0
  30. rasa/cli/inspect.py +3 -0
  31. rasa/cli/llm_fine_tuning.py +5 -0
  32. rasa/cli/run.py +4 -0
  33. rasa/cli/shell.py +3 -0
  34. rasa/cli/train.py +2 -2
  35. rasa/constants.py +6 -0
  36. rasa/core/actions/action.py +69 -39
  37. rasa/core/actions/action_run_slot_rejections.py +1 -1
  38. rasa/core/agent.py +16 -0
  39. rasa/core/available_agents.py +196 -0
  40. rasa/core/available_endpoints.py +30 -0
  41. rasa/core/channels/development_inspector.py +47 -14
  42. rasa/core/channels/inspector/dist/assets/{arc-0b11fe30.js → arc-2e78c586.js} +1 -1
  43. rasa/core/channels/inspector/dist/assets/{blockDiagram-38ab4fdb-9eef30a7.js → blockDiagram-38ab4fdb-806b712e.js} +1 -1
  44. rasa/core/channels/inspector/dist/assets/{c4Diagram-3d4e48cf-03e94f28.js → c4Diagram-3d4e48cf-0745efa9.js} +1 -1
  45. rasa/core/channels/inspector/dist/assets/channel-c436ca7c.js +1 -0
  46. rasa/core/channels/inspector/dist/assets/{classDiagram-70f12bd4-95c09eba.js → classDiagram-70f12bd4-7bd1082b.js} +1 -1
  47. rasa/core/channels/inspector/dist/assets/{classDiagram-v2-f2320105-38e8446c.js → classDiagram-v2-f2320105-d937ba49.js} +1 -1
  48. rasa/core/channels/inspector/dist/assets/clone-50dd656b.js +1 -0
  49. rasa/core/channels/inspector/dist/assets/{createText-2e5e7dd3-57dc3038.js → createText-2e5e7dd3-a2a564ca.js} +1 -1
  50. rasa/core/channels/inspector/dist/assets/{edges-e0da2a9e-4bac0545.js → edges-e0da2a9e-b5256940.js} +1 -1
  51. rasa/core/channels/inspector/dist/assets/{erDiagram-9861fffd-81795c90.js → erDiagram-9861fffd-e6883ad2.js} +1 -1
  52. rasa/core/channels/inspector/dist/assets/{flowDb-956e92f1-89489ae6.js → flowDb-956e92f1-e576fc02.js} +1 -1
  53. rasa/core/channels/inspector/dist/assets/{flowDiagram-66a62f08-cd152627.js → flowDiagram-66a62f08-2e298d01.js} +1 -1
  54. rasa/core/channels/inspector/dist/assets/flowDiagram-v2-96b9c2cf-2b2aeaf8.js +1 -0
  55. rasa/core/channels/inspector/dist/assets/{flowchart-elk-definition-4a651766-3da369bc.js → flowchart-elk-definition-4a651766-dd7b150a.js} +1 -1
  56. rasa/core/channels/inspector/dist/assets/{ganttDiagram-c361ad54-85ec16f8.js → ganttDiagram-c361ad54-5b79575c.js} +1 -1
  57. rasa/core/channels/inspector/dist/assets/{gitGraphDiagram-72cf32ee-495bc140.js → gitGraphDiagram-72cf32ee-3016f40a.js} +1 -1
  58. rasa/core/channels/inspector/dist/assets/{graph-1ec4d266.js → graph-3e19170f.js} +1 -1
  59. rasa/core/channels/inspector/dist/assets/index-1bd9135e.js +1353 -0
  60. rasa/core/channels/inspector/dist/assets/{index-3862675e-0a0e97c9.js → index-3862675e-eb9c86de.js} +1 -1
  61. rasa/core/channels/inspector/dist/assets/{infoDiagram-f8f76790-4d54bcde.js → infoDiagram-f8f76790-b4280e4d.js} +1 -1
  62. rasa/core/channels/inspector/dist/assets/{journeyDiagram-49397b02-dc097114.js → journeyDiagram-49397b02-556091f8.js} +1 -1
  63. rasa/core/channels/inspector/dist/assets/{layout-1a08981e.js → layout-08436411.js} +1 -1
  64. rasa/core/channels/inspector/dist/assets/{line-95f7f1d3.js → line-683c4f3b.js} +1 -1
  65. rasa/core/channels/inspector/dist/assets/{linear-97e69543.js → linear-cee6d791.js} +1 -1
  66. rasa/core/channels/inspector/dist/assets/{mindmap-definition-fc14e90a-8c71ff03.js → mindmap-definition-fc14e90a-a0bf0b1a.js} +1 -1
  67. rasa/core/channels/inspector/dist/assets/{pieDiagram-8a3498a8-f14c71c7.js → pieDiagram-8a3498a8-3730d5c4.js} +1 -1
  68. rasa/core/channels/inspector/dist/assets/{quadrantDiagram-120e2f19-f1d3c9ff.js → quadrantDiagram-120e2f19-12a20fed.js} +1 -1
  69. rasa/core/channels/inspector/dist/assets/{requirementDiagram-deff3bca-bfa2412f.js → requirementDiagram-deff3bca-b9732102.js} +1 -1
  70. rasa/core/channels/inspector/dist/assets/{sankeyDiagram-04a897e0-53f2c97b.js → sankeyDiagram-04a897e0-a2e72776.js} +1 -1
  71. rasa/core/channels/inspector/dist/assets/{sequenceDiagram-704730f1-319d7c0e.js → sequenceDiagram-704730f1-8b7a76bb.js} +1 -1
  72. rasa/core/channels/inspector/dist/assets/{stateDiagram-587899a1-76a09418.js → stateDiagram-587899a1-e65853ac.js} +1 -1
  73. rasa/core/channels/inspector/dist/assets/{stateDiagram-v2-d93cdb3a-a67f15d4.js → stateDiagram-v2-d93cdb3a-6f58a44b.js} +1 -1
  74. rasa/core/channels/inspector/dist/assets/{styles-6aaf32cf-0654e7c3.js → styles-6aaf32cf-df25b934.js} +1 -1
  75. rasa/core/channels/inspector/dist/assets/{styles-9a916d00-1394bb9d.js → styles-9a916d00-88357141.js} +1 -1
  76. rasa/core/channels/inspector/dist/assets/{styles-c10674c1-e4c5bdae.js → styles-c10674c1-d600174d.js} +1 -1
  77. rasa/core/channels/inspector/dist/assets/{svgDrawCommon-08f97a94-50957104.js → svgDrawCommon-08f97a94-4adc3e0b.js} +1 -1
  78. rasa/core/channels/inspector/dist/assets/{timeline-definition-85554ec2-b0885a6a.js → timeline-definition-85554ec2-42816fa1.js} +1 -1
  79. rasa/core/channels/inspector/dist/assets/{xychartDiagram-e933f94c-79e6541a.js → xychartDiagram-e933f94c-621eb66a.js} +1 -1
  80. rasa/core/channels/inspector/dist/index.html +2 -2
  81. rasa/core/channels/inspector/index.html +1 -1
  82. rasa/core/channels/inspector/src/App.tsx +53 -7
  83. rasa/core/channels/inspector/src/components/Chat.tsx +3 -2
  84. rasa/core/channels/inspector/src/components/DiagramFlow.tsx +1 -1
  85. rasa/core/channels/inspector/src/components/DialogueStack.tsx +7 -5
  86. rasa/core/channels/inspector/src/components/LatencyDisplay.tsx +268 -0
  87. rasa/core/channels/inspector/src/components/LoadingSpinner.tsx +6 -2
  88. rasa/core/channels/inspector/src/helpers/audio/audiostream.ts +8 -3
  89. rasa/core/channels/inspector/src/helpers/formatters.ts +24 -3
  90. rasa/core/channels/inspector/src/theme/base/styles.ts +19 -1
  91. rasa/core/channels/inspector/src/types.ts +12 -0
  92. rasa/core/channels/studio_chat.py +125 -34
  93. rasa/core/channels/voice_ready/twilio_voice.py +1 -1
  94. rasa/core/channels/voice_stream/audiocodes.py +9 -6
  95. rasa/core/channels/voice_stream/browser_audio.py +39 -4
  96. rasa/core/channels/voice_stream/call_state.py +13 -2
  97. rasa/core/channels/voice_stream/genesys.py +16 -13
  98. rasa/core/channels/voice_stream/jambonz.py +13 -11
  99. rasa/core/channels/voice_stream/twilio_media_streams.py +14 -13
  100. rasa/core/channels/voice_stream/util.py +11 -1
  101. rasa/core/channels/voice_stream/voice_channel.py +101 -29
  102. rasa/core/constants.py +4 -0
  103. rasa/core/nlg/contextual_response_rephraser.py +11 -7
  104. rasa/core/nlg/generator.py +21 -5
  105. rasa/core/nlg/response.py +43 -6
  106. rasa/core/nlg/translate.py +8 -0
  107. rasa/core/policies/enterprise_search_policy.py +4 -2
  108. rasa/core/policies/flow_policy.py +2 -2
  109. rasa/core/policies/flows/flow_executor.py +374 -35
  110. rasa/core/policies/flows/mcp_tool_executor.py +240 -0
  111. rasa/core/processor.py +6 -1
  112. rasa/core/run.py +8 -1
  113. rasa/core/utils.py +21 -1
  114. rasa/dialogue_understanding/commands/__init__.py +8 -0
  115. rasa/dialogue_understanding/commands/cancel_flow_command.py +97 -4
  116. rasa/dialogue_understanding/commands/chit_chat_answer_command.py +11 -0
  117. rasa/dialogue_understanding/commands/clarify_command.py +10 -0
  118. rasa/dialogue_understanding/commands/continue_agent_command.py +91 -0
  119. rasa/dialogue_understanding/commands/knowledge_answer_command.py +11 -0
  120. rasa/dialogue_understanding/commands/restart_agent_command.py +162 -0
  121. rasa/dialogue_understanding/commands/start_flow_command.py +129 -8
  122. rasa/dialogue_understanding/commands/utils.py +6 -2
  123. rasa/dialogue_understanding/generator/command_parser.py +4 -0
  124. rasa/dialogue_understanding/generator/llm_based_command_generator.py +50 -12
  125. rasa/dialogue_understanding/generator/prompt_templates/agent_command_prompt_v2_claude_3_5_sonnet_20240620_template.jinja2 +61 -0
  126. rasa/dialogue_understanding/generator/prompt_templates/agent_command_prompt_v2_gpt_4o_2024_11_20_template.jinja2 +61 -0
  127. rasa/dialogue_understanding/generator/prompt_templates/agent_command_prompt_v3_claude_3_5_sonnet_20240620_template.jinja2 +81 -0
  128. rasa/dialogue_understanding/generator/prompt_templates/agent_command_prompt_v3_gpt_4o_2024_11_20_template.jinja2 +81 -0
  129. rasa/dialogue_understanding/generator/single_step/compact_llm_command_generator.py +7 -6
  130. rasa/dialogue_understanding/generator/single_step/search_ready_llm_command_generator.py +7 -6
  131. rasa/dialogue_understanding/generator/single_step/single_step_based_llm_command_generator.py +41 -2
  132. rasa/dialogue_understanding/patterns/continue_interrupted.py +163 -1
  133. rasa/dialogue_understanding/patterns/default_flows_for_patterns.yml +51 -7
  134. rasa/dialogue_understanding/stack/dialogue_stack.py +123 -2
  135. rasa/dialogue_understanding/stack/frames/flow_stack_frame.py +57 -0
  136. rasa/dialogue_understanding/stack/utils.py +3 -2
  137. rasa/dialogue_understanding_test/du_test_runner.py +7 -2
  138. rasa/dialogue_understanding_test/du_test_schema.yml +3 -3
  139. rasa/e2e_test/e2e_test_runner.py +5 -0
  140. rasa/e2e_test/e2e_test_schema.yml +3 -3
  141. rasa/model_manager/model_api.py +1 -1
  142. rasa/model_manager/socket_bridge.py +8 -2
  143. rasa/server.py +10 -0
  144. rasa/shared/agents/__init__.py +0 -0
  145. rasa/shared/agents/utils.py +35 -0
  146. rasa/shared/constants.py +5 -0
  147. rasa/shared/core/constants.py +12 -1
  148. rasa/shared/core/domain.py +5 -5
  149. rasa/shared/core/events.py +319 -0
  150. rasa/shared/core/flows/flows_list.py +2 -2
  151. rasa/shared/core/flows/flows_yaml_schema.json +101 -186
  152. rasa/shared/core/flows/steps/call.py +51 -5
  153. rasa/shared/core/flows/validation.py +45 -7
  154. rasa/shared/core/flows/yaml_flows_io.py +3 -3
  155. rasa/shared/providers/llm/_base_litellm_client.py +39 -7
  156. rasa/shared/providers/llm/litellm_router_llm_client.py +8 -4
  157. rasa/shared/providers/llm/llm_client.py +7 -3
  158. rasa/shared/providers/llm/llm_response.py +49 -0
  159. rasa/shared/providers/llm/self_hosted_llm_client.py +8 -4
  160. rasa/shared/utils/common.py +2 -1
  161. rasa/shared/utils/llm.py +28 -5
  162. rasa/shared/utils/mcp/__init__.py +0 -0
  163. rasa/shared/utils/mcp/server_connection.py +157 -0
  164. rasa/shared/utils/schemas/events.py +42 -0
  165. rasa/studio/upload.py +4 -7
  166. rasa/tracing/instrumentation/instrumentation.py +4 -2
  167. rasa/utils/common.py +53 -0
  168. rasa/utils/licensing.py +21 -10
  169. rasa/utils/plotting.py +1 -1
  170. rasa/version.py +1 -1
  171. {rasa_pro-3.13.7.dist-info → rasa_pro-3.14.0.dev2.dist-info}/METADATA +16 -15
  172. {rasa_pro-3.13.7.dist-info → rasa_pro-3.14.0.dev2.dist-info}/RECORD +175 -138
  173. rasa/core/channels/inspector/dist/assets/channel-51d02e9e.js +0 -1
  174. rasa/core/channels/inspector/dist/assets/clone-cc738fa6.js +0 -1
  175. rasa/core/channels/inspector/dist/assets/flowDiagram-v2-96b9c2cf-0c716443.js +0 -1
  176. rasa/core/channels/inspector/dist/assets/index-c804b295.js +0 -1335
  177. {rasa_pro-3.13.7.dist-info → rasa_pro-3.14.0.dev2.dist-info}/NOTICE +0 -0
  178. {rasa_pro-3.13.7.dist-info → rasa_pro-3.14.0.dev2.dist-info}/WHEEL +0 -0
  179. {rasa_pro-3.13.7.dist-info → rasa_pro-3.14.0.dev2.dist-info}/entry_points.txt +0 -0
@@ -0,0 +1,81 @@
1
+ ## Task Description
2
+ Your task is to analyze the current conversation context and generate a list of actions to start new business processes that we call flows, to extract slots, or respond to off-topic and knowledge requests.
3
+
4
+ ---
5
+
6
+ ## Available Actions:
7
+ * `start flow flow_name`: Start a flow. For example, `start flow transfer_money` or `start flow list_contacts`.
8
+ * `set slot slot_name slot_value`: Set a slot for the active flow. For example, `set slot transfer_money_recipient Freddy`. Can be used to correct and change previously set values.
9
+ * `disambiguate flows flow_name1 flow_name2 ... flow_name_n`: When a message could refer to multiple flows, list the possible flows as options to clarify. Example: `disambiguate flows list_contacts add_contact remove_contact`.
10
+ * `search and reply`: Provide a response from the knowledge base to address the user's inquiry when no flows fit, including domain knowledge, FAQs, and all off-topic or social messages.
11
+ * `cancel flow`: Cancel the current flow if the user requests it.
12
+ * `repeat message`: Repeat the last bot message.
13
+ {% if active_agent %} * `continue agent`: Continue the currently active agent {{ active_agent.name }}.{% endif %}
14
+ {% if completed_agents %}* `restart agent agent_name`: Restart the agent with the given name, in case the user wants to change some answer to a previous question asked by the agent. For example, `restart agent car_research_agent` if the user chnaged his mind about the car he wants to buy.{% endif %}
15
+
16
+ ---
17
+
18
+ ## General Instructions
19
+ ### Start Flow
20
+ * Only start a flow if the user's message is clear and fully addressed by that flow's description and purpose.
21
+ * Pay close attention to exact wording and scope in the flow description — do not assume or “stretch” the intended use of a flow.
22
+ ### Set Slot
23
+ * Do not fill slots with abstract values or placeholders.
24
+ * For categorical slots, try to match the user message with allowed slot values. Use "other" if you cannot match it.
25
+ * Set the boolean slots based on the user's response. Map positive responses to `True`, and negative to `False`.
26
+ * Extract text slot values exactly as provided by the user. Avoid assumptions, format changes, or partial extractions.
27
+ ### Disambiguate Flows
28
+ * Use `disambiguate flows` when the user's message matches multiple flows and you cannot decide which flow is most appropriate.
29
+ * If the user message is short and not precise enough to start a flow or `search and reply`, disambiguate.
30
+ * If a single flow is a strong/plausible fit, prefer starting that flow directly.
31
+ * If a user's message unambiguously and distinctly matches multiple flows, start all relevant flows at once (rather than disambiguating).
32
+ ### Search and Reply
33
+ * Only start `search and reply` if the user intent is clear.
34
+ * Flow Priority: If you are unsure between starting a flow or `search and reply`, always prioritize starting a flow.
35
+ ### Cancel Flow
36
+ * Do not cancel any flow unless the user explicitly requests it.
37
+ * Multiple flows can be started without cancelling the previous, if the user wants to pursue multiple processes.
38
+ ### General Tips
39
+ * Only use information provided by the user.
40
+ * Strictly adhere to the provided action format.
41
+ * Focus on the last message and take it one step at a time.
42
+ * Use the previous conversation steps only to aid understanding.
43
+
44
+ ---
45
+
46
+ ## Decision Rule Table
47
+ | Condition | Action |
48
+ |-------------------------------------------------------|--------------------|
49
+ | Flow perfectly matches user's message | start flow |
50
+ | Multiple flows are equally strong, relevant matches | disambiguate flows |
51
+ | User's message is unclear or imprecise | disambiguate flows |
52
+ | No flow fits at all, but knowledge base may help | search and reply |
53
+
54
+ ---
55
+
56
+ ## Available Flows and Slots
57
+ Use the following structured data:
58
+ ```json
59
+ {"flows":[{% for flow in available_flows %}{"name":"{{ flow.name }}","description":{{ flow.description | to_json_escaped_string }}{% if flow.agent_info %},"sub-agents":[{% for agent in flow.agent_info %}{"name":"{{ agent.name }}","description":{{ agent.description | to_json_escaped_string }}}{% if not loop.last %},{% endif %}{% endfor %}]{% endif %}{% if flow.slots %},"slots":[{% for slot in flow.slots %}{"name":"{{ slot.name }}"{% if slot.description %},"description":{{ slot.description | to_json_escaped_string }}{% endif %}{% if slot.allowed_values %},"allowed_values":{{ slot.allowed_values }}{% endif %}}{% if not loop.last %},{% endif %}{% endfor %}]{% endif %}}{% if not loop.last %},{% endif %}{% endfor %}]}
60
+ ```
61
+
62
+ ---
63
+
64
+ ## Current State
65
+ {% if current_flow != None %}Use the following structured data:
66
+ ```json
67
+ {"active_flow": "{{ current_flow }}","current_step": {"requested_slot": "{{ current_slot }}","requested_slot_description": {{ current_slot_description | to_json_escaped_string }}},"slots": [{% for slot in flow_slots %}{"name": "{{ slot.name }}","value": "{{ slot.value }}","type": "{{ slot.type }}"{{ "," if slot.description or slot.allowed_values else "" }}{% if slot.description %}"description": {{ slot.description | to_json_escaped_string }}{{ "," if slot.allowed_values else "" }}{% endif %}{% if slot.allowed_values %}"allowed_values": "{{ slot.allowed_values }}"{% endif %}}{% if not loop.last %},{% endif %}{% endfor %}]{% if active_agent or completed_agents %},{% endif %}{% if active_agent %}"active_agent": {"name": "{{ active_agent.name }}","description": "{{ active_agent.description }}"}{% if completed_agents %},{% endif %}{% endif %}{% if completed_agents %}"completed_agents": [{% for agent in completed_agents %}{"name": "{{ agent.name }}","description": "{{ agent.description }}"}{% if not loop.last %},{% endif %}{% endfor %}]{% endif %}}
68
+ ```{% else %}
69
+ You are currently not inside any flow.{% endif %}
70
+
71
+ ---
72
+
73
+ ## Conversation History
74
+ {{ current_conversation }}
75
+
76
+ ---
77
+
78
+ ## Task
79
+ Create an action list with one action per line in response to the user's last message: """{{ user_message }}""".
80
+
81
+ Your action list:
@@ -0,0 +1,81 @@
1
+ ## Task Description
2
+ Your task is to analyze the current conversation context and generate a list of actions to start new business processes that we call flows, to extract slots, or respond to off-topic and knowledge requests.
3
+
4
+ ---
5
+
6
+ ## Available Flows and Slots
7
+ Use the following structured data:
8
+ ```json
9
+ {"flows":[{% for flow in available_flows %}{"name":"{{ flow.name }}","description":{{ flow.description | to_json_escaped_string }}{% if flow.agent_info %},"sub-agents":[{% for agent in flow.agent_info %}{"name":"{{ agent.name }}","description":{{ agent.description | to_json_escaped_string }}}{% if not loop.last %},{% endif %}{% endfor %}]{% endif %}{% if flow.slots %},"slots":[{% for slot in flow.slots %}{"name":"{{ slot.name }}"{% if slot.description %},"description":{{ slot.description | to_json_escaped_string }}{% endif %}{% if slot.allowed_values %},"allowed_values":{{ slot.allowed_values }}{% endif %}}{% if not loop.last %},{% endif %}{% endfor %}]{% endif %}}{% if not loop.last %},{% endif %}{% endfor %}]}
10
+ ```
11
+
12
+ ---
13
+
14
+ ## Available Actions:
15
+ * `start flow flow_name`: Start a flow. For example, `start flow transfer_money` or `start flow list_contacts`.
16
+ * `set slot slot_name slot_value`: Set a slot for the active flow. For example, `set slot transfer_money_recipient Freddy`. Can be used to correct and change previously set values.
17
+ * `disambiguate flows flow_name1 flow_name2 ... flow_name_n`: When a message could refer to multiple flows, list the possible flows as options to clarify. Example: `disambiguate flows list_contacts add_contact remove_contact`.
18
+ * `search and reply`: Provide a response from the knowledge base to address the user’s inquiry when no flows fit, including domain knowledge, FAQs, and all off-topic or social messages.
19
+ * `cancel flow`: Cancel the current flow if the user requests it.
20
+ * `repeat message`: Repeat the last bot message.
21
+ {% if active_agent %} * `continue agent`: Continue the currently active agent {{ active_agent.name }}.{% endif %}
22
+ {% if completed_agents %}* `restart agent agent_name`: Restart the agent with the given name, in case the user wants to change some answer to a previous question asked by the agent. For example, `restart agent car_research_agent` if the user chnaged his mind about the car he wants to buy.{% endif %}
23
+
24
+ ---
25
+
26
+ ## General Instructions
27
+ ### Start Flow
28
+ * Only start a flow if the user's message is clear and fully addressed by that flow's description and purpose.
29
+ * Pay close attention to exact wording and scope in the flow description — do not assume or “stretch” the intended use of a flow.
30
+ ### Set Slot
31
+ * Do not fill slots with abstract values or placeholders.
32
+ * For categorical slots try to match the user message with allowed slot values. Use "other" if you cannot match it.
33
+ * Set the boolean slots based on the user response. Map positive responses to `True`, and negative to `False`.
34
+ * Extract text slot values exactly as provided by the user. Avoid assumptions, format changes, or partial extractions.
35
+ ### Disambiguate Flows
36
+ * Use `disambiguate flows` when the user's message matches multiple flows and you cannot decide which flow is most appropriate.
37
+ * If the user message is short and not precise enough to start a flow or `search and reply`, disambiguate.
38
+ * If a single flow is a strong/plausible fit, prefer starting that flow directly.
39
+ * If a user's message unambiguously and distinctly matches multiple flows, start all relevant flows at once (rather than disambiguating).
40
+ ### Search and Reply
41
+ * Only start `search and reply` if the user intent is clear.
42
+ * Flow Priority: If you are unsure between starting a flow or `search and reply`, always prioritize starting a flow.
43
+ ### Cancel Flow
44
+ * Do not cancel any flow unless the user explicitly requests it.
45
+ * Multiple flows can be started without cancelling the previous, if the user wants to pursue multiple processes.
46
+ ### General Tips
47
+ * Only use information provided by the user.
48
+ * Strictly adhere to the provided action format.
49
+ * Focus on the last message and take it one step at a time.
50
+ * Use the previous conversation steps only to aid understanding.
51
+
52
+ ---
53
+
54
+ ## Decision Rule Table
55
+ | Condition | Action |
56
+ |-------------------------------------------------------|--------------------|
57
+ | Flow perfectly matches user's message | start flow |
58
+ | Multiple flows are equally strong, relevant matches | disambiguate flows |
59
+ | User's message is unclear or imprecise | disambiguate flows |
60
+ | No flow fits at all, but knowledge base may help | search and reply |
61
+
62
+ ---
63
+
64
+ ## Current State
65
+ {% if current_flow != None %}Use the following structured data:
66
+ ```json
67
+ {"active_flow": "{{ current_flow }}","current_step": {"requested_slot": "{{ current_slot }}","requested_slot_description": {{ current_slot_description | to_json_escaped_string }}},"slots": [{% for slot in flow_slots %}{"name": "{{ slot.name }}","value": "{{ slot.value }}","type": "{{ slot.type }}"{{ "," if slot.description or slot.allowed_values else "" }}{% if slot.description %}"description": {{ slot.description | to_json_escaped_string }}{{ "," if slot.allowed_values else "" }}{% endif %}{% if slot.allowed_values %}"allowed_values": "{{ slot.allowed_values }}"{% endif %}}{% if not loop.last %},{% endif %}{% endfor %}]{% if active_agent or completed_agents %},{% endif %}{% if active_agent %}"active_agent": {"name": "{{ active_agent.name }}","description": "{{ active_agent.description }}"}{% if completed_agents %},{% endif %}{% endif %}{% if completed_agents %}"completed_agents": [{% for agent in completed_agents %}{"name": "{{ agent.name }}","description": "{{ agent.description }}"}{% if not loop.last %},{% endif %}{% endfor %}]{% endif %}}
68
+ ```{% else %}
69
+ You are currently not inside any flow.{% endif %}
70
+
71
+ ---
72
+
73
+ ## Conversation History
74
+ {{ current_conversation }}
75
+
76
+ ---
77
+
78
+ ## Task
79
+ Create an action list with one action per line in response to the user's last message: """{{ user_message }}""".
80
+
81
+ Your action list:
@@ -45,29 +45,30 @@ DEFAULT_LLM_CONFIG = {
45
45
  TIMEOUT_CONFIG_KEY: 7,
46
46
  }
47
47
 
48
+ # TODO: only load the agent prompt template in cases where agents are actually used
48
49
  MODEL_PROMPT_MAPPER = {
49
50
  f"{OPENAI_PROVIDER}/{MODEL_NAME_GPT_4O_2024_11_20}": (
50
- "command_prompt_v2_gpt_4o_2024_11_20_template.jinja2"
51
+ "agent_command_prompt_v2_gpt_4o_2024_11_20_template.jinja2"
51
52
  ),
52
53
  f"{AZURE_OPENAI_PROVIDER}/{MODEL_NAME_GPT_4O_2024_11_20}": (
53
- "command_prompt_v2_gpt_4o_2024_11_20_template.jinja2"
54
+ "agent_command_prompt_v2_gpt_4o_2024_11_20_template.jinja2"
54
55
  ),
55
56
  f"{AWS_BEDROCK_PROVIDER}/anthropic.{MODEL_NAME_CLAUDE_3_5_SONNET_20240620}-v1:0": (
56
- "command_prompt_v2_claude_3_5_sonnet_20240620_template.jinja2"
57
+ "agent_command_prompt_v2_claude_3_5_sonnet_20240620_template.jinja2"
57
58
  ),
58
59
  f"{ANTHROPIC_PROVIDER}/{MODEL_NAME_CLAUDE_3_5_SONNET_20240620}": (
59
- "command_prompt_v2_claude_3_5_sonnet_20240620_template.jinja2"
60
+ "agent_command_prompt_v2_claude_3_5_sonnet_20240620_template.jinja2"
60
61
  ),
61
62
  }
62
63
 
63
64
  # When model is not configured, then we use the default prompt template
64
65
  DEFAULT_COMMAND_PROMPT_TEMPLATE_FILE_NAME = (
65
- "command_prompt_v2_gpt_4o_2024_11_20_template.jinja2"
66
+ "agent_command_prompt_v2_gpt_4o_2024_11_20_template.jinja2"
66
67
  )
67
68
  # When the configured model is not found in the model prompt mapper, then we use the
68
69
  # fallback prompt template
69
70
  FALLBACK_COMMAND_PROMPT_TEMPLATE_FILE_NAME = (
70
- "command_prompt_v2_gpt_4o_2024_11_20_template.jinja2"
71
+ "agent_command_prompt_v2_gpt_4o_2024_11_20_template.jinja2"
71
72
  )
72
73
 
73
74
 
@@ -44,25 +44,26 @@ DEFAULT_LLM_CONFIG = {
44
44
  TIMEOUT_CONFIG_KEY: 7,
45
45
  }
46
46
 
47
+ # TODO: only load the agent prompt template in cases where agents are actually used
47
48
  DEFAULT_COMMAND_PROMPT_TEMPLATE_FILE_NAME = (
48
- "command_prompt_v3_gpt_4o_2024_11_20_template.jinja2"
49
+ "agent_command_prompt_v3_gpt_4o_2024_11_20_template.jinja2"
49
50
  )
50
51
  FALLBACK_COMMAND_PROMPT_TEMPLATE_FILE_NAME = (
51
- "command_prompt_v3_gpt_4o_2024_11_20_template.jinja2"
52
+ "agent_command_prompt_v3_gpt_4o_2024_11_20_template.jinja2"
52
53
  )
53
54
  MODEL_PROMPT_MAPPER = {
54
55
  f"{OPENAI_PROVIDER}/{MODEL_NAME_GPT_4O_2024_11_20}": (
55
- "command_prompt_v3_gpt_4o_2024_11_20_template.jinja2"
56
+ "agent_command_prompt_v3_gpt_4o_2024_11_20_template.jinja2"
56
57
  ),
57
58
  f"{AZURE_OPENAI_PROVIDER}/{MODEL_NAME_GPT_4O_2024_11_20}": (
58
- "command_prompt_v3_gpt_4o_2024_11_20_template.jinja2"
59
+ "agent_command_prompt_v3_gpt_4o_2024_11_20_template.jinja2"
59
60
  ),
60
61
  f"{AWS_BEDROCK_PROVIDER}/anthropic."
61
62
  f"{MODEL_NAME_CLAUDE_3_5_SONNET_20240620}-v1:0": (
62
- "command_prompt_v3_claude_3_5_sonnet_20240620_template.jinja2"
63
+ "agent_command_prompt_v3_claude_3_5_sonnet_20240620_template.jinja2"
63
64
  ),
64
65
  f"{ANTHROPIC_PROVIDER}/{MODEL_NAME_CLAUDE_3_5_SONNET_20240620}": (
65
- "command_prompt_v3_claude_3_5_sonnet_20240620_template.jinja2"
66
+ "agent_command_prompt_v3_claude_3_5_sonnet_20240620_template.jinja2"
66
67
  ),
67
68
  }
68
69
 
@@ -5,6 +5,7 @@ from typing import Any, Dict, List, Literal, Optional, Text
5
5
  import structlog
6
6
 
7
7
  import rasa.shared.utils.io
8
+ from rasa.core.available_agents import AvailableAgents
8
9
  from rasa.dialogue_understanding.commands import (
9
10
  CannotHandleCommand,
10
11
  Command,
@@ -44,6 +45,7 @@ from rasa.shared.constants import (
44
45
  PROMPT_TEMPLATE_CONFIG_KEY,
45
46
  ROUTE_TO_CALM_SLOT,
46
47
  )
48
+ from rasa.shared.core.events import AgentCompleted
47
49
  from rasa.shared.core.flows import FlowsList
48
50
  from rasa.shared.core.trackers import DialogueStateTracker
49
51
  from rasa.shared.exceptions import ProviderClientAPIException
@@ -396,13 +398,15 @@ class SingleStepBasedLLMCommandGenerator(LLMBasedCommandGenerator, ABC):
396
398
  current_slot_allowed_values = allowed_values_for_slot(
397
399
  tracker.slots.get(current_slot)
398
400
  )
399
- current_conversation = tracker_as_readable_transcript(tracker)
401
+ current_conversation = tracker_as_readable_transcript(
402
+ tracker, highlight_agent_turns=True
403
+ )
400
404
  latest_user_message = sanitize_message_for_prompt(message.get(TEXT))
401
405
  current_conversation += f"\nUSER: {latest_user_message}"
402
406
 
403
407
  inputs = {
404
408
  "available_flows": self.prepare_flows_for_template(
405
- startable_flows, tracker
409
+ startable_flows, tracker, add_agent_info=True
406
410
  ),
407
411
  "current_conversation": current_conversation,
408
412
  "flow_slots": flow_slots,
@@ -412,6 +416,10 @@ class SingleStepBasedLLMCommandGenerator(LLMBasedCommandGenerator, ABC):
412
416
  "current_slot_type": current_slot_type,
413
417
  "current_slot_allowed_values": current_slot_allowed_values,
414
418
  "user_message": latest_user_message,
419
+ "active_agent": self._get_active_agent(tracker, top_flow.id)
420
+ if top_flow
421
+ else None,
422
+ "completed_agents": self._get_completed_agents(tracker),
415
423
  }
416
424
 
417
425
  return self.compile_template(self.prompt_template).render(**inputs)
@@ -459,3 +467,34 @@ class SingleStepBasedLLMCommandGenerator(LLMBasedCommandGenerator, ABC):
459
467
  ) -> Optional[str]:
460
468
  """Get the prompt template from the config or the default prompt template."""
461
469
  pass
470
+
471
+ def _get_active_agent(
472
+ self, tracker: DialogueStateTracker, active_flow_id: str
473
+ ) -> Optional[Dict[str, Any]]:
474
+ agent_frame = tracker.stack.find_active_agent_stack_frame_for_flow(
475
+ active_flow_id
476
+ )
477
+ if agent_frame:
478
+ return self._get_agent_info(agent_frame.agent_id)
479
+ return None
480
+
481
+ def _get_completed_agents(
482
+ self, tracker: DialogueStateTracker
483
+ ) -> List[Dict[str, Any]]:
484
+ completed_agents: List[Dict[str, Any]] = []
485
+ for event in reversed(tracker.events):
486
+ if isinstance(event, AgentCompleted):
487
+ agent_info = self._get_agent_info(event.agent_id)
488
+ if agent_info:
489
+ completed_agents.append(agent_info)
490
+ return completed_agents
491
+
492
+ def _get_agent_info(self, agent_id: str) -> Optional[Dict[str, Any]]:
493
+ agent_config = AvailableAgents.get_agent_config(agent_id)
494
+ if agent_config is None:
495
+ return None
496
+
497
+ return {
498
+ "name": agent_config.agent.name,
499
+ "description": agent_config.agent.description,
500
+ }
@@ -1,14 +1,31 @@
1
1
  from __future__ import annotations
2
2
 
3
3
  from dataclasses import dataclass
4
- from typing import Any, Dict
4
+ from typing import Any, Dict, List, Optional, Text
5
5
 
6
+ from rasa.core.actions.action import Action
7
+ from rasa.core.channels import OutputChannel
8
+ from rasa.core.nlg import NaturalLanguageGenerator
6
9
  from rasa.dialogue_understanding.stack.frames import PatternFlowStackFrame
10
+ from rasa.dialogue_understanding.stack.utils import top_user_flow_frame
7
11
  from rasa.shared.constants import RASA_DEFAULT_FLOW_PATTERN_PREFIX
12
+ from rasa.shared.core.constants import (
13
+ ACTION_ASK_INTERRUPTED_FLOW_TO_CONTINUE,
14
+ ACTION_CANCEL_INTERRUPTED_FLOW,
15
+ ACTION_CONTINUE_INTERRUPTED_FLOW,
16
+ ACTION_SET_INTERRUPTED_FLOWS,
17
+ )
18
+ from rasa.shared.core.domain import Domain
19
+ from rasa.shared.core.events import Event, SlotSet
20
+ from rasa.shared.core.trackers import DialogueStateTracker
8
21
 
9
22
  FLOW_PATTERN_CONTINUE_INTERRUPTED = (
10
23
  RASA_DEFAULT_FLOW_PATTERN_PREFIX + "continue_interrupted"
11
24
  )
25
+ INTERRUPTED_FLOWS_SLOT = "interrupted_flows"
26
+ INTERRUPTED_FLOW_TO_CONTINUE_SLOT = "interrupted_flow_to_continue"
27
+ MULTIPLE_FLOWS_INTERRUPTED_SLOT = "multiple_flows_interrupted"
28
+ CONFIRMATION_CONTINUE_INTERRUPTED_FLOW_SLOT = "confirmation_continue_interrupted_flow"
12
29
 
13
30
 
14
31
  @dataclass
@@ -49,3 +66,148 @@ class ContinueInterruptedPatternFlowStackFrame(PatternFlowStackFrame):
49
66
  and self.step_id == other.step_id
50
67
  and self.previous_flow_name == other.previous_flow_name
51
68
  )
69
+
70
+
71
+ class ActionSetInterruptedFlows(Action):
72
+ def name(self) -> str:
73
+ return ACTION_SET_INTERRUPTED_FLOWS
74
+
75
+ async def run(
76
+ self,
77
+ output_channel: OutputChannel,
78
+ nlg: NaturalLanguageGenerator,
79
+ tracker: DialogueStateTracker,
80
+ domain: Domain,
81
+ metadata: Optional[Dict[Text, Any]] = None,
82
+ ) -> list[Event]:
83
+ interrupted_flows_set = set()
84
+ interrupted_user_flow_stack_frames = tracker.stack.get_all_user_flow_frames()
85
+
86
+ for frame in interrupted_user_flow_stack_frames:
87
+ interrupted_flows_set.add(frame.flow_id)
88
+
89
+ interrupted_flows = list(interrupted_flows_set)
90
+ multiple_flows_interrupted = len(interrupted_flows) > 1
91
+
92
+ return [
93
+ SlotSet(INTERRUPTED_FLOWS_SLOT, interrupted_flows),
94
+ SlotSet(MULTIPLE_FLOWS_INTERRUPTED_SLOT, multiple_flows_interrupted),
95
+ ]
96
+
97
+
98
+ class ActionAskInterruptedFlowToContinue(Action):
99
+ def name(self) -> str:
100
+ return ACTION_ASK_INTERRUPTED_FLOW_TO_CONTINUE
101
+
102
+ async def run(
103
+ self,
104
+ output_channel: OutputChannel,
105
+ nlg: NaturalLanguageGenerator,
106
+ tracker: DialogueStateTracker,
107
+ domain: Domain,
108
+ metadata: Optional[Dict[Text, Any]] = None,
109
+ ) -> List[Event]:
110
+ interrupted_flows = tracker.get_slot(INTERRUPTED_FLOWS_SLOT) or []
111
+
112
+ buttons = [
113
+ {
114
+ "title": flow_id,
115
+ "payload": f'/SetSlots{{"{INTERRUPTED_FLOW_TO_CONTINUE_SLOT}": '
116
+ f'"{flow_id}"}}',
117
+ }
118
+ for flow_id in interrupted_flows or []
119
+ ]
120
+ buttons.append(
121
+ {
122
+ "title": "None of them",
123
+ "payload": f'/SetSlots{{"{INTERRUPTED_FLOW_TO_CONTINUE_SLOT}": '
124
+ f'"none"}}',
125
+ }
126
+ )
127
+
128
+ await output_channel.send_text_with_buttons(
129
+ tracker.sender_id,
130
+ "You previously started several other tasks. "
131
+ "Would you like to resume any of them?",
132
+ buttons=buttons,
133
+ )
134
+
135
+ return []
136
+
137
+
138
+ class ActionContinueInterruptedFlow(Action):
139
+ def name(self) -> str:
140
+ return ACTION_CONTINUE_INTERRUPTED_FLOW
141
+
142
+ async def run(
143
+ self,
144
+ output_channel: OutputChannel,
145
+ nlg: NaturalLanguageGenerator,
146
+ tracker: DialogueStateTracker,
147
+ domain: Domain,
148
+ metadata: Optional[Dict[Text, Any]] = None,
149
+ ) -> List[Event]:
150
+ from rasa.dialogue_understanding.commands import StartFlowCommand
151
+
152
+ # get all necessary slot values
153
+ multiple = tracker.get_slot(MULTIPLE_FLOWS_INTERRUPTED_SLOT)
154
+ selected_flow = tracker.get_slot(INTERRUPTED_FLOW_TO_CONTINUE_SLOT)
155
+ interrupted_flows = tracker.get_slot(INTERRUPTED_FLOWS_SLOT) or []
156
+
157
+ original_user_frame = top_user_flow_frame(tracker.stack)
158
+
159
+ # case of multiple interrupted flows, where the user selected a flow to continue
160
+ if multiple:
161
+ flow_id = selected_flow if selected_flow else None
162
+ # case of single interrupted flow, so there is only one flow to continue
163
+ else:
164
+ flow_id = interrupted_flows[0] if interrupted_flows else None
165
+
166
+ event_list = []
167
+ if flow_id:
168
+ # TODO: refactor to avoid creating a StartFlowCommand first
169
+ # resume the flow with the provided flow id
170
+ start_flow_command = StartFlowCommand(flow_id)
171
+ event_list = start_flow_command.resume_flow(
172
+ tracker, tracker.stack, original_user_frame
173
+ )
174
+ else:
175
+ await output_channel.send_text_message(
176
+ tracker.sender_id,
177
+ "You haven't selected a valid task to resume. "
178
+ "Please specify the task you would like to continue.",
179
+ )
180
+
181
+ return event_list
182
+
183
+
184
+ class ActionCancelInterruptedFlow(Action):
185
+ def name(self) -> str:
186
+ return ACTION_CANCEL_INTERRUPTED_FLOW
187
+
188
+ async def run(
189
+ self,
190
+ output_channel: OutputChannel,
191
+ nlg: NaturalLanguageGenerator,
192
+ tracker: DialogueStateTracker,
193
+ domain: Domain,
194
+ metadata: Optional[Dict[Text, Any]] = None,
195
+ ) -> List[Event]:
196
+ from rasa.dialogue_understanding.commands import CancelFlowCommand
197
+
198
+ interrupted_flows = tracker.get_slot(INTERRUPTED_FLOWS_SLOT) or []
199
+
200
+ event_list = []
201
+ for flow_id in interrupted_flows:
202
+ # TODO: refactor to avoid creating a CancelFlowCommand first
203
+ cancel_flow_command = CancelFlowCommand()
204
+ event_list.extend(
205
+ cancel_flow_command.cancel_flow(tracker, tracker.stack, flow_id)
206
+ )
207
+
208
+ return event_list + [
209
+ SlotSet(INTERRUPTED_FLOWS_SLOT, None),
210
+ SlotSet(INTERRUPTED_FLOW_TO_CONTINUE_SLOT, None),
211
+ SlotSet(MULTIPLE_FLOWS_INTERRUPTED_SLOT, None),
212
+ SlotSet(CONFIRMATION_CONTINUE_INTERRUPTED_FLOW_SLOT, None),
213
+ ]
@@ -1,6 +1,17 @@
1
1
  version: "3.1"
2
2
  responses:
3
3
 
4
+ utter_ask_continue_interrupted_flow:
5
+ - text: "Would you like to continue with {{ context.previous_flow_name }}?"
6
+ metadata:
7
+ rephrase: True
8
+ template: jinja
9
+ buttons:
10
+ - title: "Yes"
11
+ payload: "/SetSlots(confirmation_continue_interrupted_flow=true)"
12
+ - title: "No"
13
+ payload: "/SetSlots(confirmation_continue_interrupted_flow=false)"
14
+
4
15
  utter_ask_rephrase:
5
16
  - text: I’m sorry I am unable to understand you, could you please rephrase?
6
17
 
@@ -53,12 +64,6 @@ responses:
53
64
  rephrase: True
54
65
  template: jinja
55
66
 
56
- utter_flow_continue_interrupted:
57
- - text: "Let's continue with {{ context.previous_flow_name }}."
58
- metadata:
59
- rephrase: True
60
- template: jinja
61
-
62
67
  utter_free_chitchat_response:
63
68
  - text: "Sorry, I'm not able to answer that right now."
64
69
  metadata:
@@ -124,6 +129,19 @@ slots:
124
129
  type: float
125
130
  initial_value: 0.0
126
131
  max_value: 1000000
132
+ interrupted_flows:
133
+ type: list
134
+ multiple_flows_interrupted:
135
+ type: bool
136
+ initial_value: false
137
+ confirmation_continue_interrupted_flow:
138
+ type: bool
139
+ initial_value: null
140
+ mappings:
141
+ - type: controlled
142
+ interrupted_flow_to_continue:
143
+ type: text
144
+ initial_value: null
127
145
 
128
146
  flows:
129
147
  pattern_cancel_flow:
@@ -210,7 +228,33 @@ flows:
210
228
  description: Conversation repair flow for managing when users switch between different flows
211
229
  name: pattern continue interrupted
212
230
  steps:
213
- - action: utter_flow_continue_interrupted
231
+ - action: action_set_interrupted_flows
232
+ - noop: true
233
+ next:
234
+ - if: slots.multiple_flows_interrupted
235
+ then:
236
+ - collect: interrupted_flow_to_continue
237
+ description: "Fill this slot with the name of the flow the user wants to continue. If the user does not want to continue any of the interrupted flows, fill this slot with 'none'."
238
+ next:
239
+ - if: slots.interrupted_flow_to_continue != "none"
240
+ then:
241
+ - action: action_continue_interrupted_flow
242
+ next: END
243
+ - else:
244
+ - action: action_cancel_interrupted_flow
245
+ next: END
246
+ - else:
247
+ - collect: confirmation_continue_interrupted_flow
248
+ description: "If the user wants to continue the interrupted flow, fill this slot with true. If the user does not want to continue the interrupted flow, fill this slot with false."
249
+ utter: utter_ask_continue_interrupted_flow
250
+ next:
251
+ - if: slots.confirmation_continue_interrupted_flow
252
+ then:
253
+ - action: action_continue_interrupted_flow
254
+ next: END
255
+ - else:
256
+ - action: action_cancel_interrupted_flow
257
+ next: END
214
258
 
215
259
  pattern_correction:
216
260
  description: Conversation repair flow for managing user input changes or error corrections