Déployer le connecteur GitHub Cloud Pull Requests Microsoft 365 Copilot

Le connecteur GitHub Cloud Pull Requests Microsoft 365 Copilot permet à votre organization d’indexer les demandes de tirage stockées dans des dépôts GitHub dans des expériences Microsoft 365 Copilot et Recherche Microsoft. Cet article décrit les étapes de déploiement et de personnalisation du connecteur. Pour obtenir des informations générales sur le déploiement du connecteur Copilot, consultez Configurer des connecteurs Copilot dans le Centre d’administration Microsoft 365.

Pour obtenir des informations de configuration GitHub avancées, consultez Configurer le service GitHub pour l’ingestion des connecteurs.

Configuration requise

Avant de déployer le connecteur GitHub Cloud Pull Requests, assurez-vous que l’environnement GitHub est configuré dans votre organization. Le tableau suivant récapitule les étapes de configuration de l’environnement GitHub et de déploiement du connecteur.

Avant de déployer le connecteur, vérifiez que vous remplissez les conditions préalables suivantes :

• Vous êtes administrateur Microsoft 365.
• Votre instance GitHub est accessible via l’API.
• Un application GitHub est créé et configuré pour l’authentification.
• Le compte utilisé pour l’authentification a accès aux dépôts et aux demandes de tirage à indexer.
• Les utilisateurs qui accèdent aux données GitHub indexées ont des identités Microsoft Entra ID correspondantes pour le mappage des autorisations.

Déployer le connecteur

Pour ajouter le connecteur GitHub Cloud Pull Requests pour votre organization :

1. Dans le Centre d’administration Microsoft 365, dans le volet gauche, choisissezConnecteursCopilot>.
2. Accédez à l’onglet Connecteurs , puis dans le volet gauche, choisissez Galerie.
3. Dans la liste des connecteurs disponibles, choisissez GitHub Cloud Pull Requests.

Définir le nom d’affichage

Le nom d’affichage est utilisé pour identifier les références dans les réponses Copilot afin d’aider les utilisateurs à reconnaître le fichier ou l’élément associé. Le nom d’affichage indique également le contenu approuvé et est utilisé comme filtre source de contenu.

Vous pouvez accepter le nom d’affichage des demandes de tirage cloud GitHub par défaut ou personnaliser la valeur pour utiliser un nom d’affichage que les utilisateurs de votre organization reconnaissent.

Pour plus d’informations sur les noms d’affichage et les descriptions des connecteurs, consultez Améliorer la découverte Copilot avec Microsoft 365 Copilot contenu des connecteurs.

Choisir le type d’authentification

Le connecteur prend en charge les types d’authentification suivants :

• OAuth (recommandé) : pour utiliser l’authentification OAuth :

  • Installez l’application GitHub Issues GitHub dans le organization GitHub.
  • Choisissez un nom d’affichage qui permet aux utilisateurs de reconnaître la connexion.
  • Entrez votre nom organization.
  • Choisissez Autoriser pour vous connecter et accorder l’accès.

  Remarque

  Cette méthode d’authentification est actuellement en préversion.

• Application GitHub personnalisée (au nom de l’utilisateur) : entrez votre ID client et votre clé secrète client à partir de l’application GitHub et autorisez l’accès.

• Application GitHub personnalisée (installation) : utilisez une clé privée générée à partir de votre application GitHub. Entrez l’ID client et organization nom, puis chargez la clé privée.

Pour plus d’informations sur la création d’une application GitHub, consultez Utiliser une application GitHub personnalisée pour l’authentification.

Déploiement

Pour effectuer un déploiement sur un public limité, choisissez le bouton bascule en regard de Déploiement sur une audience limitée et spécifiez les utilisateurs et les groupes sur lesquels déployer le connecteur. Pour plus d’informations, consultez Déploiement intermédiaire pour les connecteurs Copilot.

Choisissez Créer pour déployer la connexion. Le connecteur Copilot des demandes de tirage cloud GitHub démarre immédiatement l’indexation du contenu.

Le tableau suivant répertorie les valeurs par défaut qui sont définies.

Pour personnaliser ces valeurs, choisissez Configuration personnalisée. Pour plus d’informations, consultez Personnaliser les paramètres.

Après avoir créé votre connexion, vous pouvez consulter les status dans la section Connecteurs du Centre d’administration Microsoft 365.

Personnaliser les paramètres (facultatif)

Vous pouvez personnaliser les valeurs par défaut pour les paramètres du connecteur GitHub Cloud Pull Requests. Pour personnaliser les paramètres, dans la page du connecteur dans le Centre d’administration, choisissez Configuration personnalisée.

Personnaliser les paramètres utilisateur

Autorisations d’accès

Choisissez si les données indexées sont visibles pour :

• Seules les personnes ayant accès à cette source de données (par défaut)
• Tout le monde

Si vous choisissez Uniquement les personnes ayant accès à cette source de données, les données indexées apparaissent dans les résultats de la recherche pour les utilisateurs qui y ont accès. Si vous choisissez Tout le monde, les données indexées apparaissent dans les résultats de la recherche pour tous les utilisateurs.

Mappage des identités

Pour garantir l’application correcte des autorisations, mappez les identités des utilisateurs GitHub à Microsoft Entra ID. Les options sont les suivantes :

• Email : mappe l’e-mail GitHub à Microsoft Entra ID propriétés de l’utilisateur.
• Connectez-vous: Mappe les connexions GitHub avec Microsoft Entra ID propriétés utilisateur.
• Nom: Mappe le nom GitHub avec Microsoft Entra ID propriétés utilisateur.

Si le mappage direct échoue, utilisez des expressions régulières (expression régulière) pour transformer les données. Par exemple : [a-zA-Z0-9]+

Si l’administrateur organization définit des autorisations de membre par défaut pour restreindre l’accès au dépôt, le connecteur respecte ce paramètre. Les utilisateurs ne peuvent pas afficher organization dépôts, sauf s’ils sont explicitement ajoutés en tant que collaborateurs.

Pour les entreprises qui utilisent le modèle BYOK (Bring Your Own Key) au lieu des utilisateurs gérés par l’entreprise (EMU), chaque utilisateur doit activer l’autorisation de partager le champ d’identité requis dans ses paramètres de compte GitHub. Cette étape garantit un mappage d’identité correct entre GitHub et le répertoire de votre organization.

Personnaliser les paramètres de contenu

Sous l’onglet Contenu , vous pouvez vérifier les mappages de propriétés dans les exemples de données pour les métadonnées telles que le contenu, les étiquettes, la description et les horodatages.

Filtre d’intervalle de temps

Vous pouvez configurer un filtre d’intervalle de temps. Le paramètre par défaut est 365 jours.

Gérer les propriétés

Vous pouvez ajouter ou supprimer des propriétés, attribuer des attributs de schéma et définir des étiquettes sémantiques. Les propriétés suivantes sont indexées par défaut.

Personnaliser les intervalles de synchronisation

L’intervalle d’actualisation détermine la fréquence à laquelle vos données sont synchronisées. Vous pouvez personnaliser les valeurs par défaut suivantes :

• Analyse incrémentielle : toutes les 15 minutes
• Analyse complète : tous les jours

Pour plus d’informations, consultez Recommandations pour les paramètres de synchronisation.

Contenu connexe

• Vue d’ensemble du connecteur GitHub Cloud Pull Requests
• Résoudre les problèmes liés au connecteur GitHub Cloud Pull Requests
• Configurer des connecteurs Copilot dans le Centre d’administration Microsoft 365