Переопределение параметров, управляемых предприятием для корпоративных команд

При развертывании, управляемом сервером, вы можете настроить файл предприятия managed-settings.json для применения различных параметров управления к группам пользователей на основе членства в команде предприятия. Предприятие определяет все параметры в центральном месте, а членство в команде предприятия определяет, какие пользователи получают заданный набор значений. Если файл еще не создан managed-settings.json , см. раздел AUTOTITLE.

Чтобы позволить корпоративным командам заменить корпоративный параметр по умолчанию, пометьте ключ как overridable в managed-settings.json. Переопределенный ключ использует значение команды предприятия при установке или возвращается к корпоративному умолчанию, когда команда предприятия оставляет ее не настроенной.

Поддерживаемые ключи

Синтаксис { "overridable": <VALUE> } применяется к ключам model, ,autoTier``fusionTier, permissions.deny``allowedMcpServers``permissions.allow``permissions.disableBypassPermissionsMode``deniedMcpServers``permissions.ask, extraKnownMarketplaces``strictKnownMarketplacesи.sandbox

enabledPlugins работает аддитивно. Предприятие managed-settings.json задает базовый план, а корпоративный файл команды может добавлять дополнительные подключаемые модули на его основе.

Полное описание этих ключей и их синтаксис см. в разделе Управляемые корпоративными настройками.

Переопределение параметров для определенных корпоративных команд

Эти инструкции применяются к развертываниям, управляемым серверомmanaged-settings.json (размещенным в GitHub). Другие методы развертывания не поддерживают переопределения группы предприятия и требуют развертывания различных параметров в разных группах пользователей с помощью платформы MDM.

Вы будете copilot/teams/ использовать copilot/team-mappings.json и каталог, чтобы настроить, какие корпоративные команды должны использовать параметры, которые отличаются от значений по умолчаниюcopilot/managed-settings.json.

После завершения этого раздела .github-private репозиторий будет иметь следующую структуру:

• .github-private/
  • copilot/

    ---

managed-settings.json **: { "model": { "overridable": "auto" } } * ** team-mappings.json **: { "no-auto.json": ["special-team"] } * teams/ * ** no-auto.json **: { "model": "unmanaged" }

Шаги

1. В файле предприятия copilot/managed-settings.json пометьте каждый ключ, который вы хотите сделать доступным для переопределения с помощью синтаксиса { "overridable": <VALUE> } . Файлы json , сопоставленные с корпоративными командами, могут отправлять только разные значения для ключей, которые можно переопределить.

   Указанное overridable значение является значением managed-settings.json по умолчанию, если корпоративные файлы команды не объявляют другое значение для заданного ключа.

   Например, чтобы отложить и disableBypassPermissionsMode``allowedMcpServers в корпоративные команды, выполните приведенные modelниже действия.

   {
     "model": { "overridable": "auto" },
     "permissions": {
       "disableBypassPermissionsMode": { "overridable": "disable" }
     },
     "allowedMcpServers": {
       "overridable": [
         { "serverUrl": "https://mcp.company.com/*" }
       ]
     }
   }
   

2. Создайте в .github-privateрепозитории copilot/team-mappings.json предприятия. Сопоставить каждый файл параметров команды предприятия с одним или несколькими корпоративными командами. Ключом является имя файла параметров, а значением является массив корпоративных команд slugs, поэтому можно применить один файл в нескольких корпоративных командах.

   {
     "devs.json": ["developers-all", "finops-dev"],
     "ai-users.json": ["ai-baseline-trained"],
     "frontier.json": ["ai-pioneers"]
   }
   

3. Создайте файл параметров группы предприятия в разделе copilot/teams/. Вы можете включить все ключи, помеченные как переопределимые, более строгие значения для autoTier, а также аддитивный ключ enabledPlugins. Каждый другой ключ остается управляемым вашей компанией по умолчанию.

   {
     "model": "unmanaged",
     "permissions": {
       "disableBypassPermissionsMode": "unmanaged"
     },
     "allowedMcpServers": [
       { "serverUrl": "https://team-specific-mcp.company.com/*" }
     ]
   }
   

4. Зафиксируйте и отправьте изменения в ветвь по умолчанию.

GitHub оценивает членство в команде предприятия и применяет соответствующие параметры для каждого пользователя. Если пользователь принадлежит нескольким корпоративным командам, их корпоративные файлы команды объединяются с использованием наименьшего ограничивающего значения для каждого ключа, а затем применяется под параметрами предприятия, где решения платформы всегда выигрывают.