document cloud agent managed settings

[JamieB101]

Why:

Closes: N/A

The [27 July 2026 changelog announcement](https://github.blog/changelog/2026-07-27-enterprise-managed-settings-now-apply-to-the-github-copilot-app/) confirms that the Copilot cloud agent now observes enterprise-managed plugin and marketplace controls.

The enterprise-managed settings documentation was updated for the GitHub Copilot app, but it does not show the cloud agent in the supported-client list or settings matrix. The deployment and refresh guidance also describes only locally installed clients.

What's being changed:

This PR:

• Adds the Copilot cloud agent to the list of supported clients.

• Adds a cloud-agent column to the managed settings support matrix.

• Records support for:

  • enabledPlugins
  • extraKnownMarketplaces
  • strictKnownMarketplaces

• Records that permissions.disableBypassPermissionsMode, permissions.model, and telemetry are not supported by the cloud agent.

• Clarifies that the cloud agent only uses server-managed settings.

• Clarifies that updated settings apply to the cloud agent on the next task assignment.

• Separates local-client loading and refresh behaviour from cloud-agent behaviour.

• Replaces stale wording that referred only to Copilot CLI and Visual Studio Code with the broader supported-client scope.

The GitHub Docs content linter completed with no errors.

Check off the following:

• A subject matter expert (SME) has reviewed the technical accuracy of the content in this PR. In most cases, the author can be the SME. Open source contributions may require an SME review from GitHub staff.
• The changes in this PR meet [the docs fundamentals that are required for all content](http://docs.github.com/en/contributing/writing-for-github-docs/about-githubs-documentation-fundamentals).
• All CI checks are passing and the changes look good in the review environment.

[welcome]

Thanks for opening this pull request! A GitHub docs team member should be by to give feedback soon. In the meantime, please check out the contributing guidelines.

[github-actions]

How to review these changes 👓

Thank you for your contribution. To review these changes, choose one of the following options:

• Spin up a codespace
• Set up a local development environment

A Hubber will need to deploy your changes internally to review.

Table of review links

Note: Please update the URL for your staging server or codespace.

The table shows the files in the content directory that were changed in this pull request. This helps you review your changes on a staging server. Changes to the data directory are not included in this table.

Source	Review	Production	What Changed
copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/configure-enterprise-managed-settings.md	fpt ghec	fpt ghec
copilot/reference/enterprise-managed-settings-reference.md	fpt ghec	fpt ghec

Key: fpt: Free, Pro, Team; ghec: GitHub Enterprise Cloud; ghes: GitHub Enterprise Server

🤖 This comment is automatically generated.

[Copilot]

Pull request overview

Documents enterprise-managed settings support for the Copilot cloud agent.

Changes:

• Adds the cloud agent to supported clients and the settings matrix.
• Clarifies server-managed deployment and refresh behavior.
• Distinguishes cloud-agent behavior from local clients.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.

File	Description
enterprise-managed-settings-reference.md	Adds cloud-agent support statuses.
configure-enterprise-managed-settings.md	Adds deployment and refresh guidance.