Use the Agent chat web part to bring agentic conversations directly to SharePoint sites. You can place relevant instructions, example prompts, and help content around the Agent chat web part by using other SharePoint web parts so that visitors can find the agent and get started without leaving the page.
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.
Prerequisites
Requirements for adding an Agent chat web part
Before starting, ensure you have the following:
Permission to edit the SharePoint page. The agent must be a published, user-created Copilot agent or a custom Copilot Studio agent that's already available and has been used in Copilot. Publish custom Copilot Studio agents to Microsoft 365 Copilot before adding them. Page-editing permission doesn't grant permission to share or change the agent itself.
A published, user-created Copilot agent or a custom Copilot Studio agent that's already available and has been used in Copilot. Publish custom Copilot Studio agents to Microsoft 365 Copilot before adding them.
A Microsoft 365 Copilot license.
Requirements to chat with the agent
To chat with an agent in the Agent chat web part, page visitors need:
Access to the SharePoint page.
Access to the agent.
Access to the knowledge sources used to ground the agent.
A Microsoft 365 Copilot license.
Each permission is managed separately—sharing a page or site doesn't share the agent. Manage page or site access separately from agent access. For more information, see Share the agent with your audience.
Add the Agent chat web part to a page
Open the SharePoint page where you want to add the agent.
If you're not in edit mode already, select Edit at the top right of the page.
Open the web part toolbox at the location where you want the agent to appear, and then select Agent chat (preview).
Select the agent you want to show on the page. For details, see Choose the agent.
Configure the appearance of the Agent chat web part.
Add other content around the web part, such as instructions, example prompts, or related links, to help people get started.
Before you publish, ensure your audience meets the requirements to chat with the agent.
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.
Agents you can add
You can add the following types of agents:
Published, user-created Copilot agents.
Custom Copilot Studio agents that are published to Microsoft 365 Copilot and that you used in Microsoft 365 Copilot.
Custom Copilot Studio agents must be published to Microsoft 365 Copilot. An agent’s availability doesn't by itself establish that every visitor has permission or the required entitlement to use it.
If you can't find your agent
The Agent chat web part's agent picker shows the agents you used recently. If your agent isn't listed:
Open the agent in Microsoft 365 Copilot.
Wait a short while, return to the page, and check the picker again.
Configure Agent web chat part appearance
Use the web part’s configuration pane to select the agent and adjust the appearance. The current controls include Overlay color, Overlay opacity, Show author, and Show title. Choose settings that keep the text readable against the page background.
The audience reminder doesn't grant access. Check the agent’s sharing settings separately before you publish or share the page.
Start a conversation
Open the SharePoint page containing the agent.
Enter a prompt that's relevant to the agent’s purpose, and send it.
Read the response and ask a follow-up question if you need more detail.
Open the full-screen chat view when you want more room for the conversation. Use the link back to the page to return to SharePoint page content.
Share the agent with your audience
Adding an agent to a SharePoint page doesn't give page viewers access to the agent. Share the agent with your audience by using the sharing options for that agent type:
- For a Copilot agent, see Share and manage agents built in Agent Builder.
- For a Copilot Studio agent, see Share agents with other users.
Use the normal agent-sharing experience in Copilot or Copilot Studio to give the intended people access. Check the SharePoint page’s permissions and the permissions for the agent’s grounding sources separately. Sharing the page or site isn't a substitute for granting access to the agent or its knowledge sources.
How site and page content is used
Adding the Agent chat web part to a SharePoint site or page doesn't automatically pass the site's or page's content to the agent. The agent uses site or page content only if at least one of the following conditions applies:
The agent is grounded in that site.
A user adds files to their prompt.
The agent's capabilities depend on how it was built, not on the site or page that hosts the web part.
Chat with an agent on a page
If you meet the requirements to chat with the agent, you can chat with the agent directly on the SharePoint page:
Open the SharePoint page.
In the Agent chat web part, enter a prompt that's relevant to the agent, and then send it.
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.
FAQ for the Agent chat web part
Does adding an agent to a site change who can use it?
No. Access to the SharePoint page, access to the agent, and access to the knowledge sources used to ground the agent are managed separately. Access to the page doesn't grant access to the agent or its knowledge sources.
For example, if an agent is shared only with security group SG1, adding it to a page that other people can view doesn't itself share the agent with those people. Visitors who have a Microsoft 365 Copilot license but don't have access to the configured agent can see the web part but can't interact with it.
How should I test before sharing the page?
Start with a limited audience as a best practice, and test as an intended viewer. Check that the viewer has a Microsoft 365 Copilot license and can open the page and access the agent. This recommendation is about validating access and behavior, not a restriction on the rollout audience.
How do people use the agent?
Visitors open the page, send a relevant prompt, read the response, and ask follow-up questions. They can use the full-screen chat view for more room and return to the page by using the back-to-page link.
What should I check during testing?
Check that intended viewers can start and continue a conversation and that the agent behaves as expected for its purpose. Test with accounts representing the intended permission levels, rather than relying only on the author’s access. If a viewer can't proceed, check page access and agent access separately, and confirm that the viewer has a Microsoft 365 Copilot license.
Which clients are supported?
Use the web part in a desktop browser. The Agent Chat web part isn't supported in mobile browsers.
Where do I send feedback?
On the SharePoint site, open Feedback to Microsoft and choose the option that best describes your feedback. For an issue, include what you tried, what you expected, and what happened. Describe whether the issue occurred during setup, while opening the agent, or during a conversation. Don't include confidential content or credentials.
Can an administrator enable or disable the web part?
There's no customer-accessible tenant or SharePoint admin control specifically for turning the Agent Chat web part on or off. After rollout, the web part is available to licensed users.
Does the web part change the agent’s source permissions or authentication?
Access to the SharePoint page, access to the agent, and access to the knowledge sources used to ground the agent are managed separately. Access to the page doesn't grant access to the agent or its knowledge sources. How source permissions are enforced when retrieving content depends on the agent type, the knowledge source, and how authentication is configured.
Each agent’s existing source permissions and authentication configuration continue to apply. The Agent Chat web part doesn't change them.
Review the agent’s existing source permissions and authentication configuration before making it available through the page. This review doesn't mean that all knowledge sources or custom connectors use the same permission model.
Can visitors without a Microsoft 365 Copilot license use the web part with pay-as-you-go billing?
No. A Microsoft 365 Copilot license is required to use the Agent Chat web part. Configuring pay-as-you-go billing for the Copilot app doesn't enable access to this web part for visitors without that license.
The Agent Chat web part is hidden for visitors who don't have a Microsoft 365 Copilot license. Visitors who have a Microsoft 365 Copilot license but don't have access to the configured agent can see the web part but can't interact with it.
Are conversations saved, and can I access chat history from the web part?
Conversations you start through the Agent Chat web part are saved just like chats you start in the Copilot app. You can't access chat history from the web part.
More information
For source-specific permissions, see Add SharePoint as a knowledge source.
For general Copilot Chat guidance, see Manage agents in Microsoft 365 Copilot Chat.
For agent governance and deployment, see the Microsoft 365 agents admin guide.