From c20b3bccdcde4087a176b7dbc55110b45983889d Mon Sep 17 00:00:00 2001 From: KirtiJha-MSFT Date: Tue, 7 Oct 2025 15:16:15 +0530 Subject: [PATCH 01/12] Updated --- .../appsource/prepare/review-copilot-validation-guidelines.md | 1 - .../messaging-extensions/build-bot-based-message-extension.md | 4 ++++ 2 files changed, 4 insertions(+), 1 deletion(-) diff --git a/msteams-platform/concepts/deploy-and-publish/appsource/prepare/review-copilot-validation-guidelines.md b/msteams-platform/concepts/deploy-and-publish/appsource/prepare/review-copilot-validation-guidelines.md index d36fc68112d..4f51a263b95 100644 --- a/msteams-platform/concepts/deploy-and-publish/appsource/prepare/review-copilot-validation-guidelines.md +++ b/msteams-platform/concepts/deploy-and-publish/appsource/prepare/review-copilot-validation-guidelines.md @@ -15,7 +15,6 @@ ms.collection: ce-skilling-ai-copilot > [!IMPORTANT] > > * These guidelines are applicable for Independent Software Vendors (ISV) who want to publish their agent on the store. -> * Message extensions agents in Microsoft 365 Copilot are in public preview for Microsoft Word and Microsoft PowerPoint. > * Support for Excel and OneNote client applications to be available soon. > * Ensure that Microsoft 365 Copilot is available for your organization. You have two ways to get a developer environment for Microsoft 365 Copilot: > * A sandbox Microsoft 365 tenant with Microsoft 365 Copilot (available in limited preview through [TAP membership](https://developer.microsoft.com/microsoft-365/tap)). diff --git a/msteams-platform/messaging-extensions/build-bot-based-message-extension.md b/msteams-platform/messaging-extensions/build-bot-based-message-extension.md index bc7a892b765..f72a78bb313 100644 --- a/msteams-platform/messaging-extensions/build-bot-based-message-extension.md +++ b/msteams-platform/messaging-extensions/build-bot-based-message-extension.md @@ -11,6 +11,10 @@ ms.date: 09/16/2024 # Build message extensions using Bot Framework +> [!IMPORTANT] +> +> Message extensions are no longer supported as agents. + Message extensions built using Bot Framework (Bot-based) use a web service as a bot. You can use message extensions to enable users to interact with your web service from different locations in the Teams client, such as the compose message area, the command box, or directly from a message and send back structured data, such as cards. Bot-based message extension takes advantage of the Bot Framework's messaging schema and secure communication protocol. The bot is defined in the app manifest for the Teams app and you can also define different types of commands for your message extension, such as action commands or search commands. From f3aa486fed1103428fef2abd43573a704146fd25 Mon Sep 17 00:00:00 2001 From: KirtiJha-MSFT Date: Tue, 7 Oct 2025 16:22:37 +0530 Subject: [PATCH 02/12] Update .openpublishing.redirection.json --- .openpublishing.redirection.json | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/.openpublishing.redirection.json b/.openpublishing.redirection.json index b4e4e5b4ce4..86f0ca49bc9 100644 --- a/.openpublishing.redirection.json +++ b/.openpublishing.redirection.json @@ -1487,6 +1487,14 @@ { "source_path": "msteams-platform/resources/schema/manifest-schema-dev-preview.md", "redirect_url": "/microsoftteams/platform/resources/dev-preview/developer-preview" + }, + { + "source_path": "msteams-platform/messaging-extensions/build-bot-based-agent.md", + "redirect_url": "/microsoftteams/platform/messaging-extensions/build-bot-based-message-extension" + }, + { + "source_path": "msteams-platform/messaging-extensions/dev-guidelines-agents.md", + "redirect_url": "/microsoftteams/platform/concepts/deploy-and-publish/appsource/prepare/review-copilot-validation-guidelines" } ] } From d46449ad8788cebb9deed61f51855cc46587150d Mon Sep 17 00:00:00 2001 From: KirtiJha-MSFT Date: Tue, 7 Oct 2025 18:02:41 +0530 Subject: [PATCH 03/12] Update review-copilot-validation-guidelines.md --- .../appsource/prepare/review-copilot-validation-guidelines.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/msteams-platform/concepts/deploy-and-publish/appsource/prepare/review-copilot-validation-guidelines.md b/msteams-platform/concepts/deploy-and-publish/appsource/prepare/review-copilot-validation-guidelines.md index 4f51a263b95..c61f12dffa8 100644 --- a/msteams-platform/concepts/deploy-and-publish/appsource/prepare/review-copilot-validation-guidelines.md +++ b/msteams-platform/concepts/deploy-and-publish/appsource/prepare/review-copilot-validation-guidelines.md @@ -138,9 +138,9 @@ You must ensure the following guidelines for sample prompts and prompt starters: ### Sample prompts -For message extension based declarative agent, the [`samplePrompts`](/microsoft-365/extensibility/schema/root-compose-extensions-commands-sample-prompts) property provides guidance to users on utilizing the agents in Microsoft 365 Copilot +For declarative agent, the [`samplePrompts`](/microsoft-365/extensibility/schema/root-compose-extensions-commands-sample-prompts) property provides guidance to users on utilizing the agents in Microsoft 365 Copilot -:::image type="content" source="../../../../assets/images/Copilot/bot-based-sample-prompts.png" alt-text="Screenshot shows the sample prompts displayed when the message extension agent is enabled in Microsoft 365 Copilot."::: +:::image type="content" source="../../../../assets/images/Copilot/bot-based-sample-prompts.png" alt-text="Screenshot shows the sample prompts displayed when the agent is enabled in Microsoft 365 Copilot."::: Sample prompts are specified using `samplePrompts` property in the app manifest. These prompts must meet the following requirements: From aa444e3b02853517f382a29ea8711d5005069eb3 Mon Sep 17 00:00:00 2001 From: KirtiJha-MSFT Date: Wed, 8 Oct 2025 09:47:14 +0530 Subject: [PATCH 04/12] Update teams-faq.md --- msteams-platform/teams-faq.md | 11 ++--------- 1 file changed, 2 insertions(+), 9 deletions(-) diff --git a/msteams-platform/teams-faq.md b/msteams-platform/teams-faq.md index 82acf643a74..c7982fbd953 100644 --- a/msteams-platform/teams-faq.md +++ b/msteams-platform/teams-faq.md @@ -372,14 +372,7 @@ Developers are encouraged to certify their new agent after successfully completi  
-
-How can I create or upgrade a message extension agent for Microsoft 365 Copilot? -You can [create or upgrade a message extension as an agent in Microsoft 365 Copilot](messaging-extensions/build-bot-based-agent.md) to interact with third-party tools and services and achieve more with Microsoft 365 Copilot. Additionally, your extensions must meet the standards for compliance, performance, security, and user experience outlined in [guidelines to create or upgrade a message extension agent for Microsoft 365 Copilot](messaging-extensions/dev-guidelines-copilot-agents.md). -
-  -
-
What happens to my published message extension plugins? All published message extension plugins will now appear as agents in the right pane of the Microsoft 365 Copilot. Depending on the partner's requirement to implement an API, they might either accept this upgrade or consider building a [custom engine agent](/microsoft-365-copilot/extensibility/overview-custom-engine-agent?toc=/microsoftteams/platform/toc.json&bc=/microsoftteams/platform/breadcrumb/toc.json) or an [API-based plugin](messaging-extensions/api-based-overview.md). @@ -390,7 +383,7 @@ All published message extension plugins will now appear as agents in the right p What can partners do to build a more robust agent? -If a partner wants to build a more robust agent, they can deprecate their existing plugin and build a declarative agent with custom instructions and API-based actions. For more information, see [extend bot-based message extension as agent for Microsoft 365 Copilot](messaging-extensions/build-bot-based-agent.md). +If a partner wants to build a more robust agent, they can deprecate their existing plugin and build a declarative agent with custom instructions and API-based actions. For more information, see [API plugins for Microsoft 365 Copilot]([https://learn.microsoft.com/en-us/microsoft-365-copilot/extensibility/overview-api-plugins](/microsoft-365-copilot/extensibility/overview-api-plugins)).
 
@@ -406,7 +399,7 @@ Yes, both declarative agents and custom engine agents will have the same invocat Can Independent Software Vendors (ISVs) enhance their existing wrapped declarative agents moving forward? -ISVs can continue to improve their message extension agent and submit their app through standard methods or channels. However, they will be limited in terms of adding new instructions or knowledge to their agent. +ISVs can continue to improve and submit their app through standard methods or channels. However, they will be limited in terms of adding new instructions or knowledge to their agent.
  From 31c7c99a5715e3151bd256a9fbf5472e8ecfb9d0 Mon Sep 17 00:00:00 2001 From: KirtiJha-MSFT Date: Wed, 8 Oct 2025 10:29:47 +0530 Subject: [PATCH 05/12] Update teams-faq.md --- msteams-platform/teams-faq.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/msteams-platform/teams-faq.md b/msteams-platform/teams-faq.md index c7982fbd953..82563ddbd09 100644 --- a/msteams-platform/teams-faq.md +++ b/msteams-platform/teams-faq.md @@ -375,7 +375,7 @@ Developers are encouraged to certify their new agent after successfully completi What happens to my published message extension plugins? -All published message extension plugins will now appear as agents in the right pane of the Microsoft 365 Copilot. Depending on the partner's requirement to implement an API, they might either accept this upgrade or consider building a [custom engine agent](/microsoft-365-copilot/extensibility/overview-custom-engine-agent?toc=/microsoftteams/platform/toc.json&bc=/microsoftteams/platform/breadcrumb/toc.json) or an [API-based plugin](messaging-extensions/api-based-overview.md). +All published message extension plugins will now appear in the right pane of the Microsoft 365 Copilot. Depending on the partner's requirement to implement an API, they might either accept this upgrade or consider building a [custom engine agent](/microsoft-365-copilot/extensibility/overview-custom-engine-agent?toc=/microsoftteams/platform/toc.json&bc=/microsoftteams/platform/breadcrumb/toc.json) or an [API-based plugin](messaging-extensions/api-based-overview.md).
  @@ -383,7 +383,7 @@ All published message extension plugins will now appear as agents in the right p What can partners do to build a more robust agent? -If a partner wants to build a more robust agent, they can deprecate their existing plugin and build a declarative agent with custom instructions and API-based actions. For more information, see [API plugins for Microsoft 365 Copilot]([https://learn.microsoft.com/en-us/microsoft-365-copilot/extensibility/overview-api-plugins](/microsoft-365-copilot/extensibility/overview-api-plugins)). +If a partner wants to build a more robust agent, they can deprecate their existing plugin and build a declarative agent with custom instructions and API-based actions. For more information, see [API plugins for Microsoft 365 Copilot](./microsoft-365-copilot/extensibility/overview-api-plugins).
  From de7eae69e46764017bfbb712a657fd0091a85f37 Mon Sep 17 00:00:00 2001 From: KirtiJha-MSFT Date: Wed, 8 Oct 2025 11:55:46 +0530 Subject: [PATCH 06/12] Updated --- .../build-bot-based-agent.md | 146 +++++++++--------- .../dev-guidelines-agents.md | 10 +- .../search-commands/define-search-command.md | 4 +- 3 files changed, 80 insertions(+), 80 deletions(-) diff --git a/msteams-platform/messaging-extensions/build-bot-based-agent.md b/msteams-platform/messaging-extensions/build-bot-based-agent.md index ade927cc511..663b796da8b 100644 --- a/msteams-platform/messaging-extensions/build-bot-based-agent.md +++ b/msteams-platform/messaging-extensions/build-bot-based-agent.md @@ -1,7 +1,7 @@ --- -title: Message Extension as Agent for Copilot +title: Message Extension for Copilot author: surbhigupta -description: Learn how to build a bot-based message extension agent for Microsoft 365 Copilot using Developer Portal for Teams and Microsoft 365 Agents Toolkit. +description: Learn how to build a bot-based message extension for Microsoft 365 Copilot using Developer Portal for Teams and Microsoft 365 Agents Toolkit. ms.localizationpriority: medium ms.topic: overview ms.author: anclear @@ -9,17 +9,17 @@ ms.date: 09/16/2024 ms.collection: ce-skilling-ai-copilot --- -# Extend bot-based message extension as agent for Microsoft 365 Copilot +# Extend bot-based message extension for Microsoft 365 Copilot > [!NOTE] > > * Ensure that Microsoft 365 Copilot is available for your organization. You have two ways to get a developer environment for Microsoft 365 Copilot: > * A sandbox Microsoft 365 tenant with Microsoft 365 Copilot (available in limited preview through [TAP membership](https://developer.microsoft.com/microsoft-365/tap)). > * An [eligible Microsoft 365 or Office 365 production environment](/microsoft-365-copilot/extensibility/prerequisites#customers-with-existing-microsoft-365-and-copilot-licenses) with a Microsoft 365 Copilot license. -> * Bot-based search message extension agent is available in [**public developer preview**](../resources/dev-preview/developer-preview-intro.md). +> * Bot-based search message extension is available in [**public developer preview**](../resources/dev-preview/developer-preview-intro.md). > * Only *bot-based* message extensions with *search* commands can be extended as agents for Microsoft 365 Copilot. -Microsoft 365 Copilot, powered by an advanced processing and orchestration engine, integrates Microsoft 365 apps, Microsoft Graph, and Large Language Models (LLMs) to transform your words into a potent productivity tool. Although Microsoft 365 Copilot can utilize apps and data within the Microsoft 365 ecosystem, many users rely on various external tools and services for work management and collaboration. By extending your message extension as an agent in Microsoft 365 Copilot, you can enable users to interact with third-party tools and services, therefore empowering them to achieve more with Microsoft 365 Copilot. You can achieve this extension by developing an agent or connecting to an external data source. +Microsoft 365 Copilot, powered by an advanced processing and orchestration engine, integrates Microsoft 365 apps, Microsoft Graph, and Large Language Models (LLMs) to transform your words into a potent productivity tool. Although Microsoft 365 Copilot can utilize apps and data within the Microsoft 365 ecosystem, many users rely on various external tools and services for work management and collaboration. :::image type="content" source="../assets/images/Copilot/ailib-copilot-diff.png" alt-text="Graphic shows the user interaction flow between the user, Microsoft Teams, and Microsoft 365 Copilot." lightbox="../assets/images/Copilot/ailib-copilot-diff.png"::: @@ -30,7 +30,7 @@ An agent allows Microsoft 365 Copilot to interact directly with third-party data * Fetch real-time information, such as the latest news coverage on a product launch. * Retrieve knowledge-based information, such as a team’s design files in Figma. -Descriptions enhance the usability and effectiveness of a message extension agent. The following description offer a clear and concise summary of the app’s features: +Descriptions enhance the usability and effectiveness of a message extension. The following description offer a clear and concise summary of the app’s features: * **App description**: App description helps improve your app discoverability in the Teams Store. * **Command description**: Command description maps user intent and utterance to search command inside an agent and must be built based on the analysis of the user intent and keywords. @@ -43,7 +43,7 @@ All bot-based search message extensions that are eligible for agent support must ## Prerequisites -Before you get started, ensure that you're familiar with the following standards and guidelines for building message extension agents for Microsoft 365 Copilot: +Before you get started, ensure that you're familiar with the following standards and guidelines for building message extension for Microsoft 365 Copilot: * Standards for compliance, performance, security, and user experience outlined in [Teams Store validation guidelines](../concepts/deploy-and-publish/appsource/prepare/teams-store-validation-guidelines.md#teams-apps-extensible-as-agents-for-microsoft-365-copilot). @@ -54,7 +54,7 @@ Before you get started, ensure that you're familiar with the following standards > [!IMPORTANT] > Agents for Microsoft 365 Copilot are in preview and work only in Microsoft 365 Copilot in Teams. -Let's create a bot-based search message extension agent for Teams and Microsoft 365 Copilot and share results through the compose message area of the Microsoft Teams client. +Let's create a bot-based search message extension for Teams and Microsoft 365 Copilot and share results through the compose message area of the Microsoft Teams client. # [Visual Studio Code](#tab/visual-studio-code) @@ -67,20 +67,20 @@ Before you get started, ensure that you install the following tools to build and 1. Enter **Microsoft 365 Agents Toolkit** in the **Search settings** search box. 1. Under **Extensions**, select the **Fx-extension: Develop Copilot Plugin** checkbox. -To create a bot-based search message extension agent using Visual Studio Code, follow these steps: +To create a bot-based search message extension using Visual Studio Code, follow these steps: 1. Open **Visual Studio Code**. -1. From the left pane, select **Microsoft 365 Agents Toolkit**. -1. Select **Create a New Agent/App**. -1. Select **Message Extension**. -1. Select **Custom Search Results**. -1. Select **Start with a Bot**. +2. From the left pane, select **Microsoft 365 Agents Toolkit**. +3. Select **Create a New Agent/App**. +4. Select **Message Extension**. +5. Select **Custom Search Results**. +6. Select **Start with a Bot**. :::image type="content" source="../assets/images/Copilot/bot-based-VSC-start-with-bot.png" alt-text="Screenshot shows the Start with a Bot option to create a bot-based message extension in Visual Studio Code."::: -1. Select a programming language. -1. Select **Default folder**. -1. Enter the name of your app and select **Enter**. Agents Toolkit scaffolds your app and creates a message extension. +7. Select a programming language. +8. Select **Default folder**. +9. Enter the name of your app and select **Enter**. Agents Toolkit scaffolds your app and creates a message extension. To run your message extension in Teams, follow these steps: @@ -102,16 +102,16 @@ To run your message extension in Teams, follow these steps: **Trigger message extension in Microsoft 365 Copilot** -To trigger the message extension as agent in Microsoft 365 Copilot in Teams, follow these steps: +To trigger the message extension in Microsoft 365 Copilot in Teams, follow these steps: 1. Select **Apps**. -1. Search for **Copilot** and open Microsoft 365 Copilot. -1. Select **Panel** from the top-right corner. -1. Select the required agent from the right pane. +2. Search for **Copilot** and open Microsoft 365 Copilot. +3. Select **Panel** from the top-right corner. +4. Select the required agent from the right pane. :::image type="content" source="../assets/images/messaging-extension/message-extension-agents.png" alt-text="Screenshot shows the list of agents in Microsoft 365." lightbox="../assets/images/messaging-extension/message-extension-agent.png"::: -1. From the message compose area, send a message to Microsoft 365 Copilot to search for the latest update from Teams and Microsoft 365 Copilot. +5. From the message compose area, send a message to Microsoft 365 Copilot to search for the latest update from Teams and Microsoft 365 Copilot. :::image type="content" source="../assets/images/Copilot/bot-based-message-extension-agent.png" alt-text="Screenshot shows the agent prompt and the response from Microsoft 365 Copilot." lightbox="../assets/images/Copilot/bot-based-message-extension-agent.png"::: @@ -133,75 +133,75 @@ Before you get started, ensure that you install the following tools to build and 1. Go to **Tools** > **Options**. 1. In the **Preview Features** section, select the **Enable Multi-Project Launch Profiles** checkbox. -To create a bot-based search message extension agent using Visual Studio, follow these steps: +To create a bot-based search message extension using Visual Studio, follow these steps: 1. Open **Visual Studio**. -1. Go to **File** > **New** > **Project...** or **Create a new Project**. +2. Go to **File** > **New** > **Project...** or **Create a new Project**. -1. Search for **Teams** and select **Microsoft Teams App**. +3. Search for **Teams** and select **Microsoft Teams App**. -1. Enter the project details. Ensure that the **Place solution and project in the same directory** checkbox isn't selected. +4. Enter the project details. Ensure that the **Place solution and project in the same directory** checkbox isn't selected. -1. Select **Create**. +5. Select **Create**. -1. Select **Custom Search Results**. +6. Select **Custom Search Results**. :::image type="content" source="../assets/images/Copilot/bot-based-VS-new-project.png" alt-text="Screenshot shows the custom search results option in Visual Studio."::: -1. Select **Create**. The project is scaffolded. +7. Select **Create**. The project is scaffolded. -1. In the debug dropdown menu, select **Dev Tunnels** > **Create a Tunnel**. +8. In the debug dropdown menu, select **Dev Tunnels** > **Create a Tunnel**. :::image type="content" source="../assets/images/Copilot/bot-based-VS-dev-tunnel.png" alt-text="Screenshot shows the create a tunnel option in Visual Studio.":::
1. Select the account to create the tunnel. **Azure**, **Microsoft Account (MSA)**, and **GitHub** are the account types that are supported. - 1. **Name**: Enter a name for the tunnel. - 1. **Tunnel Type**: Select **Persistent** or **Temporary**. - 1. **Access**: Select **Public**. - 1. Select **OK**. Visual Studio displays a confirmation message that a tunnel is created. + 2. **Name**: Enter a name for the tunnel. + 3. **Tunnel Type**: Select **Persistent** or **Temporary**. + 4. **Access**: Select **Public**. + 5. Select **OK**. Visual Studio displays a confirmation message that a tunnel is created. The tunnel you created is listed under **Dev Tunnels > (name of the tunnel)**. -1. Go to **Solution Explorer** and select your project. -1. Right-click the project menu and select **Microsoft 365 Agents Toolkit** > **Select Microsoft 365 Account**. +9. Go to **Solution Explorer** and select your project. +10. Right-click the project menu and select **Microsoft 365 Agents Toolkit** > **Select Microsoft 365 Account**. :::image type="content" source="../assets/images/Copilot/bot-based-VS-teams-app-dependencies.png" alt-text="Screenshot shows the Select Microsoft 365 Account option under Agents Toolkit in Visual Studio app project."::: If prompted, sign in with a Microsoft 365 account. -1. In the debug dropdown menu, select **Microsoft Teams (browser)**. Visual Studio launches Teams web client. -1. Select **Add**. The message extension is added to Teams. +11. In the debug dropdown menu, select **Microsoft Teams (browser)**. Visual Studio launches Teams web client. +12. Select **Add**. The message extension is added to Teams. :::image type="content" source="../assets/images/Copilot/bot-based-VS-debug-teams-add-app.png" alt-text="Screenshot shows an example of the Add option to add Contoso agent local app to Teams."::: -1. Go to a chat and select **Actions and apps**. -1. From the message extension fly-out menu, enter the name of your message extension in the search box. -1. Select your message extension and enter your search query. +13. Go to a chat and select **Actions and apps**. +14. From the message extension fly-out menu, enter the name of your message extension in the search box. +15. Select your message extension and enter your search query. :::image type="content" source="../assets/images/Copilot/bot-based-VS-debug-teams-invoke.png" alt-text="Screenshot shows an example of Contoso search query entered in the Contoso agent local message extension and the message extension displays seven products results."::: -1. Select a product from the list. Teams unfurls the product into an Adaptive Card in the message compose area. -1. Select **Send**. The Adaptive Card is sent to the chat. +16. Select a product from the list. Teams unfurls the product into an Adaptive Card in the message compose area. +17. Select **Send**. The Adaptive Card is sent to the chat. :::image type="content" source="../assets/images/Copilot/bot-based-VS-debug-teams-send-card.png" alt-text="Screenshot shows Contoso. Base product sent as an Adaptive Card in Teams chat."::: **Trigger message extension in Microsoft 365 Copilot** -To trigger the message extension as agent in Microsoft 365 Copilot, follow these steps: +To trigger the message extension in Microsoft 365 Copilot, follow these steps: 1. Go to **Visual Studio**. -1. In the debug dropdown, select **Copilot (browser)**. Visual Studio launches Teams web client. +2. In the debug dropdown, select **Copilot (browser)**. Visual Studio launches Teams web client. :::image type="content" source="../assets/images/Copilot/bot-based-VSC-debug-Copilot.png" alt-text="Screenshot shows the Copilot (Browser) debug option in Visual Studio."::: -1. Go to **Teams web client** > **Apps**. -1. Search for **Copilot** and open Microsoft 365 Copilot. -1. Select **Panel** from the top-right corner. -1. Select the required agent from the right pane. +3. Go to **Teams web client** > **Apps**. +4. Search for **Copilot** and open Microsoft 365 Copilot. +5. Select **Panel** from the top-right corner. +6. Select the required agent from the right pane. :::image type="content" source="../assets/images/messaging-extension/message-extension-agents.png" alt-text="Screenshot shows the list of agents in Microsoft 365." lightbox="../assets/images/messaging-extension/message-extension-agent.png"::: -1. From the message compose area, send a message to Microsoft 365 Copilot to search for the latest update from Teams and Microsoft 365 Copilot. +7. From the message compose area, send a message to Microsoft 365 Copilot to search for the latest update from Teams and Microsoft 365 Copilot. :::image type="content" source="../assets/images/Copilot/bot-based-message-extension-agent.png" alt-text="Screenshot shows the agent prompt and the response from Microsoft 365 Copilot." lightbox="../assets/images/Copilot/bot-based-message-extension-agent.png"::: @@ -224,34 +224,34 @@ Before you get started, ensure that you set the environment variable **DEVELOP_C :::image type="content" source="../assets/images/Copilot/bot-based-plugin-CLI-add-env-variable.png" alt-text="Screenshot shows the Variable name and Variable value fields in the New User Variable dialog."::: -To create a bot-based search message extension agent using Agents Toolkit CLI, follow these steps: +To create a bot-based search message extension using Agents Toolkit CLI, follow these steps: 1. Go to **Command Prompt**. -1. Enter the following command: +2. Enter the following command: ``` npm install -g @microsoft/atk-cli ``` -1. Enter `atk new` in the terminal. +3. Enter `atk new` in the terminal. -1. Select **Message Extension**. Use the arrow keys to switch between options. +4. Select **Message Extension**. Use the arrow keys to switch between options. :::image type="content" source="../assets/images/Copilot/api-based-me-CLI-new-project-me.png" alt-text="Screenshot shows Teams capabilities as options in the CLI interface."::: -1. Select **Custom Search Results**. -1. Select **Start with a Bot**. +5. Select **Custom Search Results**. +6. Select **Start with a Bot**. :::image type="content" source="../assets/images/Copilot/bot-based-CLI-new-project.png" alt-text="Screenshot shows the message extension, custom search results, and start with a bot option selected in the CLI window."::: -1. Enter the location for your project and select **Enter**. +7. Enter the location for your project and select **Enter**. -1. Enter the name of your application and select **Enter**. +8. Enter the name of your application and select **Enter**. Agents Toolkit scaffolds and creates a project in the specified location. -1. Go to the folder path where your project is created and enter the following command to provision your app in Azure: +9. Go to the folder path where your project is created and enter the following command to provision your app in Azure: ``` teamsapp provision --env dev @@ -259,20 +259,20 @@ To create a bot-based search message extension agent using Agents Toolkit CLI, f Agents Toolkit CLI opens a browser window and requests you to sign in to your Microsoft Account. -1. Sign in to your Microsoft account. Agents Toolkit CLI executes validation and provisions your app on Azure. +10. Sign in to your Microsoft account. Agents Toolkit CLI executes validation and provisions your app on Azure. -1. From the list, select a subscription. +11. From the list, select a subscription. :::image type="content" source="../assets/images/Copilot/bot-based-CLI-resource-group.png" alt-text="Screenshot shows the sign-in to Azure and select a subscription option in the CLI window."::: -1. From the list, select a resource group. -1. If you receive a message, which reads **Cost may incur according to the usage. Do you want to provision resources in dev environment using accounts listed above?**, enter **Y**. +12. From the list, select a resource group. +13. If you receive a message, which reads **Cost may incur according to the usage. Do you want to provision resources in dev environment using accounts listed above?**, enter **Y**. :::image type="content" source="../assets/images/Copilot/bot-based-CLI-provisoin-preview.png" alt-text="Screenshot shows the Cost may incur according to the usage. Do you want to provision resources in dev environment using accounts listed option in the CLI window."::: Agents Toolkit validates your app manifest and provisions your app on Azure. -1. In the command prompt window, enter the following command to preview your app in Teams: +14. In the command prompt window, enter the following command to preview your app in Teams: ``` teamsapp preview --env dev @@ -280,23 +280,23 @@ To create a bot-based search message extension agent using Agents Toolkit CLI, f A new browser window with Teams web client opens. You can add your app to Teams. -1. Select **Add**. The message extension is added to Teams. -1. Go to a chat and select **Actions and apps**. -1. From the message extension fly-out menu, enter the name of your message extension in the search box. -1. Select your message extension and enter your search query. +15. Select **Add**. The message extension is added to Teams. +16. Go to a chat and select **Actions and apps**. +17. From the message extension fly-out menu, enter the name of your message extension in the search box. +18. Select your message extension and enter your search query. **Trigger message extension in Microsoft 365 Copilot** -To trigger the message extension as agent in Microsoft 365 Copilot in Teams, follow these steps: +To trigger the message extension in Microsoft 365 Copilot in Teams, follow these steps: 1. Select **Apps**. -1. Search for **Copilot** and open Microsoft 365 Copilot. -1. Select **Panel** from the top-right corner. -1. Select the required agent from the right pane. +2. Search for **Copilot** and open Microsoft 365 Copilot. +3. Select **Panel** from the top-right corner. +4. Select the required agent from the right pane. :::image type="content" source="../assets/images/messaging-extension/message-extension-agents.png" alt-text="Screenshot shows the list of agents in Microsoft 365." lightbox="../assets/images/messaging-extension/message-extension-agent.png"::: -1. From the message compose area, send a message to Microsoft 365 Copilot to search for the latest update from Teams and Microsoft 365 Copilot. +5. From the message compose area, send a message to Microsoft 365 Copilot to search for the latest update from Teams and Microsoft 365 Copilot. :::image type="content" source="../assets/images/Copilot/bot-based-message-extension-agent.png" alt-text="Screenshot shows the agent prompt and the response from Microsoft 365 Copilot." lightbox="../assets/images/Copilot/bot-based-message-extension-agent.png"::: diff --git a/msteams-platform/messaging-extensions/dev-guidelines-agents.md b/msteams-platform/messaging-extensions/dev-guidelines-agents.md index db55e3c9ef5..c5d273a2dfb 100644 --- a/msteams-platform/messaging-extensions/dev-guidelines-agents.md +++ b/msteams-platform/messaging-extensions/dev-guidelines-agents.md @@ -14,14 +14,14 @@ ms.collection: ce-skilling-ai-copilot > [!IMPORTANT] > > * Agents for Microsoft 365 Copilot are in preview and work only in Microsoft 365 Copilot. -> * Message extension agents are in preview. -> * Message extensions agents in Microsoft 365 Copilot are in public preview for Microsoft Word and PowerPoint. +> * Message extension are in preview. +> * Message extensions in Microsoft 365 Copilot are in public preview for Microsoft Word and PowerPoint. > * Ensure that Microsoft 365 Copilot is available for your organization. You have two ways to get a developer environment for Microsoft 365 Copilot: > * A sandbox Microsoft 365 tenant with Microsoft 365 Copilot (available in limited preview through [TAP membership](https://developer.microsoft.com/microsoft-365/tap)). > * An enterprise customer production environment with Microsoft 365 Copilot licenses. > For more information about validation guidelines for agents to increase their chance for being listed on the Team Store, see [validation guidelines for agents](../concepts/deploy-and-publish/appsource/prepare/review-copilot-validation-guidelines.md). -Microsoft 365 agents provide integration with various Microsoft 365 products, such as Teams and Outlook. The integration helps users to search or create content in external systems. Message extension agents allow Microsoft 365 Copilot to interact with APIs from other software and services through a bot. With Microsoft 365 Copilot, you can: +Microsoft 365 agents provide integration with various Microsoft 365 products, such as Teams and Outlook. The integration helps users to search or create content in external systems. Message extension allow Microsoft 365 Copilot to interact with APIs from other software and services through a bot. With Microsoft 365 Copilot, you can: * Search for the latest information or record. For example, the latest incident ticket or survey results. * Summarize information based on multiple records. For example, summarize all incident tickets related to the project Northwind. @@ -34,7 +34,7 @@ We recommend that you build or upgrade your existing message extensions to maxim [*Must fix*] -A good description offers a clear and concise summary of the app’s features and allows Microsoft 365 Copilot to efficiently discover and execute search operations. When a user enters the app name along with a verb, for example, **Find Contoso tickets**, the message extension agent must be invoked from Microsoft 365 Copilot. +A good description offers a clear and concise summary of the app’s features and allows Microsoft 365 Copilot to efficiently discover and execute search operations. When a user enters the app name along with a verb, for example, **Find Contoso tickets**, the message extension must be invoked from Microsoft 365 Copilot. :::image type="content" source="../assets/images/Copilot/validation-guidelines-plugin-prompt-pass.png" alt-text="Screenshot shows a pass scenario with an example of a sample prompt for message extension agent in Microsoft 365 Copilot."::: @@ -44,7 +44,7 @@ A good description offers a clear and concise summary of the app’s features an Long and short app descriptions must be clear and define the app's scope. To render an app as an agent in Microsoft 365 Copilot, modify the app description to suit the following agent requirements: -* Long description must clearly explain the functionality and usage of the message extension agent in Microsoft 365 Copilot. For example, use Contoso cloud in Microsoft 365 Copilot to search and summarize your tasks. +* Long description must clearly explain the functionality and usage of the message extension in Microsoft 365 Copilot. For example, use Contoso cloud in Microsoft 365 Copilot to search and summarize your tasks. * Short description must briefly describe the app's functionality in a natural language and can include the name of the app. The following code snippets show the short description examples for each category: diff --git a/msteams-platform/messaging-extensions/how-to/search-commands/define-search-command.md b/msteams-platform/messaging-extensions/how-to/search-commands/define-search-command.md index 237f4d7f85f..bedee9a1237 100644 --- a/msteams-platform/messaging-extensions/how-to/search-commands/define-search-command.md +++ b/msteams-platform/messaging-extensions/how-to/search-commands/define-search-command.md @@ -110,12 +110,12 @@ To run the message extension in Teams, follow these steps: --- -### Extend bot-based message extension as agent +### Extend bot-based message extension > [!IMPORTANT] > Agents for Microsoft 365 Copilot are in preview and only work in Microsoft 365 Copilot in Teams. -Microsoft 365 agents provide integration with various Microsoft 365 products, such as Teams and Outlook. The integration helps users to search or create content in external systems. Message extension agents allow Microsoft 365 Copilot to interact with APIs from other software and services through a bot. We recommend that you build or upgrade your existing message extensions to maximize their usefulness and usability in Microsoft 365 Copilot. For more information, see [extend bot-based message extension as agent for Microsoft 365 Copilot](../../build-bot-based-agent.md). +Microsoft 365 agents provide integration with various Microsoft 365 products, such as Teams and Outlook. The integration helps users to search or create content in external systems. Message extension allow Microsoft 365 Copilot to interact with APIs from other software and services through a bot. We recommend that you build or upgrade your existing message extensions to maximize their usefulness and usability in Microsoft 365 Copilot. For more information, see [extend bot-based message extension as agent for Microsoft 365 Copilot](../../build-bot-based-agent.md). ## Code snippets From 53a8b5b2632f769ff783ceacc4bc87668b4b8a4e Mon Sep 17 00:00:00 2001 From: KirtiJha-MSFT Date: Wed, 8 Oct 2025 16:07:50 +0530 Subject: [PATCH 07/12] Update teams-faq.md --- msteams-platform/teams-faq.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/msteams-platform/teams-faq.md b/msteams-platform/teams-faq.md index 82563ddbd09..c58cae78d38 100644 --- a/msteams-platform/teams-faq.md +++ b/msteams-platform/teams-faq.md @@ -383,7 +383,7 @@ All published message extension plugins will now appear in the right pane of the What can partners do to build a more robust agent? -If a partner wants to build a more robust agent, they can deprecate their existing plugin and build a declarative agent with custom instructions and API-based actions. For more information, see [API plugins for Microsoft 365 Copilot](./microsoft-365-copilot/extensibility/overview-api-plugins). +If a partner wants to build a more robust agent, they can deprecate their existing plugin and build a declarative agent with custom instructions and API-based actions. For more information, see [API plugins for Microsoft 365 Copilot](./microsoft-365-copilot/extensibility/overview-api-plugins.md).
  From 5b4d6ae29e98a86eb9ebfde1a7c8b23d6dd9fb80 Mon Sep 17 00:00:00 2001 From: KirtiJha-MSFT Date: Thu, 9 Oct 2025 11:17:29 +0530 Subject: [PATCH 08/12] Update teams-faq.md --- msteams-platform/teams-faq.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/msteams-platform/teams-faq.md b/msteams-platform/teams-faq.md index c58cae78d38..bb25a27e36f 100644 --- a/msteams-platform/teams-faq.md +++ b/msteams-platform/teams-faq.md @@ -383,7 +383,7 @@ All published message extension plugins will now appear in the right pane of the What can partners do to build a more robust agent? -If a partner wants to build a more robust agent, they can deprecate their existing plugin and build a declarative agent with custom instructions and API-based actions. For more information, see [API plugins for Microsoft 365 Copilot](./microsoft-365-copilot/extensibility/overview-api-plugins.md). +If a partner wants to build a more robust agent, they can deprecate their existing plugin and build a declarative agent with custom instructions and API-based actions. For more information, see [API plugins for Microsoft 365 Copilot](/microsoft-365-copilot/extensibility/overview-api-plugins).
  @@ -1236,4 +1236,4 @@ Shared references to deploy the code using toolkit: You can call Graph API to get the app user's profile photo. - + \ No newline at end of file From 8118b58bd85732209364707acbf2e39b26884f59 Mon Sep 17 00:00:00 2001 From: KirtiJha-MSFT Date: Thu, 9 Oct 2025 11:47:56 +0530 Subject: [PATCH 09/12] Update TOC.yml --- msteams-platform/TOC.yml | 6 ------ 1 file changed, 6 deletions(-) diff --git a/msteams-platform/TOC.yml b/msteams-platform/TOC.yml index f56bd432b06..4ce60e8a8c9 100644 --- a/msteams-platform/TOC.yml +++ b/msteams-platform/TOC.yml @@ -572,12 +572,6 @@ - name: Universal actions for search based message extensions href: messaging-extensions/how-to/search-commands/universal-actions-for-search-based-message-extensions.md displayName: Handle tap actions, Just-in-time install, JIT - - name: Bot-based message extension agent guidelines - href: messaging-extensions/dev-guidelines-agents.md - displayName: criteria, extend message extension, agent, Microsoft 365 Copilot, Copilot agents, plugins - - name: Extend bot-based message extension as agent - href: messaging-extensions/build-bot-based-agent.md - displayName: extend message extension, search based message extension, M365, Microsoft 365 Copilot - name: Debug an agent for Microsoft 365 Copilot with developer mode href: /microsoft-365-copilot/extensibility/debugging-copilot-plugin?toc=/microsoftteams/platform/toc.json&bc=/microsoftteams/platform/breadcrumb/toc.json displayName: Copilot, Microsoft 365 Copilot, enabled agents, matched functions, selected functions for execution, function execution details, plugin From 484772f39277ec871d3cc9e3d1863286924ad4be Mon Sep 17 00:00:00 2001 From: KirtiJha-MSFT Date: Fri, 10 Oct 2025 09:52:16 +0530 Subject: [PATCH 10/12] Updated --- .../messaging-extensions/dev-guidelines-agents.md | 6 ++---- .../how-to/search-commands/define-search-command.md | 7 ------- 2 files changed, 2 insertions(+), 11 deletions(-) diff --git a/msteams-platform/messaging-extensions/dev-guidelines-agents.md b/msteams-platform/messaging-extensions/dev-guidelines-agents.md index c5d273a2dfb..298721a6320 100644 --- a/msteams-platform/messaging-extensions/dev-guidelines-agents.md +++ b/msteams-platform/messaging-extensions/dev-guidelines-agents.md @@ -14,14 +14,12 @@ ms.collection: ce-skilling-ai-copilot > [!IMPORTANT] > > * Agents for Microsoft 365 Copilot are in preview and work only in Microsoft 365 Copilot. -> * Message extension are in preview. -> * Message extensions in Microsoft 365 Copilot are in public preview for Microsoft Word and PowerPoint. > * Ensure that Microsoft 365 Copilot is available for your organization. You have two ways to get a developer environment for Microsoft 365 Copilot: > * A sandbox Microsoft 365 tenant with Microsoft 365 Copilot (available in limited preview through [TAP membership](https://developer.microsoft.com/microsoft-365/tap)). > * An enterprise customer production environment with Microsoft 365 Copilot licenses. > For more information about validation guidelines for agents to increase their chance for being listed on the Team Store, see [validation guidelines for agents](../concepts/deploy-and-publish/appsource/prepare/review-copilot-validation-guidelines.md). -Microsoft 365 agents provide integration with various Microsoft 365 products, such as Teams and Outlook. The integration helps users to search or create content in external systems. Message extension allow Microsoft 365 Copilot to interact with APIs from other software and services through a bot. With Microsoft 365 Copilot, you can: +Microsoft 365 agents provide integration with various Microsoft 365 products, such as Teams and Outlook. The integration helps users to search or create content in external systems. Agents enable Microsoft 365 Copilot to interact with APIs from other software and services through a bot. With Microsoft 365 Copilot, you can: * Search for the latest information or record. For example, the latest incident ticket or survey results. * Summarize information based on multiple records. For example, summarize all incident tickets related to the project Northwind. @@ -44,7 +42,7 @@ A good description offers a clear and concise summary of the app’s features an Long and short app descriptions must be clear and define the app's scope. To render an app as an agent in Microsoft 365 Copilot, modify the app description to suit the following agent requirements: -* Long description must clearly explain the functionality and usage of the message extension in Microsoft 365 Copilot. For example, use Contoso cloud in Microsoft 365 Copilot to search and summarize your tasks. +* Long description must clearly explain the functionality and usage of agent in Microsoft 365 Copilot. For example, use Contoso cloud in Microsoft 365 Copilot to search and summarize your tasks. * Short description must briefly describe the app's functionality in a natural language and can include the name of the app. The following code snippets show the short description examples for each category: diff --git a/msteams-platform/messaging-extensions/how-to/search-commands/define-search-command.md b/msteams-platform/messaging-extensions/how-to/search-commands/define-search-command.md index bedee9a1237..d3e978c43e7 100644 --- a/msteams-platform/messaging-extensions/how-to/search-commands/define-search-command.md +++ b/msteams-platform/messaging-extensions/how-to/search-commands/define-search-command.md @@ -110,13 +110,6 @@ To run the message extension in Teams, follow these steps: --- -### Extend bot-based message extension - -> [!IMPORTANT] -> Agents for Microsoft 365 Copilot are in preview and only work in Microsoft 365 Copilot in Teams. - -Microsoft 365 agents provide integration with various Microsoft 365 products, such as Teams and Outlook. The integration helps users to search or create content in external systems. Message extension allow Microsoft 365 Copilot to interact with APIs from other software and services through a bot. We recommend that you build or upgrade your existing message extensions to maximize their usefulness and usability in Microsoft 365 Copilot. For more information, see [extend bot-based message extension as agent for Microsoft 365 Copilot](../../build-bot-based-agent.md). - ## Code snippets The following code provides an example of search-based for message extensions: From 7723e370c950e86bf1f7a994dc1b8b961d53af5e Mon Sep 17 00:00:00 2001 From: KirtiJha-MSFT Date: Fri, 10 Oct 2025 10:52:23 +0530 Subject: [PATCH 11/12] Updated --- .../appsource/prepare/review-copilot-validation-guidelines.md | 1 - msteams-platform/whats-new.md | 1 - 2 files changed, 2 deletions(-) diff --git a/msteams-platform/concepts/deploy-and-publish/appsource/prepare/review-copilot-validation-guidelines.md b/msteams-platform/concepts/deploy-and-publish/appsource/prepare/review-copilot-validation-guidelines.md index c61f12dffa8..ab7e71232cd 100644 --- a/msteams-platform/concepts/deploy-and-publish/appsource/prepare/review-copilot-validation-guidelines.md +++ b/msteams-platform/concepts/deploy-and-publish/appsource/prepare/review-copilot-validation-guidelines.md @@ -419,5 +419,4 @@ Agents that use OpenAPI specs must ensure the following security standards: * [Teams Store validation guidelines](teams-store-validation-guidelines.md) * [Guidelines to create and upgrade agents](../../../../messaging-extensions/dev-guidelines-agents.md) -* [Extend bot-based message extension as agent for Microsoft 365 Copilot](../../../../messaging-extensions/build-bot-based-agent.md) * [Extend Microsoft 365 Copilot](/microsoft-365-copilot/extensibility/) diff --git a/msteams-platform/whats-new.md b/msteams-platform/whats-new.md index 74e9246e7eb..87d8e2087f2 100644 --- a/msteams-platform/whats-new.md +++ b/msteams-platform/whats-new.md @@ -92,7 +92,6 @@ Teams platform features that are available to all app developers.
| 18/12/2024 | Introducing text customization for share to stage button. | Build apps for Teams meetings and calls > Configure apps for Teams meetings > Build apps for meeting stage > [Advanced share to stage APIs](apps-in-teams-meetings/build-apps-for-teams-meeting-stage.md#advanced-share-to-stage-apis) | | 18/12/2024 | Introducing share to meeting from personal app. | Integrate with Teams > Share to Teams > Share to Teams from personal app or tab > [Share to meeting from personal app](concepts/build-and-test/share-to-teams-from-personal-app-or-tab.md#share-to-meeting-from-personal-app) | | 16/12/2024 | Introducing multi parameters for API-based message extensions which allows more than one input type for query command. | Build message extensions > Build message extensions using API > Create API-based message extensions > [Multi parameters](messaging-extensions/create-api-message-extension.md#multi-parameters) | -| 13/12/2024 | Learn to extend bot-based message extension as an agent for Microsoft 365 Copilot. | Build message extensions > Build message extensions using Bot Framework > Search commands > [Extend bot-based message extension as agent](messaging-extensions/build-bot-based-agent.md) | | 11/12/2024 | Enhanced user experience for Teams app installed from Teams Store or custom upload. | Publish your app > [Configure default options for Teams app](concepts/deploy-and-publish/add-default-install-scope.md) | | 27/11/2024 | Terminology update. **Copilot agent** is referred to as **agent**. | | | 19/11/2024 | Terminology update. **Plugin** is referred to as **agent** for Microsoft 365 Copilot. | | From ae09231b8d07b056994e36da63e3873f6104ba2c Mon Sep 17 00:00:00 2001 From: KirtiJha-MSFT Date: Mon, 13 Oct 2025 12:42:43 +0530 Subject: [PATCH 12/12] Update build-bot-based-message-extension.md --- .../messaging-extensions/build-bot-based-message-extension.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/msteams-platform/messaging-extensions/build-bot-based-message-extension.md b/msteams-platform/messaging-extensions/build-bot-based-message-extension.md index f72a78bb313..a9cadbf88f2 100644 --- a/msteams-platform/messaging-extensions/build-bot-based-message-extension.md +++ b/msteams-platform/messaging-extensions/build-bot-based-message-extension.md @@ -13,7 +13,7 @@ ms.date: 09/16/2024 > [!IMPORTANT] > -> Message extensions are no longer supported as agents. +> Message extensions are no longer supported as agents in Microsoft 365 Copilot. Message extensions built using Bot Framework (Bot-based) use a web service as a bot. You can use message extensions to enable users to interact with your web service from different locations in the Teams client, such as the compose message area, the command box, or directly from a message and send back structured data, such as cards.