Referencia de ajustes administrados por Enterprise

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, la configuración anterior en esta lista tiene prioridad sobre la configuración más adelante en la lista:

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

Teclas compatibles

Ejemplo de configuración

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

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

enabledPlugins

Define complementos que se instalan o bloquean automáticamente para todos los usuarios empresariales. Cada entrada usa el formato PLUGIN-NAME@MARKETPLACE-NAME como clave, con un valor booleano: true para requerir que el complemento esté habilitado o false para requerir que se deshabilite. Consulte Acerca de los estándares de complementos administrados por la empresa.

extraKnownMarketplaces

Define marketplaces de complementos adicionales disponibles para los usuarios. Cada entrada es un objeto de mercado con nombre que contiene una propiedad source. Se admiten los siguientes tipos de origen:

• "github" : requiere repo en OWNER/REPO formato; opcional ref (rama, etiqueta o SHA) y path (subdirectorio)
• "git" — requiere url; opcional ref y path
• "directory" — requiere path

Consulte Acerca de los estándares de complementos administrados por la empresa.

strictKnownMarketplaces

Restringe la instalación del complemento solo a los marketplaces definidos explícitamente por la empresa. Un array vacío significa bloqueo completo. Cada entrada es un objeto de Marketplace con una source propiedad que indica el tipo de origen. Se admiten los siguientes tipos de origen:

• "github" — requiere repo en OWNER/REPO formato; opcional ref y path
• "git" — requiere url; opcional ref y path
• "url": requiere url; objeto opcional headers
• "npm" — requiere package
• "file" — requiere path
• "directory" — requiere path

•           `"hostPattern"`: requiere `hostPattern` (regex que coincide con los hosts del marketplace)
  

• "pathPattern" — requiere pathPattern (regex que coincida con las rutas del Marketplace)

permissions

disableBypassPermissionsMode

Impide que los usuarios habiliten el modo de omisión (también conocido como "modo YOLO") en CLI de Copilot y VS Code. El modo de omisión permite a un agente ejecutar comandos, acceder a archivos y capturar direcciones URL sin solicitar aprobación.

Cuando se establece disableBypassPermissionsMode en "disable", los usuarios no pueden activar el modo de omisión en ninguno de los dos clientes:

• En CLI de Copilot, las opciones de línea de comandos --yolo y --allow-all y los comandos con barra /yolo y /allow-all están bloqueados. Las marcas individuales, como --allow-all-tools y --allow-all-paths , no están bloqueadas.
• En VS Code, la configuración global de aprobación automática (chat.tools.global.autoApprove), también conocida como "modo YOLO", está desactivada y no se puede volver a habilitar.

model

Establece la selección automática del modelo como valor predeterminado para las nuevas conversaciones en CLI de Copilot. Consulte Acerca de Copilotselección automática de modelos.

Al establecer permissions.model a "auto", las nuevas sesiones usan el modelo Auto, a menos que el usuario especifique un modelo diferente para cada conversación.

telemetry

Configura la exportación de OpenTelemetry, dirigiendo los datos de uso Copilot a un colector que elija.

Cuando establece la propiedad telemetry, la telemetría Copilot se envía al punto de conexión que especifique. Se admiten las siguientes subpropiedades:

• enabled: se establece en true para activar la exportación de telemetría o false para desactivarla.
• endpoint: la dirección URL del recopilador de OTLP (por ejemplo, https://otel-collector.example.com).
• protocol: protocolo de transporte para la exportación de telemetría. Los valores aceptados son: "http/json" y "http/protobuf".
• captureContent: se establece en true para incluir contenido de solicitud y respuesta en la carga de telemetría o false para excluirlo.
• lockCaptureContent: se establece en true para impedir que los usuarios cambien la captureContent configuración.
• serviceName: una etiqueta para el nombre del servicio de telemetría (por ejemplo, "copilot").
• resourceAttributes: un objeto de los atributos de recursos openTelemetry que se van a asociar a todos los datos de telemetría exportados (por ejemplo, {"deployment.environment": "production"}).
• headers: objeto de encabezados HTTP que se van a incluir con cada solicitud de telemetría (por ejemplo, un Authorization encabezado para el recopilador).