Copilot Studio Friction
Knowledge returns nothing — and no error is shown
Last verified
Details & related
Assessment
- Confidence
- Confirmed officialConfirmed by Microsoft documentation or an official statement.
- Severity
- Blocking
- Typical time lost
- Days
Identification
Verification & changes
Verified
Doc check by human: Official troubleshooting doc re-read during seed migration; silent no-results behavior for missing scopes or consent still documented.
Change
Provisionally approved by the Product Owner; external LLM quality review pending.
Change
Initial record created from the seed dossier (migration wave 1).
Are you in the right place?
- Your agent answers general questions, but anything that needs your documents comes back empty.
- There is no error message anywhere — it behaves as if no documents were found.
- The knowledge source looks healthy on the "Knowledge" page.
- The same content is found when you search SharePoint directly.
- Your agent uses custom authentication, or its authentication was recently changed.
If instead single questions fail silently while others work → see No answer, no error: silent "ContentFiltered". If instead only certain PDFs are skipped → see Your PDF files are ignored or not answered. If instead only new files are missing → see New or updated files don't show up in answers. If instead users see connection prompts → see Users get "Unable to provision connection" prompts.
What's happening
Your agent reads SharePoint through an Entra ID app registration. An app registration is the identity card your agent presents to other Microsoft services. That identity card needs permissions, called scopes, and an admin's consent to use them. When a scope or the consent is missing, SharePoint returns an empty result — not an error. Copilot Studio passes the emptiness on to the user. It looks exactly like "no matching documents". Picture a security guard who turns your courier away at the door and tells nobody.
For technicians
Official troubleshooting, verbatim: "no results are returned, nor any errors or exceptions. For a user, it appears as if no documents were found."
- The failure mode applies to agents that authenticate through a custom Entra app registration (documented as of 2026-07-08).
- Silent scope failures are indistinguishable from empty search results at every layer visible to makers.
How to fix it
Solution 1
Official workaroundVerify the app registration's scopes and consent
- Find out which app registration your agent's authentication uses.
- Compare its configured API permissions with the scopes listed in Microsoft's troubleshooting article.
- Add any missing scopes.
- Ask an Entra administrator to grant admin consent for the scopes.
✅ You should now see: every required permission with a granted status in the app registration.
- Retest the agent with a document question.
✅ You should now see: grounded answers with citations from your documents.
Check that it worked
If it didn't work
- Consent was granted, but not for every scope. Recheck each permission's status line individually.
- The user lacks SharePoint permissions. The agent searches with the signed-in user's rights. Test with an account that can open the files.
- The content was filtered, not missing. See No answer, no error: silent "ContentFiltered".
- Your change hasn't propagated to the channel. See Teams answers with an old version of your agent.
Prevent it next time
- Add a scope-and-consent check to your deployment checklist for every agent with custom authentication.
- After any authentication change, retest one document question before you sign off.
Evidence
Official documentationlearn.microsoft.com
Documents that missing Entra app-registration scopes or consent return no results and no errors, appearing as if no documents were found.
Official documentationlearn.microsoft.com
Describes the end-user authentication configuration, including the app registration and scopes that knowledge features depend on.