Use the Agent chat web part (preview)

Applies To
SharePoint Server 2019

When you add a modern page to a site, you add and customize web parts, which are the building blocks of your page.

This article describes the Agent chat web part.

Use this web part to put a Microsoft 365 Copilot agent directly on a SharePoint page. People can chat with the agent on the sites they already use, and you can surround it with instructions, examples, and related content to help them get started.

Note

The Agent chat web part is in preview. Some features might change before general availability. Preview is available only in the public/commercial clouds.

How does it work?

Before you begin

Add the Agent chat web part to a page

Choose the agent

Share the agent with your audience

How site and page content is used

Chat with an agent on a page

Known limitations

How does it work?

  1. Add the Agent chat web part: Start by adding the web part to your page.
  2. Choose the agent: Select a published Copilot agent or Copilot Studio agent that you used recently.
  3. Share the agent: Ensure the people who visit the page also have access to the agent. Sharing the page doesn't share the agent.

Before you begin

Who can add the web part

To add the Agent chat web part, you need permission to edit the SharePoint page.

Page access and agent access are separate

Sharing a page or site doesn't share the agents added to it through this web part. You manage access to the page or site separately from access to the agent. For more information, see Share the agent with your audience.

Add the Agent chat web part to a page

  1. If you're not in edit mode already, select Edit at the top right of the page. Find the Toolbox (

) on the right. 2. Select See all web parts, then select or drag-and-drop Agent chat (preview) from the list of web parts.

  1. Select the agent you want to show on the page. For details, see Choose the agent.
  2. Add other content around the web part, such as instructions, example prompts, or related links, to help people get started.
  3. When you're done, select Republish or Publish.

Choose the agent

After you add the web part, select the agent you want to show from the agent picker.

Which agents you can add

You can add the following types of agents:

  • Published, user-created Copilot agents.
  • Custom Copilot Studio agents that are already available and used in Copilot.

Note

You must publish Custom Copilot Studio agents to Microsoft 365 Copilot before you can add them to the web part.

If you can't find your agent

The agent picker shows the agents you used recently. If your agent isn't listed:

  1. Open the agent in Microsoft 365 Copilot.
  2. Wait a short while, return to the page, and check the picker again.

Share the agent with your audience

Adding an agent to a page doesn't give page viewers access to the agent. To ensure people can chat with the agent, share it with them through the usual sharing experience:

How site and page content is used

The site or page hosts the agent, but it doesn't automatically pass its content to the agent. The agent uses site or page content only when:

  • The agent is grounded in that site, or
  • A user adds files to their prompt.

Note

What an agent can do depends on how it was built. It's possible that the agent on the page doesn't know about the contents of the specific site hosting that agent. What the agent can do and help with is independent of the site or page where you add the configured web part.

Chat with an agent on a page

People who have access to the page and the agent, and a Microsoft 365 Copilot license, can chat with it right on the page:

  1. Open the SharePoint page.
  2. Enter a prompt that's relevant to the agent, and then send it.
  3. Read the response, and then ask a follow-up question to continue the conversation.

Known limitations

During preview:

  • You can't use the agent chat web part in mobile browsers or in the SharePoint app in Teams mobile.