Настройка управляемых корпоративными настройками

Настройте управляемые корпоративными настройками, определив managed-settings.json файл в репозитории .github-private вашего предприятия для централизованного управления Copilot клиентскими конфигурациями.

Кто может использовать эту функцию?

Enterprise owners

В этой статье

С корпоративными управляемыми настройками владельцы могут централизованно определять и распространять настройки конфигурации для Второй пилот CLIVS Code пользователей на тарифном Copilot плане вашего предприятия, обеспечивая работу каждого участника в рамках одинаковых ограничений. За этим последует дополнительная поддержка клиентов. Он managed-settings.json имеет приоритет над конфигурацией на основе файлов, установленной пользователями в своих клиентах для поддерживаемых ключей.

Консолидированная ссылка на схему

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

JSON
{
  "extraKnownMarketplaces": {
    "agent-skills": {
      "source": {
        "source": "github",
        "repo": "OWNER/REPO"
      }
    }
  },
  "strictKnownMarketplaces": [
    {
      "source": "github",
      "repo": "OWNER/REPO"
    }
  ],
  "enabledPlugins": {
    "PLUGIN-NAME@MARKETPLACE-NAME": true
  },
  "permissions": {
    "disableBypassPermissionsMode": "disable",
    "model": "auto"
  }
}
  • extraKnownMarketplaces: Определяет дополнительные маркетплейсы плагинов, доступные пользователям. Каждая запись — это именованный объект маркетплейса, содержащий source свойство, указывающее провайдера ("github") и репозиторий в OWNER/REPO формате.
  • strictKnownMarketplaces: Ограничивает установку плагинов только маркетплейсами, явно определёнными предприятием. Каждая запись — это объект на рынке, содержащий свойство source . Он source указывает провайдера либо "github" с in repo форматомOWNER/REPO, либо "git" с url указанием на git-репозиторий.
  • enabledPlugins: Определяет плагины, которые автоматически устанавливаются для всех корпоративных пользователей. Каждая запись использует формат PLUGIN-NAME@MARKETPLACE-NAME в качестве ключа с булевым значением true для включения плагина.
  • permissions: Контролирует, могут ли пользователи обойти одобрение команд.
    • Настройте model так, "auto" чтобы новые разговоры начинались с автоматического выбора модели Copilot по умолчанию. Пользователи всё равно могут переходить на другую модель в зависимости от каждого разговора.
    • Настройте disableBypassPermissionsMode так, "disable" чтобы предотвратить включение режима обхода. См. подробнее в статье «Отключение режима обхода для вашего предприятия » для получения дополнительной информации.

Настройка корпоративных стандартов плагинов

Вы можете применять настройки для управления доступными плагинами и плагинами по умолчанию. См . раздел AUTOTITLE.

  1. В репозитории .github-private вашего предприятия создайте управляемый файл настроек по адресу copilot/managed-settings.json. Если вы не установили .github-private репозиторий в качестве источника конфигурации агентов вашего предприятия, см. Создание .github-private репозитория.

    Также поддерживается наследственный путь (.github/copilot/settings.json).

  2. Добавьте конфигурацию вашей политики плагина в файл, используя extraKnownMarketplaces, strictKnownMarketplacesи enabledPlugins свойства , описанные в Consolidated schema reference.

    JSON
    {
  "extraKnownMarketplaces": {
    "agent-skills": {
      "source": {
        "source": "github",
        "repo": "OWNER/REPO"
      }
    }
  },
  "strictKnownMarketplaces": [
    {
      "source": "github",
      "repo": "OWNER/REPO"
    }
  ],
  "enabledPlugins": {
    "PLUGIN-NAME@MARKETPLACE-NAME": true
  }
}

  3. Зафиксируйте и отправьте изменения в стандартную ветку .github-private репозитория.

Установка автоматического выбора модели Copilot по умолчанию

Можно установить автоматический выбор модели как модель по умолчанию для новых разговоров в Второй пилот CLI и VS Code. Чтобы узнать больше, смотрите О компании Copilotвыбор автоматической модели. Установив его по умолчанию для вашего предприятия, вы гарантируете, что новые разговоры начинаются с выбранной автомодели.

Что делает настройка Auto model по умолчанию

Когда вы установите model под "auto"``permissions, начинаются новые разговоры с выбранной автомоделью в обоих клиентах:

  • В Второй пилот CLI, новые сессии используют автомодель, если пользователь не указал другую модель.
  • В VS Code, выбирающий модель по умолчанию переключается на Автомодель, когда пользователь начинает новый разговор.

Пользователи всё равно могут переходить на другую модель в зависимости от каждого разговора.

Отключение режима обхода для вашего предприятия

Вы можете запретить пользователям включать режим обхода (также известный как «режим YOLO») в Второй пилот CLI и VS Code. Режим обхода позволяет агенту запускать команды, получать доступ к файлам и получать URL без запроса одобрения. Отключив его для вашего бизнеса, вы гарантируете, что человек внимательно проверяет каждое из этих действий.

Что мешает отключению режима обхода

При установке disableBypassPermissionsMode , "disable"пользователи не могут включить режим обхода ни в одном из клиентов:

  • В Второй пилот CLI, --yolo``--allow-all``--allow-all-tools``--allow-all-paths, и --allow-all-urls командной строке, а /yolo также команды и /allow-all и slash блокируются.
  • В VS Code, глобальная настройка автоутверждения (chat.tools.global.autoApprove), также известная как «режим YOLO», отключена и не может быть вновь активирована.

Настройка сеттинга

  1. В репозитории .github-private вашего предприятия создайте управляемый файл настроек по адресу copilot/managed-settings.json. Если вы не установили .github-private репозиторий в качестве источника конфигурации агентов вашего предприятия, см. Создание .github-private репозитория.

    Также поддерживается наследственный путь (.github/copilot/settings.json).

  2. Добавьте свойство permissions в файл, установив disableBypassPermissionsMode на "disable".

    JSON
    {
  "permissions": {
    "disableBypassPermissionsMode": "disable"
  }
}

  3. Зафиксируйте и отправьте изменения в стандартную ветку .github-private репозитория.

Проверка конфигурации применена

После закрепления конфигурации пользователи увидят указанные настройки при следующей аутентификации с поддерживаемого клиента. Клиенты получают последнюю конфигурацию раз в час.

Если пользователь не видит этих настроек, убедитесь, что он получает доступ через Copilot вашу компанию или одну из её организаций. Если пользователь получает лицензию от нескольких биллинговых организаций, убедитесь, что он выбрал ваше предприятие в выпадающем меню «Использование выставленного счетом» в своих личных Copilot настройках.