Azure Connecteur Microsoft 365 Copilot Wiki DevOps

Le connecteur Azure de Microsoft 365 Copilot Wiki DevOps permet à votre organization d’indexer des wikis dans son instance du service Azure DevOps. Après avoir configuré le connecteur, les utilisateurs finaux peuvent rechercher des wikis de projet et des wikis de code à partir de Azure DevOps dans Recherche et Microsoft 365 Copilot Microsoft.

Cet article est destiné aux administrateurs Microsoft 365 ou à toute personne qui configure, exécute et surveille un connecteur Azure Wiki DevOps Copilot.

Fonctionnalités

• Indexer des wikis à partir de Azure DevOps
• Permettre à vos utilisateurs finaux de poser des questions relatives aux wikis de projet et aux wikis de code.
• Utilisez la recherche sémantique dans Copilot pour permettre aux utilisateurs de trouver du contenu pertinent en fonction des mots clés, des préférences personnelles et des connexions sociales.

Limitations

• Le connecteur indexe uniquement un organization ADO par connexion.

Filtres de données personnalisés

Le connecteur Wiki Azure DevOps comprend les filtres de données personnalisés suivants pour la recherche Copilot :

• Chemin d’accès à la zone
• Affectée à

Configuration requise

• Vous devez être l’administrateur de recherche du locataire Microsoft 365 de votre organization.

• Pour permettre au connecteur de se connecter à votre organization DevOps Azure, vous devez activer l’accès aux applications tierces via OAuth. Pour plus d’informations, consultez Gérer les stratégies de sécurité pour en savoir plus.

  

• Compte de service : pour vous connecter à Azure DevOps et autoriser le connecteur Azure DevOps Wiki Copilot à mettre à jour régulièrement les wikis, vous avez besoin d’un compte de service avec les autorisations suivantes qui lui sont accordées. Le compte de service est le principal de service publié par Microsoft (pour l’authentification des informations d’identification fédérées) ou le compte d’administrateur Microsoft 365 connecté (pour l’authentification OAuth Microsoft Entra ID), selon la méthode d’authentification sélectionnée.

  Nom de l’autorisation	Type d’autorisation	Requis pour
  Afficher les informations au niveau du projet	Autorisation de projet	Analyse Azure Wiki DevOps. Cette autorisation est obligatoire pour les projets qui doivent être indexés.

Prise en main

Choisir un nom d’affichage

Un nom d’affichage est utilisé pour identifier chaque citation dans Copilot, ce qui permet aux utilisateurs de reconnaître facilement le fichier ou l’élément associé. Le nom d’affichage indique également le contenu approuvé. Le nom d’affichage est également utilisé comme filtre de source de contenu. Une valeur par défaut est présente pour ce champ, mais vous pouvez la personnaliser avec un nom que les utilisateurs de votre organization reconnaître.

Fournir le type d’authentification

Pour authentifier et synchroniser des wikis à partir de Azure DevOps, choisissez l’une des deux méthodes prises en charge :

• Informations d’identification fédérées (recommandé) : utilise un principal de service Microsoft Entra publié par Microsoft comme compte de service d’analyse. Les autorisations accordées à ce principal de service dans Azure DevOps déterminent ce que le connecteur peut indexer.
• Microsoft Entra ID OAuth : utilise OAuth délégué où le compte d’administrateur Microsoft 365 connecté fait office de compte de service d’analyse. Dans ce cas, les autorisations DevOps Azure affectées à ce compte administrateur déterminent ce que le connecteur peut indexer.

Informations d’identification fédérées (recommandé)

Les informations d’identification fédérées utilisent une application d’entreprise publiée par Microsoft comme compte de service d’analyse. Vous devez accorder à ce principal de service les autorisations nécessaires dans Azure DevOps.

Vérifier que l’application de principal de service est provisionnée

1. Accédez au centre d’administration Microsoft Entra.
2. Recherchez Application d’informations d’identification fédérées du connecteur Graph ou utilisez l’ID d’application : 933838e2-bec1-440f-a634-9363c82e5b6d.
3. Si l’application n’est pas provisionnée, ouvrez la page des connecteurs Copilot dans le Centre d’administration Microsoft 365. L’approvisionnement peut prendre plusieurs heures.

Accorder à l’application Microsoft Entra l’accès à Azure projets DevOps

Accordez au principal de service l’accès aux projets DevOps Azure que vous souhaitez indexer.

1. Accédez à Azure DevOps et sélectionnez le organization.
2. Sélectionnez Paramètres de l’organisation.
3. Dans le volet gauche, sous Général, sélectionnez Utilisateurs.
4. Sélectionnez Ajouter des utilisateurs.
5. Dans Utilisateurs ou principaux de service, entrez l’ID d’application : 933838e2-bec1-440f-a634-9363c82e5b6d.
6. Affectez le niveau d’accès De base , sélectionnez les projets à indexer et ajoutez l’application au groupe Lecteurs du projet (ou à un groupe équivalent). Désactivez l’option d’envoi d’une invitation par e-mail.

Configurer l’authentification des informations d’identification fédérées

Sélectionnez Informations d’identification fédérées comme type d’authentification et authentifiez-vous lorsque vous y êtes invité.

Microsoft Entra ID OAuth

Vérifiez que votre organization ADO est connecté à Microsoft Entra

Le connecteur Copilot wiki Azure DevOps indexe uniquement le contenu d’un organization ADO connecté à Microsoft Entra de votre locataire. Pour vous assurer que votre organization ADO est connecté à Microsoft Entra compte, procédez comme suit.

1. Accédez à Azure DevOps et sélectionnez la organization requise.
2. Sélectionnez Organization settings.
3. Dans le volet de navigation gauche, sélectionnez Microsoft Entra sous l’en-tête « Général ».
4. Vérifiez que le organization est connecté au compte Microsoft Entra de votre locataire.

Créer une inscription d’application Microsoft Entra ID

1. Accédez au Portail Azure et connectez-vous avec les informations d’identification d’administrateur du locataire.
2. Accédez à Microsoft Entra ID ->Gérer ->inscriptions d'applications dans le volet de navigation, puis sélectionnez Nouvelle inscription.
3. Fournissez un nom pour l’application, puis sélectionnez Inscrire.
4. Notez l’ID d’application (client). Cet ID est utilisé pour accorder à l’application Microsoft Entra l’accès aux projets dans le organization ADO.
5. Ouvrez autorisations d’API dans le volet de navigation et sélectionnez Ajouter une autorisation.
6. Sélectionnez Azure DevOps, puis Autorisations déléguées.
7. Recherchez les autorisations suivantes, puis sélectionnez Ajouter des autorisations.
   a. Identité (lecture)
   b. Code (lecture)
   c. Droits d’utilisation (lecture)
   d. Projet et équipe (lecture)
   e. Graphe (lecture)
   f. MemberEntitlement Management (lecture)
   g. Wiki (lecture)
8. Sélectionnez Accorder le consentement administrateur pour [TenantName] et confirmez en sélectionnant Oui.
9. Vérifiez que les autorisations sont dans l’état « Accordé ».
10. Ouvrez Authentification à partir du volet de navigation. Sélectionnez Add a platform et choisissez Web. Ajoutez l’un des URI suivants sous « URI de redirection » :
    • Pour M365 Enterprise : https://gcs.office.com/v1.0/admin/oauth/callback
    • Pour le gouvernement M365 : https://gcsgcc.office.com/v1.0/admin/oauth/callback
11. Sous Octroi implicite et flux hybrides, case activée l’option pour ID tokens (used for implicit and hybrid flows) et cliquez sur Configurer.
12. Dans le volet de navigation, sélectionnez Certificats et secrets sous Gérer.
13. Sélectionnez Nouvelle clé secrète client , puis sélectionnez une période d’expiration pour le secret. Copiez le secret généré (Valeur) et enregistrez-le, car il n’est plus affiché.
14. Utilisez cette clé secrète client et l’ID d’application pour configurer le connecteur.

Accorder à l’application Microsoft Entra l’accès aux projets dans le organization ADO

Vous devez fournir à l’application Microsoft Entra l’accès nécessaire aux projets qui doivent être indexés en procédant comme suit :

1. Accédez à Azure DevOps et sélectionnez la organization requise.
2. Sélectionnez Organization settings.
3. Dans le volet de navigation gauche, sélectionnez Users sous l’en-tête « Général ».
4. Sélectionnez Add users.
5. Copiez l’ID d’application (client) obtenu à partir de l’application dans « Utilisateurs ou principaux de service ».
6. Accordez le Basic niveau d’accès et sélectionnez les projets pour autoriser l’accès à l’index. Ajoutez également au Project Reader Azure groupe DevOps (ou équivalent) pour garantir l’accès. Désélectionnez l’option permettant d’envoyer une invitation par e-mail aux utilisateurs.

Sélectionner organization

Indiquez votre nom de organization DevOps Azure. Le nom organization Azure DevOps est le segment après https://dev.azure.com/. Par exemple :

• URL :https://dev.azure.com/contoso
• Organisation: contoso

Seul le nom organization est requis. Ne fournissez pas l’URL complète.

Déployer sur un public limité

Déployez cette connexion sur une base d’utilisateurs limitée si vous souhaitez la valider dans Copilot et d’autres surfaces de recherche avant d’étendre le déploiement à un public plus large. Pour en savoir plus sur le déploiement limité, consultez Déploiement intermédiaire.

À ce stade, vous êtes prêt à créer la connexion pour Azure wikis DevOps. Vous pouvez cliquer sur Créer pour publier votre connexion et indexer des wikis à partir de votre Azure DevOps organization.

Pour les autres paramètres, tels que les autorisations d’accès, lesrègles d’inclusion de données, le schéma, la fréquence d’analyse, etc., nous avons des valeurs par défaut basées sur ce qui fonctionne le mieux avec les données ADO. Vous pouvez voir les valeurs par défaut ci-dessous :

Si vous souhaitez modifier l’une de ces valeurs, vous devez choisir la « Configuration personnalisée »

Configuration personnalisée

L’installation personnalisée est destinée aux administrateurs qui souhaitent modifier les valeurs par défaut des paramètres répertoriés dans le tableau ci-dessus. Une fois que vous avez cliqué sur l’option « Configuration personnalisée », trois onglets supplémentaires s’affichent : Utilisateurs, Contenu et Synchronisation.

Utilisateurs

Autorisations d’accès

Le connecteur Copilot Azure Wiki DevOps prend en charge les autorisations de recherche visibles pour tout le monde ou uniquement pour les personnes ayant accès à cette source de données. Si vous choisissez Tout le monde, les données indexées apparaissent dans les résultats de la recherche pour tous les utilisateurs. 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.

Contenu

Choisir des projets

Dans cette étape, vous spécifiez l’étendue des données que vous souhaitez indexer à l’aide du connecteur Copilot Azure Wiki DevOps. Vous pouvez ensuite choisir que la connexion indexe l’intégralité du organization ou des projets spécifiques dans le organization sélectionné.

Si vous choisissez d’indexer l’intégralité de la organization, les wikis de tous les projets du organization sont indexés. Les nouveaux projets et wikis sont indexés lors de l’analyse suivante après leur création.

Si vous choisissez d’indexer des projets individuels, seuls les wikis des projets sélectionnés sont indexés.

Gérer les propriétés

Ici, vous pouvez ajouter ou supprimer des propriétés disponibles de votre source de données Azure DevOps, affecter un schéma à la propriété (définir si une propriété peut faire l’objet d’une recherche, s’il est interrogeable, récupérable ou refinable), modifier l’étiquette sémantique et ajouter un alias à la propriété. Les propriétés sélectionnées par défaut sont répertoriées ci-dessous.

Afficher un aperçu des données

Utilisez le bouton d’aperçu des résultats pour vérifier les exemples de valeurs des propriétés sélectionnées.

Synchronisation

L’intervalle d’actualisation détermine la fréquence à laquelle vos données sont synchronisées entre la source de données et l’index Azure connecteur Copilot Wiki DevOps. Il existe deux types d’intervalles d’actualisation : l’analyse complète et l’analyse incrémentielle. Pour plus d’informations, consultez Paramètres d’actualisation.

Vous pouvez modifier les valeurs par défaut de l’intervalle d’actualisation à partir d’ici si vous le souhaitez.

Page Configurer les résultats de la recherche

Après avoir publié la connexion, vous devez personnaliser la page des résultats de recherche avec les secteurs verticaux et les types de résultats. Pour en savoir plus sur la personnalisation des résultats de recherche, passez en revue la gestion des secteurs verticaux et destypes de résultats.

Vous pouvez également utiliser l’exemple de disposition des résultats pour le connecteur Copilot wiki Azure DevOps. Copiez et collez le json de disposition des résultats pour commencer.

Résolution des problèmes

Après avoir publié votre connexion, vous pouvez consulter les status dans la section Connecteurs du Centre d’administration. Pour savoir comment effectuer des mises à jour et des suppressions, consultez Gérer votre connecteur.

Pour résoudre les problèmes, consultez Résolution des problèmes.