Referencia de configuraciones administradas empresariales

Referencia del esquema de configuración administrada empresarial utilizado por los clientes Copilot.

En este artículo

Nota:

Esta característica está en versión preliminar pública y está sujeta a cambios.

Use esta referencia para comprender las claves admitidas actualmente en managed-settings.json.

Para obtener métodos de implementación, consulte Configuración de opciones administradas por la empresa.

Reglas de precedencia

Cuando hay varios orígenes de configuración, los clientes aplican la configuración en este orden:

  1. Configuración administrada por el servidor
  2. Configuración administrada por MDM
  3. Configuración basada en archivos
  4. Configuración de nivel de usuario

La configuración administrada por MDM tiene prioridad. Si la configuración administrada por MDM no está disponible, los clientes aplican la configuración administrada por el servidor antes de la configuración basada en archivos.

Teclas compatibles

KeyTipoValores aceptadosPurpose
permissions.disableBypassPermissionsModestring"disable"Deshabilita el comportamiento de elusión o de permitirlo todo al estilo YOLO
enabledPluginsobjectFormato de clave: PLUGIN-NAME@MARKETPLACE-NAME; valor: trueHabilita complementos específicos por clave
extraKnownMarketplacesobjectObjeto marketplace con nombre con source.source ("github") y source.repo (OWNER/REPO)Agrega marketplaces de complementos a los que los usuarios pueden acceder
strictKnownMarketplacesarrayMatriz de objetos de Marketplace con source valores ("github" con repo, o "git" con url)Restringe la instalación del complemento a marketplaces enumerados explícitamente.
modelobject
default establecido en un nombre de modelo admitidoDefine la configuración predeterminada de gobernanza del modelo.
telemetryobject
enabled (boolean), endpoint (string), protocol ("otlp-http" o "otlp-grpc"), captureContent (boolean), lockCaptureContent (boolean), serviceName (string), resourceAttributes (object), headers (object)Configura la exportación de OpenTelemetry para VS Code

Ejemplo de configuración

En el ejemplo siguiente se muestran estas claves en un archivo de configuración administrada.

{
  "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"
    }
  }
}