Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Le connecteur Guru Microsoft 365 Copilot intègre le contenu Guru dans Microsoft 365, ce qui permet à Copilot, Copilot Search et Microsoft Search de faire apparaître les cartes Guru pertinentes directement dans des applications telles que Teams, Outlook et SharePoint. Cet article décrit les étapes de déploiement et de personnalisation du connecteur Guru.
Configuration requise
Avant de déployer le connecteur Guru, vérifiez que vous remplissez les conditions préalables suivantes :
- Vous devez être l’administrateur de recherche du locataire Microsoft 365 de votre organization.
- Compte d’instance Guru Administration : pour vous connecter à votre instance Guru et autoriser le connecteur Guru Microsoft 365 Copilot à mettre à jour régulièrement les cartes Guru, vous avez besoin d’un compte d’utilisateur administrateur de votre instance Guru avec l’autorisation de créer un jeton utilisateur. Pour plus d’informations , cliquez ici.
Déployer le connecteur
Pour ajouter le connecteur Guru pour votre organization :
- Dans le Centre d’administration Microsoft 365, dans le volet gauche, choisissezConnecteursCopilot>.
- Accédez à l’onglet Connecteurs , puis dans le volet gauche, choisissez Galerie.
- Dans la liste des connecteurs disponibles, choisissez Guru.
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 Guru 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 copilote du contenu du connecteur.
Définir instance URL
Fournissez l’URL de votre instance Guru. La structure classique est https://app.getguru.com/ suivie de l’identificateur de instance de votre organization.
Choisir le type d’authentification
Le connecteur Guru prend en charge l’authentification de base à l’aide d’un jeton utilisateur. Nous vous recommandons d’utiliser un compte d’administrateur Guru pour générer le jeton utilisateur. Pour plus d’informations, consultez la documentation de l’API Guru.
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 Guru Copilot commence immédiatement à indexer le contenu.
Le tableau suivant répertorie les valeurs par défaut qui sont définies.
| Catégorie | Valeur par défaut |
|---|---|
| Utilisateurs | Seules les personnes ayant accès à cette source de données. |
| Utilisateurs | Identités de source de données mappées à l’aide d’ID de Microsoft Entra. |
| Contenu | Toutes les cartes, à l’exception des cartes dans l’espace personnel. |
| Contenu | Pour case activée propriétés par défaut et leur schéma, consultez Gérer les propriétés. |
| Synchronisation | Analyse incrémentielle : toutes les 15 minutes. |
| Synchronisation | Analyse complète : tous les jours. |
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 Guru. 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
Le connecteur Guru prend en charge deux options pour les autorisations d’accès :
- Tout le monde : les données indexées apparaissent dans les résultats de la recherche pour tous les utilisateurs.
- Seules les personnes ayant accès à cette source de données (par défaut) : seuls les utilisateurs disposant d’un accès dans Guru peuvent voir le contenu.
Si vous choisissez Uniquement les personnes ayant accès à cette source de données, vous devez choisir si votre instance Guru a Microsoft Entra ID utilisateurs provisionnés ou des utilisateurs non-Entra ID :
- Choisissez l’option Microsoft Entra ID si l’ID d’e-mail des utilisateurs Guru est identique au nom d’utilisateur principal (UPN) des utilisateurs dans Microsoft Entra ID.
- Choisissez l’option ID non-Entra si l’ID d’e-mail des utilisateurs Guru est différent de l’UPN des utilisateurs dans Entra ID.
Si vous choisissez Microsoft Entra ID comme source d’identité, le connecteur mappe les ID d’e-mail utilisateur de Guru à la propriété UPN dans Microsoft Entra ID. Si vous choisissez un ID non-Entra comme source d’identité, fournissez une expression régulière pour mapper l’ID d’e-mail à l’UPN. Pour plus d’informations, consultez Mapper vos identités d’ID non Entra.
Remarque
Mises à jour aux utilisateurs ou aux groupes qui régissent les autorisations d’accès sont synchronisés uniquement dans des analyses complètes. Les analyses incrémentielles ne prennent actuellement pas en charge le traitement des mises à jour des autorisations.
Personnaliser les paramètres de contenu
Vous pouvez personnaliser les données incluses et exclues et personnaliser les propriétés du connecteur par défaut.
Filtres d’ingestion de contenu
Vous pouvez choisir les données que vous souhaitez indexer. Utilisez le langage de requête GQL (GQL) pour filtrer vos données avant qu’elles ne sont indexées, ce qui vous permet de contrôler les données pouvant faire l’objet d’une recherche. Par exemple, vous pouvez utiliser le filtre GQL pour indexer le contenu modifié après un certain temps à l’aide lastModified > 2016-01-01T00:00:00.000-00:00de .
Pour plus d’informations, consultez Langage de requête Guru.
Utilisez le bouton d’aperçu des résultats pour vérifier les exemples de valeurs des propriétés et filtres sélectionnés.
Gérer les propriétés
Vous pouvez case activée les propriétés disponibles à partir de votre instance Guru. Affectez un schéma à la propriété (définissez si une propriété peut faire l’objet d’une recherche, s’il est interrogeable, récupérable ou refinable), modifiez l’étiquette sémantique et ajoutez un alias à la propriété. Le tableau suivant répertorie les propriétés indexées par défaut par le connecteur.
| Propriété par défaut | Étiquette sémantique | Description | Schéma |
|---|---|---|---|
| Titre | title | Titre du carte | Interroger, Rechercher, Récupérer |
| Liens | URL | URL de l’élément | Récupérer |
| CreatedTime | createdDateTime | Date/heure de création du carte | Requête, récupération |
| ModifiedTime | lastModifiedDateTime | Date/heure de la dernière mise à jour du carte | Interroger, récupérer, affiner |
| Propriétaire | createdBy | Propriétaire du carte | Interroger, Rechercher, Récupérer |
| LastModifiedBy | lastModifiedBy | Nom de la personne qui a modifié la dernière carte | Interroger, Rechercher, Récupérer |
| Collection | containerName | Nom de la collection à laquelle appartient le carte | Interroger, Rechercher, Récupérer |
| CollectionUrl | containerUrl | URL de la collection à laquelle appartient le carte | Récupérer |
| Contenu | contenu | Contenu HTML rendu de la page | Requête, Recherche |
Personnaliser les intervalles de 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 du connecteur Guru. Les connecteurs Copilot utilisent deux types d’intervalles d’actualisation :
- Analyse complète : la valeur par défaut est tous les jours.
- Analyse incrémentielle : la valeur par défaut est toutes les 15 minutes.
Vous pouvez modifier les valeurs par défaut des intervalles d’actualisation. Pour plus d’informations, consultez Recommandations pour les paramètres de synchronisation.