Referência de configurações gerenciadas da empresa

Referência para o esquema de configurações gerenciadas da empresa usado pelos Copilot clientes.

Neste artigo

Observação

Esse recurso está dentro prévia pública e sujeito a alterações.

Use essa referência para entender as chaves atualmente compatíveis em managed-settings.json.

Para métodos de implantação, consulte Configurando configurações gerenciadas pela empresa.

Regras de precedência

Quando várias fontes de configurações estão presentes, os clientes aplicam as configurações nesta ordem:

  1. Configurações gerenciadas pelo servidor
  2. Configurações gerenciadas por MDM
  3. Configurações baseadas em arquivo
  4. Configurações no nível do usuário

As configurações gerenciadas por MDM têm precedência. Se as configurações gerenciadas por MDM não estiverem disponíveis, os clientes aplicarão configurações gerenciadas pelo servidor antes das configurações baseadas em arquivo.

Chaves com suporte

ChaveTipoValores aceitosPurpose
permissions.disableBypassPermissionsModestring"disable"Desabilita o bypass ou o comportamento de permitir tudo no estilo YOLO
enabledPluginsobjectFormato de chave: PLUGIN-NAME@MARKETPLACE-NAME; valor: trueHabilita plug-ins específicos por chave
extraKnownMarketplacesobjectObjeto do marketplace nomeado com source.source ("github") e source.repo (OWNER/REPO)Adiciona marketplaces de plug-in que os usuários podem acessar
strictKnownMarketplacesarrayArray de objetos de marketplace com valores source ("github" com repo ou "git" com url)Restringe a instalação do plug-in a marketplaces explicitamente listados
modelobject
default configurado para um nome de modelo compatívelDefine as configurações de governança de modelo padrão
telemetryobject
enabled (boolean), endpoint (string), protocol ("otlp-http" ou "otlp-grpc"), captureContent (boolean), lockCaptureContent (boolean), serviceName (string), resourceAttributes (object), headers (object)Configura a exportação do OpenTelemetry para VS Code

Configuração de exemplo

O exemplo a seguir mostra essas chaves em um arquivo de configurações gerenciadas.

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