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

## User Guide

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

## Domains

The `Domain` defines the universe in which your assistant operates.
It specifies the `intents`, `entities`, `slots`, and `actions`
your bot should know about. Optionally, it can also include `responses`
for the things your bot can say.

### An example of a Domain

As an example, the domain created by `rasa init` has the following yaml definition:

```yaml
intents:
  - greet
  - goodbye
  - affirm
  - deny
  - mood_great
  - mood_unhappy
  - bot_challenge

responses:
  utter_greet:
  - text: "Hey! How are you?"

utter_cheer_up:
  - text: "Here is something to cheer you up:"
    image: "https://i.imgur.com/nGF1K8f.jpg"

utter_did_that_help:
  - text: "Did that help you?"

utter_happy:
  - text: "Great, carry on!"

utter_goodbye:
  - text: "Bye"

utter_iamabot:
  - text: "I am a bot, powered by Rasa."

session_config:
  session_expiration_time: 60
  carry_over_slots_to_new_session: true
```

### Custom Actions and Slots

To reference slots in your domain, you need to reference them by their **module path**. To reference custom actions, use their **name**.
For example, if you have a module called `my_actions` containing a class `MyAwesomeAction`, and module `my_slots` containing `MyAwesomeSlot`, you would add these lines to the domain file:

```yaml
actions:
  - my_custom_action
  ...

slots:
  - my_slots.MyAwesomeSlot
```

### Responses

Responses are messages the bot will send back to the user. There are two ways to use these responses:

1. If the name of the response starts with `utter_`, the response can directly be used as an action. You would add the response
to the domain:

```yaml
    responses:
      utter_greet:
    - text: "Hey! How are you?"
    ```

2. You can use the responses to generate response messages from your custom actions using the dispatcher:  
   `dispatcher.utter_message(template="utter_greet")`.

### Images and Buttons

Responses defined in a domain’s yaml file can contain images and buttons as well:

```yaml
responses:
  utter_greet:
  - text: "Hey! How are you?"
    buttons:
    - title: "great"
      payload: "great"
    - title: "super sad"
      payload: "super sad"
  utter_cheer_up:
  - text: "Here is something to cheer you up:"
    image: "https://i.imgur.com/nGF1K8f.jpg"
```

### Custom Output Payloads

You can also send any arbitrary output to the output channel using the `custom:` key.

```yaml
responses:
  utter_take_bet:
  - custom:
      blocks:
      - type: section
        text:
          text: "Make a bet on when the world will end:"
          type: mrkdwn
        accessory:
          type: datepicker
          initial_date: '2019-05-21'
          placeholder:
            type: plain_text
            text: Select a date
```

### Channel-Specific Responses

For each response, you can have multiple **response templates**. If you have certain response templates that you would like sent only to specific channels, you can specify this with the `channel:` key.

```yaml
responses:
  utter_ask_game:
  - text: "Which game would you like to play?"
    channel: "slack"
    custom:
      - # payload for Slack dropdown menu to choose a game
  - text: "Which game would you like to play?"
    buttons:
    - title: "Chess"
      payload: '/inform{"game": "chess"}'
    - title: "Checkers"
      payload: '/inform{"game": "checkers"}'
    - title: "Fortnite"
      payload: '/inform{"game": "fortnite"}'
```

### Variables

You can also use **variables** in your responses to insert information collected during the dialogue.

```yaml
responses:
  utter_greet:
  - text: "Hey, {name}. How are you?"
```

### Variations

If you want to randomly vary the response sent to the user, you can list multiple **response templates** and Rasa will randomly pick one of them:

```yaml
responses:
  utter_greeting:
  - text: "Hey, {name}. How are you?"
  - text: "Hey, {name}. How is your day going?"
```

### Ignoring entities for certain intents

If you want all entities to be ignored for certain intents, you can add the `use_entities: []` parameter to the intent in your domain file like this:

```yaml
intents:
  - greet:
      use_entities: []
```

### Session configuration

A conversation session represents the dialogue between the assistant and the user. You can define the period of inactivity after which a new conversation session is triggered in the domain under the `session_config` key.

```yaml
session_config:
  session_expiration_time: 60  # value in minutes, 0 means infinitely long
  carry_over_slots_to_new_session: true  # set to false to forget slots between sessions
```

👋 I can help you get started with Rasa and answer your technical questions.