rasa-pro 3.8.18__py3-none-any.whl → 3.9.15__py3-none-any.whl

rasa/dialogue_understanding/generator/nlu_command_adapter.py

@@ -2,20 +2,27 @@ from typing import Dict, Text, Any, Optional, List
 
 import structlog
 
+
 from rasa.dialogue_understanding.commands import (
     Command,
     StartFlowCommand,
     SetSlotCommand,
 )
+from rasa.dialogue_understanding.commands.set_slot_command import SetSlotExtractor
 from rasa.dialogue_understanding.generator import CommandGenerator
 from rasa.engine.graph import GraphComponent, ExecutionContext
 from rasa.engine.recipes.default_recipe import DefaultV1Recipe
 from rasa.engine.storage.resource import Resource
 from rasa.engine.storage.storage import ModelStorage
 from rasa.shared.constants import ROUTE_TO_CALM_SLOT
+from rasa.shared.core.domain import Domain
 from rasa.shared.core.flows.flows_list import FlowsList
+from rasa.shared.core.slot_mappings import (
+    SlotFillingManager,
+    extract_slot_value,
+)
 from rasa.shared.core.trackers import DialogueStateTracker
-from rasa.shared.nlu.constants import INTENT
+from rasa.shared.nlu.constants import ENTITIES, INTENT
 from rasa.shared.nlu.training_data.message import Message
 from rasa.shared.nlu.training_data.training_data import TrainingData
 
@@ -76,6 +83,7 @@ class NLUCommandAdapter(GraphComponent, CommandGenerator):
         message: Message,
         flows: FlowsList,
         tracker: Optional[DialogueStateTracker] = None,
+        **kwargs: Any,
     ) -> List[Command]:
         """Creates commands using the predicted intents.
 
@@ -83,6 +91,7 @@ class NLUCommandAdapter(GraphComponent, CommandGenerator):
             message: The message from the user.
             flows: The flows available to the user.
             tracker: The tracker containing the current state of the conversation.
+            **kwargs: Keyword arguments for forward compatibility.
 
         Returns:
             The commands triggered by NLU.
@@ -91,9 +100,18 @@ class NLUCommandAdapter(GraphComponent, CommandGenerator):
             # cannot do anything if there are no flows or no tracker
             return []
 
-        commands = self.convert_nlu_to_commands(message, tracker, flows)
+        domain = kwargs.get("domain", None)
+        commands = self.convert_nlu_to_commands(message, tracker, flows, domain)
+
+        commands_contain_start_flow = any(
+            isinstance(command, StartFlowCommand) for command in commands
+        )
 
-        if commands and len(commands) >= 1 and tracker.has_coexistence_routing_slot:
+        if (
+            commands
+            and commands_contain_start_flow
+            and tracker.has_coexistence_routing_slot
+        ):
             # if the nlu command adapter will start a flow and the coexistence feature
             # is used, make sure to set the routing slot
             commands += [SetSlotCommand(ROUTE_TO_CALM_SLOT, True)]
@@ -121,15 +139,22 @@ class NLUCommandAdapter(GraphComponent, CommandGenerator):
 
     @staticmethod
     def convert_nlu_to_commands(
-        message: Message, tracker: DialogueStateTracker, flows: FlowsList
+        message: Message,
+        tracker: DialogueStateTracker,
+        flows: FlowsList,
+        domain: Optional[Domain] = None,
     ) -> List[Command]:
         """Converts the predicted intent to a command."""
         if tracker is None or flows.is_empty():
             # cannot do anything if there are no flows or no tracker
             return []
 
-        if not message.get(INTENT) or not message.get(INTENT)["name"]:
-            # if the message does not have an intent set,
+        if not (
+            message.get(INTENT)
+            or message.get(INTENT, {}).get("name")
+            or message.get(ENTITIES)
+        ):
+            # if the message does not have an intent or entities set
             # no commands can be predicted
             return []
 
@@ -139,8 +164,6 @@ class NLUCommandAdapter(GraphComponent, CommandGenerator):
             if flow.nlu_triggers and flow.nlu_triggers.is_triggered(message):
                 commands.append(StartFlowCommand(flow.id))
 
-        structlogger.info("nlu_command_adapter.predict_commands", commands=commands)
-
         # there should be just one flow that can be triggered by the predicted intent
         # this is checked when loading the flows
         # however we just doublecheck here and return the first command if there are
@@ -154,4 +177,42 @@ class NLUCommandAdapter(GraphComponent, CommandGenerator):
             )
             commands = [commands[0]]
 
+        set_slot_commands = _issue_set_slot_commands(message, tracker, flows, domain)
+        commands.extend(set_slot_commands)
+
+        structlogger.info("nlu_command_adapter.predict_commands", commands=commands)
+
         return commands
+
+
+def _issue_set_slot_commands(
+    message: Message,
+    tracker: DialogueStateTracker,
+    flows: FlowsList,
+    domain: Optional[Domain] = None,
+) -> List[Command]:
+    """Issue SetSlotCommand for each slot that can be filled with NLU properties."""
+    commands: List[Command] = []
+    domain = domain if domain else Domain.empty()
+    slot_filling_manager = SlotFillingManager(domain, tracker, message)
+    available_slot_names = flows.available_slot_names()
+
+    for _, slot in tracker.slots.items():
+        # if a slot is not collected in available flows,
+        # it means that it is not a slot that can be filled by CALM,
+        # so we skip it
+        if slot.name not in available_slot_names:
+            structlogger.debug("nlu_command_adapter.skip_slot", slot=slot.name)
+            continue
+
+        slot_value, is_extracted = extract_slot_value(slot, slot_filling_manager)
+        if is_extracted:
+            commands.append(
+                SetSlotCommand(
+                    name=slot.name,
+                    value=slot_value,
+                    extractor=SetSlotExtractor.NLU.value,
+                )
+            )
+
+    return commands

rasa/dialogue_understanding/generator/single_step/single_step_llm_command_generator.py

@@ -0,0 +1,345 @@
+import importlib.resources
+import re
+import structlog
+from typing import Dict, Any, List, Optional, Text
+
+import rasa.shared.utils.io
+from rasa.dialogue_understanding.commands import (
+    Command,
+    ErrorCommand,
+    SetSlotCommand,
+    CancelFlowCommand,
+    HumanHandoffCommand,
+    ChitChatAnswerCommand,
+    SkipQuestionCommand,
+    KnowledgeAnswerCommand,
+    ClarifyCommand,
+    CannotHandleCommand,
+)
+from rasa.dialogue_understanding.generator.llm_based_command_generator import (
+    LLMBasedCommandGenerator,
+)
+from rasa.dialogue_understanding.generator.constants import (
+    LLM_CONFIG_KEY,
+    USER_INPUT_CONFIG_KEY,
+    FLOW_RETRIEVAL_KEY,
+)
+from rasa.dialogue_understanding.generator.flow_retrieval import (
+    FlowRetrieval,
+)
+from rasa.dialogue_understanding.stack.utils import top_flow_frame
+from rasa.engine.graph import ExecutionContext
+from rasa.engine.recipes.default_recipe import DefaultV1Recipe
+from rasa.engine.storage.resource import Resource
+from rasa.engine.storage.storage import ModelStorage
+from rasa.shared.constants import ROUTE_TO_CALM_SLOT
+from rasa.shared.core.flows import FlowsList
+from rasa.shared.core.trackers import DialogueStateTracker
+from rasa.shared.nlu.constants import TEXT
+from rasa.shared.nlu.training_data.message import Message
+from rasa.shared.exceptions import ProviderClientAPIException
+from rasa.shared.utils.io import deep_container_fingerprint
+from rasa.shared.utils.llm import (
+    get_prompt_template,
+    tracker_as_readable_transcript,
+    sanitize_message_for_prompt,
+)
+from rasa.utils.log_utils import log_llm
+
+COMMAND_PROMPT_FILE_NAME = "command_prompt.jinja2"
+
+DEFAULT_COMMAND_PROMPT_TEMPLATE = importlib.resources.read_text(
+    "rasa.dialogue_understanding.generator.single_step",
+    "command_prompt_template.jinja2",
+)
+
+structlogger = structlog.get_logger()
+
+
+@DefaultV1Recipe.register(
+    [
+        DefaultV1Recipe.ComponentType.COMMAND_GENERATOR,
+    ],
+    is_trainable=True,
+)
+class SingleStepLLMCommandGenerator(LLMBasedCommandGenerator):
+    """A single step LLM-based command generator."""
+
+    def __init__(
+        self,
+        config: Dict[str, Any],
+        model_storage: ModelStorage,
+        resource: Resource,
+        prompt_template: Optional[Text] = None,
+        **kwargs: Any,
+    ) -> None:
+        super().__init__(
+            config,
+            model_storage,
+            resource,
+            prompt_template=prompt_template,
+            **kwargs,
+        )
+
+        # Set the prompt template
+        if config.get("prompt"):
+            structlogger.warning(
+                "single_step_llm_command_generator.init",
+                event_info=(
+                    "The config parameter 'prompt' is deprecated "
+                    "and will be removed in Rasa 4.0.0. "
+                    "Please use the config parameter 'prompt_template' instead. "
+                ),
+            )
+        config_prompt = config.get("prompt") or config.get("prompt_template") or None
+        self.prompt_template = prompt_template or get_prompt_template(
+            config_prompt,
+            DEFAULT_COMMAND_PROMPT_TEMPLATE,
+        )
+
+        self.trace_prompt_tokens = self.config.get("trace_prompt_tokens", False)
+
+    ### Implementations of LLMBasedCommandGenerator parent
+    @staticmethod
+    def get_default_config() -> Dict[str, Any]:
+        """The component's default config (see parent class for full docstring)."""
+        return {
+            "prompt": None,  # Legacy
+            "prompt_template": None,
+            USER_INPUT_CONFIG_KEY: None,
+            LLM_CONFIG_KEY: None,
+            FLOW_RETRIEVAL_KEY: FlowRetrieval.get_default_config(),
+        }
+
+    @classmethod
+    def load(
+        cls: Any,
+        config: Dict[str, Any],
+        model_storage: ModelStorage,
+        resource: Resource,
+        execution_context: ExecutionContext,
+        **kwargs: Any,
+    ) -> "SingleStepLLMCommandGenerator":
+        """Loads trained component (see parent class for full docstring)."""
+        # load prompt template from the model storage.
+        prompt_template = cls.load_prompt_template_from_model_storage(
+            model_storage, resource, COMMAND_PROMPT_FILE_NAME
+        )
+        # init base command generator
+        command_generator = cls(config, model_storage, resource, prompt_template)
+        # load flow retrieval if enabled
+        if command_generator.enabled_flow_retrieval:
+            command_generator.flow_retrieval = cls.load_flow_retrival(
+                command_generator.config, model_storage, resource
+            )
+        return command_generator
+
+    def persist(self) -> None:
+        """Persist this component to disk for future loading."""
+        # persist prompt template
+        with self._model_storage.write_to(self._resource) as path:
+            rasa.shared.utils.io.write_text_file(
+                self.prompt_template, path / COMMAND_PROMPT_FILE_NAME
+            )
+        # persist flow retrieval
+        if self.flow_retrieval is not None:
+            self.flow_retrieval.persist()
+
+    async def predict_commands(
+        self,
+        message: Message,
+        flows: FlowsList,
+        tracker: Optional[DialogueStateTracker] = None,
+        **kwargs: Any,
+    ) -> List[Command]:
+        """Predict commands using the LLM.
+
+        Args:
+            message: The message from the user.
+            flows: The flows available to the user.
+            tracker: The tracker containing the current state of the conversation.
+            **kwargs: Keyword arguments for forward compatibility.
+
+        Returns:
+            The commands generated by the llm.
+        """
+        if tracker is None or flows.is_empty():
+            # cannot do anything if there are no flows or no tracker
+            return []
+
+        # retrieve flows
+        try:
+            filtered_flows = await self.filter_flows(message, flows, tracker)
+        except ProviderClientAPIException:
+            return [ErrorCommand()]
+
+        flow_prompt = self.render_template(message, tracker, filtered_flows, flows)
+        log_llm(
+            logger=structlogger,
+            log_module="SingleStepLLMCommandGenerator",
+            log_event="llm_command_generator.predict_commands.prompt_rendered",
+            prompt=flow_prompt,
+        )
+
+        try:
+            action_list = await self.invoke_llm(flow_prompt)
+            # The check for 'None' maintains compatibility with older versions
+            # of LLMCommandGenerator. In previous implementations, 'invoke_llm'
+            # might return 'None' to indicate a failure to generate actions.
+            if action_list is None:
+                return [ErrorCommand()]
+        except ProviderClientAPIException:
+            return [ErrorCommand()]
+
+        log_llm(
+            logger=structlogger,
+            log_module="SingleStepLLMCommandGenerator",
+            log_event="llm_command_generator.predict_commands.actions_generated",
+            action_list=action_list,
+        )
+
+        commands = self.parse_commands(action_list, tracker, flows)
+
+        if not commands:
+            # no commands are parsed or there's an invalid command
+            commands = [CannotHandleCommand()]
+        else:
+            # if the LLM command generator predicted valid commands and the
+            # coexistence feature is used, set the routing slot
+            if tracker.has_coexistence_routing_slot:
+                commands += [SetSlotCommand(ROUTE_TO_CALM_SLOT, True)]
+
+        log_llm(
+            logger=structlogger,
+            log_module="SingleStepLLMCommandGenerator",
+            log_event="llm_command_generator.predict_commands.finished",
+            commands=commands,
+        )
+        return commands
+
+    @classmethod
+    def parse_commands(
+        cls, actions: Optional[str], tracker: DialogueStateTracker, flows: FlowsList
+    ) -> List[Command]:
+        """Parse the actions returned by the llm into intent and entities.
+
+        Args:
+            actions: The actions returned by the llm.
+            tracker: The tracker containing the current state of the conversation.
+            flows: the list of flows
+
+        Returns:
+            The parsed commands.
+        """
+        if actions is None:
+            return []
+
+        commands: List[Command] = []
+
+        slot_set_re = re.compile(r"""SetSlot\(([a-zA-Z_][a-zA-Z0-9_-]*?), ?(.*)\)""")
+        start_flow_re = re.compile(r"StartFlow\(([a-zA-Z0-9_-]+?)\)")
+        cancel_flow_re = re.compile(r"CancelFlow\(\)")
+        chitchat_re = re.compile(r"ChitChat\(\)")
+        skip_question_re = re.compile(r"SkipQuestion\(\)")
+        knowledge_re = re.compile(r"SearchAndReply\(\)")
+        humand_handoff_re = re.compile(r"HumanHandoff\(\)")
+        clarify_re = re.compile(r"Clarify\(([a-zA-Z0-9_, ]+)\)")
+
+        for action in actions.strip().splitlines():
+            if match := slot_set_re.search(action):
+                slot_name = match.group(1).strip()
+                slot_value = cls.clean_extracted_value(match.group(2))
+                # error case where the llm tries to start a flow using a slot set
+                if slot_name == "flow_name":
+                    commands.extend(cls.start_flow_by_name(slot_value, flows))
+                else:
+                    typed_slot_value = cls.get_nullable_slot_value(slot_value)
+                    commands.append(
+                        SetSlotCommand(name=slot_name, value=typed_slot_value)
+                    )
+            elif match := start_flow_re.search(action):
+                flow_name = match.group(1).strip()
+                commands.extend(cls.start_flow_by_name(flow_name, flows))
+            elif cancel_flow_re.search(action):
+                commands.append(CancelFlowCommand())
+            elif chitchat_re.search(action):
+                commands.append(ChitChatAnswerCommand())
+            elif skip_question_re.search(action):
+                commands.append(SkipQuestionCommand())
+            elif knowledge_re.search(action):
+                commands.append(KnowledgeAnswerCommand())
+            elif humand_handoff_re.search(action):
+                commands.append(HumanHandoffCommand())
+            elif match := clarify_re.search(action):
+                options = sorted([opt.strip() for opt in match.group(1).split(",")])
+                valid_options = [
+                    flow for flow in options if flow in flows.user_flow_ids
+                ]
+                if len(set(valid_options)) == 1:
+                    commands.extend(cls.start_flow_by_name(valid_options[0], flows))
+                elif len(valid_options) > 1:
+                    commands.append(ClarifyCommand(valid_options))
+
+        return commands
+
+    @classmethod
+    def fingerprint_addon(cls: Any, config: Dict[str, Any]) -> Optional[str]:
+        """Add a fingerprint of the knowledge base for the graph."""
+        config_prompt = config.get("prompt") or config.get("prompt_template") or None
+        prompt_template = get_prompt_template(
+            config_prompt,
+            DEFAULT_COMMAND_PROMPT_TEMPLATE,
+        )
+        return deep_container_fingerprint(prompt_template)
+
+    ### Helper methods
+    def render_template(
+        self,
+        message: Message,
+        tracker: DialogueStateTracker,
+        startable_flows: FlowsList,
+        all_flows: FlowsList,
+    ) -> str:
+        """Render the jinja template to create the prompt for the LLM.
+
+        Args:
+            message: The current message from the user.
+            tracker: The tracker containing the current state of the conversation.
+            startable_flows: The flows startable at this point in time by the user.
+            all_flows: all flows present in the assistant
+
+        Returns:
+            The rendered prompt template.
+        """
+        # need to make this distinction here because current step of the
+        # top_calling_frame would be the call step, but we need the collect step from
+        # the called frame. If no call is active calling and called frame are the same.
+        top_calling_frame = top_flow_frame(tracker.stack)
+        top_called_frame = top_flow_frame(tracker.stack, ignore_call_frames=False)
+
+        top_flow = top_calling_frame.flow(all_flows) if top_calling_frame else None
+        current_step = top_called_frame.step(all_flows) if top_called_frame else None
+
+        flow_slots = self.prepare_current_flow_slots_for_template(
+            top_flow, current_step, tracker
+        )
+        current_slot, current_slot_description = self.prepare_current_slot_for_template(
+            current_step
+        )
+        current_conversation = tracker_as_readable_transcript(tracker)
+        latest_user_message = sanitize_message_for_prompt(message.get(TEXT))
+        current_conversation += f"\nUSER: {latest_user_message}"
+
+        inputs = {
+            "available_flows": self.prepare_flows_for_template(
+                startable_flows, tracker
+            ),
+            "current_conversation": current_conversation,
+            "flow_slots": flow_slots,
+            "current_flow": top_flow.id if top_flow is not None else None,
+            "current_slot": current_slot,
+            "current_slot_description": current_slot_description,
+            "user_message": latest_user_message,
+        }
+
+        return self.compile_template(self.prompt_template).render(**inputs)

rasa/dialogue_understanding/patterns/default_flows_for_patterns.yml

@@ -11,7 +11,7 @@ responses:
         template: jinja
 
   utter_can_do_something_else:
-    - text: "What else I can help you with?"
+    - text: "What else can I help you with?"
       metadata:
         rephrase: True
 
@@ -100,11 +100,11 @@ slots:
   confirm_correction:
     type: bool
     mappings:
-      - type: custom
+      - type: from_llm
 
 flows:
   pattern_cancel_flow:
-    description: A meta flow that's started when a flow is cancelled.
+    description: Conversation repair flow that starts when a flow is cancelled
     name: pattern_cancel_flow
     steps:
       - action: action_cancel_flow
@@ -112,72 +112,77 @@ flows:
 
   pattern_cannot_handle:
     description: |
-      pattern that is triggered when the command generators fail to create (any) valid commands
+      Conversation repair flow for addressing failed command generation scenarios
     name: pattern cannot handle
     steps:
       - noop: true
         next:
           # chitchat fallback
-          - if: "'{{context.reason}}' == 'cannot_handle_chitchat'"
+          - if: "'{{context.reason}}' = 'cannot_handle_chitchat'"
             then:
               - action: utter_cannot_handle
                 next: "END"
+          # fallback for things that are not supported
+          - if: "'{{context.reason}}' = 'cannot_handle_not_supported'"
+            then:
+              - action: utter_cannot_handle
+                next: END
           # default
           - else:
               - action: utter_ask_rephrase
-                next: "END"
+                next: END
 
   pattern_chitchat:
-    description: handle interactions with the user that are not task-oriented
+    description: Conversation repair flow for off-topic interactions that won't disrupt the main conversation
     name: pattern chitchat
     steps:
       - action: action_trigger_chitchat
 
   pattern_clarification:
-    description: handle clarifications with the user
+    description: Conversation repair flow for handling ambiguous requests that could match multiple flows
     name: pattern clarification
     steps:
       - action: action_clarify_flows
       - action: utter_clarification_options_rasa
 
   pattern_code_change:
-    description: flow used to clean the stack after a bot update
+    description: Conversation repair flow for cleaning the stack after an assistant update
     name: pattern code change
     steps:
       - action: utter_inform_code_change
       - action: action_clean_stack
 
   pattern_collect_information:
-    description: flow used to fill a slot
+    description: Flow for collecting information from users
     name: pattern collect information
     steps:
-      - id: "start"
+      - id: start
         action: action_run_slot_rejections
       - action: validate_{{context.collect}}
         next:
           - if: "slots.{{context.collect}} is not null"
-            then: "END"
-          - else: "ask_collect"
-      - id: "ask_collect"
+            then: END
+          - else: ask_collect
+      - id: ask_collect
         action: "{{context.utter}}"
       - action: "{{context.collect_action}}"
       - action: action_listen
-        next: "start"
+        next: start
 
   pattern_completed:
-    description: a flow has been completed and there is nothing else to be done
+    description: Flow that asks if the user needs more help after completing their initiated use cases
     name: pattern completed
     steps:
       - action: utter_can_do_something_else
 
   pattern_continue_interrupted:
-    description: A flow that should will be started to continue an interrupted flow.
+    description: Conversation repair flow for managing when users switch between different flows
     name: pattern continue interrupted
     steps:
       - action: utter_flow_continue_interrupted
 
   pattern_correction:
-    description: Handle a correction of a slot value.
+    description: Conversation repair flow for managing user input changes or error corrections
     name: pattern correction
     steps:
       - action: action_correct_flow_slot
@@ -185,36 +190,36 @@ flows:
           - if: not context.is_reset_only
             then:
               - action: utter_corrected_previous_input
-                next: "END"
-          - else: "END"
+                next: END
+          - else: END
 
   pattern_human_handoff:
-    description: human handoff
+    description: Conversation repair flow for switching users to a human agent if their request can't be handled
     name: pattern human handoff
     steps:
       - action: utter_human_handoff_not_available
 
   pattern_internal_error:
-    description: internal error
+    description: Conversation repair flow for informing users about internal errors
     name: pattern internal error
     steps:
       - noop: true
         next:
-          - if: "'{{context.error_type}}' == 'rasa_internal_error_user_input_too_long'"
+          - if: "'{{context.error_type}}' = 'rasa_internal_error_user_input_too_long'"
             then:
               - action: utter_user_input_too_long_error_rasa
-                next: "END"
-          - if: "'{{context.error_type}}' == 'rasa_internal_error_user_input_empty'"
+                next: END
+          - if: "'{{context.error_type}}' = 'rasa_internal_error_user_input_empty'"
             then:
               - action: utter_user_input_empty_error_rasa
-                next: "END"
+                next: END
           - else:
               - action: utter_internal_error_rasa
-                next: "END"
+                next: END
 
 
   pattern_restart:
-    description: flow used to restart the conversation
+    description: Flow for restarting the conversation
     name: pattern restart
     nlu_trigger:
       - intent: restart
@@ -222,14 +227,14 @@ flows:
       - action: action_restart
 
   pattern_search:
-    description: handle a knowledge-based question or request
+    description: Flow for handling knowledge-based questions
     name: pattern search
     steps:
       - action: utter_no_knowledge_base
       # - action: action_trigger_search to use doc search policy if present
 
   pattern_session_start:
-    description: flow used to start the conversation
+    description: Flow for starting the conversation
     name: pattern session start
     nlu_trigger:
       - intent: session_start
@@ -237,7 +242,7 @@ flows:
       - action: action_session_start
 
   pattern_skip_question:
-    description: flow used to handle users intent to skip questions (steps)
+    description: Conversation repair flow for managing user intents to skip questions (steps)
     name: pattern skip question
     steps:
       - action: utter_skip_question_answer