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

# User Guide

- [Installation](https://legacy-docs-v1.rasa.com/1.10.14/user-guide/installation/)
- [Tutorial: Rasa Basics](https://legacy-docs-v1.rasa.com/1.10.14/user-guide/rasa-tutorial/)
- [Tutorial: Building Assistants](https://legacy-docs-v1.rasa.com/1.10.14/user-guide/building-assistants/)
- [Command Line Interface](https://legacy-docs-v1.rasa.com/1.10.14/user-guide/command-line-interface/)
- [Architecture](https://legacy-docs-v1.rasa.com/1.10.14/user-guide/architecture/)
- [Messaging and Voice Channels](https://legacy-docs-v1.rasa.com/1.10.14/user-guide/messaging-and-voice-channels/)
- [Testing Your Assistant](https://legacy-docs-v1.rasa.com/1.10.14/user-guide/testing-your-assistant/)
- [Setting up CI/CD](https://legacy-docs-v1.rasa.com/1.10.14/user-guide/setting-up-ci-cd/)
- [Validate Data](https://legacy-docs-v1.rasa.com/1.10.14/user-guide/validate-files/)
- [Configuring the HTTP API](https://legacy-docs-v1.rasa.com/1.10.14/user-guide/configuring-http-api/)
- [Deploying Your Rasa Assistant](https://legacy-docs-v1.rasa.com/1.10.14/user-guide/how-to-deploy/)
- [Cloud Storage](https://legacy-docs-v1.rasa.com/1.10.14/user-guide/cloud-storage/)

# NLU

- [About](https://legacy-docs-v1.rasa.com/1.10.14/nlu/about/)
- [Using NLU Only](https://legacy-docs-v1.rasa.com/1.10.14/nlu/using-nlu-only/)
- [Training Data Format](https://legacy-docs-v1.rasa.com/1.10.14/nlu/training-data-format/)
- [Language Support](https://legacy-docs-v1.rasa.com/1.10.14/nlu/language-support/)
- [Choosing a Pipeline](https://legacy-docs-v1.rasa.com/1.10.14/nlu/choosing-a-pipeline/)
- [Components](https://legacy-docs-v1.rasa.com/1.10.14/nlu/components/)
- [Entity Extraction](https://legacy-docs-v1.rasa.com/1.10.14/nlu/entity-extraction/)

# Core

- [About](https://legacy-docs-v1.rasa.com/1.10.14/core/about/)
- [Stories](https://legacy-docs-v1.rasa.com/1.10.14/core/stories/)
- [Domains](https://legacy-docs-v1.rasa.com/1.10.14/core/domains/)
- [Responses](https://legacy-docs-v1.rasa.com/1.10.14/core/responses/)
- [Actions](https://legacy-docs-v1.rasa.com/1.10.14/core/actions/#)
- [Reminders and External Events](https://legacy-docs-v1.rasa.com/1.10.14/core/reminders-and-external-events/)
- [Policies](https://legacy-docs-v1.rasa.com/1.10.14/core/policies/)
- [Slots](https://legacy-docs-v1.rasa.com/1.10.14/core/slots/)
- [Forms](https://legacy-docs-v1.rasa.com/1.10.14/core/forms/)
- [Retrieval Actions](https://legacy-docs-v1.rasa.com/1.10.14/core/retrieval-actions/)
- [Interactive Learning](https://legacy-docs-v1.rasa.com/1.10.14/core/interactive-learning/)
- [Fallback Actions](https://legacy-docs-v1.rasa.com/1.10.14/core/fallback-actions/)
- [Knowledge Base Actions](https://legacy-docs-v1.rasa.com/1.10.14/core/knowledge-bases/)

# Conversation Design

- [Dialogue Elements](https://legacy-docs-v1.rasa.com/1.10.14/dialogue-elements/dialogue-elements/)
- [Small Talk](https://legacy-docs-v1.rasa.com/1.10.14/dialogue-elements/small-talk/)
- [Completing Tasks](https://legacy-docs-v1.rasa.com/1.10.14/dialogue-elements/completing-tasks/)
- [Guiding Users](https://legacy-docs-v1.rasa.com/1.10.14/dialogue-elements/guiding-users/)

# API Reference

- [Action Server](https://legacy-docs-v1.rasa.com/1.10.14/api/action-server/)
- [HTTP API](https://legacy-docs-v1.rasa.com/1.10.14/api/http-api/)
- [Jupyter Notebooks](https://legacy-docs-v1.rasa.com/1.10.14/api/jupyter-notebooks/)
- [Agent](https://legacy-docs-v1.rasa.com/1.10.14/api/agent/)
- [Custom NLU Components](https://legacy-docs-v1.rasa.com/1.10.14/api/custom-nlu-components/)
- [Rasa SDK](https://legacy-docs-v1.rasa.com/1.10.14/api/rasa-sdk/)
- [Events](https://legacy-docs-v1.rasa.com/1.10.14/api/events/)
- [Tracker](https://legacy-docs-v1.rasa.com/1.10.14/api/tracker/)
- [Tracker Stores](https://legacy-docs-v1.rasa.com/1.10.14/api/tracker-stores/)
- [Event Brokers](https://legacy-docs-v1.rasa.com/1.10.14/api/event-brokers/)
- [Lock Stores](https://legacy-docs-v1.rasa.com/1.10.14/api/lock-stores/)
- [Training Data Importers](https://legacy-docs-v1.rasa.com/1.10.14/api/training-data-importers/)
- [Featurization of Conversations](https://legacy-docs-v1.rasa.com/1.10.14/api/core-featurization/)
- [TensorFlow Configuration](https://legacy-docs-v1.rasa.com/1.10.14/api/tensorflow_usage/)
- [Migration Guide](https://legacy-docs-v1.rasa.com/1.10.14/migration-guide/)
- [Rasa Open Source Change Log](https://legacy-docs-v1.rasa.com/1.10.14/changelog/)

# Migrate from (beta)

- [Dialogflow](https://legacy-docs-v1.rasa.com/1.10.14/migrate-from/google-dialogflow-to-rasa/)
- [Wit.ai](https://legacy-docs-v1.rasa.com/1.10.14/migrate-from/facebook-wit-ai-to-rasa/)
- [LUIS](https://legacy-docs-v1.rasa.com/1.10.14/migrate-from/microsoft-luis-to-rasa/)
- [IBM Watson](https://legacy-docs-v1.rasa.com/1.10.14/migrate-from/ibm-watson-to-rasa/)

# Reference

- [Glossary](https://legacy-docs-v1.rasa.com/1.10.14/glossary/)

# 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 a response to the domain file
that starts with `utter_`:

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

If you use an external NLG service, you don’t need to specify the
responses in the domain, but you still need to add the utterance names
to the actions list of the domain.

## 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.

Rasa will call an endpoint you can specify, when a custom action is
predicted. This endpoint should be a webserver that reacts to this
call, runs the code and optionally returns information to modify
the dialogue state.

To specify, your action server use the `endpoints.yml`:

```
action_endpoint:
  url: "http://localhost:5055/webhook"
```

### Custom Actions Written in Python

For actions written in python, we have a convenient [Rasa SDK](https://legacy-docs-v1.rasa.com/1.10.14/api/rasa-sdk/#rasa-sdk) which starts
this action server for you.

## Default Actions

The available default actions are:

|     |     |
| --- | --- |
| `action_listen` | Stop predicting more actions and wait for user<br>input. |
| `action_restart` | Reset the whole conversation. Can be triggered<br>during a conversation by entering `/restart`. |
| `action_session_start` | Start a new conversation session. |
| `action_default_fallback` | Undo the last user message and
utter a message that the bot did not
understand. |
| `action_deactivate_form` | Deactivate the active form and reset the<br>requested slot. |
| `action_back` | Undo the last user message. |

All actions can be overridden by adding their name to the list in the domain.