From acfa8c0a5f927f8e6baf0b43feaf3523fd89ccf8 Mon Sep 17 00:00:00 2001 From: KirtiJha-MSFT Date: Mon, 15 Sep 2025 15:02:45 +0530 Subject: [PATCH 1/3] Updated --- msteams-platform/resources/schema/manifest-schema.md | 8 ++++---- msteams-platform/samples/integrate-web-apps-overview.md | 2 +- msteams-platform/samples/teams-low-code-solutions.md | 2 +- msteams-platform/samples/virtual-assistant.md | 6 +++--- 4 files changed, 9 insertions(+), 9 deletions(-) diff --git a/msteams-platform/resources/schema/manifest-schema.md b/msteams-platform/resources/schema/manifest-schema.md index ff914330280..fad5efdc71f 100644 --- a/msteams-platform/resources/schema/manifest-schema.md +++ b/msteams-platform/resources/schema/manifest-schema.md @@ -413,7 +413,7 @@ This version string must follow the [semver](http://semver.org/) standard (MAJOR **Required** – Microsoft app ID -The ID is a unique Microsoft-generated identifier for the app. The format of the ID is GUID. You have an ID if your bot is registered through the Microsoft Bot Framework. You have an ID if your tab's web app already signs in with Microsoft. You must enter the ID here. Otherwise, you must generate a new ID at the [Microsoft Application Registration Portal](https://aka.ms/appregistrations). Use the same ID if you add a bot. +The ID is a unique Microsoft-generated identifier for the app. The format of the ID is GUID. You have an ID if your bot is registered through the Microsoft Agents SDK. You have an ID if your tab's web app already signs in with Microsoft. You must enter the ID here. Otherwise, you must generate a new ID at the [Microsoft Application Registration Portal](https://aka.ms/appregistrations). Use the same ID if you add a bot. The ID stored in Teams admin center is the **External App ID** and it's visible as **ExternalID** on the traces. @@ -660,7 +660,7 @@ The item is an array (maximum of only one element— only one bot is allowed |Name| Type| Maximum size | Required | Description| |---|---|---|---|---| -|`botId`|String||✔️|The unique Microsoft app ID for the bot as registered with the Bot Framework. The ID can be the same as the overall [app ID](#id).| +|`botId`|String||✔️|The unique Microsoft app ID for the bot as registered with the Agents SDK. The ID can be the same as the overall [app ID](#id).| |`scopes`|Array of enums|4|✔️|Specifies whether the bot offers an experience in the context of a channel in a team, in a group chat (`groupChat`), an experience scoped to an individual user alone (`personal`) or within Copilot surfaces. These options are non-exclusive. | |`needsChannelSelector`|Boolean|||Describes whether or not the bot uses a user hint to add the bot to a specific channel.
Default value: `false` | |`isNotificationOnly`|Boolean|||Indicates whether a bot is a one-way, notification-only bot, as opposed to a conversational bot.
Default value: `false` | @@ -757,7 +757,7 @@ The item is an array (maximum of one element) with all elements of type `object` |Name| Type | Maximum Size | Required | Description       | |---|---|---|---|---| |`id`|String||64| Unique identifier for the message extension. Used when defining one-way and mutual app capability dependencies under [elementRelationshipSet](#elementrelationshipset).| -|`botId`|String|||The unique Microsoft app ID for the bot that backs the message extension, as registered with the Bot Framework. The ID can be the same as the overall App ID.| +|`botId`|String|||The unique Microsoft app ID for the bot that backs the message extension, as registered with the Agents SDK. The ID can be the same as the overall App ID.| |`composeExtensionType`|String||✔️|Type of the compose extension. Enum values are `botBased` and `apiBased`.| |`authorization`|Object| ||Authorization related information for the API-based message extension.| |`authorization.authType`|String|||Enum of possible authorization types. Supported values are `none`, `apiSecretServiceAuth`, and `microsoftEntra`.| @@ -1767,7 +1767,7 @@ Defines the content source of a given dashboard card. |Name| Type| Maximum size | Required | Description| |---|---|---|---|---| -|`botId`| String | | | The unique Microsoft app ID for the bot as registered with the Bot Framework. ID must be a GUID.| +|`botId`| String | | | The unique Microsoft app ID for the bot as registered with the Agents SDK. ID must be a GUID.| ## intuneInfo diff --git a/msteams-platform/samples/integrate-web-apps-overview.md b/msteams-platform/samples/integrate-web-apps-overview.md index 06efe608a47..c53820d7d58 100644 --- a/msteams-platform/samples/integrate-web-apps-overview.md +++ b/msteams-platform/samples/integrate-web-apps-overview.md @@ -44,7 +44,7 @@ With Power Apps, you can build business apps that connect to your business data ### Power Virtual Agents -Power Virtual Agent is a no code, guided graphical interface solution. Built on the Microsoft Power Platform and the Bot Framework. It empowers every member of your team to create and maintain rich conversational chatbots that easily integrate with the Teams platform. You can design, develop, and publish intelligent virtual agents for Teams without having to set up a development environment, create a web service, or directly register with the Bot Framework. +Power Virtual Agent is a no code, guided graphical interface solution. Built on the Microsoft Power Platform and the Agents SDK. It empowers every member of your team to create and maintain rich conversational chatbots that easily integrate with the Teams platform. You can design, develop, and publish intelligent virtual agents for Teams without having to set up a development environment, create a web service, or directly register with the Agents SDK. ### Create Virtual Assistant diff --git a/msteams-platform/samples/teams-low-code-solutions.md b/msteams-platform/samples/teams-low-code-solutions.md index f2e205d830b..d5cdc24f98d 100644 --- a/msteams-platform/samples/teams-low-code-solutions.md +++ b/msteams-platform/samples/teams-low-code-solutions.md @@ -41,7 +41,7 @@ You can [create flows to automate repetitive work tasks](https://flow.microsoft. ### ✔ Teams and Power Virtual Agents -[Power Virtual Agents](/power-virtual-agents/fundamentals-what-is-power-virtual-agents) is a no code, guided graphical interface solution, built on the Microsoft Power Platform and the Bot Framework. It empowers every member of your team to create and maintain rich, conversational chatbots that easily integrate with the Teams platform. All content authored in Power Virtual Agents renders naturally in Teams and Power Virtual Agents bots engage with users in the Teams native chat canvas. You can [integrate your Power Virtual Agents chatbot](/power-virtual-agents/publication-add-bot-to-microsoft-teams) to Teams through the [Power Virtual Agents portal](https://powervirtualagents.microsoft.com). +[Power Virtual Agents](/power-virtual-agents/fundamentals-what-is-power-virtual-agents) is a no code, guided graphical interface solution, built on the Microsoft Power Platform and the Agents SDK. It empowers every member of your team to create and maintain rich, conversational chatbots that easily integrate with the Teams platform. All content authored in Power Virtual Agents renders naturally in Teams and Power Virtual Agents bots engage with users in the Teams native chat canvas. You can [integrate your Power Virtual Agents chatbot](/power-virtual-agents/publication-add-bot-to-microsoft-teams) to Teams through the [Power Virtual Agents portal](https://powervirtualagents.microsoft.com). Use the new [Power Virtual Agents](/power-virtual-agents/teams/fundamentals-what-is-power-virtual-agents-teams) app in Teams, to create, manage, and publish conversational chatbots easily from within Teams. You can share your bots with other people in your organization to chat and get answers for their questions. diff --git a/msteams-platform/samples/virtual-assistant.md b/msteams-platform/samples/virtual-assistant.md index 00b876a1fcc..fea2d8a1146 100644 --- a/msteams-platform/samples/virtual-assistant.md +++ b/msteams-platform/samples/virtual-assistant.md @@ -8,7 +8,7 @@ ms.date: 12/21/2022 # Create Virtual Assistant -Virtual Assistant is a Microsoft open-source template that enables you to create a robust conversational solution while maintaining full control of user experience, organizational branding, and necessary data. The [Virtual Assistant core template](https://microsoft.github.io/botframework-solutions/overview/virtual-assistant-template) is the basic building block that brings together the Microsoft technologies required to build a Virtual Assistant, including the [Bot Framework SDK](https://github.com/microsoft/botframework-sdk), [Language Understanding (LUIS)](https://www.luis.ai/), and [QnA Maker](https://www.qnamaker.ai/). It also brings together the essential capabilities including skills registration, linked accounts, basic conversational intent to offer a range of seamless interactions and experiences to users. In addition, the template capabilities include rich examples of reusable conversational [skills](https://microsoft.github.io/botframework-solutions/overview/skills). Individual skills are integrated in a Virtual Assistant solution to enable multiple scenarios. Using the Bot Framework SDK, skills are presented in source code form, enabling you to customize and extend as required. For more information on skills of Bot Framework, see [What is a Bot Framework skill](https://microsoft.github.io/botframework-solutions/overview/skills/). This document guides you on Virtual Assistant implementation considerations for organizations, how to create a Teams focused Virtual Assistant, related example, code sample, and limitations of Virtual Assistant. +Virtual Assistant is a Microsoft open-source template that enables you to create a robust conversational solution while maintaining full control of user experience, organizational branding, and necessary data. The [Virtual Assistant core template](https://microsoft.github.io/botframework-solutions/overview/virtual-assistant-template) is the basic building block that brings together the Microsoft technologies required to build a Virtual Assistant, including the [Bot Framework SDK](https://github.com/microsoft/botframework-sdk), [Language Understanding (LUIS)](https://www.luis.ai/), and [QnA Maker](https://www.qnamaker.ai/). It also brings together the essential capabilities including skills registration, linked accounts, basic conversational intent to offer a range of seamless interactions and experiences to users. In addition, the template capabilities include rich examples of reusable conversational [skills](https://microsoft.github.io/botframework-solutions/overview/skills). Individual skills are integrated in a Virtual Assistant solution to enable multiple scenarios. Using the Agents SDK, skills are presented in source code form, enabling you to customize and extend as required. For more information on skills of Agents SDK, see [What is a Bot Framework skill](https://microsoft.github.io/botframework-solutions/overview/skills/). This document guides you on Virtual Assistant implementation considerations for organizations, how to create a Teams focused Virtual Assistant, related example, code sample, and limitations of Virtual Assistant. The following image displays the overview of virtual assistant: :::image type="content" source="../assets/images/bots/virtual-assistant/overview.png" alt-text="Diagram that shows Virtual Assistant overview."::: @@ -118,7 +118,7 @@ A code snippet to extract `skillId` from card action data is shown in the follo ### Handle interruptions -Virtual Assistant can handle interruptions in cases where a user tries to invoke a skill while another skill is active. `TeamsSkillDialog`, and `TeamsSwitchSkillDialog`are introduced based on Bot Framework's [SkillDialog](https://github.com/microsoft/botframework-solutions/blob/5b46d73e220bbb4fba86c48be532e495535ca78a/sdk/csharp/libraries/microsoft.bot.solutions/Skills/SkillDialog.cs) and [SwitchSkillDialog](https://github.com/microsoft/botframework-solutions/blob/6d40fa8ae05f96b0c5e0464e01361a9e1deb696c/sdk/csharp/libraries/microsoft.bot.solutions/Skills/Dialogs/SwitchSkillDialog.cs). They enable users to switch a skill experience from card actions. To handle this request, the Virtual Assistant prompts the user with a confirmation message to switch skills: +Virtual Assistant can handle interruptions in cases where a user tries to invoke a skill while another skill is active. `TeamsSkillDialog`, and `TeamsSwitchSkillDialog`are introduced based on Agents SDK's [SkillDialog](https://github.com/microsoft/botframework-solutions/blob/5b46d73e220bbb4fba86c48be532e495535ca78a/sdk/csharp/libraries/microsoft.bot.solutions/Skills/SkillDialog.cs) and [SwitchSkillDialog](https://github.com/microsoft/botframework-solutions/blob/6d40fa8ae05f96b0c5e0464e01361a9e1deb696c/sdk/csharp/libraries/microsoft.bot.solutions/Skills/Dialogs/SwitchSkillDialog.cs). They enable users to switch a skill experience from card actions. To handle this request, the Virtual Assistant prompts the user with a confirmation message to switch skills: :::image type="content" source="../assets/images/bots/virtual-assistant/switch-skills-prompt.png" alt-text="Screenshot of the confirmation prompt when switching to a new skill."::: @@ -513,7 +513,7 @@ To modify `languages` parameter, update bot skills command as follows: botskills connect --remoteManifest "" --luisFolder "" --languages "en-us, your_language_culture" --cs ``` -Virtual Assistant uses `SetLocaleMiddleware` to identify current locale and invoke corresponding dispatch model. Bot framework activity has locale field, which is used by this middleware. You can use the same for your skill as well. Book-a-room bot doesn't use this middleware and instead gets locale from Bot framework activity's [clientInfo entity](https://github.com/microsoft/botframework-sdk/blob/master/specs/botframework-activity/botframework-activity.md#clientinfo). +Virtual Assistant uses `SetLocaleMiddleware` to identify current locale and invoke corresponding dispatch model. Agents SDK activity has locale field, which is used by this middleware. You can use the same for your skill as well. Book-a-room bot doesn't use this middleware and instead gets locale from Agents SDK activity's [clientInfo entity](https://github.com/microsoft/botframework-sdk/blob/master/specs/botframework-activity/botframework-activity.md#clientinfo). ### Claim validation From bb166f6881fe8aaf75e16d18dbb517e5892a5c3e Mon Sep 17 00:00:00 2001 From: KirtiJha-MSFT Date: Mon, 15 Sep 2025 15:18:32 +0530 Subject: [PATCH 2/3] Updated --- msteams-platform/resources/schema/manifest-schema.md | 8 ++++---- msteams-platform/samples/integrate-web-apps-overview.md | 2 +- msteams-platform/samples/teams-low-code-solutions.md | 2 +- msteams-platform/samples/virtual-assistant.md | 6 +++--- 4 files changed, 9 insertions(+), 9 deletions(-) diff --git a/msteams-platform/resources/schema/manifest-schema.md b/msteams-platform/resources/schema/manifest-schema.md index fad5efdc71f..8082d709a5b 100644 --- a/msteams-platform/resources/schema/manifest-schema.md +++ b/msteams-platform/resources/schema/manifest-schema.md @@ -413,7 +413,7 @@ This version string must follow the [semver](http://semver.org/) standard (MAJOR **Required** – Microsoft app ID -The ID is a unique Microsoft-generated identifier for the app. The format of the ID is GUID. You have an ID if your bot is registered through the Microsoft Agents SDK. You have an ID if your tab's web app already signs in with Microsoft. You must enter the ID here. Otherwise, you must generate a new ID at the [Microsoft Application Registration Portal](https://aka.ms/appregistrations). Use the same ID if you add a bot. +The ID is a unique Microsoft-generated identifier for the app. The format of the ID is GUID. You have an ID if your bot is registered through the Microsoft 365 Agents SDK. You have an ID if your tab's web app already signs in with Microsoft. You must enter the ID here. Otherwise, you must generate a new ID at the [Microsoft Application Registration Portal](https://aka.ms/appregistrations). Use the same ID if you add a bot. The ID stored in Teams admin center is the **External App ID** and it's visible as **ExternalID** on the traces. @@ -660,7 +660,7 @@ The item is an array (maximum of only one element— only one bot is allowed |Name| Type| Maximum size | Required | Description| |---|---|---|---|---| -|`botId`|String||✔️|The unique Microsoft app ID for the bot as registered with the Agents SDK. The ID can be the same as the overall [app ID](#id).| +|`botId`|String||✔️|The unique Microsoft app ID for the bot as registered with the Microsoft 365 Agents SDK. The ID can be the same as the overall [app ID](#id).| |`scopes`|Array of enums|4|✔️|Specifies whether the bot offers an experience in the context of a channel in a team, in a group chat (`groupChat`), an experience scoped to an individual user alone (`personal`) or within Copilot surfaces. These options are non-exclusive. | |`needsChannelSelector`|Boolean|||Describes whether or not the bot uses a user hint to add the bot to a specific channel.
Default value: `false` | |`isNotificationOnly`|Boolean|||Indicates whether a bot is a one-way, notification-only bot, as opposed to a conversational bot.
Default value: `false` | @@ -757,7 +757,7 @@ The item is an array (maximum of one element) with all elements of type `object` |Name| Type | Maximum Size | Required | Description       | |---|---|---|---|---| |`id`|String||64| Unique identifier for the message extension. Used when defining one-way and mutual app capability dependencies under [elementRelationshipSet](#elementrelationshipset).| -|`botId`|String|||The unique Microsoft app ID for the bot that backs the message extension, as registered with the Agents SDK. The ID can be the same as the overall App ID.| +|`botId`|String|||The unique Microsoft app ID for the bot that backs the message extension, as registered with the Microsoft 365 Agents SDK. The ID can be the same as the overall App ID.| |`composeExtensionType`|String||✔️|Type of the compose extension. Enum values are `botBased` and `apiBased`.| |`authorization`|Object| ||Authorization related information for the API-based message extension.| |`authorization.authType`|String|||Enum of possible authorization types. Supported values are `none`, `apiSecretServiceAuth`, and `microsoftEntra`.| @@ -1767,7 +1767,7 @@ Defines the content source of a given dashboard card. |Name| Type| Maximum size | Required | Description| |---|---|---|---|---| -|`botId`| String | | | The unique Microsoft app ID for the bot as registered with the Agents SDK. ID must be a GUID.| +|`botId`| String | | | The unique Microsoft app ID for the bot as registered with the Microsoft 365 Agents SDK. ID must be a GUID.| ## intuneInfo diff --git a/msteams-platform/samples/integrate-web-apps-overview.md b/msteams-platform/samples/integrate-web-apps-overview.md index c53820d7d58..58b37d9283e 100644 --- a/msteams-platform/samples/integrate-web-apps-overview.md +++ b/msteams-platform/samples/integrate-web-apps-overview.md @@ -44,7 +44,7 @@ With Power Apps, you can build business apps that connect to your business data ### Power Virtual Agents -Power Virtual Agent is a no code, guided graphical interface solution. Built on the Microsoft Power Platform and the Agents SDK. It empowers every member of your team to create and maintain rich conversational chatbots that easily integrate with the Teams platform. You can design, develop, and publish intelligent virtual agents for Teams without having to set up a development environment, create a web service, or directly register with the Agents SDK. +Power Virtual Agent is a no code, guided graphical interface solution. Built on the Microsoft Power Platform and the Micorosft 365 Agents SDK. It empowers every member of your team to create and maintain rich conversational chatbots that easily integrate with the Teams platform. You can design, develop, and publish intelligent virtual agents for Teams without having to set up a development environment, create a web service, or directly register with the Microsoft 365 Agents SDK. ### Create Virtual Assistant diff --git a/msteams-platform/samples/teams-low-code-solutions.md b/msteams-platform/samples/teams-low-code-solutions.md index d5cdc24f98d..906cffe94b2 100644 --- a/msteams-platform/samples/teams-low-code-solutions.md +++ b/msteams-platform/samples/teams-low-code-solutions.md @@ -41,7 +41,7 @@ You can [create flows to automate repetitive work tasks](https://flow.microsoft. ### ✔ Teams and Power Virtual Agents -[Power Virtual Agents](/power-virtual-agents/fundamentals-what-is-power-virtual-agents) is a no code, guided graphical interface solution, built on the Microsoft Power Platform and the Agents SDK. It empowers every member of your team to create and maintain rich, conversational chatbots that easily integrate with the Teams platform. All content authored in Power Virtual Agents renders naturally in Teams and Power Virtual Agents bots engage with users in the Teams native chat canvas. You can [integrate your Power Virtual Agents chatbot](/power-virtual-agents/publication-add-bot-to-microsoft-teams) to Teams through the [Power Virtual Agents portal](https://powervirtualagents.microsoft.com). +[Power Virtual Agents](/power-virtual-agents/fundamentals-what-is-power-virtual-agents) is a no code, guided graphical interface solution, built on the Microsoft Power Platform and the Microsoft 365 Agents SDK. It empowers every member of your team to create and maintain rich, conversational chatbots that easily integrate with the Teams platform. All content authored in Power Virtual Agents renders naturally in Teams and Power Virtual Agents bots engage with users in the Teams native chat canvas. You can [integrate your Power Virtual Agents chatbot](/power-virtual-agents/publication-add-bot-to-microsoft-teams) to Teams through the [Power Virtual Agents portal](https://powervirtualagents.microsoft.com). Use the new [Power Virtual Agents](/power-virtual-agents/teams/fundamentals-what-is-power-virtual-agents-teams) app in Teams, to create, manage, and publish conversational chatbots easily from within Teams. You can share your bots with other people in your organization to chat and get answers for their questions. diff --git a/msteams-platform/samples/virtual-assistant.md b/msteams-platform/samples/virtual-assistant.md index fea2d8a1146..b1874ded052 100644 --- a/msteams-platform/samples/virtual-assistant.md +++ b/msteams-platform/samples/virtual-assistant.md @@ -8,7 +8,7 @@ ms.date: 12/21/2022 # Create Virtual Assistant -Virtual Assistant is a Microsoft open-source template that enables you to create a robust conversational solution while maintaining full control of user experience, organizational branding, and necessary data. The [Virtual Assistant core template](https://microsoft.github.io/botframework-solutions/overview/virtual-assistant-template) is the basic building block that brings together the Microsoft technologies required to build a Virtual Assistant, including the [Bot Framework SDK](https://github.com/microsoft/botframework-sdk), [Language Understanding (LUIS)](https://www.luis.ai/), and [QnA Maker](https://www.qnamaker.ai/). It also brings together the essential capabilities including skills registration, linked accounts, basic conversational intent to offer a range of seamless interactions and experiences to users. In addition, the template capabilities include rich examples of reusable conversational [skills](https://microsoft.github.io/botframework-solutions/overview/skills). Individual skills are integrated in a Virtual Assistant solution to enable multiple scenarios. Using the Agents SDK, skills are presented in source code form, enabling you to customize and extend as required. For more information on skills of Agents SDK, see [What is a Bot Framework skill](https://microsoft.github.io/botframework-solutions/overview/skills/). This document guides you on Virtual Assistant implementation considerations for organizations, how to create a Teams focused Virtual Assistant, related example, code sample, and limitations of Virtual Assistant. +Virtual Assistant is a Microsoft open-source template that enables you to create a robust conversational solution while maintaining full control of user experience, organizational branding, and necessary data. The [Virtual Assistant core template](https://microsoft.github.io/botframework-solutions/overview/virtual-assistant-template) is the basic building block that brings together the Microsoft technologies required to build a Virtual Assistant, including the [Bot Framework SDK](https://github.com/microsoft/botframework-sdk), [Language Understanding (LUIS)](https://www.luis.ai/), and [QnA Maker](https://www.qnamaker.ai/). It also brings together the essential capabilities including skills registration, linked accounts, basic conversational intent to offer a range of seamless interactions and experiences to users. In addition, the template capabilities include rich examples of reusable conversational [skills](https://microsoft.github.io/botframework-solutions/overview/skills). Individual skills are integrated in a Virtual Assistant solution to enable multiple scenarios. Using the Microsoft 365 Agents SDK, skills are presented in source code form, enabling you to customize and extend as required. For more information on skills of Microsoft 365 Agents SDK, see [What is a Bot Framework skill](https://microsoft.github.io/botframework-solutions/overview/skills/). This document guides you on Virtual Assistant implementation considerations for organizations, how to create a Teams focused Virtual Assistant, related example, code sample, and limitations of Virtual Assistant. The following image displays the overview of virtual assistant: :::image type="content" source="../assets/images/bots/virtual-assistant/overview.png" alt-text="Diagram that shows Virtual Assistant overview."::: @@ -118,7 +118,7 @@ A code snippet to extract `skillId` from card action data is shown in the follo ### Handle interruptions -Virtual Assistant can handle interruptions in cases where a user tries to invoke a skill while another skill is active. `TeamsSkillDialog`, and `TeamsSwitchSkillDialog`are introduced based on Agents SDK's [SkillDialog](https://github.com/microsoft/botframework-solutions/blob/5b46d73e220bbb4fba86c48be532e495535ca78a/sdk/csharp/libraries/microsoft.bot.solutions/Skills/SkillDialog.cs) and [SwitchSkillDialog](https://github.com/microsoft/botframework-solutions/blob/6d40fa8ae05f96b0c5e0464e01361a9e1deb696c/sdk/csharp/libraries/microsoft.bot.solutions/Skills/Dialogs/SwitchSkillDialog.cs). They enable users to switch a skill experience from card actions. To handle this request, the Virtual Assistant prompts the user with a confirmation message to switch skills: +Virtual Assistant can handle interruptions in cases where a user tries to invoke a skill while another skill is active. `TeamsSkillDialog`, and `TeamsSwitchSkillDialog`are introduced based on Microsoft 365 Agents SDK's [SkillDialog](https://github.com/microsoft/botframework-solutions/blob/5b46d73e220bbb4fba86c48be532e495535ca78a/sdk/csharp/libraries/microsoft.bot.solutions/Skills/SkillDialog.cs) and [SwitchSkillDialog](https://github.com/microsoft/botframework-solutions/blob/6d40fa8ae05f96b0c5e0464e01361a9e1deb696c/sdk/csharp/libraries/microsoft.bot.solutions/Skills/Dialogs/SwitchSkillDialog.cs). They enable users to switch a skill experience from card actions. To handle this request, the Virtual Assistant prompts the user with a confirmation message to switch skills: :::image type="content" source="../assets/images/bots/virtual-assistant/switch-skills-prompt.png" alt-text="Screenshot of the confirmation prompt when switching to a new skill."::: @@ -513,7 +513,7 @@ To modify `languages` parameter, update bot skills command as follows: botskills connect --remoteManifest "" --luisFolder "" --languages "en-us, your_language_culture" --cs ``` -Virtual Assistant uses `SetLocaleMiddleware` to identify current locale and invoke corresponding dispatch model. Agents SDK activity has locale field, which is used by this middleware. You can use the same for your skill as well. Book-a-room bot doesn't use this middleware and instead gets locale from Agents SDK activity's [clientInfo entity](https://github.com/microsoft/botframework-sdk/blob/master/specs/botframework-activity/botframework-activity.md#clientinfo). +Virtual Assistant uses `SetLocaleMiddleware` to identify current locale and invoke corresponding dispatch model. Microsoft 365 Agents SDK activity has locale field, which is used by this middleware. You can use the same for your skill as well. Book-a-room bot doesn't use this middleware and instead gets locale from Microsoft 365 Agents SDK activity's [clientInfo entity](https://github.com/microsoft/botframework-sdk/blob/master/specs/botframework-activity/botframework-activity.md#clientinfo). ### Claim validation From f00bc6e291611e5b45c7c9086a7aecbb58adec9f Mon Sep 17 00:00:00 2001 From: KirtiJha-MSFT Date: Fri, 19 Sep 2025 14:35:31 +0530 Subject: [PATCH 3/3] Updated --- msteams-platform/resources/schema/manifest-schema.md | 8 ++++---- msteams-platform/samples/integrate-web-apps-overview.md | 2 +- msteams-platform/samples/teams-low-code-solutions.md | 2 +- msteams-platform/samples/virtual-assistant.md | 6 +++--- 4 files changed, 9 insertions(+), 9 deletions(-) diff --git a/msteams-platform/resources/schema/manifest-schema.md b/msteams-platform/resources/schema/manifest-schema.md index 8082d709a5b..bddda5a5207 100644 --- a/msteams-platform/resources/schema/manifest-schema.md +++ b/msteams-platform/resources/schema/manifest-schema.md @@ -413,7 +413,7 @@ This version string must follow the [semver](http://semver.org/) standard (MAJOR **Required** – Microsoft app ID -The ID is a unique Microsoft-generated identifier for the app. The format of the ID is GUID. You have an ID if your bot is registered through the Microsoft 365 Agents SDK. You have an ID if your tab's web app already signs in with Microsoft. You must enter the ID here. Otherwise, you must generate a new ID at the [Microsoft Application Registration Portal](https://aka.ms/appregistrations). Use the same ID if you add a bot. +The ID is a unique Microsoft-generated identifier for the app. The format of the ID is GUID. You have an ID if your bot is registered through the Microsoft 365 Agents SDK (previously known as Bot Framework SDK). You have an ID if your tab's web app already signs in with Microsoft. You must enter the ID here. Otherwise, you must generate a new ID at the [Microsoft Application Registration Portal](https://aka.ms/appregistrations). Use the same ID if you add a bot. The ID stored in Teams admin center is the **External App ID** and it's visible as **ExternalID** on the traces. @@ -660,7 +660,7 @@ The item is an array (maximum of only one element— only one bot is allowed |Name| Type| Maximum size | Required | Description| |---|---|---|---|---| -|`botId`|String||✔️|The unique Microsoft app ID for the bot as registered with the Microsoft 365 Agents SDK. The ID can be the same as the overall [app ID](#id).| +|`botId`|String||✔️|The unique Microsoft app ID for the bot as registered with the Microsoft 365 Agents SDK (previously known as Bot Framework SDK). The ID can be the same as the overall [app ID](#id).| |`scopes`|Array of enums|4|✔️|Specifies whether the bot offers an experience in the context of a channel in a team, in a group chat (`groupChat`), an experience scoped to an individual user alone (`personal`) or within Copilot surfaces. These options are non-exclusive. | |`needsChannelSelector`|Boolean|||Describes whether or not the bot uses a user hint to add the bot to a specific channel.
Default value: `false` | |`isNotificationOnly`|Boolean|||Indicates whether a bot is a one-way, notification-only bot, as opposed to a conversational bot.
Default value: `false` | @@ -757,7 +757,7 @@ The item is an array (maximum of one element) with all elements of type `object` |Name| Type | Maximum Size | Required | Description       | |---|---|---|---|---| |`id`|String||64| Unique identifier for the message extension. Used when defining one-way and mutual app capability dependencies under [elementRelationshipSet](#elementrelationshipset).| -|`botId`|String|||The unique Microsoft app ID for the bot that backs the message extension, as registered with the Microsoft 365 Agents SDK. The ID can be the same as the overall App ID.| +|`botId`|String|||The unique Microsoft app ID for the bot that backs the message extension, as registered with the Microsoft 365 Agents SDK (previously known as Bot Framework SDK). The ID can be the same as the overall App ID.| |`composeExtensionType`|String||✔️|Type of the compose extension. Enum values are `botBased` and `apiBased`.| |`authorization`|Object| ||Authorization related information for the API-based message extension.| |`authorization.authType`|String|||Enum of possible authorization types. Supported values are `none`, `apiSecretServiceAuth`, and `microsoftEntra`.| @@ -1767,7 +1767,7 @@ Defines the content source of a given dashboard card. |Name| Type| Maximum size | Required | Description| |---|---|---|---|---| -|`botId`| String | | | The unique Microsoft app ID for the bot as registered with the Microsoft 365 Agents SDK. ID must be a GUID.| +|`botId`| String | | | The unique Microsoft app ID for the bot as registered with the Microsoft 365 Agents SDK (previously known as Bot Framework SDK). ID must be a GUID.| ## intuneInfo diff --git a/msteams-platform/samples/integrate-web-apps-overview.md b/msteams-platform/samples/integrate-web-apps-overview.md index 58b37d9283e..99669042d73 100644 --- a/msteams-platform/samples/integrate-web-apps-overview.md +++ b/msteams-platform/samples/integrate-web-apps-overview.md @@ -44,7 +44,7 @@ With Power Apps, you can build business apps that connect to your business data ### Power Virtual Agents -Power Virtual Agent is a no code, guided graphical interface solution. Built on the Microsoft Power Platform and the Micorosft 365 Agents SDK. It empowers every member of your team to create and maintain rich conversational chatbots that easily integrate with the Teams platform. You can design, develop, and publish intelligent virtual agents for Teams without having to set up a development environment, create a web service, or directly register with the Microsoft 365 Agents SDK. +Power Virtual Agent is a no code, guided graphical interface solution. Built on the Microsoft Power Platform and the Microsoft 365 Agents SDK (previously known as Bot Framework SDK). It empowers every member of your team to create and maintain rich conversational chatbots that easily integrate with the Teams platform. You can design, develop, and publish intelligent virtual agents for Teams without having to set up a development environment, create a web service, or directly register with the Microsoft 365 Agents SDK (previously known as Bot Framework SDK). ### Create Virtual Assistant diff --git a/msteams-platform/samples/teams-low-code-solutions.md b/msteams-platform/samples/teams-low-code-solutions.md index 906cffe94b2..3368f230c9e 100644 --- a/msteams-platform/samples/teams-low-code-solutions.md +++ b/msteams-platform/samples/teams-low-code-solutions.md @@ -41,7 +41,7 @@ You can [create flows to automate repetitive work tasks](https://flow.microsoft. ### ✔ Teams and Power Virtual Agents -[Power Virtual Agents](/power-virtual-agents/fundamentals-what-is-power-virtual-agents) is a no code, guided graphical interface solution, built on the Microsoft Power Platform and the Microsoft 365 Agents SDK. It empowers every member of your team to create and maintain rich, conversational chatbots that easily integrate with the Teams platform. All content authored in Power Virtual Agents renders naturally in Teams and Power Virtual Agents bots engage with users in the Teams native chat canvas. You can [integrate your Power Virtual Agents chatbot](/power-virtual-agents/publication-add-bot-to-microsoft-teams) to Teams through the [Power Virtual Agents portal](https://powervirtualagents.microsoft.com). +[Power Virtual Agents](/power-virtual-agents/fundamentals-what-is-power-virtual-agents) is a no code, guided graphical interface solution, built on the Microsoft Power Platform and the Microsoft 365 Agents SDK (previously known as Bot Framework SDK). It empowers every member of your team to create and maintain rich, conversational chatbots that easily integrate with the Teams platform. All content authored in Power Virtual Agents renders naturally in Teams and Power Virtual Agents bots engage with users in the Teams native chat canvas. You can [integrate your Power Virtual Agents chatbot](/power-virtual-agents/publication-add-bot-to-microsoft-teams) to Teams through the [Power Virtual Agents portal](https://powervirtualagents.microsoft.com). Use the new [Power Virtual Agents](/power-virtual-agents/teams/fundamentals-what-is-power-virtual-agents-teams) app in Teams, to create, manage, and publish conversational chatbots easily from within Teams. You can share your bots with other people in your organization to chat and get answers for their questions. diff --git a/msteams-platform/samples/virtual-assistant.md b/msteams-platform/samples/virtual-assistant.md index b1874ded052..11b86e50ec5 100644 --- a/msteams-platform/samples/virtual-assistant.md +++ b/msteams-platform/samples/virtual-assistant.md @@ -8,7 +8,7 @@ ms.date: 12/21/2022 # Create Virtual Assistant -Virtual Assistant is a Microsoft open-source template that enables you to create a robust conversational solution while maintaining full control of user experience, organizational branding, and necessary data. The [Virtual Assistant core template](https://microsoft.github.io/botframework-solutions/overview/virtual-assistant-template) is the basic building block that brings together the Microsoft technologies required to build a Virtual Assistant, including the [Bot Framework SDK](https://github.com/microsoft/botframework-sdk), [Language Understanding (LUIS)](https://www.luis.ai/), and [QnA Maker](https://www.qnamaker.ai/). It also brings together the essential capabilities including skills registration, linked accounts, basic conversational intent to offer a range of seamless interactions and experiences to users. In addition, the template capabilities include rich examples of reusable conversational [skills](https://microsoft.github.io/botframework-solutions/overview/skills). Individual skills are integrated in a Virtual Assistant solution to enable multiple scenarios. Using the Microsoft 365 Agents SDK, skills are presented in source code form, enabling you to customize and extend as required. For more information on skills of Microsoft 365 Agents SDK, see [What is a Bot Framework skill](https://microsoft.github.io/botframework-solutions/overview/skills/). This document guides you on Virtual Assistant implementation considerations for organizations, how to create a Teams focused Virtual Assistant, related example, code sample, and limitations of Virtual Assistant. +Virtual Assistant is a Microsoft open-source template that enables you to create a robust conversational solution while maintaining full control of user experience, organizational branding, and necessary data. The [Virtual Assistant core template](https://microsoft.github.io/botframework-solutions/overview/virtual-assistant-template) is the basic building block that brings together the Microsoft technologies required to build a Virtual Assistant, including the [Bot Framework SDK](https://github.com/microsoft/botframework-sdk), [Language Understanding (LUIS)](https://www.luis.ai/), and [QnA Maker](https://www.qnamaker.ai/). It also brings together the essential capabilities including skills registration, linked accounts, basic conversational intent to offer a range of seamless interactions and experiences to users. In addition, the template capabilities include rich examples of reusable conversational [skills](https://microsoft.github.io/botframework-solutions/overview/skills). Individual skills are integrated in a Virtual Assistant solution to enable multiple scenarios. Using the Microsoft 365 Agents SDK (previously known as Bot Framework SDK), skills are presented in source code form, enabling you to customize and extend as required. For more information on skills of Microsoft 365 Agents SDK (previously known as Bot Framework SDK), see [What is a Bot Framework skill](https://microsoft.github.io/botframework-solutions/overview/skills/). This document guides you on Virtual Assistant implementation considerations for organizations, how to create a Teams focused Virtual Assistant, related example, code sample, and limitations of Virtual Assistant. The following image displays the overview of virtual assistant: :::image type="content" source="../assets/images/bots/virtual-assistant/overview.png" alt-text="Diagram that shows Virtual Assistant overview."::: @@ -118,7 +118,7 @@ A code snippet to extract `skillId` from card action data is shown in the follo ### Handle interruptions -Virtual Assistant can handle interruptions in cases where a user tries to invoke a skill while another skill is active. `TeamsSkillDialog`, and `TeamsSwitchSkillDialog`are introduced based on Microsoft 365 Agents SDK's [SkillDialog](https://github.com/microsoft/botframework-solutions/blob/5b46d73e220bbb4fba86c48be532e495535ca78a/sdk/csharp/libraries/microsoft.bot.solutions/Skills/SkillDialog.cs) and [SwitchSkillDialog](https://github.com/microsoft/botframework-solutions/blob/6d40fa8ae05f96b0c5e0464e01361a9e1deb696c/sdk/csharp/libraries/microsoft.bot.solutions/Skills/Dialogs/SwitchSkillDialog.cs). They enable users to switch a skill experience from card actions. To handle this request, the Virtual Assistant prompts the user with a confirmation message to switch skills: +Virtual Assistant can handle interruptions in cases where a user tries to invoke a skill while another skill is active. `TeamsSkillDialog`, and `TeamsSwitchSkillDialog`are introduced based on Microsoft 365 Agents SDK's (previously known as Bot Framework SDK) [SkillDialog](https://github.com/microsoft/botframework-solutions/blob/5b46d73e220bbb4fba86c48be532e495535ca78a/sdk/csharp/libraries/microsoft.bot.solutions/Skills/SkillDialog.cs) and [SwitchSkillDialog](https://github.com/microsoft/botframework-solutions/blob/6d40fa8ae05f96b0c5e0464e01361a9e1deb696c/sdk/csharp/libraries/microsoft.bot.solutions/Skills/Dialogs/SwitchSkillDialog.cs). They enable users to switch a skill experience from card actions. To handle this request, the Virtual Assistant prompts the user with a confirmation message to switch skills: :::image type="content" source="../assets/images/bots/virtual-assistant/switch-skills-prompt.png" alt-text="Screenshot of the confirmation prompt when switching to a new skill."::: @@ -513,7 +513,7 @@ To modify `languages` parameter, update bot skills command as follows: botskills connect --remoteManifest "" --luisFolder "" --languages "en-us, your_language_culture" --cs ``` -Virtual Assistant uses `SetLocaleMiddleware` to identify current locale and invoke corresponding dispatch model. Microsoft 365 Agents SDK activity has locale field, which is used by this middleware. You can use the same for your skill as well. Book-a-room bot doesn't use this middleware and instead gets locale from Microsoft 365 Agents SDK activity's [clientInfo entity](https://github.com/microsoft/botframework-sdk/blob/master/specs/botframework-activity/botframework-activity.md#clientinfo). +Virtual Assistant uses `SetLocaleMiddleware` to identify current locale and invoke corresponding dispatch model. Microsoft 365 Agents SDK (previously known as Bot Framework SDK) activity has locale field, which is used by this middleware. You can use the same for your skill as well. Book-a-room bot doesn't use this middleware and instead gets locale from Microsoft 365 Agents SDK (previously known as Bot Framework SDK) activity's [clientInfo entity](https://github.com/microsoft/botframework-sdk/blob/master/specs/botframework-activity/botframework-activity.md#clientinfo). ### Claim validation