Users can see Copilot agent in "Built by your org" but cannot add it unless explicitly granted Viewer access

Ermal Haka 20 Reputation points
2026-08-03T13:30:05.67+00:00

Issue

The agent has been successfully published.

"Show to everyone in my organization" is enabled.

The agent appears under "Built by your org" for all users.

The agent status shows "Available in App Store".

Affected users have valid Microsoft 365 Copilot licenses and can use Copilot normally.

However, when users attempt to add the agent, they receive the following error:

"You don't have permissions to add this agent. Please contact your IT admin for help."

Troubleshooting performed

Verified the agent is published and available to the organization.

Verified affected users can see the agent in the store.

Verified affected users have the required Copilot licenses.

Tested from both Microsoft 365 Copilot and Microsoft Teams.

Enabled "Show to everyone in my organization".

Tested with End user access.

Republished the agent multiple times.

Verified authentication is configured with Microsoft Entra ID.

Key findings

When a user is explicitly added to the agent as a Viewer:

The user can successfully add the agent.

The user can use the agent without any issue.

Once the explicit Viewer permission is removed and access relies only on "Everyone in organization", the issue returns immediately.

Additional observation

The issue is not limited to this specific agent. We have observed the same behavior with other agents available under "Built by your org".

This suggests the issue may be related to tenant-wide access controls, organizational sharing permissions, or a platform-level issue affecting organizational Copilot agents rather than a specific agent configuration.

Could you please advise whether there are known restrictions, tenant settings, or service issues that could cause users to see organizational agents but be unable to add them unless they are explicitly assigned access?

Microsoft Copilot | Microsoft 365 Copilot | Development

Answer accepted by question author

AI answer

2026-08-03T13:30:30.26+00:00

The behavior matches an access-control issue rather than a publishing issue.

Supported facts from the documented behavior:

  1. Visibility in the store and actual usage access are separate controls. An agent can appear in Built by your org / Built for your org after admin approval, but access and use are still governed by tenant admin controls and sharing settings.
  2. Tenant admins can restrict who can access agents. In the Microsoft 365 admin center under Agents > Settings > User access, admins can allow:
    • All users
    • No users
    • Specific users/groups
    If this is set to Specific users/groups, users can see agents in the registry or store experience, but only the selected users or groups can actually use them.
  3. Org-wide sharing can also be restricted by admin policy. Admins can control who is allowed to share agents with the organization:
    • All users
    • Specific users or groups
    • No users
    When org-wide sharing is disabled, the Anyone in your organization option is restricted for new sharing actions.
  4. Direct assignment working as Viewer is consistent with the platform behavior. Sharing an agent directly with users or groups adds them to the people with access list, and those users can then view/test or use the agent depending on the sharing mode. That aligns with the symptom where explicitly adding a user immediately resolves the error.
  5. Licensing can also block use of an agent even when the agent is shared. Users must have the Microsoft 365 Copilot license required for the capabilities configured in that agent. If the license doesn’t match the agent capabilities, attempts to use the agent can result in an error.

Based on the scenario, the most likely checks are:

  1. In Microsoft 365 admin centerAgentsSettingsUser access, confirm the tenant is set to All users or that the affected users/groups are included in Specific users/groups.
  2. Verify the affected users are in any required allowed group if Specific users/groups is configured.
  3. Confirm the agent’s capabilities match the users’ available Microsoft 365 Copilot licensing.
  4. If immediate access is required, continue assigning the affected users or groups directly to the agent as a workaround, since direct sharing is behaving as expected.

If the agent is visible in Built by your org, users can use other org agents, and only explicit Viewer assignment makes this specific agent usable, the strongest documented explanation is that effective access is being limited by agent access/sharing controls rather than by publication status.


References:

AI-generated content may be incorrect. Read our transparency notes for more information.

Was this answer helpful?

1 person found this answer helpful.

0 additional answers

Sort by: Most helpful

Your answer

Answers can be marked as 'Accepted' by the question author and 'Recommended' by moderators, which helps users know the answer solved the author's problem.