Skip to content
Closed
Show file tree
Hide file tree
Changes from 9 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 8 additions & 0 deletions .openpublishing.redirection.json
Original file line number Diff line number Diff line change
Expand Up @@ -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"
}
]
}
6 changes: 0 additions & 6 deletions msteams-platform/TOC.yml
Original file line number Diff line number Diff line change
Expand Up @@ -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
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

If the files are unlinked why the changes are made to the files and are in the PR.

Copy link
Collaborator Author

@KirtiJha-MSFT KirtiJha-MSFT Oct 10, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  1. Took a backup of the relevant files
  2. Removed the files from the Table of Contents (TOC)

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
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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)).
Expand Down Expand Up @@ -139,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:

Expand Down
146 changes: 73 additions & 73 deletions msteams-platform/messaging-extensions/build-bot-based-agent.md

Large diffs are not rendered by default.

Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
10 changes: 5 additions & 5 deletions msteams-platform/messaging-extensions/dev-guidelines-agents.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Remove this both notes

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done.

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I am unable to open the remove the review site for this. It's opening the guidelines to validate the agents page

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I have redirected this file.

> * 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:
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The message extension is not supported in Copilot. Try to understand what the sentence trying to convey don't just blindly remove agents references. Here the sentence should start something like Agents allow Microsoft 365 Copilot to interact with APIs from other software and services through a bot. With Microsoft 365 Copilot, you can:

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done


* 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.
Expand All @@ -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.":::

Expand All @@ -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.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Same here

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done.

* 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:
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Remove this section

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done.


> [!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

Expand Down
15 changes: 4 additions & 11 deletions msteams-platform/teams-faq.md
Original file line number Diff line number Diff line change
Expand Up @@ -372,25 +372,18 @@ Developers are encouraged to certify their new agent after successfully completi
 
</details>
<details>
<br>
<summary>How can I create or upgrade a message extension agent for Microsoft 365 Copilot?</summary>

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).
<br>
&nbsp;
</details>
<details>
<summary>What happens to my published message extension plugins? </summary>

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).
<br>
&nbsp;
</details>
<details>

<summary>What can partners do to build a more robust agent?</summary>

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](/microsoft-365-copilot/extensibility/overview-api-plugins).
<br>
&nbsp;
</details>
Expand All @@ -406,7 +399,7 @@ Yes, both declarative agents and custom engine agents will have the same invocat

<summary>Can Independent Software Vendors (ISVs) enhance their existing wrapped declarative agents moving forward?</summary>

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.
<br>
&nbsp;
</details>
Expand Down Expand Up @@ -1243,4 +1236,4 @@ Shared references to deploy the code using toolkit:

You can call Graph API to get the app user's profile photo.

</details>
</details>