Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

fix: update lu format link #2107

Merged
merged 4 commits into from
Feb 27, 2020
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 1 addition & 2 deletions Composer/packages/lib/code-editor/demo/src/richEditor.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -5,8 +5,7 @@ import React, { useState } from 'react';

import { RichEditor } from '../../src';

const LU_HELP =
'https://github.com/Microsoft/botbuilder-tools/blob/master/packages/Ludown/docs/lu-file-format.md#lu-file-format';
const LU_HELP = 'https://aka.ms/lu-file-format';

const content = `# Greeting
-Good morning
Expand Down
2 changes: 1 addition & 1 deletion Composer/packages/lib/code-editor/src/LuEditor.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ import { registerLULanguage } from './languages';
import { createUrl, createWebSocket, createLanguageClient } from './utils/lspUtil';
import { RichEditor, RichEditorProps } from './RichEditor';

const LU_HELP = 'https://github.com/microsoft/botframework-cli/blob/master/packages/luis/docs/lu-file-format.md';
const LU_HELP = 'https://aka.ms/lu-file-format';
const placeholder = `> To learn more about the LU file format, read the documentation at
> ${LU_HELP}`;

Expand Down
4 changes: 2 additions & 2 deletions docs/Create-Your-First-Bot.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ Follow these six steps to create a weather bot from scratch using Bot Framework
## Prerequisites

- [Bot Framework Composer](https://github.com/microsoft/BotFramework-Composer)
- Bot Framework Emulator ([download](https://github.com/microsoft/BotFramework-Emulator/releases/tag/v4.5.2))
- Bot Framework Emulator ([download](https://github.com/microsoft/BotFramework-Emulator/releases/latest))
- LUIS authoring key ([where to find](https://docs.microsoft.com/en-us/azure/cognitive-services/luis/luis-concept-keys#programmatic-key))

## Step 1: Creating a new bot
Expand All @@ -22,7 +22,7 @@ On the right-hand side of the page, select **BF Language Understanding** for **R

In the text editor, type in the intents and utterances, then click **Save**.

**Note**: You should use the correct file format to edit the recognizer (see example below). Follow this [link](https://github.com/Microsoft/botbuilder-tools/blob/master/packages/Ludown/docs/lu-file-format.md#lu-file-format) to learn more about the LU format.
**Note**: You should use the correct file format to edit the recognizer (see example below). Follow this [link](https://aka.ms/lu-file-format) to learn more about the LU format.

![screenshot: editing the LU](Assets/LU.png)

Expand Down
41 changes: 22 additions & 19 deletions docs/CreateYourFirstBot.md
Original file line number Diff line number Diff line change
@@ -1,74 +1,77 @@
# Create your first bot

Follow these six steps to create a weather bot from scratch using Bot Framework Composer. Alternatively, watch the [video](https://microsoft-my.sharepoint.com/:v:/p/t-yangxi/EVcxF6YjGKZOvJjPZstfS5EBLVlDldzoZ5yQiqJlNs_NKw?e=zkzymp).

## Prerequisites
* [Bot Framework Composer](https://github.com/microsoft/BotFramework-Composer)
* Bot Framework Emulator ([download](https://github.com/microsoft/BotFramework-Emulator/releases/tag/v4.5.2))
* LUIS authoring key ([where to find](https://docs.microsoft.com/en-us/azure/cognitive-services/luis/luis-concept-keys#programmatic-key))

- [Bot Framework Composer](https://github.com/microsoft/BotFramework-Composer)
- Bot Framework Emulator ([download](https://github.com/microsoft/BotFramework-Emulator/releases/latest))
- LUIS authoring key ([where to find](https://docs.microsoft.com/en-us/azure/cognitive-services/luis/luis-concept-keys#programmatic-key))

## Step 1: Creating a new bot
On the Composer homepage, click **New**. Select **Create from scratch**. Click **Next**. Give your bot a name, for example *WeatherBot*. Once created, you should be able to see the following screen.

![screenshot: creating a new bot](Assets/DesignFlow.png)
On the Composer homepage, click **New**. Select **Create from scratch**. Click **Next**. Give your bot a name, for example _WeatherBot_. Once created, you should be able to see the following screen.

![screenshot: creating a new bot](Assets/DesignFlow.png)

## Step 2: Setting up the intent recognizer

On the right-hand side of the page, select **BF Language Understanding** for **Recognizer Type**.

![screenshot: setting up the recognizer](Assets/Recognizer.png)

In the text editor, type in the intents and utterances, then click **Save**.

**Note**: You should use the correct file format to edit the recognizer (see example below). Follow this [link](https://github.com/Microsoft/botbuilder-tools/blob/master/packages/Ludown/docs/lu-file-format.md#lu-file-format) to learn more about the LU format.
**Note**: You should use the correct file format to edit the recognizer (see example below). Follow this [link](https://aka.ms/lu-file-format) to learn more about the LU format.

![screenshot: editing the LU](Assets/LU.png)


## Step 3: Creating event handlers to handle the intents

On the **Events** pane, click the **add icon**, then select **Handle an Intent**.

<img src = "Assets/CreateIntentHandler.png" alt = "create intent handler" width = 250></img>

On the right-hand side of the page, give the intent a name, for example, *GreetingIntentHandler*. In the **Intent** field, type in the name of the intent that this event is intended to handle. **Note**: The name should match the intent name in the recognizer.
On the right-hand side of the page, give the intent a name, for example, _GreetingIntentHandler_. In the **Intent** field, type in the name of the intent that this event is intended to handle. **Note**: The name should match the intent name in the recognizer.

It's a good practice to create a handler for each intent. In this guide, we’ve created two handlers named *GreetingIntentHandler* and *CheckWeatherIntentHandler*.
It's a good practice to create a handler for each intent. In this guide, we’ve created two handlers named _GreetingIntentHandler_ and _CheckWeatherIntentHandler_.

<img src = "Assets/IntentName.png" alt = "Intent name" width = 500></img>


## Step 4: Adding actions to the handlers

Here we define the actions that the bot will take when an intent is recognized. You can add actions such as sending messages or performing computational tasks. You can also call a dialog ([SDK docs: Bot Framework Dialogs](https://docs.microsoft.com/en-us/azure/bot-service/bot-builder-concept-dialog?view=azure-bot-service-4.0)) as part of the actions.

### 4.1: Adding actions to *GreetingIntentHandler*
Double-click on the *GreetingIntentHandler* node to get started.
### 4.1: Adding actions to _GreetingIntentHandler_

Double-click on the _GreetingIntentHandler_ node to get started.

<img src = "Assets/GreetingIntentHandler.png" alt = "Other event handler" width = 250></img>

By design, we want the bot to send a message to the user in response to the *Greeting* intent. To do this, click the **add icon**, select **Send Messages**, then select **Send Activity**. On the **Language Generation** pane, type in the bot response. For example, *Hello from the bot!*.
By design, we want the bot to send a message to the user in response to the _Greeting_ intent. To do this, click the **add icon**, select **Send Messages**, then select **Send Activity**. On the **Language Generation** pane, type in the bot response. For example, _Hello from the bot!_.

![screenshot: LG](Assets/AddActions.png)

### 4.2 Adding actions to *CheckWeatherIntentHandler*
Double-click on the *CheckWeatherIntentHandler* node to get started. By design, we want the bot to begin a dialog (and take actions as specified in that dialog) in response to the *CheckWeather* intent. To do this, we first need to create a dialog (e.g. *CheckWeatherDialog*), then add this dialog to the *CheckWeatherIntentHandler*.
### 4.2 Adding actions to _CheckWeatherIntentHandler_

Double-click on the _CheckWeatherIntentHandler_ node to get started. By design, we want the bot to begin a dialog (and take actions as specified in that dialog) in response to the _CheckWeather_ intent. To do this, we first need to create a dialog (e.g. _CheckWeatherDialog_), then add this dialog to the _CheckWeatherIntentHandler_.

To create a dialog, click **Add** on the **Dialogs** pane, and follow the instructions to complete the process. Once a dialog is created, add actions to this dialog following the same process as described in 4.1.

<img src = "Assets/addDialog.png" alt = "Other event handler" width = 250></img>


To add the newly created dialog to the event, first, go back to the root dialog, then select the event to which you want to add the dialog. Click the **add icon**, select **Dialogs**, select **Begin a Dialog**, then choose a dialog from the list.
To add the newly created dialog to the event, first, go back to the root dialog, then select the event to which you want to add the dialog. Click the **add icon**, select **Dialogs**, select **Begin a Dialog**, then choose a dialog from the list.

![screenshot: LG](Assets/BeginADialog.png)


## Step 5: (Optional) Creating handlers for other types of events

Besides recognized intents, you may want to handle other types of events, for example, when there are unrecognized intents or when a user joins the conversation. Creating handlers for these types of events is no different from creating intent handlers. You just need to select a different event type as shown below. For example, select **Greeting (ConversationUpdate)** if you want to send a welcome message to the user when they first join the conversation (when a conversationUpdate event is trigged).

<img src = "Assets/OtherEventHandlers.png" alt = "Other event handler" width = 500></img>


## Step 6: Testing your bot

Now your bot is ready for testing! Click **Connect/Reload** on the top right corner of the screen, then select **Test in Emulator**.

**Note**: You may be prompted to **Publish LUIS models**. Please follow the link to the LUIS site, go to **Settings**, copy the **Authoring Key**, and fill out the fields to publish LUIS models.
Expand Down
2 changes: 1 addition & 1 deletion docs/concept-events-and-triggers.md
Original file line number Diff line number Diff line change
Expand Up @@ -96,7 +96,7 @@ For additional information, see [Custom event](how-to-define-triggers.md#custom-
## Further reading

- [Adaptive dialog: Recognizers, rules, steps and inputs](https://github.com/microsoft/BotBuilder-Samples/blob/master/experimental/adaptive-dialog/docs/recognizers-rules-steps-reference.md#Rules)
- [.lu format file](https://github.com/microsoft/botbuilder-tools/blob/master/packages/Ludown/docs/lu-file-format.md)
- [.lu format file](https://aka.ms/lu-file-format)
- [RegEx recognizer and LUIS recognizer](https://github.com/microsoft/BotBuilder-Samples/blob/master/experimental/adaptive-dialog/docs/recognizers-rules-steps-reference.md#regex-recognizer)

## Next
Expand Down
Loading