Vue d’ensemble du Kit de développement logiciel (SDK) des connecteurs Microsoft Graph

  • Article

Le Kit de développement logiciel (SDK) de connecteurs Microsoft Graph simplifie le processus de création de connecteurs de haute qualité, efficaces et résilients pour une source de données qui n’a pas de connecteur prédéfini, mais que vous souhaitez indexer dans Microsoft Graph.

Le Kit de développement logiciel (SDK) inclut les composants d’infrastructure et de contrat pour vous aider à écrire le code et les outils permettant de tester votre code.

Le Kit de développement logiciel (SDK) connecteurs vous permet de créer des connecteurs Microsoft Graph personnalisés directement dans l’environnement de développement intégré (IDE) Visual Studio. Il fournit tout ce dont vous avez besoin pour générer, déboguer et déployer votre connecteur personnalisé.

Les éléments ingérés par le biais de connexions créées avec le Kit de développement logiciel (SDK) consomment votre quota d’éléments. Pour en savoir plus sur la façon de déterminer le quota d’éléments dont vous disposez et comment acheter davantage de quota, consultez Exigences de licence et tarification.

Composants

Le Kit de développement logiciel (SDK) de connecteurs comprend les composants suivants :

  • Modèle de connecteur personnalisé : si vous souhaitez développer votre connecteur personnalisé en C#, vous pouvez télécharger le modèle à partir de Visual Studio Marketplace et commencer rapidement. Vous pouvez également choisir de développer votre connecteur personnalisé dans l’une des langues de cette liste.

  • Contrats : les contrats sont des fichiers de mémoire tampon de protocole gRPC qui contiennent les contrats d’interaction entre la plateforme Microsoft (agent de connecteur Microsoft Graph) et votre code de connecteur personnalisé.

  • Agent de connecteur Microsoft Graph : composant logiciel léger qui gère les fonctionnalités du connecteur et les coordonnées entre le Centre d'administration Microsoft 365 et votre code de connecteur personnalisé.

    Téléchargez la dernière version de l’agent de connecteur et exécutez la configuration d’installation assistant. Pour plus d’informations, consultez Agent de connecteur Microsoft Graph.

  • Utilitaire de test du Kit de développement logiciel (SDK) Connecteurs : inclut des scénarios de test prédéfinis que vous pouvez utiliser pour tester votre code de connecteur personnalisé et communiquer avec la plateforme de l’agent de connecteur.

Fonctionnalités de l’agent de connecteur Microsoft Graph

L’agent de connecteur repose sur la même plateforme de connecteur robuste que celle utilisée pour exécuter les connecteurs microsoft intégrés.

Il inclut les fonctionnalités suivantes :

  • Obtenir des données à partir du connecteur : l’agent peut se connecter à votre connecteur personnalisé pour obtenir des données à partir de la source à l’aide de la logique implémentée par votre connecteur.

  • intégration Centre d'administration Microsoft 365 : l’agent vous permet de configurer, de gérer et de surveiller vos connecteurs personnalisés via le Centre d'administration Microsoft 365.

  • Planification et gestion des analyses : l’agent est capable d’analyser la source de données via des analyses complètes et incrémentielles. Les analyses complètes (basées sur une liste ou Sur Microsoft Graph) parcourent régulièrement l’intégralité de vos données à un intervalle que vous avez défini. Les analyses incrémentielles sont plus fréquentes et analysent la source de données à partir de l’horodatage/point de contrôle précédent à un intervalle que vous avez défini.

  • Détection de suppression, de différence et de cycle : l’agent est capable de détecter les éléments supprimés de votre source de données en fonction des éléments envoyés par votre connecteur lors d’analyses complètes périodiques. L’agent se charge ensuite également de supprimer l’élément de l’index Microsoft.

    L’agent détecte également les éléments qui ont changé depuis la dernière analyse en calculant un hachage de l’élément et en le comparant au hachage de l’élément vu précédemment. Pour accélérer les analyses, l’agent envoie les données à indexer uniquement lorsque l’élément change.

    L’agent détecte également les éléments en double qui proviennent de sources de données qui ont des éléments liés (comme des sites web) et ignore l’analyse de ces éléments.

  • Mappage d’identité : l’agent de connecteur active l’horodatage de Access Control Listes (ACL) sur vos données pour activer le découpage de sécurité. Vous pouvez activer le découpage de sécurité en fonction des Microsoft Entra ID ou des listes de contrôle d’accès de votre source de données.

  • Ingestion Microsoft Graph : l’agent ingère les données dans Microsoft Graph après les avoir reçues de votre connecteur personnalisé.

Remarque

Les fonctionnalités suivantes ne sont actuellement pas disponibles :

  • Traversée de la source de données basée sur des graphiques pendant les analyses ; par exemple, parcourir des structures de dossiers.
  • Possibilité de gérer les autorisations de recherche en fonction du contrôle d’accès à partir de votre source de données.

Vous pouvez commencer en C# avec nos exemples de connecteurs ou dans d’autres langages pris en charge à l’aide des contrats de la page du Kit de développement logiciel (SDK) des connecteurs Microsoft Graph dans GitHub.

Étapes suivantes