rasa-pro 3.14.0.dev20250901__py3-none-any.whl → 3.14.0rc1__py3-none-any.whl

rasa/shared/core/flows/flows_yaml_schema.json

@@ -1,20 +1,12 @@
 {
     "type": "object",
-    "required": [
-        "flows"
-    ],
+    "required": ["flows"],
     "properties": {
-        "version": {
-            "type": "string"
-        },
+        "version": {"type": "string"},
         "flows": {
             "type": "object",
             "schema_name": "dictionary of flows",
-            "patternProperties": {
-                "^[A-Za-z_][A-Za-z0-9_]*$": {
-                    "$ref": "#/$defs/flow"
-                }
-            }
+            "patternProperties": {"^[A-Za-z_][A-Za-z0-9_]*$": {"$ref": "#/$defs/flow"}}
         }
     },
     "$defs": {
@@ -28,34 +20,22 @@
                     {
                         "schema_name": "intent trigger",
                         "type": "object",
-                        "required": [
-                            "intent"
-                        ],
+                        "required": ["intent"],
                         "additionalProperties": false,
                         "properties": {
                             "intent": {
                                 "type": "object",
                                 "properties": {
-                                    "confidence_threshold": {
-                                        "type": "number"
-                                    },
-                                    "name": {
-                                        "type": "string"
-                                    }
+                                    "confidence_threshold": {"type": "number"},
+                                    "name": {"type": "string"}
                                 },
-                                "required": [
-                                    "name"
-                                ]
+                                "required": ["name"]
                             }
                         }
                     },
                     {
                         "schema_name": "simple intent trigger",
-                        "properties": {
-                            "intent": {
-                                "type": "string"
-                            }
-                        }
+                        "properties": {"intent": {"type": "string"}}
                     }
                 ]
             }
@@ -66,9 +46,7 @@
             "items": {
                 "type": "object",
                 "properties": {
-                    "id": {
-                        "type": "string"
-                    },
+                    "id": {"type": "string"},
                     "next": {
                         "anyOf": [
                             {
@@ -79,16 +57,11 @@
                                     "oneOf": [
                                         {
                                             "schema_name": "if-then block",
-                                            "required": [
-                                                "if",
-                                                "then"
-                                            ]
+                                            "required": ["if", "then"]
                                         },
                                         {
                                             "schema_name": "else block",
-                                            "required": [
-                                                "else"
-                                            ]
+                                            "required": ["else"]
                                         }
                                     ],
                                     "properties": {
@@ -104,12 +77,7 @@
                                                 }
                                             ]
                                         },
-                                        "if": {
-                                            "type": [
-                                                "boolean",
-                                                "string"
-                                            ]
-                                        },
+                                        "if": {"type": ["boolean", "string"]},
                                         "then": {
                                             "oneOf": [
                                                 {
@@ -125,66 +93,25 @@
                                     }
                                 }
                             },
-                            {
-                                "type": "string",
-                                "schema_name": "step id"
-                            }
+                            {"type": "string", "schema_name": "step id"}
                         ]
                     },
-                    "action": {
-                        "type": "string"
-                    },
-                    "collect": {
-                        "type": "string"
-                    },
-                    "link": {
-                        "type": "string"
-                    },
-                    "call": {
-                        "type": "string"
-                    },
+                    "action": {"type": "string"},
+                    "collect": {"type": "string"},
+                    "link": {"type": "string"},
+                    "call": {"type": "string"},
                     "set_slots": {
                         "$ref": "#/$defs/set_slots",
                         "schema_name": "slot set"
                     }
                 },
                 "oneOf": [
-                    {
-                        "required": [
-                            "action"
-                        ],
-                        "schema_name": "action step"
-                    },
-                    {
-                        "required": [
-                            "collect"
-                        ],
-                        "schema_name": "collect step"
-                    },
-                    {
-                        "required": [
-                            "link"
-                        ],
-                        "schema_name": "link step"
-                    },
-                    {
-                        "required": [
-                            "call"
-                        ],
-                        "schema_name": "call step"
-                    },
-                    {
-                        "required": [
-                            "set_slots"
-                        ],
-                        "schema_name": "slot set step"
-                    },
-                    {
-                        "required": [
-                            "noop"
-                        ],
-                        "schema_name": ""
-                    }
+                    {"required": ["action"], "schema_name": "action step"},
+                    {"required": ["collect"], "schema_name": "collect step"},
+                    {"required": ["link"], "schema_name": "link step"},
+                    {"required": ["call"], "schema_name": "call step"},
+                    {"required": ["set_slots"], "schema_name": "slot set step"},
+                    {"required": ["noop"], "schema_name": ""}
                 ],
                 "dependentSchemas": {
                     "action": {
@@ -196,10 +123,23 @@
                             "metadata": {}
                         }
                     },
-                    "noop": {
-                        "required": [
-                            "next"
-                        ]
+                    "noop": {"required": ["next"]},
+                    "call": {
+                        "additionalProperties": false,
+                        "properties": {
+                            "call": {"type": "string"},
+                            "id": {},
+                            "next": {},
+                            "metadata": {},
+                            "description": {"type": "string"},
+                            "mcp_server": {"type": "string"},
+                            "mapping": {"$ref": "#/$defs/call_step/properties/mapping"},
+                            "exit_if": {"$ref": "#/$defs/call_step/properties/exit_if"}
+                        },
+                        "dependentSchemas": {
+                            "mcp_server": {"required": ["mapping"]},
+                            "mapping": {"required": ["mcp_server"]}
+                        }
                     },
                     "collect": {
                         "additionalProperties": false,
@@ -208,45 +148,32 @@
                             "id": {},
                             "next": {},
                             "metadata": {},
-                            "description": {
-                                "type": "string"
-                            },
-                            "ask_before_filling": {
-                                "type": "boolean"
-                            },
-                            "reset_after_flow_ends": {
-                                "type": "boolean"
-                            },
-                            "utter": {
-                                "type": "string"
-                            },
-                            "force_slot_filling": {
-                                "type": "boolean"
-                            },
+                            "description": {"type": "string"},
+                            "ask_before_filling": {"type": "boolean"},
+                            "reset_after_flow_ends": {"type": "boolean"},
+                            "utter": {"type": "string"},
+                            "force_slot_filling": {"type": "boolean"},
                             "rejections": {
                                 "type": "array",
                                 "schema_name": "list of rejections",
                                 "items": {
                                     "type": "object",
-                                    "required": [
-                                        "if",
-                                        "utter"
-                                    ],
+                                    "required": ["if", "utter"],
                                     "properties": {
-                                        "if": {
-                                            "type": [
-                                                "boolean",
-                                                "string"
-                                            ]
-                                        },
-                                        "utter": {
-                                            "type": "string"
-                                        }
+                                        "if": {"type": ["boolean", "string"]},
+                                        "utter": {"type": "string"}
                                     }
                                 }
                             },
                             "silence_timeout": {
-                                "type": "number"
+                                "oneOf": [
+                                  {
+                                    "type": "number"
+                                  },
+                                  {
+                                    "type": "object"
+                                  }
+                              ]
                             }
                         }
                     }
@@ -254,84 +181,92 @@
             }
         },
         "flow": {
-            "required": [
-                "steps",
-                "description"
-            ],
+            "required": ["steps", "description"],
             "type": "object",
             "additionalProperties": false,
             "schema_name": "dictionary with flow properties",
             "properties": {
-                "name": {
-                    "type": "string"
-                },
-                "description": {
-                    "type": "string"
-                },
+                "name": {"type": "string"},
+                "description": {"type": "string"},
                 "translation": {
                     "type": "object",
+                    "additionalProperties": false,
                     "schema_name": "flow translation mapping",
-                    "properties": {
-                        "metadata": {
-                            "type": "object"
-                        }
-                    },
+                    "properties": {"metadata": {"type": "object"}},
                     "patternProperties": {
                         "^(?!metadata$).+": {
                             "type": "object",
                             "additionalProperties": false,
-                            "required": [
-                                "name"
-                            ],
-                            "properties": {
-                                "name": {
-                                    "type": "string"
-                                },
-                                "metadata": {}
-                            }
+                            "required": ["name"],
+                            "properties": {"name": {"type": "string"}, "metadata": {}}
                         }
-                    },
-                    "additionalProperties": false
-                },
-                "if": {
-                    "type": [
-                        "string",
-                        "boolean"
-                    ]
-                },
-                "always_include_in_prompt": {
-                    "type": "boolean"
-                },
-                "nlu_trigger": {
-                    "$ref": "#/$defs/nlu_trigger"
-                },
-                "file_path": {
-                    "type": "string"
-                },
-                "steps": {
-                    "$ref": "#/$defs/steps"
-                },
-                "persisted_slots": {
-                    "$ref": "#/$defs/persisted_slots"
+                    }
                 },
-                "run_pattern_completed": {
-                    "type": "boolean"
-                }
+                "if": {"type": ["string", "boolean"]},
+                "always_include_in_prompt": {"type": "boolean"},
+                "nlu_trigger": {"$ref": "#/$defs/nlu_trigger"},
+                "file_path": {"type": "string"},
+                "steps": {"$ref": "#/$defs/steps"},
+                "persisted_slots": {"$ref": "#/$defs/persisted_slots"},
+                "run_pattern_completed": {"type": "boolean"}
             }
         },
         "set_slots": {
             "type": "array",
             "schema_name": "list of slot sets",
-            "items": {
-                "type": "object"
+            "items": {"type": "object"}
+        },
+        "call_step": {
+            "type": "object",
+            "additionalProperties": false,
+            "schema_name": "dictionary with call properties",
+            "required": ["call"],
+            "properties": {
+                "call": {"type": "string"},
+                "mcp_server": {"type": "string"},
+                "mapping": {
+                    "type": "object",
+                    "additionalProperties": false,
+                    "schema_name": "input and output mapping for a MCP tool call",
+                    "required": ["input", "output"],
+                    "properties": {
+                        "input": {
+                            "type": "array",
+                            "items": {
+                                "type": "object",
+                                "additionalProperties": false,
+                                "required": ["slot", "param"],
+                                "properties": {
+                                    "slot": {"type": "string"},
+                                    "param": {"type": "string"}
+                                }
+                            }
+                        },
+                        "output": {
+                            "type": "array",
+                            "items": {
+                                "type": "object",
+                                "additionalProperties": false,
+                                "required": ["slot", "value"],
+                                "properties": {
+                                    "slot": {"type": "string"},
+                                    "value": {"type": "string"}
+                                }
+                            }
+                        }
+                    }
+                },
+                "exit_if": {
+                    "type": "array",
+                    "schema_name": "list of slot predicates to exit agent call",
+                    "items": {"type": ["string"]}
+                }
             }
         },
         "persisted_slots": {
             "type": "array",
             "schema_name": "list of slots",
-            "items": {
-                "type": "string"
-            }
+            "items": {"type": "string"}
         }
     }
 }

rasa/shared/core/flows/steps/call.py

@@ -1,8 +1,9 @@
 from __future__ import annotations
 
 from dataclasses import dataclass
-from typing import TYPE_CHECKING, Any, Dict, Generator, Optional, Text
+from typing import TYPE_CHECKING, Any, Dict, Generator, List, Optional, Text
 
+from rasa.core.available_agents import AvailableAgents
 from rasa.shared.core.flows.flow_step import FlowStep
 
 if TYPE_CHECKING:
@@ -11,12 +12,22 @@ if TYPE_CHECKING:
 
 @dataclass
 class CallFlowStep(FlowStep):
-    """Represents the configuration of an call flow step."""
+    """Represents the configuration of a call flow/agent step."""
 
     call: Text
-    """The flow to be called."""
+    """The flow to be called or the ID of the agent to be called."""
     called_flow_reference: Optional["Flow"] = None
 
+    # MCP Tool calling
+    """The MCP server that hosts the tool to be called."""
+    mcp_server: Optional[str] = None
+    """The input and output mapping for the MCP tool."""
+    mapping: Optional[Dict[str, Any]] = None
+
+    # Call agent exit condition
+    """A list of slot predicates that determine when to exit the agent loop."""
+    exit_if: Optional[List[str]] = None
+
     @classmethod
     def from_json(cls, flow_id: Text, data: Dict[Text, Any]) -> CallFlowStep:
         """Used to read flow steps from parsed YAML.
@@ -31,6 +42,9 @@ class CallFlowStep(FlowStep):
         base = super().from_json(flow_id, data)
         return CallFlowStep(
             call=data.get("call", ""),
+            mcp_server=data.get("mcp_server", None),
+            mapping=data.get("mapping", None),
+            exit_if=data.get("exit_if", None),
             **base.__dict__,
         )
 
@@ -40,7 +54,16 @@ class CallFlowStep(FlowStep):
         Returns:
             The flow step as a dictionary.
         """
-        return super().as_json(step_properties={"call": self.call})
+        step_properties: Dict[str, Any] = {
+            "call": self.call,
+        }
+        if self.is_calling_mcp_tool():
+            step_properties["mcp_server"] = self.mcp_server
+            step_properties["mapping"] = self.mapping
+        if self.exit_if:
+            step_properties["exit_if"] = self.exit_if
+
+        return super().as_json(step_properties=step_properties)
 
     def steps_in_tree(
         self, should_resolve_calls: bool = True
@@ -48,7 +71,7 @@ class CallFlowStep(FlowStep):
         """Returns the steps in the tree of the flow step."""
         yield self
 
-        if should_resolve_calls:
+        if should_resolve_calls and self.is_calling_flow():
             if not self.called_flow_reference:
                 raise ValueError(
                     f"Flow step '{self.id}' in flow '{self.flow_id}' is trying "
@@ -63,6 +86,24 @@ class CallFlowStep(FlowStep):
 
         yield from self.next.steps_in_tree(should_resolve_calls)
 
+    def is_calling_flow(self) -> bool:
+        """Returns True if the call references a flow."""
+        return not self.is_calling_mcp_tool() and not self.is_calling_agent()
+
+    def is_calling_mcp_tool(self) -> bool:
+        """Returns True if the call references an MCP tool of an existing MCP server."""
+        from rasa.shared.utils.mcp.utils import mcp_server_exists
+
+        return self.has_mcp_tool_properties() and mcp_server_exists(self.mcp_server)
+
+    def has_mcp_tool_properties(self) -> bool:
+        """Returns True if the call step has MCP tool properties."""
+        return self.mcp_server is not None and self.mapping is not None
+
+    def is_calling_agent(self) -> bool:
+        """Returns True if the call references an agent."""
+        return self.call in AvailableAgents.get_instance().agents
+
     @property
     def default_id_postfix(self) -> str:
         """Returns the default id postfix of the flow step."""
@@ -73,6 +114,9 @@ class CallFlowStep(FlowStep):
             return (
                 self.call == other.call
                 and self.called_flow_reference == other.called_flow_reference
+                and self.mcp_server == other.mcp_server
+                and self.mapping == other.mapping
+                and self.exit_if == other.exit_if
                 and super().__eq__(other)
             )
         return False