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

## User Guide

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

## NLU

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

## Core

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

## Conversation Design

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

## API Reference

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

## Migrate from (beta)

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

## Reference

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

## Forms

### Note

There is an in-depth tutorial [here](https://blog.rasa.com/building-contextual-assistants-with-rasa-formaction/) about how to use Rasa Forms for slot filling.

#### Configuration File

To use forms, you also need to include the `FormPolicy` in your policy configuration file. For example:

```yaml
policies:
  - name: "FormPolicy"
```

#### Form Basics

Using a `FormAction`, you can describe _all_ of the happy paths with a single story. By “happy path”, we mean that whenever you ask a user for some information, they respond with the information you asked for.

```yaml
## happy path
* request_restaurant
    - restaurant_form
    - form{"name": "restaurant_form"}
    - form{"name": null}
```

The `FormAction` will only request slots which haven’t already been set. If a user starts the conversation with
I’d like a vegetarian Chinese restaurant for 8 people, then they won’t be asked about the `cuisine` and `num_people` slots.

#### Custom slot mappings

If you do not define slot mappings, slots will be only filled by entities with the same name as the slot that are picked up from the user input. Some slots, like `cuisine`, can be picked up using a single entity, but a `FormAction` can also support yes/no questions and free-text input.

#### Validating user input

After extracting a slot value from user input, the form will try to validate the value of the slot. Note that by default, validation only happens if the form action is executed immediately after user input.

#### Handling unhappy paths

Of course your users will not always respond with the information you ask of them. Typically, users will ask questions, make chitchat, change their mind, or otherwise stray from the happy path.

## Debugging

The first thing to try is to run your bot with the `debug` flag, see [Command Line Interface](https://legacy-docs-v1.rasa.com/1.10.0/user-guide/command-line-interface/#command-line-interface) for details.