Skip to content
This repository has been archived by the owner on Jun 30, 2022. It is now read-only.

Commit

Permalink
Merge pull request #3690 from southworks/feature/southworks/documenta…
Browse files Browse the repository at this point in the history
…tion/update-overview-documentation

[Documentation] Update overview section
  • Loading branch information
peterinnesmsft committed Nov 6, 2020
2 parents f4d6227 + 2177316 commit bad8129
Show file tree
Hide file tree
Showing 5 changed files with 11 additions and 159 deletions.
6 changes: 3 additions & 3 deletions docs/_docs/overview/skills.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,13 +8,13 @@ toc: true
# {{ page.title }}
{:.no_toc}

Bot Framework Skills are re-usable conversational skill building-blocks covering conversational use-cases enabling you to add extensive functionality to a Bot within minutes. Skills include language understanding (LUIS) models, dialogs and integration code and delivered as source code enabling you to customize and extend as required. At this time we provide Calendar, Email, To Do, Point of Interest skills and a number of other experimental skills.
Bot Framework Skills are re-usable conversational skill building-blocks covering conversational use-cases enabling you to add extensive functionality to a Bot within minutes. Skills include [Language Understanding](https://docs.microsoft.com/en-us/azure/cognitive-services/luis/what-is-luis) (LUIS) models, dialogs and integration code, delivered as source code enabling you to customize and extend as required. At this time we provide Calendar, Email, To Do, Point of Interest skills and a number of other experimental skills.

A Skill is like a standard conversational bot but with the ability to be plugged in to a broader solution. This can be a complex Virtual Assistant or perhaps an Enterprise Bot seeking to stitch together multiple bots within an organization.

Apart from some minor differences that enable this special invocation pattern, a Skill looks and behaves like a regular bot. The same protocol is maintained between two bots to ensure a consistent approach. Skills for common scenarios like productivity and navigation can be used as-is or customized however a customer prefers.

>The Skill implementations currently provided are in C# only but the remote invocation nature of the Skills does enable you to invoke C# based Skills from a typescript Bot project.
>The Skill implementations currently provided are in C# only but the remote invocation nature of the Skills does enable you to invoke C# based Skills from a TypeScript Bot project.
## Available Skill samples

Expand All @@ -33,7 +33,7 @@ The following Skill samples are available out of the box, each with deployment s
### Experimental Skills

These experimental Bot Framework Skills are early prototypes to help bring Skill concepts to life for demonstrations and proof-of-concepts.
By their very nature these Skill are not complete, with only English support. If you have any feedback on these Skills, please [open a new issue](https://github.com/microsoft/botframework-solutions/issues/new/choose) on the Bot Framework Solutions repository.
By their very nature these Skills are not complete, with only English support. If you have any feedback on these Skills, please [open a new issue](https://github.com/microsoft/botframework-skills/issues/new/choose) on the Bot Framework Skills repository.

- [Automotive]({{site.baseurl}}/skills/samples/automotive)
- [Bing Search]({{site.baseurl}}/skills/samples/bing-search)
Expand Down
6 changes: 2 additions & 4 deletions docs/_docs/overview/virtual-assistant-solution.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,14 +14,12 @@ Customers and partners have increasing need to deliver advanced conversational a

At its core the [Virtual Assistant]({{site.baseurl}}//overview/virtual-assistant-template) (available in C# and TypeScript) is a project template with the best practices for developing a bot on the Microsoft Azure platform.

Common assistant scenarios are provided as reusable conversational skills, increasing developer productivity and enabling a vibrant ecosystem of reusable components. Individual skills can be added to an assistant to enable new scenarios, for example: finding a point of interest, checking off an item on a to-do list, or replying to an email. Skills are fully customizable and consist of language models and responses for multiple languages, dialogs, and code.
Common assistant scenarios are provided as reusable conversational skills, increasing developer productivity and enabling a vibrant ecosystem of reusable components. Individual skills can be added to an assistant to enable new scenarios, extending the Virtual Assistant experience with reusable [Bot Framework Skills]({{site.baseurl}}/overview/skills), for example: finding a point of interest, checking off an item on a to-do list, or replying to an email. Skills are fully customizable and consist of language models and responses for multiple languages, dialogs, and code.

Owning and enriching customer relationships and providing insights is vital to the goals of the Virtual Assistant. This contrasts with established in-market assistants that do not enable white-labelling, customization or privacy placed in control of the customer.

Further skills can be created and made available either through your own assistant or made available through a broader ecosystem enabling assistant owners to curate the capabilities that make sense for their scenario and work across industries.

Extend a Virtual Assistant experience with reusable [Bot Framework Skills]({{site.baseurl}}/overview/skills), fulfilling common scenarios such as finding a nearby point of interest, checking off an item on a to-do list, or replying to an email. Skills can be fully customized and samples are available, enabling you to get started with multiple languages, dialogs, and code.

Review analytics captured from the out-of-the-box Application Insights telemetry using the [Virtual Assistant Analytics Power BI template]({{site.baseurl}}/solution-accelerators/tutorials/view-analytics/1-intro).


Expand Down Expand Up @@ -70,7 +68,7 @@ The [Virtual Assistant core template]({{site.baseurl}}/overview/virtual-assistan
### Skills
{:.no_toc}

Bot Framework Skills leverage the new Bot Framework SDK capabilities and provide re-usable conversational skill building-blocks covering conversational use-cases enabling you to add extensive functionality to a Bot within minutes. Skills include LUIS models, Dialogs and Integration code and delivered in source code form enabling you to customize and extend as required. Provided are Calendar, Email, To Do, Point of Interest skills and a number of other experimental skills. You can find more details in the [Skills]() section of this site.
Bot Framework Skills leverage the new Bot Framework SDK capabilities and provide re-usable conversational skill building-blocks covering conversational use-cases enabling you to add extensive functionality to a Bot within minutes. Skills include LUIS models, Dialogs and Integration code and delivered in source code form enabling you to customize and extend as required. Provided are Calendar, Email, To Do, Point of Interest skills and a number of other experimental skills. You can find more details in the [Skills]({{site.baseurl}}/overview/skills) section of this site.

### Assistant Solution Accelerators
{:.no_toc}
Expand Down
12 changes: 6 additions & 6 deletions docs/_docs/overview/whats-new/0.7-beta/Summary.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,12 +24,12 @@ Virtual Assistant Core has many new features that have been added to follow the
### Bot Framework 4.6 Support
{:.no_toc}

Virtual Assistant is updated to Bot Framework 4.6. Some new capabilities of the SDK are highlighted in this document, but more details of Bot Framework 4.6 can be found [here](https://github.com/microsoft/botframework#Bot-Framework-SDK-v4).
Virtual Assistant is updated to Bot Framework 4.6. Some new capabilities of the SDK are highlighted in this document, but more details of Bot Framework 4.6 can be found [here](https://github.com/microsoft/botframework-sdk).

### Language Generation (LG) Support
{:.no_toc}

Microsoft has added support of the new [Language Generation (LG)](https://github.com/Microsoft/BotBuilder-Samples/tree/master/experimental/language-generation) features that have been added to the [Bot Framework 4.6](https://github.com/microsoft/botframework#Bot-Framework-SDK-v4) allowing for richer dialogs that have more dynamic, natural responses. Microsoft has also incorporated LG into the Virtual Assistant Skills.
Microsoft has added support of the new [Language Generation (LG)](https://docs.microsoft.com/en-us/azure/bot-service/bot-builder-concept-language-generation?view=azure-bot-service-4.0&tabs=csharp) features that have been added to the [Bot Framework 4.6](https://github.com/microsoft/botframework-sdk) allowing for richer dialogs that have more dynamic, natural responses. Microsoft has also incorporated LG into the Virtual Assistant and the Skills.

### Context Switching
{:.no_toc}
Expand All @@ -44,12 +44,12 @@ Microsoft has added speech support to Virtual Assistant enabling Speech-first ex
### Teams Channel Support
{:.no_toc}

Microsoft has worked closely with the Microsoft Teams organization to incorporate the Microsoft Teams channel as a supported channel for Virtual Assistant. As Virtual Assistant moves forward you will continue to see enhancements to allow for smoother Teams integration as a part of Virtual Assistant. An example Manifest is provided as part of the Enterprise Assistant to simplify addition of your assistant to Teams.
Microsoft has worked closely with the Microsoft Teams organization to incorporate the [Microsoft Teams channel]({{site.baseurl}}/clients-and-channels/tutorials/enable-teams/1-intro/) as a supported channel for Virtual Assistant. As Virtual Assistant moves forward you will continue to see enhancements to allow for smoother Teams integration as a part of Virtual Assistant. An example Manifest is provided as part of the Enterprise Assistant to simplify addition of your assistant to Teams.

### Multi-Turn QnA Maker Support
{:.no_toc}

Microsoft has added support to Virtual Assistant to allow for the support of Multi-Turn QnA Maker as a solution for more advanced FAQ experiences. Much of this comes with the support of [Bot Framework 4.6](https://github.com/microsoft/botframework#Bot-Framework-SDK-v4). More details you can review the [Multi-turn QnA Maker documentation](https://docs.microsoft.com/en-us/azure/cognitive-services/QnAMaker/how-to/multiturn-conversation).
Microsoft has added support to Virtual Assistant to allow for the support of Multi-Turn QnA Maker as a solution for more advanced FAQ experiences. Much of this comes with the support of [Bot Framework 4.6](https://github.com/microsoft/botframework-sdk). More details you can review the [Multi-turn QnA Maker documentation](https://docs.microsoft.com/en-us/azure/cognitive-services/QnAMaker/how-to/multiturn-conversation).


## Skills
Expand Down Expand Up @@ -82,7 +82,7 @@ Microsoft has introduced the concept of Assistant Samples during this time. As w
### Base Virtual Assistant
{:.no_toc}

Microsoft has not necessarily released a new capability as much as the concept of an Empty Core assistant that allows for customers to build from a completely empty solution that does not incorporate any pre-installed skills. This has always been the basis of the Virtual Assistant, but we want to ensure that this is the base that customers can start with if they want to assemble a solution that one of the other examples does not fit easily to their solution.
Microsoft has not necessarily released a new capability as much as the concept of an Empty Core assistant that allows for customers to build from a completely empty solution that does not incorporate any pre-installed skills. This has always been the basis of the Virtual Assistant, but we want to ensure that this is the base that customers can start with if they want to assemble a solution that one of the other examples does not fit easily to their solution. You can get more details around this sample [here]({{site.baseurl}}/overview/virtual-assistant-template).

### Enterprise Assistant Sample
{:.no_toc}
Expand Down Expand Up @@ -123,7 +123,7 @@ This sample application can be used to quickly test your Virtual Assistant or an
### Teams Channel Support
{:.no_toc}

Microsoft has added Teams Channel support to our [Bot Framework 4.6](https://github.com/microsoft/botframework#Bot-Framework-SDK-v4) channel and is now supported for Out of the Box use with Virtual Assistant.
Microsoft has added Teams Channel support to our [Bot Framework 4.6](https://github.com/microsoft/botframework-sdk) channel and is now supported for Out of the Box use with Virtual Assistant.


## Summary
Expand Down
Loading

0 comments on commit bad8129

Please sign in to comment.