企业托管设置参考

使用此参考了解 managed-settings.json 中当前支持的密钥。

有关部署方法和支持的客户端，请参阅配置企业管理设置。

优先规则

当存在多个设置源时，此列表中的前面设置优先于列表中的设置：

受 MDM 管理的设置
由服务器管理的设置
基于文件的配置
用户级设置

支持的密钥

密钥	Purpose	Copilot 命令行界面（CLI）	VS Code	GitHub Copilot 应用
`permissions.disableBypassPermissionsMode`	禁用绕过或 YOLO 样式允许的所有行为
`permissions.model`	将自动模型选择设置为新对话的默认值
`enabledPlugins`	按密钥启用或禁用特定插件
`extraKnownMarketplaces`	添加用户可以访问的插件市场
`strictKnownMarketplaces`	仅允许从明确列出的应用市场安装插件
`telemetry`	配置 OpenTelemetry 导出，将 Copilot 使用数据路由到你所选择的收集器
`remoteControl`	根据所列出的组织的控制客户端的 SSO 授权状态，限制是否可以远程控制此设备上托管的会话。不会影响用户远程控制在其他设备上托管的会话的能力

配置示例

以下示例在一个托管设置文件中显示这些密钥。

{
  "permissions": {
    "disableBypassPermissionsMode": "disable",
    "model": "auto"
  },
  "enabledPlugins": {
    "my-plugin@agent-skills": true
  },
  "extraKnownMarketplaces": {
    "agent-skills": {
      "source": {
        "source": "github",
        "repo": "OWNER/REPO"
      }
    }
  },
  "strictKnownMarketplaces": [
    {
      "source": "github",
      "repo": "OWNER/REPO"
    }
  ],
  "telemetry": {
    "enabled": true,
    "endpoint": "https://otel-collector.example.com",
    "protocol": "http/protobuf",
    "captureContent": false,
    "lockCaptureContent": true,
    "serviceName": "copilot",
    "resourceAttributes": {
      "deployment.environment": "production"
    },
    "headers": {
      "Authorization": "Bearer TOKEN"
    }
  },
  "remoteControl": {
    "mode": "requireSSO",
    "githubDotComOrganizations": ["ORG-NAME"]
  }
}

`enabledPlugins`

定义为所有企业用户自动安装或禁止的插件。每个条目使用格式 PLUGIN-NAME@MARKETPLACE-NAME 作为键，并带有布尔值： true 要求启用插件或 false 要求禁用插件。请参阅“关于企业管理的插件标准”。

`extraKnownMarketplaces`

定义可供用户使用的其他插件市场。每个条目都是包含属性 source 的命名市场对象。支持以下源类型：

"github" - 需要 repo 格式的 OWNER/REPO；可选的 ref（分支、标记或 SHA）和 path（子目录）
"git" — 需要 url;可选 ref 和 path
"directory" — 需要 path

请参阅“关于企业管理的插件标准”。

`strictKnownMarketplaces`

将插件安装限制为仅可从企业明确指定的应用市场进行安装。空数组表示完全锁定。每个条目都是一个市场对象，其中包含一个 source 指示源类型的属性。支持以下源类型：

"github" - 需要 repo 格式的 OWNER/REPO，可选 ref 和 path
"git" — 需要 url;可选 ref 和 path
"url" — 需要 url;可选 headers 对象
"npm" — 需要 package
"file" — 需要 path
"directory" — 需要 path
"hostPattern" - 需要 hostPattern（用于匹配市场主机的正则表达式）
"pathPattern" - 需要 pathPattern（用于匹配市场路径的正则表达式）

`permissions`

`disableBypassPermissionsMode`

阻止用户启用绕过模式（也称为“YOLO 模式”）。绕过模式允许代理在不请求批准的情况下运行命令、访问文件和提取 URL。

当您将 disableBypassPermissionsMode 设置为 "disable" 时，用户无法启用绕过模式：

在Copilot 命令行界面（CLI）中，允许所有权限（--yolo以及--allow-all单个--allow-all-tools``--allow-all-paths权限和--allow-all-urls选项）的所有命令行选项在启动时被禁止，并且无法授予提升的权限。 /yolo /allow-all还会阻止斜杠命令。
在中 VS Code，全局自动批准设置（chat.tools.global.autoApprove）已关闭，无法重新启用。
在 GitHub Copilot 应用的会话设置中，“工具权限”的“允许所有”设置被禁用。

`model`

将自动模型选择设置为新对话的默认值。请参阅“关于 Copilot自动模型选择”。

如果设置为permissions.model``"auto"，则新会话将使用自动模型，除非用户为每个会话指定不同的模型。

`telemetry`

配置 OpenTelemetry 导出，将使用情况数据路由 Copilot 到所选收集器。

Copilot 命令行界面（CLI）和 VS Code 支持此属性。

设置 telemetry 属性时， Copilot 遥测数据将发送到指定的终结点。支持以下子属性：

enabled：设置为 true 打开遥测导出，或 false 将其关闭。
endpoint：OTLP 收集器的 URL（例如 https://otel-collector.example.com）。
protocol：用于遥测导出的传输协议。接受的值是 "http/json" 和 "http/protobuf"。
captureContent：设置为 true 时，在遥测有效负载中包含提示和响应内容；设置为 false 时，则不包含这些内容。
lockCaptureContent：设置为 true 阻止用户更改 captureContent 设置。
serviceName：遥测服务名称的标签（例如 "copilot"）。
resourceAttributes：一个包含 OpenTelemetry 资源属性的对象，用于附加到所有导出的遥测数据（例如 {"deployment.environment": "production"}）。
headers：要随附于每个遥测请求的 HTTP 头的对象（例如，适用于收集器的 Authorization 头）。

`remoteControl`

限制是否可以 Copilot 远程控制设备上托管的会话。这不会影响用户远程控制在其他设备上托管的会话的能力。

mode：设置为 "disabled" 防止对设备上的会话进行远程控制， "requireSSO" 以便仅允许远程控制针对所列 githubDotComOrganizations组织的 SSO 授权的客户端，或 "enabled" 允许其不受限制。
githubDotComOrganizations：组织登录名数组。当 mode 是 "requireSSO" 时为必需项。

企业托管设置参考

在本文中