The process of building custom applications and tools that interact with Microsoft SharePoint, including SharePoint Online in Microsoft 365.
This pattern matches documented SharePoint knowledge-source failures where the agent returns no results without throwing an error, even when the configuration appears unchanged.
The most relevant checks are:
- Verify user access to the exact SharePoint content
- Copilot Studio respects Microsoft 365 security trimming.
- Affected users must still have read access to the relevant sites and files.
- Test by opening the exact SharePoint document path as the affected user.
- Then run the same query with the same user account in Microsoft 365 Copilot Chat. If Copilot Chat also fails to retrieve the content, that points to a permission or search-indexing barrier rather than an agent-specific issue.
- Check the app registration and agent authentication scopes
- If SharePoint knowledge is configured with manual authentication, the Microsoft Entra ID app registration must include at least
Sites.Read.AllandFiles.Read.All. - Those scopes must also be present in the agent authentication settings together with
profileandopenid. - Required consent must be granted.
- If scopes are missing from either the app registration or the agent settings, the agent can return no results and no errors.
- If SharePoint knowledge is configured with manual authentication, the Microsoft Entra ID app registration must include at least
- Confirm Restricted SharePoint Search is not blocking retrieval
- If Restricted SharePoint Search is enabled for the tenant, SharePoint as a knowledge source is blocked regardless of app registration or agent configuration.
- In that state, no results are returned until the relevant sites are added to the allowed list or the restriction is removed.
- Check whether the content is indexed
- If the SharePoint content is not indexed by Microsoft Search, retrieval can be incomplete or fail.
- Recently changed or large content sets can require time to appear.
- Inconsistent results can also occur while semantic index synchronization is still catching up.
- Validate the SharePoint path and scope
- Confirm the configured SharePoint site URL and library path are still correct and accessible.
- If responses are slow or incomplete, narrow the search scope to specific sites or libraries and test with more specific queries.
- If this uses the SharePoint tool in Foundry or agent API scenarios, confirm identity mode
- The SharePoint tool requires user identity passthrough.
- Application-only authentication is not supported and can cause authentication failures.
- Also confirm the user identity is in the same tenant as Microsoft 365.
About known service-side changes:
- No publicly documented change in the provided material indicates a platform update that should broadly disable previously working SharePoint knowledge retrieval.
- A similar reported case was resolved after Microsoft addressed an internal service issue, so a service-side problem is possible when previously working agents and newly created agents both stop retrieving SharePoint knowledge without any tenant-side changes.
A practical troubleshooting sequence is:
- Test one affected query in Microsoft 365 Copilot Chat using the same user.
- Open the exact SharePoint file directly as that user.
- Review the app registration permissions and the agent authentication scopes for
Sites.Read.All,Files.Read.All,profile, andopenid, and confirm consent is granted. - Ask the SharePoint admin to verify Restricted SharePoint Search is not enabled for the tenant or blocking the relevant sites.
- Confirm the site/library path is still valid and the content is indexed.
- If both existing and newly created agents fail with the same SharePoint source and the checks above pass, treat it as a likely service-side issue.
References: