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

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

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

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

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

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

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

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

### Versions
viewing: 1.10.20

### Training Data Format
#### Data Formats
You can provide training data as Markdown or as JSON, as a single file or as a directory containing multiple files. Note that Markdown is usually easier to work with.

#### Markdown Format
Markdown is the easiest Rasa NLU format for humans to read and write. Examples are listed using the unordered list syntax, e.g. minus `-`, asterisk `*`, or plus `+`.

```markdown
## intent:check_balance
- what is my balance <!-- no entity -->  
- how much do I have on my [savings](source_account) <!-- entity "source_account" has value "savings" -->  
- how much do I have on my [savings account]{"entity": "source_account", "value": "savings"} <!-- synonyms, method 1-->  
- Could I pay in [yen](currency)?  <!-- entity matched by lookup table -->

## intent:greet
- hey  
- hello

## synonym:savings   <!-- synonyms, method 2 -->  
- pink pig

## regex:zipcode
- [0-9]{5}

## lookup:additional_currencies  <!-- specify lookup tables in an external file -->  
path/to/currencies.txt
```

#### JSON Format
The JSON format consists of a top-level object called `rasa_nlu_data`, with the keys `common_examples`, `entity_synonyms` and `regex_features`.

```json
{
    "rasa_nlu_data": {
        "common_examples": [],
        "regex_features" : [],
        "lookup_tables"  : [],
        "entity_synonyms": []
    }
}
```

### Common Examples
Common examples have three components: `text`, `intent` and `entities`. The first two are strings while the last one is an array.

> - The _text_ is the user message [required]
> - The _intent_ is the intent that should be associated with the text [optional]
> - The _entities_ are specific parts of the text which need to be identified [optional]

```markdown
## intent:restaurant_search
- show me [chinese](cuisine) restaurants
```

### Regular Expression Features
Regular expressions can be used to support the intent classification and entity extraction. For example, if your entity has a deterministic structure (like a zipcode or an email address), you can use a regular expression to ease detection of that entity.

```markdown
## regex:zipcode
- [0-9]{5}
```

### Lookup Tables
Lookup tables provide a convenient way to supply a list of entity examples. The supplied lookup table files must be in a newline-delimited format.

```markdown
## lookup:plates
data/test/lookup_tables/plates.txt
```

### Normalizing Data
#### Entity Synonyms
If you define entities as having the same value they will be treated as synonyms. Here is an example of that:

```markdown
## intent:search
- in the center of [NYC]{"entity": "city", "value": "New York City"}
- in the centre of [New York City](city)
```

### Note
This document is for an old version of Rasa. The latest version is 1.10.26.