You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/v4sdk/bot-file-basics.md
+4-6Lines changed: 4 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -35,17 +35,17 @@ Apart from these, your bot might rely on other custom services. You can leverage
35
35
36
36
## When is a .bot file created?
37
37
- If you create a bot using [Azure Bot Service](https://ms.portal.azure.com/#blade/Microsoft_Azure_Marketplace/GalleryResultsListBlade/selectedSubMenuItemId/%7B%22menuItemId%22%3A%22gallery%2FCognitiveServices_MP%2FBotService%22%2C%22resourceGroupId%22%3A%22%22%2C%22resourceGroupLocation%22%3A%22%22%2C%22dontDiscardJourney%22%3Afalse%2C%22launchingContext%22%3A%7B%22source%22%3A%5B%22GalleryFeaturedMenuItemPart%22%5D%2C%22menuItemId%22%3A%22CognitiveServices_MP%22%2C%22subMenuItemId%22%3A%22BotService%22%7D%7D), a .bot file is automatically created for you with list of connected services provisioned. The .bot is encrypted by default.
38
-
- If you create a bot using Bot Builder V4 SDK [Template](https://marketplace.visualstudio.com/items?itemName=BotBuilder.botbuilderv4) for Visual Studio or using Bot Builder [Yeoman Generator](https://www.npmjs.com/package/generator-botbuilder), a .bot file is automatically. No connected services are provisioned in this flow and the bot file is not encrypted.
38
+
- If you create a bot using Bot Builder V4 SDK [Template](https://marketplace.visualstudio.com/items?itemName=BotBuilder.botbuilderv4) for Visual Studio or using Bot Builder [Yeoman Generator](https://www.npmjs.com/package/generator-botbuilder), a .bot file is automatically created. No connected services are provisioned in this flow and the bot file is not encrypted.
39
39
- If you are starting with [BotBuilder-samples](https://github.com/Microsoft/botbuilder-samples), every sample for Bot Builder V4 SDK includes a .bot file and the .bot file is not encrypted.
40
40
- You can also create a bot file using the [MSBot](https://github.com/Microsoft/botbuilder-tools/blob/master/packages/MSBot/README.md) tool.
41
41
42
42
## What does a bot file look like?
43
43
Take a look at a sample [.bot](https://github.com/Microsoft/botbuilder-tools/blob/master/packages/MSBot/docs/sample-bot-file.json) file.
44
44
To learn about encrypting and decrypting the .bot file, see [Bot Secrets](https://github.com/Microsoft/botbuilder-tools/blob/master/packages/MSBot/docs/bot-file-encryption.md).
45
-
## Why do I need a .bot file?
46
45
46
+
## Why do I need a .bot file?
47
47
A .bot file is **not** a requirement to build bots with Bot Builder SDK. You can continue to use appsettings.json, web.config, env,
48
-
keyvault or any mechanism they you see fit to keep track of service references and keys that your bot depends on. However, to test
48
+
keyvault or any mechanism you see fit to keep track of service references and keys that your bot depends on. However, to test
49
49
the bot using the Emulator, you'll need a .bot file. The good news is that Emulator can create a .bot file for testing. To do that,
50
50
start the Emulator, click on the **create a new bot configuration** link on the Welcome page. In the dialog box that appears, type a **Bot name** and an **Endpoint URL**. Then connect.
51
51
@@ -54,11 +54,9 @@ The advantages of using .bot file are:
54
54
- Bot Framework Emulator and CLI tools rely on and work great with tracking connected services in a consistent format (in a .bot file)
55
55
- Elegant tooling solutions around services creation and management is harder without a well defined schema (.bot file).
56
56
57
-
58
57
## Using .bot file in your Bot Builder SDK bot
59
58
You can use the .bot file to get service configuration information in your bot's code. The BotFramework-Configuration library available
60
-
for [C#](https://www.nuget.org/packages/Microsoft.Bot.Configuration) and [JS](https://www.npmjs.com/package/botframework-config) helps you load a bot file and supports several methods to query and get
61
-
the appropriate service configuration information.
59
+
for [C#](https://www.nuget.org/packages/Microsoft.Bot.Configuration) and [JS](https://www.npmjs.com/package/botframework-config) helps you load a bot file and supports several methods to query and get the appropriate service configuration information.
62
60
63
61
## Additional resources
64
62
Refer to [MSBot](https://github.com/Microsoft/botbuilder-tools/blob/master/packages/MSBot/README.md) readme file for more infomration on using a bot file.
0 commit comments