Changelog History
Page 1
-
v4.11.0 Changes
November 13, 2020November 2020 (version 4.11.0)
π Welcome to the November 2020 release of the Bot Framework SDK. We continue to focus on code quality, improving developer experience, customer requests, overall SDK improvements and partner support. We are previewing a new Cloud Adapter and other exciting things, including:
- π Teams Introduction of Teams Meeting Participant API along with new features and fixes.
- Skills We continue our 'skills everywhere!' mission by reducing development friction, enabling interruptions, and additional features.
- π Composer Continued improvements in deployment, Skills integration, features flags, and more!
- π Orchestrator (preview) Improved samples, models, and Bot Framework Composer support
- π Bot Framework Documentation We've added Adaptive Dialog support, updated docs around Adaptive Expressions, and custom .lg functions.
- π CLI Improvements to merging and importing of dialogs and assets
- Virtual Assistant Improved core runtime, advancements in skills features
- π Power Virtual Agents Thanks to the Bot Framework SDK, it is easier and easier to build a PVA Bot!
- π HealthBot Health Bot, built using the Bot Framework, continues to advance in support of multiple Health related initiatives!
Insiders : Want to try new features as soon as possible? You can download the nightly Insiders build [C#] [JS] [Python] [CLI] and try the latest updates as soon as they are available. And for the latest Bot Framework news, updates, and content, follow us on Twitter @msbotframework!
Microsoft Teams
Continued improvements enabling features for creating bots and apps in Teams.
- Get Participant Meeting API
- π CacheInfo support on Invoke responses
- OAuthInput fix
- π Meeting specific notification support
- Add on_teams_team_renamed (python only)
Skills
β To reduce development friction, you can now run and test skills locally with the Emulator without needing an AppId and password.
π Quality for skills is critical, and we're making large invements in automated testing. That work is (mostly) still in the design phase, and feedback is very welcome:
We're also continuing to bring features to skills to enable additional scenarios:
- Interruptions are enabled in BeginSkill.
- β‘οΈ Update and Delete activities from a skill.
Overall SDK Improvements
π Code quality and testing infrastructure have continued to be a focus for the this SDK release.
- 0οΈβ£ The default branch on all repositories has been renamed to 'main'.
- We have improved typing and transcript logger middleware behavior and error handling.
- β Dotnet SDK tests have been ported to xunit.
- π§ Configurable Adaptive Dialog cycle detection.
- Form Dialog preview
π Documentation
π Updates and improvements to existing documentation have continued.
- π Updated and expanded documentation for adaptive dialogs.
- β‘οΈ Updated and reorganized the security and authentication topics.
- β‘οΈ Updated information about: .lg custom functions, adaptive expressions, and memory scopes.
- β Added Java (preview) reference documentation: https://docs.microsoft.com/en-us/java/api/?term=microsoft.bot.builder
- β Added information on how to use the Bot Framework CLI commands in support of various adaptive dialog features.
- π Updated skills documentation.
- The claims validator is now required for bot a skill and skill consumer.
- β‘οΈ Updated information about Direct Line extensions.
- β‘οΈ Updated how to connect to some of the channels: Slack, Webex.
- π Archived the SDK v3 content, available at: https://docs.microsoft.com/previous-versions/azure/bot-service/index-bf-sdk
- β‘οΈ Updated information about the dialogs library and the overall architecture of a bot.
Cloud Adapter (not yet feature complete, dotnet only)
π§ The Cloud Adapter introduces an enriched configuration model and enables hosting a bot in any cloud environment.
- π Supports the Bot Framework protocol and auth model.
- π§ All the constants defining the auth model are configurable.
- Note: 4.11.0 does not have full feature parity with BotFrameworkAdapter
- Streaming support, OAuthPrompt support and full Skill support are coming soon.
- Preview: The recommendation is to continue using BotFrameworkAapter in the 4.11.0 release unless the environment requires configurable auth constants.
Orchestrator Preview
Orchestrator is a Language Understanding arbitration (βdispatchβ) technology to route incoming user utterances to an appropriate skill or to subsequent language processing service such as LUIS or QnA Maker.
- β‘οΈ It is a transformer based solution that is optimized for conversational AI applications.
- It is built to run locally in your bot.
- It is written in C++ and is available as a library in C#, Node.js and soon Python and Java.
- π The current release is designed to be used only for intent detection. Entity recognition is on the roadmap.
- Orchestrator can be used in code-first solutions or directly in Composer.
π This is a preview release with improved documentation and language models.
CLI
- π The CLI will now download an merge dialog assets.
- π Ordering of names while merging.
- π¦ Expose import resolver interface for cross-train/luis:build/qnamaker:build
- π Region support in lg translate
Virtual Assistant
- Skills improvements
- β‘οΈ Core runtime design updates
Composer
- π Please see the detailed Bot Framework Composer release notes
HealthBot
β¬οΈ The Health Bot Service is a cloud platform for virtual health assistants and health bots, Health Bot uses Bot Framework under the hood. With the latest upgrade to the Bot Framework SDK V4 foundation, Health Bot can be called as a Bot Framework skill or call subsequent custom Bot Framework skills. See more here: Health Bot Overview.
Power Virtual Agents
β Power Virtual Agents (PVA) is part of Microsoft Power Platform. In PVA, chatbots can be created with a guided, no-code graphical interface - and without the need for data scientists or developers. In the latest integration with Bot Framework SDK, PVA can be extended to create custom solutions.
- π Use Bot Framework Composer to create and connect to Bot Framework skills.
- Publish directly from Bot Framework Composer to PVA portal into PVA Topics runtime (coming soon).
π 4.11.0 Change Logs
- π BotBuilder-Dotnet
- π BotBuilder-Js
- π BotBuilder-Python
- π BotBuilder-Java
- π BotFramework-CLI
- BotFramework-WebChat
-
v4.10 Changes
August 18, 2020August 2020 (version 4.10.0)
π Welcome to the August 2020 release of the Bot Framework SDK. We are introducing some exciting Additional New Features with Updates and Enhancements. This milestone we focused on all-up quality and engineering debt, broken down across the following pillars:
π Documentation Includes improvements to existing documentation and net new documentation centered on recurring issues and developer pain points.
π Customer Supportability Improvements focused on developers seeking assistance using the Bot Framework, tools and SDKs.
Customer Ask Implemented enhancements and feature requests from the developer community and 3rd parties using the Bot Framework SDK and tools.
β Code Quality Enforcement of code styling and format rules, increased testing code coverage, and functional tests.
π Team Agility Improved validation of SDK code and integration with supporting libraries and environments. Continuous integarion and build pipleline improvements.
Insiders : Want to try new features as soon as possible? You can download the nightly Insiders build [C#] [JS] [Python] [CLI] and try the latest updates as soon as they are available. And for the latest Bot Framework news, updates, and content, follow us on Twitter @msbotframework!
π Documentation
π BF Docs GitHub
π Following feedback from customers and the Bot Framework Support Team,β―a number ofβ―net new documents have been written as well as updates to existing documentation.β―These are helpful towards providingβ―answers and information relating to recurring issues from bot developers.
- π Code comment documentation
- Samples readme improvements
- β‘οΈ SDK repository readme and wiki updates
- π New documents addressing recurring bot developer issues
π Customer Supportability
π Developers using the Microsoft Bot Framework have many avenues for getting help. See additional resources Internal tools have been improved to increase the responsiveness of the engineering team in areas of most interest to developers.
- π Creation of internal bots and improved tools for customer support
- π Improved analytics of trends in customer reported feature requests and issues
- Coordination of labels across
GitHub
repositories
Customer Ask
- β Additional Teams channel lifecycle events
- π Improved
Application Insights
integration - Coordination of labels across
Git Hub
repositories - β Add Locale to
ConversationUpdate
- β‘οΈ Update
CardAction
to support alt text for images on buttons - β‘οΈ Update
Skill Handler
to returnResource Response
- π Release of library using latest
Azure Blobs
storage - Enable custom fields for
Entity
- π Fixes to OAuthPrompt timeout and addition of EndOnInvalidMessage
- π Various bug fixes and telemetry improvements
Code Quality
- π Analyzer rules in place and running (code style and format)
- β Unit test code coverage and quality
- Increased profiling of the code base
- Swagger file unified across SDK repositories and version # introduced
- Specific SDKs asks and needs:
- Settings object pattern for C# adapters
- LG dependent files testing (C#)
- Dependency policing (JS)
- Integration tests with Direct Line JS and adaptive cards
Team Agility
π Improvements have been made across SDK repositories towards decreased CI pipeline times, improved testing, including both functional integration and unit tests.
Speedβ
- β¬οΈ Reduce time to build for SDKs (local and remote)β
- π¨ Reduce SDK unit test duration through refactoring and/or concurrent approachesβ
- π¨ Refactor ADO pipelines into smaller, separate jobs or stagesβ
- π Run as-applicable pipelines (e.g. no style-checks on .yaml files)β
βReliabilityβ
- Refine or replace current monorepo/βmono-solutionβ setups as necessaryβ
- β Address nondeterministic build/test failures
- Enable continuous integration for forked pull request submissions
- β Complete integration tests added with bots dynamically created
β‘οΈ Other Updates and Enhancements
- π Microsoft Teams Continued improvements to Microsoft Teams API support
- π Bot Framework CLI Tools
Lg
added as core plugin, publish preview builds to npm, other improvements - β‘οΈ Bot Builder Samples Readme updates, CI improvements, new Teams
Typescript
samples - π Composer Advancements in Skills support and Cognitive Services integration
- π Web Chat Many Accessibility improvements
- β‘οΈ Emulator Bug fixes and updates
Microsoft Teams
- π SDK and
OAuthPrompt
now support Teams SSO - π Increased
Adaptive Dialog
support for Teams events - βͺ SDK supprot for lifecyle events:
ChannelRestored
,TeamArchived
,TeamUnarchived
,TeamRestored
,TeamDeleted
, andTeamHardDeleted
- β‘οΈ
InstallationUpdate
activity type support - π°
LinkToMessage
added toMessageActionsPayload
Bot Framework CLI Tools
- π
Lg
added as BF-CLI core plugin - β¨ Enhancements and fixes to
lu
parser - π
QnaMaker
support extended - π Publish daily builds and RCs of
botframework-cli
to npm
Samples
- β‘οΈ Readme updates and consolidation across language samples
- π Build pipelines for samples CI
- β‘οΈ Demonstreate using Locale in
ConversationUpdate
welcome message sample - β Additional Teams samples in Typescript
- π Teams
TaskModule
samples now includes HTML/JavaScript task modules
Composer
- π The Bot Framework SDK continues to support the
Bot Framework Composer
.
π See Composer 1.1.1 Release Notes
π Web Chat
- π Many accessibility improvements and fixes
- Group activity by timestamp and sender
- Convert emoticon to Emoji
- β Added scrolling API: allow save/restore scroll position and scroll to specific activity
Emulator
- β Added an additional log panel entry on conversation start that displays the current bot's endpoint
- π Fixed a bug where trying to open the sign-in link on an OAuth card when ngrok was not configured would cause the Windows File Explorer to open
- π Improved CONTRIBUTING.md to more accurately reflect requisites to build the Emulator from source
- β‘οΈ Updates to Cosmos DB service editor dialog
β Additional New SDK Features
π Orchestrator: Transformer based solution that runs locally with your bot to dispatch across one or more Bot Builder Skills or LUIS applications or QnA Maker Knowledgebase.
π Microsoft.Bot.Builder.Azure.Queues (preview) Enables more easily interacting with Azure Queues and
ContinueConversationLater
Dialog. (Currently .NET only, coming soon to other languages)π Microsoft.Bot.Builder.Azure.Blobs
BlobsStorage
andBlobsTranscriptStore
implementations replacingAzureBlobStorage
andAzureBlobTranscriptStore
. This library uses Azure.Storage.Blobs and is a replacement for the older Microsoft.Azure.Storage.Blob used by Microsoft.Bot.Builder.Azure. (Currently .NET only, coming soon to other languages)π Changelogs:
- π BotBuilder-Dotnet
- π BotBuilder-Js
- π BotBuilder-Python
- π BotBuilder-Java
- π BotFramework-CLI
- π BotFramework-Composer
- π BotFramework-WebChat
- π BotFramework-Emulator
-
v4.9 Changes
May 12, 2020May 2020 (version 4.9.0)
π Welcome to the May 2020 release of the Bot Framework SDK. There are a number of updates in this version that we hope you will like; some of the key highlights include:
- π Skills - Skills now support adaptive dialogs and all activity types, and have improved support for SSO and OAuth. The v2.1 skill manifest is now GA. We also added Bot Framework Composer support for building and consuming Skills.
- π Microsoft Teams - Improvements in Microsoft Teams API support, including support in Java!
- π Bot Telemetry - Mapping of Dialogs into Azure AppInsights Page View Events.
- Health Check APIs - Quickly verify a bot is running.
- π Adaptive Dialogs - A more flexible, event driven dialog system for implementing multi-turn conversational patterns.
- π CLI tools for Adaptive Dialogs - new ability to merge and validate adaptive schema assets.
- Language Generation - Add language and personality responses to your bot conversations.
- Adaptive Expressions - Use bot aware expressions to react to user input and drive bot functionality.
- Authentication Improvements - SSO between Bots and Skills and improvements to X.509 auth.
- π± Generated Dialogs (Early Preview) - Automatically create robust Bot Framework Composer assets from JSON or JSON Schema that leverage Adaptive Dialogs.
- π VS Code debugger for Adaptive Dialogs (Early Preview) - Create & validate .lu and .lg documents as well as debug declaratively defined adaptive dialogs.
Insiders : Want to try new features as soon as possible? You can download the nightly Insiders build [C#] [JS] [Python] [CLI] and try the latest updates as soon as they are available. And for the latest Bot Framework news, updates, and content, follow us on Twitter @msbotframework!
Skills
β‘οΈ Skills have been updated to work with adaptive dialogs, and both adaptive and traditional dialogs will now accept all types of activities.
β‘οΈ The skill manifest schema has been updated to version 2.1. Improvements in this version include the ability to declare & share your language models, and define any type of activity that your skill can receive.
π This release also includes authentication improvements with skills, including using SSO with dialogs, and OAuth without needing a magic code in WebChat and DirectLine.
Microsoft Teams
π We continue to focus on making sure all the Teams-specific APIs are fully supported across our SDKs. This release brings full support for Microsoft Teams APIs in the preview Java SDK, including samples.
β‘οΈ The
OnTeamsMemberAdded
event in the activity handler has been updated to use the get single member endpoint under the covers, which should significantly reduce latency and reliability of this event in large teams.β‘οΈ The
TeamsChannelAccount
object has been updated to includeuserRole
(one of owner, member, or guest) andtenantId
(for the user's tenantId).Bot Telemetry
π Bots now capture Page View events, native to Application Insights, whenever a dialog is started. This allows you to use the User Flows dashboard in Application Insights to see how users move through your bot, between dialogs and where they drop out.
πHealth Check APIs
π Support was added for a new invoke named
healthCheck
that allows a sender to verify if a bot is responding to requests, and if trust can be established between the sender and the bot. The bot also has the option of overriding the response to add additional health information in the response.π Adaptive Dialogs
π Weβre also excited to make Adaptive Dialogs generally available in C# and as a preview release in JavaScript!
β‘οΈ Adaptive Dialogs, which underpin the dialog design and management authoring features found in Bot Framework Composer, enable developers to dynamically update conversation flow based on context and events. This is especially useful when dealing with more sophisticated conversation requirements, such as context switches and interruptions. Bot Framework Skills can now also leverage Adaptive Dialogs.
π Adaptive Dialogs also now support Telemetry. Data from Adaptive Dialogs, including triggers, actions and recognizers now flow into your Azure Application Insights instance.
π CLI tools for Adaptive Dialogs
β‘οΈ CLI tools for Adaptive Dialogs, Language Generation, QnaMaker and Luis Cross-train - new ability to merge and validate adaptive schema assets, augment qna and lu files, create/ update/ replace/ train/ publish LUIS and or QnA maker application and Language Generation templates manipulation.
π New CLI Tools were added for management of Adaptive Dialogs.
- π¦ bf-dialog supports merging dialog schema files and verify file format correctness.
- β‘οΈ bf-luis Adds commands to augment lu files and create/ update/ replace/ train/ publish LUIS
- β‘οΈ bf-qnamaker Adds commands to augment qna files and create/ update/ replace/ train/ publish QnAMaker
- π¦ bf-lg Parse, collate, expand and translate lg files.
Language Generation
LG is Generally Available (GA) on both the C# and JS Platforms.
π° Language Generation (LG) enables you to define multiple variations of a phrase, execute simple expressions based on context, and refer to conversational memory. At the core of language generation lies template expansion and entity substitution. You can provide one-off variation for expansion as well as conditionally expanding a template. The output from language generation can be a simple text string or multi-line response or a complex object payload that a layer above language generation will use to construct a complete activity. The Bot Framework Composer natively supports language generation to produce output activities using the LG templating system.
You can use Language Generation to:
- Achieve a coherent personality, tone of voice for your bot.
- Separate business logic from presentation.
- Include variations and sophisticated composition for any of your bot's replies.
- Construct cards, suggested actions and attachments using a structured response template.
Language Generation is achieved through:
- A markdown based .lg file that contains the templates and their composition.
Full access to the current bot's memory so you can data bind language to the state of memory. - π Parser and runtime libraries that help achieve runtime resolution.
Adaptive Expressions
Adaptive Expressions are Generally Available (GA) on both the C# and JS Platforms.
Bots use expressions to evaluate the outcome of a condition based on runtime information available in memory to the dialog or the Language Generation system. These evaluations determine how your bot reacts to user input and other factors that impact bot functionality.
π Adaptive expressions were created to address this core need as well as provide an adaptive expression language that can used with the Bot Framework SDK and other conversational AI components, like Bot Framework Composer, Language Generation, Adaptive dialogs, and Adaptive Cards.
π An adaptive expression can contain one or more explicit values, pre-built functions or [custom functions. Consumers of adaptive expressions also have the capability to inject additional supported functions. For example, all Language Generation templates are available as functions as well as additional functions that are only available within that component's use of adaptive expressions.
Authentication Improvements
π We added support for single sign-on while using Expect Replies. This applies to SSO performed between a pair of bots: host and a skill.
For Bot Identification we've added the ability to specify
sendx5c
parameter for certificate authentication. This feature was requested by customers and allows for more flexibility when using cert auth.β Additional Sovereign Clouds are supported.
π Generated Dialogs - Early Preview
π The Bot Framework has a rich collection of conversational building blocks, but
creating a bot that feels natural to converse with requires understanding and
coordinating across language understanding, language generation and dialog
management. To simplify this process and capture best practices, we've created
π the bf-generate plugin for the BotFramework CLI tool. The
π generated dialogs make use of event-driven adaptive dialogs with a rich and
evolving set of capabilities including:- π Handle out of order and multiple responses for simple and array properties.
- β Add, remove, clear and show properties.
- π Support for choosing between ambiguous entity values and entity property mappings.
- Recognizing and mapping for all LUIS prebuilt entities.
- Help function, including auto-help on multiple retries.
- Cancel
- Confirmation
VS Code Debugger - Early Preview
π Adaptive tools is a brand new Visual studio code extension you can use to create/ validate .lu and .lg documents as well as debug declaratively defined adaptive dialogs. This extension provides rich authoring & editing capabilities for .lu and .lg file formats including syntax highlighting, auto-suggest and auto-complete.
π We anticipate adding an early preview to the VS Marketplace shortly after this release.
π Bot Builder Community
π During this release, the Bot Builder Community has further raised the bar by adding more features, more adapters, and fixing more bugs.
π A revised C# Alexa Adapter and Google Home Adapter Re-built from the ground up, starting with Alexa, to allow the adapters to be consumed by Azure Bot Service and made available as channels. Improvements include better native activity type mapping, improved markdown rendering and support for more complex scenarios (such as merging multiple outgoing activities).
π A new C# Zoom Adapter. Currently supports Zoom 1:1 and channel chat capabilities, being converted to native BF activity types. Also supports the subscribing to any event a Zoom as supports (translated into Event activities), with full support for Zoom interactive messages and rich message templates.
π A RingCentral Adapter. The RingCentral Engage adapter allows you to add an additional endpoint to your bot for RingCentral Engage Digital Platform integration. The RingCentral endpoint can be used in conjunction with other channels meaning, for example, you can have a bot exposed on out of the box channels such as Facebook and Teams, but also integrated as an RingCentral Engage Digital Source SDK into RingCentral.
-
v3.16.1.40077_BotBuilder
September 23, 2018 -
v3.16.1.38906_BotBuilder
September 06, 2018 -
v3.16.1.38846_BotBuilder
September 05, 2018 -
v3.16.1.38846 Changes
September 06, 2018- π Fix for 401 errors on refresh token
- π Fix for ObjectDisposed Exception
-
v3.16.1.38843_BotBuilder
September 05, 2018 -
v3.16.1.38820_BotBuilder
September 05, 2018 -
v3.16.0.38376_BotBuilder
August 25, 2018