From e14ae52fb8cb6ee5e5951ec418c8d58de0c4dce4 Mon Sep 17 00:00:00 2001 From: SirajShaik-MSFT Date: Wed, 15 Oct 2025 20:12:40 +0530 Subject: [PATCH 1/4] Changed from Bot Framework to Teams AI library --- ...considerations-application-hosted-media-bots.md | 1 - .../add-power-virtual-agents-bot-to-teams.md | 2 +- .../how-to/bot-messages-ai-generated-content.md | 14 ++++++++++++++ msteams-platform/bots/how-to/bots-filesv4.md | 3 +-- 4 files changed, 16 insertions(+), 4 deletions(-) diff --git a/msteams-platform/bots/calls-and-meetings/requirements-considerations-application-hosted-media-bots.md b/msteams-platform/bots/calls-and-meetings/requirements-considerations-application-hosted-media-bots.md index 38a73674e5e..e26613f6737 100644 --- a/msteams-platform/bots/calls-and-meetings/requirements-considerations-application-hosted-media-bots.md +++ b/msteams-platform/bots/calls-and-meetings/requirements-considerations-application-hosted-media-bots.md @@ -49,7 +49,6 @@ Application-hosted media bots must be directly accessible on the internet. These * The service hosting an application-hosted media bot must also configure each VM instance with a public-facing port, which maps to the specific instance. * For an Azure Cloud Service, this requires an instance input endpoint. For more information, see [enable communication for role instances in Azure](/azure/cloud-services/cloud-services-enable-communication-role-instances). * For a VM Scale Set, a NAT rule on the load balancer must be configured. For more information, see [virtual networks and virtual machines in Azure](/azure/virtual-machines/windows/network-overview). -* Bot Framework Emulator doesn't support application-hosted media bots. The next section provides details on scalability and performance considerations of application-hosted media bots. diff --git a/msteams-platform/bots/how-to/add-power-virtual-agents-bot-to-teams.md b/msteams-platform/bots/how-to/add-power-virtual-agents-bot-to-teams.md index b5b2cd90b6c..a939da97ff9 100644 --- a/msteams-platform/bots/how-to/add-power-virtual-agents-bot-to-teams.md +++ b/msteams-platform/bots/how-to/add-power-virtual-agents-bot-to-teams.md @@ -10,7 +10,7 @@ ms.date: 03/11/2025 # Add Power Virtual Agents chatbot -Power Virtual Agents is a no-code, guided graphical interface solution that empowers every member of your team to create rich, conversational chatbots that easily integrate with the Teams platform. All content authored in Power Virtual Agents renders naturally in Teams. Power Virtual Agents bots engage with users in the Teams native chat canvas. The IT administrators, business analysts, domain specialists, and skilled app developers can design, develop, and publish intelligent virtual agents for Teams without having to setup a development environment. They can create a web service, or directly register with the Bot Framework. +Power Virtual Agents is a no-code, guided graphical interface solution that empowers every member of your team to create rich, conversational chatbots that easily integrate with the Teams platform. All content authored in Power Virtual Agents renders naturally in Teams. Power Virtual Agents bots engage with users in the Teams native chat canvas. The IT administrators, business analysts, domain specialists, and skilled app developers can design, develop, and publish intelligent virtual agents for Teams without having to setup a development environment. They can create a web service, or directly register with the Azure portal. This document guides you on how to make your chatbot available in Teams through the Power Virtual Agents portal and add your bot to Teams using Developer Portal. diff --git a/msteams-platform/bots/how-to/bot-messages-ai-generated-content.md b/msteams-platform/bots/how-to/bot-messages-ai-generated-content.md index 2a979c4a8d3..ddbcdd147bf 100644 --- a/msteams-platform/bots/how-to/bot-messages-ai-generated-content.md +++ b/msteams-platform/bots/how-to/bot-messages-ai-generated-content.md @@ -87,6 +87,7 @@ An AI label on your bot message indicates that it’s generated by AI. While AI- If you're using **Teams AI library** to build your bot, AI label is automatically enabled for all AI-powered bot messages in the `ai` module within the `PredictedSayCommand` action. For more information, see [AIEntity interface](https://github.com/microsoft/teams-ai/blob/main/js/packages/teams-ai/src/actions/SayCommand.ts#L67). + After you add an AI label, your bot's message shows an **AI generated** label next to the bot's name. When you hover over the AI label, a disclaimer appears stating, **AI-generated content may be incorrect.**. The AI label and disclaimer can't be customized for AI-powered bots. + ## Citations @@ -165,6 +169,7 @@ Citations in your bot's messages can include the following: If you're using **Teams AI library** to build your bot, citations are added to an AI-powered bot message automatically through `PredictedSayCommand` action. You can also modify the `PredictedSayCommand` action to add citations to your bot message. For more information, see [ClientCitation interface](https://github.com/microsoft/teams-ai/blob/main/js/packages/teams-ai/src/actions/SayCommand.ts#L42). + After you enable citations, the bot message includes in-text citations and references. The in-text citations display the reference details when users hover over the citation. + ## Feedback buttons @@ -348,6 +356,7 @@ export const app = new Application({ For more information, see the [const app variable](https://github.com/microsoft/teams-ai/blob/main/js/samples/04.ai-apps/h.datasource-azureOpenAI/src/app.ts#L65). After you enable feedback buttons, all `SAY` commands from the bot have `feedbackLoopEnabled` in the `channelData` object automatically set to `true`. + ### Handle feedback @@ -395,6 +405,7 @@ app.feedbackLoop(async (_context: TurnContext, _state: TurnState, feedbackLoopDa ``` For more information, see the [asynchronous callback function](https://github.com/microsoft/teams-ai/blob/main/js/samples/04.ai-apps/h.datasource-azureOpenAI/src/app.ts#L111). + ## Sensitivity label @@ -464,6 +476,7 @@ Bot responses might contain confidential information or be accessible only to ce ### Add sensitivity label For bots built using **Teams AI library**, sensitivity label can be added through `PredictedSayCommand` action. For more information, see [SensitivityUsageInfo interface](https://github.com/microsoft/teams-ai/blob/main/js/packages/teams-ai/src/types/AIEntity.ts#L46). + ## Modify `PredictedSayCommand` diff --git a/msteams-platform/bots/how-to/bots-filesv4.md b/msteams-platform/bots/how-to/bots-filesv4.md index b1024ff5d97..a1259f51306 100644 --- a/msteams-platform/bots/how-to/bots-filesv4.md +++ b/msteams-platform/bots/how-to/bots-filesv4.md @@ -10,7 +10,6 @@ ms.owner: angovil > [!IMPORTANT] > -> * This article is based on the v4 Bot Framework SDK. > * Bots don't support sending and receiving files in Government Community Cloud High (GCC High), Department of Defense (DoD), and Teams operated by 21Vianet environments. There are two ways to send files to and receive files from a bot: @@ -453,7 +452,7 @@ The following code sample demonstrates how to obtain file consent and upload fil |**Sample name** | **Description** | **.NET** | **Node.js** | **Python**| **Manifest**| |----------------|-----------------|--------------|----------------|-----------|-----------| -| File upload | This bot sample for Teams demonstrates file upload capabilities using Bot Framework v4, enabling users to upload files and view inline images within chats. | [View](https://github.com/OfficeDev/Microsoft-Teams-Samples/tree/main/samples/bot-file-upload/csharp) | [View](https://github.com/OfficeDev/Microsoft-Teams-Samples/tree/main/samples/bot-file-upload/nodejs) | [View](https://github.com/OfficeDev/Microsoft-Teams-Samples/tree/main/samples/bot-file-upload/python) | [View](https://github.com/OfficeDev/Microsoft-Teams-Samples/tree/main/samples/bot-file-upload/csharp/demo-manifest/bot-file-upload.zip) +| File upload | This bot sample for Teams demonstrates file upload capabilities using Teams AI library, enabling users to upload files and view inline images within chats. | [View](https://github.com/OfficeDev/Microsoft-Teams-Samples/tree/main/samples/bot-file-upload/csharp) | [View](https://github.com/OfficeDev/Microsoft-Teams-Samples/tree/main/samples/bot-file-upload/nodejs) | [View](https://github.com/OfficeDev/Microsoft-Teams-Samples/tree/main/samples/bot-file-upload/python) | [View](https://github.com/OfficeDev/Microsoft-Teams-Samples/tree/main/samples/bot-file-upload/csharp/demo-manifest/bot-file-upload.zip) ## Next step From e2b307eedc9ce0e13a7b6cf8bda7c3bcbebbd84e Mon Sep 17 00:00:00 2001 From: SirajShaik-MSFT Date: Wed, 15 Oct 2025 22:19:22 +0530 Subject: [PATCH 2/4] Update add-power-virtual-agents-bot-to-teams.md --- .../bots/how-to/add-power-virtual-agents-bot-to-teams.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/msteams-platform/bots/how-to/add-power-virtual-agents-bot-to-teams.md b/msteams-platform/bots/how-to/add-power-virtual-agents-bot-to-teams.md index a939da97ff9..6bdc67c9468 100644 --- a/msteams-platform/bots/how-to/add-power-virtual-agents-bot-to-teams.md +++ b/msteams-platform/bots/how-to/add-power-virtual-agents-bot-to-teams.md @@ -60,7 +60,7 @@ If [uploading custom apps is enabled](/microsoftteams/admin-settings) in your Te 1. **Create the app manifest (previously called Teams app manifest) in Developer Portal** - 1. Bots in Teams are defined by an app manifest JSON file that provides the basic information about your bot and its capabilities. In **Developer Portal**, select **Apps**, and select **New app**. + 1. The app manifest JSON file defines bots in Teams by providing basic information about the bot and its capabilities. In **Developer Portal**, select **Apps**, and select **New app**. :::image type="content" source="../../assets/images/tdp/create-new-app.png" alt-text="Screenshot shows how to create app manifest in Developer Portal."::: From beda9cb2ff5844e5cff1d10c3544cff1a49e3ee2 Mon Sep 17 00:00:00 2001 From: SirajShaik-MSFT Date: Wed, 15 Oct 2025 22:29:03 +0530 Subject: [PATCH 3/4] Update add-power-virtual-agents-bot-to-teams.md --- .../bots/how-to/add-power-virtual-agents-bot-to-teams.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/msteams-platform/bots/how-to/add-power-virtual-agents-bot-to-teams.md b/msteams-platform/bots/how-to/add-power-virtual-agents-bot-to-teams.md index 6bdc67c9468..f0c9e6e9ebb 100644 --- a/msteams-platform/bots/how-to/add-power-virtual-agents-bot-to-teams.md +++ b/msteams-platform/bots/how-to/add-power-virtual-agents-bot-to-teams.md @@ -10,7 +10,7 @@ ms.date: 03/11/2025 # Add Power Virtual Agents chatbot -Power Virtual Agents is a no-code, guided graphical interface solution that empowers every member of your team to create rich, conversational chatbots that easily integrate with the Teams platform. All content authored in Power Virtual Agents renders naturally in Teams. Power Virtual Agents bots engage with users in the Teams native chat canvas. The IT administrators, business analysts, domain specialists, and skilled app developers can design, develop, and publish intelligent virtual agents for Teams without having to setup a development environment. They can create a web service, or directly register with the Azure portal. +Power Virtual Agents is a no-code, guided graphical interface solution that empowers every member of your team to create rich, conversational chatbots that easily integrate with the Teams platform. All content authored in Power Virtual Agents renders naturally in Teams. Power Virtual Agents bots engage with users in the Teams native chat canvas. The IT administrators, business analysts, domain specialists, and skilled app developers can design, develop, and publish intelligent virtual agents for Teams without having to set up a development environment. They can create a web service, or directly register with the Azure portal. This document guides you on how to make your chatbot available in Teams through the Power Virtual Agents portal and add your bot to Teams using Developer Portal. @@ -60,7 +60,7 @@ If [uploading custom apps is enabled](/microsoftteams/admin-settings) in your Te 1. **Create the app manifest (previously called Teams app manifest) in Developer Portal** - 1. The app manifest JSON file defines bots in Teams by providing basic information about the bot and its capabilities. In **Developer Portal**, select **Apps**, and select **New app**. + 1. Bots in Teams are defined by an app manifest JSON file that provides the basic information about your bot and its capabilities. In **Developer Portal**, select **Apps**, and select **New app**. :::image type="content" source="../../assets/images/tdp/create-new-app.png" alt-text="Screenshot shows how to create app manifest in Developer Portal."::: From dd25160c0135941ebdaef981cbc1c55ef476b515 Mon Sep 17 00:00:00 2001 From: SirajShaik-MSFT Date: Wed, 15 Oct 2025 22:32:37 +0530 Subject: [PATCH 4/4] Update add-power-virtual-agents-bot-to-teams.md --- .../bots/how-to/add-power-virtual-agents-bot-to-teams.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/msteams-platform/bots/how-to/add-power-virtual-agents-bot-to-teams.md b/msteams-platform/bots/how-to/add-power-virtual-agents-bot-to-teams.md index f0c9e6e9ebb..e5efac9b7f4 100644 --- a/msteams-platform/bots/how-to/add-power-virtual-agents-bot-to-teams.md +++ b/msteams-platform/bots/how-to/add-power-virtual-agents-bot-to-teams.md @@ -90,7 +90,7 @@ If [uploading custom apps is enabled](/microsoftteams/admin-settings) in your Te 1. **Start a chat** - The set up process for adding your Power Virtual Agents chat bot to Teams is complete. You can now start a conversation with your bot in a personal chat. + The setup process for adding your Power Virtual Agents chat bot to Teams is complete. You can now start a conversation with your bot in a personal chat. ## See also