Prise en main des paramètres gérés par l’entreprise

Avec les paramètres gérés par l’entreprise, vous pouvez définir et distribuer de manière centralisée les paramètres de configuration pour GitHub Copilot les clients pris en charge. Cela garantit que tout le monde travaille dans les garde-fous que vous définissez, avec la possibilité de spécialiser les paramètres pour différentes équipes. Par exemple, vous pouvez empêcher les agents d’effectuer des opérations sensibles, d’installer des plug-ins d’agent approuvés ou de s’assurer que les sessions s’exécutent dans un bac à sable.

Ce guide explique comment créer le fichier managed-settings.json sur GitHub, déployer les paramètres auprès des utilisateurs et redéfinir certains paramètres pour les équipes de l’entreprise. À titre d’exemple simple, nous veillerons à ce que les nouvelles conversations démarrent en mode auto du modèle pour la plupart des utilisateurs, et nous définirons une exception à ce paramètre pour une équipe d’entreprise spécifique. Cet exemple vous permet de tester le déploiement des paramètres managés sans provoquer d’interruption pour les utilisateurs.

Remarque

Si vous utilisez une entreprise dédiée pour Copilot Entreprise, il existe des conseils supplémentaires à prendre en compte. Consultez « Utilisation de paramètres gérés par l’entreprise sans organisations ».

Clients pris en charge

Les clients suivants sont pris en charge, bien que tous les clients ne prennent pas en charge chaque propriété :

Copilot CLI
VS Code
GitHub Copilot app.
Copilot cloud agent
JetBrains IDEs

Pour obtenir une référence complète des clés prises en charge, consultez Paramètres gérés par l’entreprise.

1. Créer un `.github-private` référentiel

Vous pouvez héberger le managed-settings.json fichier dans un .github-private référentiel appartenant à une organisation désignée de votre entreprise. Cela vous permet de conserver vos paramètres gérés à côté de vos profils d’agent personnalisés, dans un emplacement que les membres de l’entreprise peuvent consulter.

Pour obtenir des instructions sur la création du référentiel et sa sélection comme source de gouvernance cliente de votre entreprise, consultez Création d’un .github-private référentiel.

Les paramètres de gouvernance de ce référentiel s’appliquent à tous les utilisateurs qui reçoivent une Copilot licence de votre entreprise ou de l’une de ses organisations, que l’utilisateur ait accès au référentiel ou à .github-private l’organisation qui le possède. Nous vous recommandons d’offrir une visibilité interne au référentiel, afin que les membres de l’entreprise puissent afficher les paramètres de gouvernance et restreindre les modifications du managed-settings.json fichier aux administrateurs et aux gestionnaires d’IA.

Conseil

Il s’agit d’un déploiement « géré par le serveur ». Il existe d’autres méthodes de distribution de paramètres managés aux utilisateurs, notamment la gestion des appareils mobiles (MDM) et la remise de fichiers locaux. Pour plus d’informations, consultez « Choix de la façon de déployer des paramètres gérés par l’entreprise sur des utilisateurs ».

2. Créer le `managed-settings.json` fichier

Dans cet exemple, nous utilisons une configuration très simple qui garantit que les conversations des utilisateurs démarrent en mode automatique. Cela signifie que Copilot vous choisissez automatiquement le meilleur modèle pour la tâche d’un utilisateur à partir des modèles autorisés de votre entreprise, ce qui réduit les problèmes de limitation de débit pour les utilisateurs.

Dans le référentiel .github-private, créez un fichier au chemin copilot/managed-settings.json.
Ajoutez la configuration au fichier. Par exemple:
JSON
```
{
  "model": "auto"
}
```
```
{
  "model": "auto"
}
```
Validez vos modifications dans la branche par défaut.

Pour un déploiement réel, vérifiez les clés prises en charge et leur couverture selon les clients. Consultez « Paramètres gérés par l’entreprise ».

3. Remplacer le paramètre pour des équipes spécifiques

Vous pouvez redéfinir les propriétés prises en charge du fichier managed-settings.json pour les équipes d’entreprise. Dans cet exemple, nous allons désactiver la valeur par défaut du modèle automatique pour une équipe qui doit respecter des modèles spécifiques pour le travail spécialisé.

Une fois cette section terminée, votre .github-private référentiel aura la structure suivante :

.github-private/
- copilot/

managed-settings.json **: { "model": { "overridable": "auto" } } * ** team-mappings.json **: { "no-auto.json": ["special-team"] } * teams/ * ** no-auto.json **: { "model": "unmanaged" }

Steps

Créez une équipe d’entreprise contenant des utilisateurs qui ne doivent pas recevoir le mode automatique par défaut. Dans cet exemple, nous allons l’appeler special-team. Consultez « Création d’équipes d’entreprise ».
Dans votre fichier copilot/managed-settings.json, marquez la clé comme pouvant être redéfinie à l’aide de la syntaxe { "overridable": VALUE }. La valeur VALUE est utilisée par défaut lorsque les fichiers Teams ne définissent pas de valeur différente pour une clé donnée.

Par exemple, nous allons rendre model substituable pour les équipes d’entreprise, avec auto la valeur par défaut restante pour tous les autres :
JSON
```
{
  "model": { "overridable": "auto" }
}
```
```
{
  "model": { "overridable": "auto" }
}
```
Dans votre .github-private référentiel, créez un fichier de paramètres dédié pour l’équipe d’entreprise sous copilot/teams/. Par exemple : copilot/teams/no-auto.json.

Dans ce fichier, ajoutez une configuration qui fournit des valeurs pour les propriétés substituables.

L’exemple suivant supprime le contrôle en mode modèle automatique. Tout le reste reste régi par votre managed-settings.json fichier.
JSON
```
{
  "model": "unmanaged"
}
```
```
{
  "model": "unmanaged"
}
```
Dans votre .github-private référentiel, créez copilot/team-mappings.json. Dans ce fichier, mappez le nom de l’équipe d’entreprise à son fichier de configuration spécial. La clé est le nom du fichier de paramètres et la valeur est un tableau de slugs d’équipe. Vous pouvez donc appliquer un fichier à plusieurs équipes.
JSON
```
{
  "no-auto.json": ["special-team"]
}
```
```
{
  "no-auto.json": ["special-team"]
}
```
Validez et envoyez vos modifications à la branche par défaut.

Par la suite, vous pouvez ajouter différentes dérogations pour d’autres clés et d’autres équipes. Pour obtenir un exemple plus complet, consultez Substitution des paramètres gérés par l’entreprise pour les équipes.

4. Vérifiez que les paramètres sont actifs

Vérifiez que les paramètres que vous avez définis sont actifs pour les utilisateurs et redéfinis pour certaines équipes. Dans cet exemple, la plupart des utilisateurs de Copilot votre entreprise doivent trouver que de nouvelles conversations dans leur client démarrent en mode automatique. L’équipe special-team d’entreprise ne doit pas avoir cette expérience.

Pour les déploiements gérés par le serveur, les utilisateurs sur un client pris en charge voient les paramètres spécifiés dans un délai d’environ une heure. Cela inclut copilot/managed-settings.json, copilot/team-mappings.jsonet les fichiers dans copilot/teams/. Le redémarrage du client ou la connexion déclenche une actualisation immédiate.

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.

Pour les déploiements gérés par MDM, les clients vérifient chaque heure si des stratégies ont été mises à jour. Pour les déploiements basés sur des fichiers, redémarrez le client pour charger un fichier mis à jour. Ces méthodes de déploiement s’appliquent à tous les utilisateurs disposant des paramètres installés sur leur ordinateur, quel que soit l’emplacement de leur Copilot licence.

Étape suivante

Maintenant que vous avez créé une configuration de paramètres managés simple, vous pouvez :

Ajoutez des propriétés de gouvernance supplémentaires au fichier. Consultez « Paramètres gérés par l’entreprise ».
Déterminez s’il faut déployer des paramètres sur les utilisateurs via d’autres méthodes. Consultez « Choix de la façon de déployer des paramètres gérés par l’entreprise sur des utilisateurs ».

Prise en main des paramètres gérés par l’entreprise

Qui peut utiliser cette fonctionnalité ?

Dans cet article

À suivre