Configurar los ajustes de administración empresarial

Configure los ajustes administrados de la empresa definiendo un archivo managed-settings.json en el repositorio .github-private de su empresa para controlar de forma centralizada las configuraciones del cliente Copilot.

¿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. El managed-settings.json tiene prioridad sobre la configuración basada en archivos que los usuarios establecen en sus clientes para las claves admitidas.

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 model en "auto" para que las nuevas conversaciones empiecen con la selección automática de modelos de Copilot de forma predeterminada. Los usuarios todavía pueden cambiar a un modelo diferente por conversación.
    • 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.

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. En el repositorio .github-private de su empresa, cree el archivo de ajustes gestionados en copilot/managed-settings.json. Si no ha establecido un repositorio .github-private como fuente de configuración del agente de su empresa, consulte Creación de un .github-private repositorio.

    También se admite la ruta heredada (.github/copilot/settings.json).

  2. Añada la configuración de la política del complemento al archivo, usando las propiedades extraKnownMarketplaces, strictKnownMarketplaces y enabledPlugins que se describen en Referencia del 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 y empuje los cambios a la rama predeterminada del repositorio .github-private.

Establecer la selección automática de modelo de Copilot como opción predeterminada

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 se establece model en "auto" en permissions, las nuevas conversaciones comienzan con el modelo automático 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.

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. En el repositorio .github-private de su empresa, cree el archivo de ajustes gestionados en copilot/managed-settings.json. Si no ha establecido un repositorio .github-private como fuente de configuración del agente de su empresa, consulte Creación de un .github-private repositorio.

    También se admite la ruta heredada (.github/copilot/settings.json).

  2. Agregue la permissions propiedad al archivo , con disableBypassPermissionsMode establecido en "disable".

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

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

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

Una vez confirmada la configuración, los usuarios verán la configuración especificada la próxima vez que se autentiquen desde un cliente compatible. Los clientes extraen la configuración más reciente una vez por hora.

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.