Configurando configurações gerenciadas pela empresa

Defina as configurações gerenciadas da empresa definindo um managed-settings.json arquivo no repositório da sua empresa para controlar .github-private centralmente as configurações do Copilot cliente.

Quem pode usar esse recurso?

Enterprise owners

Neste artigo

Com as configurações gerenciadas pela empresa, os proprietários da empresa podem definir e distribuir centralmente as configurações para CLI do Copilot e VS Code para os usuários no plano Copilot da sua empresa, garantindo que todos os membros trabalhem dentro das mesmas diretrizes. Suporte adicional ao cliente será disponibilizado posteriormente. O managed-settings.json tem precedência sobre a configuração baseada em arquivo definida pelos usuários nos clientes para as chaves suportadas.

Referência de esquema consolidado

O managed-settings.json arquivo dá suporte às seguintes propriedades de nível superior. Você pode incluir qualquer combinação dessas propriedades com base em quais configurações você deseja impor.

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: define outros marketplaces de plug-in disponíveis para os usuários. Cada entrada é um objeto do marketplace nomeado que contém uma source propriedade que especifica o provedor ("github") e o repositório em OWNER/REPO formato.
  • strictKnownMarketplaces: restringe a instalação do plug-in somente aos marketplaces definidos explicitamente pela empresa. Cada entrada é um objeto do marketplace que contém uma source propriedade. O source especifica o provedor como "github" com um repo no formato OWNER/REPO, ou como "git" com um url apontando para um repositório Git.
  • enabledPlugins: define plug-ins instalados automaticamente para todos os usuários corporativos. Cada entrada usa o formato PLUGIN-NAME@MARKETPLACE-NAME como chave, com um valor booleano de true para habilitar o plug-in.
  • permissions: controla se os usuários podem ignorar a aprovação do comando.
    • Defina model como "auto" para que novas conversas sejam iniciadas com a seleção automática de modelo do Copilot por padrão. Os usuários ainda podem mudar para um modelo diferente por conversa.
    • Defina disableBypassPermissionsMode como "disable" para impedir que os usuários ativem o modo bypass. Consulte Desativar o modo de bypass para sua empresa mais adiante neste artigo para obter mais informações.

Configurando padrões corporativos de plug-ins

Você pode aplicar configurações para controlar os marketplaces de plug-in disponíveis dos usuários e os plug-ins instalados por padrão. Consulte Sobre os padrões de plug-in gerenciados pela empresa.

  1. No repositório da .github-private sua empresa, crie o arquivo de configurações gerenciadas em copilot/managed-settings.json. Se você ainda não definiu um .github-private repositório como a fonte de configuração do agente da sua empresa, consulte Criando um .github-private repositório.

    O caminho herdado (.github/copilot/settings.json) também tem suporte.

  2. Adicione a configuração da política de plug-in ao arquivo, usando as propriedades extraKnownMarketplaces, strictKnownMarketplaces e enabledPlugins descritas em Referência de esquema consolidado.

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

  3. Confirme e envie suas alterações por push para o branch padrão do .github-private repositório.

Definir a seleção automática de modelo do Copilot como padrão

Você pode definir a seleção de modelo automático como o modelo padrão para novas conversas dentro CLI do Copilot e VS Code. Para saber mais, consulte Sobre CopilotSeleção de modelo automática. Definindo-o como o padrão para sua empresa, você garante que novas conversas comecem com o modelo automático selecionado.

O que acontece ao definir o modelo Auto como padrão

Quando você definir model como "auto" em permissions, novas conversas começam com o modelo automático selecionado em ambos os clientes:

  • Em CLI do Copilot, novas sessões usam o modelo automático, a menos que o usuário especifique um modelo diferente.
  • Em VS Code, o seletor de modelo usa como padrão o modelo automático quando um usuário inicia uma nova conversa.

Os usuários ainda podem mudar para um modelo diferente por conversa.

Desabilitando o modo de bypass para sua empresa

Você pode impedir que os usuários habilitem o modo de bypass (também conhecido como "modo YOLO") dentro CLI do Copilot e VS Code. O modo de bypass permite que um agente execute comandos, acesse arquivos e busque URLs sem solicitar aprovação. Ao desabilitá-lo para sua empresa, você garante que uma pessoa examine cada uma dessas ações.

O que a desabilitação do modo de bypass impede

Quando você define disableBypassPermissionsMode como "disable", os usuários não podem ativar o modo de bypass em qualquer cliente:

  • Em CLI do Copilot, as opções de linha de comando --yolo, --allow-all, --allow-all-tools, --allow-all-paths e --allow-all-urls e os comandos de barra /yolo e /allow-all são bloqueados.
  • Em VS Code, a configuração de aprovação automática global (chat.tools.global.autoApprove), também conhecida como "modo YOLO", está desativada e não pode ser reabilitada.

Configurando a configuração

  1. No repositório da .github-private sua empresa, crie o arquivo de configurações gerenciadas em copilot/managed-settings.json. Se você ainda não definiu um .github-private repositório como a fonte de configuração do agente da sua empresa, consulte Criando um .github-private repositório.

    O caminho herdado (.github/copilot/settings.json) também tem suporte.

  2. Adicione a permissions propriedade ao arquivo, com disableBypassPermissionsMode definido como "disable".

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

  3. Confirme e envie suas alterações por push para o branch padrão do .github-private repositório.

Verificar se a configuração foi aplicada

Depois que a configuração for confirmada, os usuários verão as configurações especificadas na próxima vez que se autenticarem de um cliente com suporte. Os clientes puxam a configuração mais recente uma vez por hora.

Se um usuário não vir essas configurações, verifique se ele recebe acesso a Copilot por meio da sua empresa ou de uma de suas organizações. Se um usuário receber uma licença de múltiplas entidades de cobrança, verifique se ele selecionou sua empresa na lista suspensa "Uso cobrado para" nas configurações pessoais Copilot.