Actions

These docs are for version 1.x of Rasa Open Source.

User Guide

• Installation
• Rasa Tutorial
• Command Line Interface
• Architecture
• Messaging and Voice Channels
• Evaluating Models
• Validate Data
• Running the Server
• Running Rasa with Docker
• Cloud Storage

NLU

• About
• Using NLU Only
• Training Data Format
• Choosing a Pipeline
• Language Support
• Entity Extraction
• Components

Core

• About
• Stories
• Domains
• Responses
• Actions
• Policies
• Slots
• Forms
• Retrieval Actions
• Interactive Learning
• Fallback Actions
• Knowledge Base Actions

Conversation Design

• Dialogue Elements
• Small Talk
• Completing Tasks
• Guiding Users

API Reference

• Action Server
• HTTP API
• Jupyter Notebooks
• Agent
• Custom NLU Components
• Events
• Tracker
• Tracker Stores
• Event Brokers
• Lock Stores
• Training Data Importers
• Featurization
• Migration Guide
• Rasa Change Log

Migrate from (beta)

• Dialogflow
• Wit.ai
• LUIS
• IBM Watson

Reference

• Glossary

Versions

viewing: 1.3.10

Actions

Actions are the things your bot runs in response to user input. There are four kinds of actions in Rasa:

1. Utterance actions: start with utter_ and send a specific message to the user.
2. Retrieval actions: start with respond_ and send a message selected by a retrieval model.
3. Custom actions: run arbitrary code and send any number of messages (or none).
4. Default actions: e.g. action_listen, action_restart, action_default_fallback.

Utterance Actions

To define an utterance action (ActionUtterTemplate), add an utterance template to the domain file that starts with utter_:

templates:
  utter_my_message:
    - "this is what I want my action to say!"

Retrieval Actions

Retrieval actions make it easier to work with a large number of similar intents like chitchat and FAQs.

Custom Actions

An action can run any code you want. Custom actions can turn on the lights, add an event to a calendar, check a user’s bank balance, or anything else you can imagine.

# Example for custom action
from rasa_sdk import Action
from rasa_sdk.events import SlotSet

class ActionCheckRestaurants(Action):
   def name(self) -> Text:
      return "action_check_restaurants"

def run(self,
           dispatcher: CollectingDispatcher,
           tracker: Tracker,
           domain: Dict[Text, Any]) -> List[Dict[Text, Any]]:

cuisine = tracker.get_slot('cuisine')
      q = "select * from restaurants where cuisine='{0}' limit 1".format(cuisine)
      result = db.query(q)

return [SlotSet("matches", result if result is not None else [])]

Default Actions

There are eight default actions: