Events

Conversations in Rasa are represented as a sequence of events. This page lists the event types defined in Rasa Core.

Note
If you are using the Rasa SDK to write custom actions in Python, you need to import the events from rasa_sdk.events, not from rasa.core.events. If you are writing actions in another language, your events should be formatted like the JSON objects on this page.

General Purpose Events

Set a Slot

Short
Event to set a slot on a tracker
JSON

evt = {"event": "slot", "name": "departure_airport", "value": "BER"}

The user has specified their preference for the value of a slot.

Restart a conversation

Short
Resets anything logged on the tracker.
JSON

evt = {"event": "restart"}

Conversation should start over & history wiped.

Reset all Slots

Short
Resets all the slots of a conversation.
JSON

evt = {"event": "reset_slots"}

If you want to keep the dialogue history and only want to reset the slots, you can use this event to set all the slots to their initial values.

Schedule a reminder

Short
Schedule an intent to be triggered in the future.
JSON

evt = {
  "event": "reminder",
  "intent": "my_intent",
  "entities": {"entity1": "value1", "entity2": "value2"},
  "date_time": "2018-09-03T11:41:10.128172",
  "name": "my_reminder",
  "kill_on_user_msg": true,
}

Schedules the asynchronous triggering of a user intent (with entities if needed) at a given time.

Cancel a reminder

Short
Cancel one or more reminders.
JSON

evt = {
  "event": "cancel_reminder",
  "name": "my_reminder",
  "intent": "my_intent",
  "entities": [
        {"entity": "entity1", "value": "value1"},
        {"entity": "entity2", "value": "value2"}
    ],
  "date_time": "2018-09-03T11:41:10.128172",
}

Cancel certain jobs.

Pause a conversation

Short
Stops the bot from responding to messages. Action prediction will be halted until resumed.
JSON

evt = {"event": "pause"}

Ignore messages from the user to let a human take over.

Resume a conversation

Short
Resumes a previously paused conversation. The bot will start predicting actions again.
JSON

evt = {"event": "resume"}

Bot takes over conversation.

Force a followup action

Short
Instead of predicting the next action, force the next action to be a fixed one.
JSON

evt = {"event": "followup", "name": "my_action"}

Enqueue a followup action.

Automatically tracked events

User sent message

Short
Message a user sent to the bot.
JSON

evt = {
    "event": "user",
    "text": "Hey",
    "parse_data": {
        "intent": {
            "name": "greet",
            "confidence": 0.9
        },
        "entities": []
    },
    "metadata": {},
}

The user has said something to the bot.

Bot responded message

Short
Message a bot sent to the user.
JSON

evt = {"event": "bot", "text": "Hey there!", "data": {}}

The bot has said something to the user.

Undo a user message

Short
Undoes all side effects that happened after the last user message (including the user event of the message).
JSON

evt = {"event": "rewind"}

Bot reverts everything until before the most recent user message.

Undo an action

Short
Undoes all side effects that happened after the last action (including the action event of the action).
JSON

evt = {"event": "undo"}

Bot undoes its last action.

Log an executed action

Short
Logs an action the bot executed to the conversation. Events that action created are logged separately.
JSON

evt = {"event": "action", "name": "my_action"}

An operation describes an action taken + its result.

Start a new conversation session

Short
Marks the beginning of a new conversation session. Resets the tracker and triggers an ActionSessionStart which by default applies the existing SlotSet events to the new session.
JSON

evt = {"event": "session_started"}

Mark the beginning of a new conversation session.