Partager via

Connecteur Salesforce Knowledge Copilot

Le connecteur Salesforce Knowledge Copilot permet à votre organization d’indexer des articles de Salesforce Knowledge. Après avoir configuré le connecteur, les utilisateurs finaux peuvent rechercher des articles de connaissances à partir de Salesforce dans Microsoft Copilot et à partir de n’importe quel client Recherche Microsoft.

Cette documentation est destinée aux administrateurs Microsoft 365 ou à toute personne qui configure, exécute et surveille un connecteur Salesforce Knowledge Copilot.

Fonctionnalités

  • Indexer les articles Salesforce Knowledge.
  • Permettre aux utilisateurs au sein de l’entreprise de poser des questions en langage naturel à l’aide de Copilot et de recevoir des réponses basées sur des articles dans Salesforce. Exemples :
    • Quelles sont les étapes à suivre pour traiter un remboursement ?
    • Quelle est la procédure d’escalade pour les cas prioritaires ?
    • Quelles sont les dernières mises à jour de notre politique de garantie produit ?
  • 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 Salesforce Knowledge prend actuellement en charge les autorisations basées uniquement sur l’accès à l’entité de connaissances. Il ne prend pas en charge les autorisations basées sur les catégories de données, la sécurité au niveau du champ (FLS) ou les règles de partage.
  • Prend uniquement en charge les articles et les éléments écrits en anglais.
  • Seuls les éléments publiés sont indexés.

Conditions préalables

Remarque

Assurez-vous que le compte Salesforce utilisé pour se connecter au connecteur Salesforce Knowledge Copilot est identique au compte déjà connecté à Salesforce.

Autorisations Salesforce requises

Pour configurer le connecteur Salesforce Knowledge, les autorisations suivantes sont requises :

  • API activée
  • Afficher l’installation et la configuration
  • Autoriser l’affichage des connaissances
  • Accès en lecture pour l’entité Knowledge

Obtenir les informations d’identification salesforce Knowledge Connector

Pour vous connecter à votre instance Salesforce, vous avez besoin de votre URL de instance Salesforce, de l’ID client et de la clé secrète client pour l’authentification OAuth 2.0. Les étapes suivantes expliquent comment vous ou votre administrateur Salesforce pouvez obtenir ces informations à partir de votre compte Salesforce :

  • Connectez-vous à votre instance Salesforce et accédez à Configuration.

  • Accédez à Applications -> Gestionnaire d’applications.

  • Sélectionnez Nouvelle application connectée.

  • Cliquez sur Créer une application cliente externe.

  • Complétez la section API comme suit :

    • Cochez la case Activer les paramètres Oauth.
    • Spécifiez l’URL de rappel comme suit : Pour M365 Entreprise : https://gcs.office.com/v1.0/admin/oauth/callback, pour M365 Government : https://gcsgcc.office.com/v1.0/admin/oauth/callback
    • Sélectionnez les étendues OAuth requises.
      • Accéder à vos données (API) et les gérer.
      • Effectuez des demandes en votre nom à tout moment (refresh_token, offline_access).
    • Cochez la case Exiger un secret pour le flux de serveur web.
    • Enregistrez l’application.

      Capture d’écran montrant la section API dans Salesforce instance une fois que l’administrateur a entré toutes les configurations requises répertoriées ci-dessus.

  • Copiez la clé du consommateur et la clé secrète du consommateur. Ces informations sont utilisées comme ID client et clé secrète client lorsque vous configurez les paramètres de connexion pour votre connecteur Salesforce Knowledge Copilot dans le portail d’administration Microsoft 365.

    Capture d’écran montrant les résultats retournés par la section API dans Salesforce instance une fois que l’administrateur a envoyé toutes les configurations requises. La clé de consommateur se trouve en haut de la colonne de gauche et la clé secrète du consommateur se trouve en haut de la colonne de droite.

  • Avant de fermer votre instance Salesforce, procédez comme suit pour vous assurer que les jetons d’actualisation n’expirent pas :

    • Accédez à Applications -> Gestionnaire d’applications.
    • Recherchez l’application que vous avez créée et sélectionnez la liste déroulante à droite. Sélectionnez Gérer.
    • Sélectionnez Modifier les stratégies.
    • Pour la stratégie de jeton d’actualisation, sélectionnez Le jeton d’actualisation est valide jusqu’à ce qu’il soit révoqué.

      Capture d’écran montrant la sélection de la stratégie de jeton d’actualisation nommée « Le jeton d’actualisation est valide jusqu’à ce qu’il soit révoqué ».

Vous pouvez maintenant utiliser le centre Administration Microsoft 365 pour terminer le reste du processus de configuration de votre connecteur Salesforce Knowledge Copilot.

Prise en main

1. 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.

2. URL salesforce knowledge

Utilisez l’URL de l’instance de connaissances Salesforce de votre organization. Cette URL est l’adresse web spécifique utilisée pour accéder aux services d’API Salesforce Knowledge et interagir avec ceux-ci pour la récupération des données, ce qui ressemble généralement à https://[COMPANY_NAME].my.salesforce.com

3. Type d’authentification

Pour le connecteur Salesforce Knowledge Copilot, utilisez OAuth 2.0 pour l’authentification.

Pour vous authentifier, entrez l’ID client et la clé secrète client. L’ID client est un identificateur unique affecté à votre application pour effectuer des demandes à l’API Salesforce Knowledge. La clé secrète client est une clé confidentielle utilisée avec l’ID client pour authentifier votre application en toute sécurité avec l’API Salesforce Knowledge.

La première fois que vous avez tenté de vous connecter avec ces paramètres, vous obtenez une fenêtre contextuelle vous demandant de vous connecter à Salesforce avec votre nom d’utilisateur et votre mot de passe d’administrateur.

Remarque

  • Si la fenêtre contextuelle n’apparaît pas, elle peut être bloquée dans votre navigateur. Vous devez donc autoriser les fenêtres contextuelles et les redirections.
  • Vérifiez que le compte Salesforce utilisé pour se connecter au connecteur Graph est identique à celui de l’utilisateur déjà connecté à Salesforce.
  • Vérifiez que l’utilisateur qui se connecte dispose de toutes les autorisations d’objet nécessaires pour l’organization.

4. Déployer pour 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 Salesforce Knowledge. Vous pouvez cliquer sur le bouton « Créer » pour publier votre connexion et indexer les publications à partir de votre compte Salesforce Knowledge.

Pour d’autres paramètres, tels que les autorisations d’accès, lesrègles d’inclusion des données, le schéma, la fréquence d’analyse, les valeurs par défaut sont préconfigurées et optimisées pour les données Salesforce Knowledge. Vous trouverez les valeurs par défaut répertoriées ci-dessous :

Utilisateurs Description
Autorisations d’accès Uniquement les personnes ayant accès au contenu dans la source de données.
Mapper des identités Identités de source de données mappées à l’aide d’ID de Microsoft Entra.
Contenu Description
Gérer les propriétés Pour case activée propriétés par défaut et leur schéma, consultez le contenu.
Synchronisation Description
Analyse incrémentielle Fréquence : toutes les 15 minutes
Analyse complète Fréquence : Tous les jours

Pour modifier l’une de ces valeurs, sélectionnez l’option 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. Une fois que vous avez cliqué sur l’option « Configuration personnalisée », trois autres onglets s’affichent : Utilisateurs, Contenu et Synchronisation.

Utilisateurs

Autorisations d’accès

Le connecteur Salesforce Knowledge prend en charge les autorisations de recherche visibles pour tout le monde ou uniquement 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. Choisissez celle qui convient le mieux à votre organization.

Mappage des identités

Vous pouvez choisir d’ingérer des listes de Access Control (ACL) à partir de votre instance Salesforce ou d’autoriser tous les membres de votre organization à voir les résultats de la recherche à partir de cette source de données. Les listes de contrôle d’accès peuvent inclure des identités Microsoft Entra (utilisateurs fédérés de Microsoft Entra ID vers Salesforce), des identités AD non Azure (utilisateurs Salesforce natifs qui ont des identités correspondantes dans Microsoft Entra ID) ou les deux.

Remarque

Si vous utilisez un fournisseur d’identité tiers comme Ping ID ou secureAuth, vous devez sélectionner « non Microsoft Entra » comme type d’identité.

Si vous avez choisi d’ingérer une liste de contrôle d’accès à partir de votre instance Salesforce et que vous avez sélectionné « ID non-ME » pour le type d’identité, consultez Mapper vos identités non Microsoft Entra pour obtenir des instructions sur le mappage des identités.

Si vous avez choisi d’ingérer une liste de contrôle d’accès à partir de votre instance Salesforce et que vous avez sélectionné « ME-ID » pour le type d’identité, consultez Mapper vos identités Microsoft Entra pour obtenir des instructions sur le mappage des identités. Pour savoir comment configurer Microsoft Entra’authentification unique pour Salesforce, consultez ce tutoriel.

Remarque

Mises à jour aux groupes qui régissent les autorisations d’accès sont synchronisées uniquement dans des analyses complètes. Les analyses incrémentielles ne prennent pas en charge le traitement des mises à jour des autorisations.

Dans la vidéo suivante, vous allez apprendre à vous authentifier auprès de votre instance Salesforce, à synchroniser vos identités non Microsoft Entra avec vos identités Microsoft Entra et à appliquer les paramètres de sécurité appropriés à vos éléments Salesforce. Bien que ce guide concerne spécifiquement le connecteur Salesforce CRM, les mêmes étapes peuvent être appliquées au connecteur Salesforce Knowledge.

Contenu

Gérer les propriétés

Ici, vous pouvez ajouter ou supprimer des propriétés disponibles à partir de votre source de données Salesforce Knowledge, 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 :

Source, propriété Étiquette sémantique Description Schéma
Articleid Requête, récupération
Numéro d’article Numéro unique attribué automatiquement à l’article lors de sa création. Requête, récupération
ArticleType Type ou catégorie de l’article de connaissances (par exemple, FAQ, Article de support, Guide pratique). Récupérer
CondensedBody Inclut le contenu complet ou le corps principal de l’article Récupérer, rechercher
CreatedById Interroger, Récupérer, Rechercher
CreatedByName createdBy Utilisateur qui a initialement créé l’article. Interroger, Récupérer, Rechercher
CreatedDate createdDateTime Horodatage de la création initiale de l’article. Requête, récupération
IconUrl iconUrl Récupérer
Langue Langue dans laquelle l’article est écrit. Récupérer
LastModifiedById Interroger, Récupérer, Rechercher
LastModifiedByName lastModifiedBy Utilisateur qui a mis à jour l’article en dernier. Interroger, Récupérer, Rechercher
LastModifiedDate lastModifiedDateTime Horodatage de la mise à jour la plus récente de l’article. Requête, récupération
LastPublishedDate Date de la dernière publication de l’article. Requête, récupération
LastPublishedVersionId Requête, récupération
Résumé Brève vue d’ensemble ou résumé du contenu de l’article. Recherche
Titre title Titre principal ou titre de l’article. Interroger, Récupérer, Rechercher
Url url Lien vers l’article dans Salesforce Knowledge. Récupérer
UrlName Nom unique convivial d’URL généré pour l’article. Requête, récupération

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 Salesforce Knowledge Copilot. 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.

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.

Recherche d’éléments dans l’Explorateur d’index

Si vous souhaitez examiner un article de connaissances spécifique dans l’Explorateur d’index, vous aurez d’abord besoin de son KnowledgeArticleId (l’ID master qui lie toutes les versions de l’article). Voici comment l’obtenir à partir de Salesforce :

  1. Obtenez l’ID de version de l’article à partir de l’URL : Ouvrez l’article dans Salesforce. Copiez l’ID à partir de l’URL. Par exemple : /lightning/r/Knowledge__kav/kav1234567890ABC/view. kav1234567890ABC Voici l’ID.
  2. Ouvrir la console du développeur
  3. Exécutez la requête SOQL : accédez à l’onglet Éditeur de requête et exécutez la requête suivante (remplacez par votre ID). 
    SELECT Id, KnowledgeArticleId, Title 
FROM KnowledgeArticleVersion 
WHERE Id = '<<KNOWLEDGE_URL_ID>>'
  4. Dans les résultats, copiez le KnowledgeArticleId
  5. Entrez ceci KnowledgeArticleId dans l’Explorateur d’index pour afficher toutes les données indexées associées.

Si vous rencontrez des problèmes ou si vous souhaitez fournir des commentaires, consultez prise en charge de Microsoft Graph.

  • Last updated on