V3 Deprecation Notification
Microsoft Bot Framework SDK V4 was released in September 2018, and since then we have shipped a few dot-release improvements. As announced previously, the V3 SDK is being retired with final long-term support ending on December 31st, 2019. Accordingly, there will be no more development in this repo. Existing V3 bot workloads will continue to run without interruption. We have no plans to disrupt any running workloads.
We highly recommend that you start migrating your V3 bots to V4. In order to support this migration we have produced migration documentation and will provide extended support for migration initiatives (via standard channels such as Stack Overflow and Microsoft Customer Support).
For more information please refer to the following references:
- Migration Documentation: https://aka.ms/bf-migration-overview
- End of lifetime support announcement: https://aka.ms/bfmigfaq
- Primary V4 Repositories to develop Bot Framework bots
- QnA Maker Libraries were replaced with the following V4 libraries:
- Azure Libraries were replaced with the following V4 libraries:
Bot Builder SDK
If you are new to the Bot Builder SDK, we strongly encourage you to build your bot using the v4 SDK.
This repo contains version 3.
The Bot Builder SDK enables you to build bots that support different types of interactions with users. You can design conversations in your bot to be freeform. Your bot can also have more guided interactions where it provides the user choices or actions. The conversation can use simple text or more complex rich cards that contain text, images, and action buttons. You can add natural language interactions and questions and answers, which let your users interact with your bots in a natural way.
The Bot Builder includes a set of command line tools to streamline end-to-end conversation centric development experience, and an emulator for debugging your bot locally or in the cloud.
You can create a bot with Bot Builder v3 SDK using your favorite language:
Documentation
Visit azure.com for the primary Azure Bot Service documentation page to learn about building bots using Bot Builder. There is additional documentation on the SDK, oriented towards contributors. The v3 SDK currently supports two programing language:
Samples
Bot builder SDK v3 includes samples for all supported languages:
Questions and Help
If you have questions about Bot Builder SDK v3 or using Azure Bot Service, we encourage you to reach out to the community and Azure Bot Service dev team for help.
- For questions which fit the Stack Overflow format ("how does this work?"), we monitor the both Azure-bot-service and bot framework tags (search both)
- You can also tweet/follow @msbotframework
While we do our best to help out on a timely basis, we don't have any promise around the above resources. If you need an SLA on support from us, it's recommended you invest in an Azure Support plan.
Issues and feature requests
We track functional issues and features asks for and Bot Builder and Azure Bot Service in a variety of locations. If you have found an issue or have a feature request, please submit an issue to the below repositories.
| Item | Description | Link |
|---|---|---|
| SDK v3 (.NET and JS) | core bot runtime, abstractions, prompts, dialogs, FormFlow, etc. | File an issue |
| Documentation | Docs for Bot Builder and Azure Bot Service | File an issue |
| CLI tools | MSBot, chatdown, ludown, LUIS, LUISGen, QnA Maker, dispatch | File an issue |
| Emulator | view transcripts, connect to services, debug your bot | File an issue |
Helpful links
GitHub repositories
- SDK v3 (.NET and node)
- SDK v4 - .NET
- SDK v4 - JavaScript
- SDK v4 - Python
- SDK v4 - Java
- Bot Builder tools
- Bot Builder Emulator
Documentation
Adding intelligence to your bot
Your bot can provide a great conversational experience without using any Azure Cognitive Services. You can increase your customers' delight with adding a more natural interaction using one or multiple Azure Cognitive Services. The following are common services integrated to bots:
- LUIS
- QnA Maker
- Speech
- Personality Chat - Handles Small-Talk/Chitchat for any bot, in line with a distinct personality.
- all Azure Cognitive Services
Get started quickly with our samples:
- Bot Builder samples GitHub repo
- More samples are available within the SDK C#, Node.js
Join the conversation on Gitter.
See all the support options here.
This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.