Configuration des paramètres gérés par l’entreprise

Configurez les paramètres gérés par l’entreprise en définissant un managed-settings.json fichier dans le référentiel de .github-private votre entreprise pour contrôler Copilot de manière centralisée les configurations du client.

Qui peut utiliser cette fonctionnalité ?

Enterprise owners

Dans cet article

Grâce aux paramètres gérés par l’entreprise, les propriétaires de l’entreprise peuvent définir et distribuer de manière centralisée des paramètres de configuration à Copilot pour CLI et VS Code pour les utilisateurs du forfait Copilot de votre entreprise, garantissant ainsi que chaque membre opère dans le même cadre. Une assistance supplémentaire aux clients sera assurée ultérieurement. Le managed-settings.json prévaut sur la configuration basée sur des fichiers définie par les utilisateurs dans leurs clients pour les clés prises en charge.

Référence du schéma consolidé

Le managed-settings.json fichier prend en charge les propriétés de niveau supérieur suivantes. Vous pouvez inclure n’importe quelle combinaison de ces propriétés en fonction des paramètres que vous souhaitez appliquer.

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: définit des places de marché de plug-in supplémentaires disponibles pour les utilisateurs. Chaque entrée est un objet de place de marché nommé contenant une source propriété qui spécifie le fournisseur ("github") et le référentiel au OWNER/REPO format.
  • strictKnownMarketplaces: limite l’installation du plug-in aux places de marché définies explicitement par l’entreprise. Chaque entrée est un objet marketplace contenant une source propriété. Le source spécifie le fournisseur comme étant soit "github" avec un repo au format OWNER/REPO, soit "git" avec un url pointant vers un dépôt Git.
  • enabledPlugins: définit les plug-ins installés automatiquement pour tous les utilisateurs d’entreprise. Chaque entrée utilise le format PLUGIN-NAME@MARKETPLACE-NAME comme clé, avec une valeur booléenne pour true pour activer le plug-in.
  • permissions: contrôle si les utilisateurs peuvent ignorer l’approbation des commandes.
    • Définissez model sur "auto" afin que les nouvelles conversations démarrent avec la sélection automatique du modèle de Copilot par défaut. Les utilisateurs peuvent toujours basculer vers un autre modèle par conversation.
    • Définissez disableBypassPermissionsMode sur "disable" pour empêcher les utilisateurs d’activer le mode de contournement. Consultez Désactiver le mode de contournement pour votre entreprise plus loin dans cet article pour plus d’informations.

Configuration des normes de plug-in d’entreprise

Vous pouvez appliquer des paramètres pour contrôler les marketplaces de plug-in disponibles des utilisateurs et les plug-ins installés par défaut. Consultez « À propos des normes de plug-in gérés par l’entreprise ».

  1. Dans le référentiel de .github-private votre entreprise, créez le fichier de paramètres managés à l’adresse copilot/managed-settings.json. Si vous n’avez pas défini de .github-private référentiel comme source de configuration des agents de votre entreprise, consultez Création d’un .github-private référentiel.

    L’ancien chemin d’accès (.github/copilot/settings.json) est également pris en charge.

  2. Ajoutez au fichier la configuration de la stratégie de votre module d’extension, à l’aide des propriétés extraKnownMarketplaces, strictKnownMarketplaces et enabledPlugins décrites dans la référence du schéma consolidé.

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

  3. Validez et envoyez vos modifications à la branche par défaut du .github-private référentiel.

Définir la sélection automatique du modèle de Copilot par défaut

Vous pouvez définir la sélection automatique du modèle comme modèle par défaut pour les nouvelles conversations dans Copilot pour CLI et VS Code. Pour en savoir plus, consultez À propos de Copilotsélection automatique de modèle. En le définissant comme valeur par défaut pour votre entreprise, vous vérifiez que les nouvelles conversations commencent par le modèle automatique sélectionné.

Effet de la définition du modèle Auto comme modèle par défaut

Lorsque vous définissez model sur "auto" dans permissions, les nouvelles conversations démarrent avec le modèle Auto sélectionné dans les deux clients :

  • Dans Copilot pour CLI, les nouvelles sessions utilisent le modèle automatique, sauf si l’utilisateur spécifie un autre modèle.
  • Dans VS Code, le sélecteur de modèles est défini par défaut sur Modèle automatique lorsqu’un utilisateur démarre une nouvelle conversation.

Les utilisateurs peuvent toujours basculer vers un autre modèle par conversation.

Désactivation du mode de contournement pour votre entreprise

Vous pouvez empêcher les utilisateurs d’activer le mode de contournement (également appelé « mode YOLO ») dans Copilot pour CLI et VS Code. Le mode contournement permet à un agent d’exécuter des commandes, d’accéder aux fichiers et d’extraire des URL sans demander d’approbation. En le désactivant pour votre entreprise, vous assurez qu’une personne passe en revue chacune de ces actions.

Ce que la désactivation du mode de contournement empêche

Lorsque vous définissez disableBypassPermissionsMode sur "disable", les utilisateurs ne peuvent pas activer le mode de contournement dans aucun des deux clients :

  • Dans Copilot pour CLI, les options de ligne de commande --yolo, --allow-all, --allow-all-tools, --allow-all-paths et --allow-all-urls, ainsi que les commandes slash /yolo et /allow-all, sont bloquées.
  • Dans VS Code, le paramètre global d’approbation automatique (chat.tools.global.autoApprove), également appelé « mode YOLO », est désactivé et ne peut pas être réactivé.

Configuration du paramètre

  1. Dans le référentiel de .github-private votre entreprise, créez le fichier de paramètres managés à l’adresse copilot/managed-settings.json. Si vous n’avez pas défini de .github-private référentiel comme source de configuration des agents de votre entreprise, consultez Création d’un .github-private référentiel.

    L’ancien chemin d’accès (.github/copilot/settings.json) est également pris en charge.

  2. Ajoutez la propriété permissions au fichier, avec disableBypassPermissionsMode définie sur "disable".

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

  3. Validez et envoyez vos modifications à la branche par défaut du .github-private référentiel.

Vérification de l’application de la configuration

Une fois la configuration validée, les utilisateurs verront les paramètres spécifiés la prochaine fois qu’ils s’authentifient à partir d’un client pris en charge. Les clients extrayent la dernière configuration une fois par heure.

Si un utilisateur ne voit pas ces paramètres, assurez-vous qu’il ait accès à Copilot par le biais de votre entreprise ou de l’une de ses organisations. Si un utilisateur reçoit une licence de plusieurs entités de facturation, vérifiez qu’il a sélectionné votre entreprise dans la liste déroulante « Utilisation facturée à » dans ses paramètres personnelsCopilot.