Based on the symptoms, there are two main areas to focus on: Teams app/channel behavior and SharePoint‑grounded agents’ known issues and limitations.
- Verify Teams channel and app configuration
- Open the agent in Copilot Studio, go to Channels and open Teams and Microsoft 365 Copilot.
- Confirm the Teams channel is still connected and not removed or disconnected. If needed:
- Turn off the Teams channel, save, then turn it back on.
- Republish the agent after re‑enabling the channel.
- If the agent was made available via the Teams app store or Microsoft 365 Agent Store and was previously approved by an admin, confirm with the Teams admin that:
- The app is still Approved and not disabled or removed.
- App setup policies still allow users to install and use the agent.
- If users see errors when adding the app ("Something went wrong and we couldn't add…"), this can indicate a stale or cached configuration in Teams. In similar scenarios, the recommended workaround is:
- In the Teams admin center, disable the agent app, wait a few seconds, then re‑enable it.
- In Copilot Studio, toggle the Teams channel off and on, then republish.
- Have users sign out and back into Teams or refresh the Teams web client to clear app cache.
- Check known limitations for Teams vs. Microsoft 365 Copilot
- Agents created with Microsoft 365 Copilot’s Agent Builder cannot be used in Teams Chat. If the working agent is an Agent Builder agent (created directly in Microsoft 365 Copilot) and not a Copilot Studio/Foundry‑published bot, it won’t be supported in Teams.
- Teams has its own known limitations for Copilot Studio agents, including:
- Rate limiting on agents.
- Restrictions on certain node types and authentication behaviors.
- In group or channel chats, agents cannot use knowledge sources that require end‑user authentication (such as SharePoint) and are supported only in 1:1 chats.
- If the agent relies on SharePoint knowledge sources and is used in a context where end‑user authentication is required but not supported (for example, group chats or channels), the agent can fail at runtime even though it works in Copilot chat.
- Validate SharePoint grounding and licensing
- Declarative agents grounded in SharePoint can fail at runtime with a generic error when the signed‑in user does not have a valid Microsoft 365 Copilot license. Even if IT reports no license changes, verify that:
- The affected users still have an active Microsoft 365 Copilot or Microsoft 365 Copilot Business license.
- The user can directly access the SharePoint site URLs used as knowledge sources.
- The agent’s connection uses User authentication (service principals are not supported for SharePoint grounding).
- The user has at least Read permission on the SharePoint sites.
- If the agent is created via Microsoft 365 Copilot and uses SharePoint knowledge sources, note that:
- Auto‑sharing of SharePoint files/folders is limited to specific security groups; if permissions changed on those groups or files, the agent may stop returning information.
- Compare with the working “dummy” agent
- The dummy agent working in Teams indicates:
- Teams itself and the tenant’s basic bot policies are functioning.
- The issue is likely related to either:
- The specific app package/metadata of the original agent (for example, stale or invalid configuration in Teams), or
- The SharePoint grounding and authentication model used by the original agent.
- To avoid recurrence:
- Keep a simple test topic in the production agent that does not depend on SharePoint; use it to distinguish between Teams/app issues and SharePoint grounding issues.
- When changing SharePoint sites, permissions, or knowledge sources, test the agent in both Copilot chat and Teams 1:1 chat immediately after publishing.
- If the agent is exposed via the Teams app store or Microsoft 365 Agent Store, coordinate with the Teams admin so that any changes to access settings or app policies are reviewed when issues appear.
If, after re‑toggling the Teams channel, republishing, and confirming licensing and SharePoint access, the agent still fails only in Teams, the next step is to open a support case and provide the Conversation ID, Agent ID, and timestamps of the failing interactions so the backend configuration and runtime logs can be checked.
References: