Configuración de opciones administradas por la empresa

Configure las opciones administradas por la empresa para controlar Copilot de forma centralizada el comportamiento del cliente en toda la empresa mediante la implementación basada en archivos, administrada por MDM o administrada por el servidor.

¿Quién puede utilizar esta característica?

Enterprise owners

En este artículo

Con la configuración administrada por la empresa, los propietarios de empresas pueden definir y distribuir de forma centralizada las opciones de configuración a CLI de Copilot y VS Code para los usuarios en el plan de su Copilot empresa, lo que garantiza que todos los miembros funcionen dentro de los mismos límites de protección. Habrá soporte adicional para el cliente a continuación.

Esta configuración se aplica a toda la empresa, sin posibilidad de anulación a nivel de organización. Para cada clave admitida, el managed-settings.json valor tiene prioridad sobre cualquier configuración basada en archivos que un usuario establezca en su cliente.

La configuración administrada se carga localmente cuando se inicia el cliente, incluso si el dispositivo no tiene ninguna conexión de red. Esto significa que controles como el modo de omisión desactivado y la configuración restringida de complementos siguen aplicándose antes de iniciar sesión o de cualquier ida y vuelta al servidor, y siguen activos cuando los usuarios cambian de cuenta.

Elección de un método de implementación

Hay varias formas de desplegar la configuración administrada empresarial. Use las instrucciones siguientes para elegir el método adecuado para usted. Para cualquier método, realice una prueba piloto con un grupo pequeño de dispositivos antes de un despliegue generalizado.

  • Administrado por el servidor: valor predeterminado para la mayoría de las empresas y mejor para revisar flujos de trabajo e historial de auditoría
  • Gestionado por MDM: Mejor cuando los equipos de TI necesitan segmentación por grupos de dispositivos mediante las herramientas de MDM existentes en macOS y Windows
  • Basado en archivos: disponible en todas las plataformas y útil cuando la implementación administrada por el servidor y administrada por MDM no está disponible, incluidos los entornos de desarrollador, como contenedores y Codespaces

Implementación de la configuración administrada por el servidor

  1. Cree y configure el .github-private repositorio. Consulte Creación de un .github-private repositorio.
  2. En el repositorio, cree o actualice copilot/managed-settings.json.
  3. Agregue las claves y los valores de la directiva empresarial en formato JSON.
  4. Confirme e inserte los cambios en la rama predeterminada.
  5. Confirme que los usuarios empresariales ejecutan un cliente compatible. La configuración actualizada se aplica automáticamente en aproximadamente una hora, o inmediatamente después de que el cliente se reinicie o el usuario vuelva a iniciar sesión.

Implementación de la configuración administrada por MDM

  1. Crea o actualiza tu managed-settings.json carga útil con el mismo esquema JSON utilizado para la configuración gestionada por el servidor.

  2. Implemente el paquete mediante su plataforma de MDM empresarial y el proceso de implementación estándar.

  3. Asigne la directiva a los grupos de dispositivos de destino.

    Los clientes no necesitan reiniciarse y comprobar si hay directivas actualizadas cada hora. En VS Code, un administrador puede forzar una comprobación de las pruebas ejecutando el Developer: Sync Account Policy comando .

  4. Confirme que la configuración surtió efecto. Consulte Comprobación de que se ha aplicado la configuración.

Implementación de la configuración basada en archivos

  1. Cree o actualice un managed-settings.json archivo con las claves de directiva y los valores que desea aplicar.
  2. Distribuya el archivo a máquinas administradas mediante el proceso de administración de dispositivos estándar. Las máquinas que no reciben el archivo no están restringidas por esta directiva, por lo que la implementación basada en archivos solo proporciona cobertura para las máquinas a las que se distribuye activamente.
  3. Aplique permisos de archivo según los requisitos de seguridad de la empresa.
  4. Pida a los usuarios que reinicien los clientes compatibles para que la directiva actualizada se cargue durante el inicio.
  5. Confirme que la configuración surtió efecto. Consulte Comprobación de que se ha aplicado la configuración.

Referencia de esquema consolidado

El managed-settings.json archivo admite las siguientes propiedades de nivel superior. Puede incluir cualquier combinación de estas propiedades en función de la configuración que quiera aplicar.

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 marketplaces de complementos adicionales disponibles para los usuarios. Cada entrada es un objeto de Marketplace con nombre que contiene una source propiedad que especifica el proveedor ("github") y el repositorio en OWNER/REPO formato.
  • strictKnownMarketplaces: restringe la instalación del complemento solo a los marketplaces definidos explícitamente por la empresa. Cada entrada es un objeto de Marketplace que contiene una source propiedad . source especifica el proveedor como "github" con un repo en OWNER/REPO formato o "git" con un url que apunta a un repositorio git.
  • enabledPlugins: define complementos que se instalan automáticamente para todos los usuarios empresariales. Cada entrada usa el formato PLUGIN-NAME@MARKETPLACE-NAME como clave, con un valor booleano de true para habilitar el complemento.
  • permissions: controla si los usuarios pueden omitir la aprobación de comandos. Establezca disableBypassPermissionsMode en "disable" para evitar que los usuarios activen el modo bypass. Consulte Deshabilitación del modo de omisión para su empresa más adelante en este artículo para obtener más información.
  • model: controla la configuración predeterminada de gobernanza del modelo. Establézcalo en "auto" para que las nuevas conversaciones comiencen con la selección automática de modelo de Copilot de forma predeterminada. Los usuarios todavía pueden cambiar a un modelo diferente por conversación.

Configuración de estándares de complementos empresariales

Puede aplicar la configuración para controlar los marketplaces de complementos disponibles de los usuarios y los complementos instalados de forma predeterminada. Consulte Acerca de los estándares de complementos administrados por la empresa.

  1. Cree o actualice el archivo de configuración administrada de empresa mediante el método de implementación preferido. Para obtener una comparación de los métodos de implementación, consulte Configuración de opciones administradas por la empresa.

    Para la implementación administrada por el servidor en un .github-private repositorio, cree el archivo en copilot/managed-settings.json. También se admite la ruta heredada (.github/copilot/settings.json).

  2. Añada al archivo las propiedades extraKnownMarketplaces, strictKnownMarketplaces y enabledPlugins que necesite. Consulte el ejemplo y las descripciones de propiedades en Referencia de esquema consolidado. Combine estas propiedades en un archivo existente en lugar de sobrescribirla, por lo que no se quitan las opciones configuradas para otras directivas, como permissions.

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

  3. Confirme y empuje los cambios a la rama predeterminada del repositorio .github-private.

Establecimiento de Copilot la selección automática del modelo como valor predeterminado

Puede establecer la selección automática del modelo como modelo predeterminado para las nuevas conversaciones en CLI de Copilot y VS Code. Para más información, consulte Acerca de Copilotselección automática de modelos. Al establecerlo como valor predeterminado para su empresa, asegúrese de que las nuevas conversaciones comienzan con el modelo automático seleccionado.

Qué hace establecer el modelo Auto como predeterminado

Cuando cambias de model a "auto", las nuevas conversaciones se inician con el modelo Auto seleccionado en ambos clientes:

  • En CLI de Copilot, las nuevas sesiones usan el modelo automático a menos que el usuario especifique otro modelo.
  • En VS Code, el selector de modelos tiene como valor predeterminado Modelo automático cuando un usuario inicia una nueva conversación.

Los usuarios todavía pueden cambiar a un modelo diferente por conversación.

Configuración de la configuración

  1. Cree o actualice el archivo de configuración administrada de empresa mediante el método de implementación preferido. Para obtener una comparación de los métodos de implementación, consulte Configuración de opciones administradas por la empresa.

    Para la implementación administrada por el servidor en un .github-private repositorio, cree el archivo en copilot/managed-settings.json. También se admite la ruta heredada (.github/copilot/settings.json).

  2. Agregue la model propiedad al archivo y establezca en "auto".

    JSON
    {
  "model": "auto"
}

Desactivar el modo de bypass de su empresa

Puede impedir 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. Al deshabilitarla para su empresa, asegúrese de que una persona revisa cada una de estas acciones.

Lo que impide deshabilitar el modo de omisió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, se bloquean las opciones de línea de comandos --yolo, --allow-all, --allow-all-tools, --allow-all-paths y --allow-all-urls, y los comandos con barra diagonal /yolo y /allow-all.
  • 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.

Configuración de la configuración

  1. Cree o actualice el archivo de configuración administrada de empresa mediante el método de implementación preferido. Para obtener una comparación de los métodos de implementación, consulte Configuración de opciones administradas por la empresa.

    Para la implementación administrada por el servidor en un .github-private repositorio, cree el archivo en copilot/managed-settings.json. También se admite la ruta heredada (.github/copilot/settings.json).

  2. Agregue la permissions propiedad al archivo , con disableBypassPermissionsMode establecido en "disable". Si el archivo ya tiene un permissions objeto (por ejemplo, desde otra configuración de permisos), combine esta clave en él en lugar de reemplazar el objeto .

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

Comprobación de que la configuración se ha aplicado

Una vez confirmada la configuración, los usuarios de un cliente compatible ven la configuración especificada en aproximadamente una hora, ya que los clientes comprueban periódicamente el servidor para obtener la configuración actualizada. Reiniciar el cliente o iniciar sesión de nuevo aplica la configuración más reciente inmediatamente.

Si un usuario no ve esta configuración, asegúrese de que recibe acceso a Copilot través de su empresa o de una de sus organizaciones. Si un usuario recibe una licencia de varias entidades de facturación, asegúrese de que ha seleccionado la empresa en la lista desplegable "Uso facturado a" en su configuración personalCopilot.