Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Microsoft Teams
Microsoft Teams est un outil de collaboration d'entreprise pour la messagerie, les réunions et le partage de fichiers. Si vous êtes un utilisateur de Microsoft Teams, vous pouvez l'utiliser Amazon Kendra pour indexer votre source de données Microsoft Teams.
Vous pouvez vous connecter Amazon Kendra à votre source de données Microsoft Teams à l'aide de la Amazon Kendra console
Pour résoudre les problèmes liés à votre connecteur de source de données Amazon Kendra Microsoft Teams, consultezDépannage des sources de données.
Fonctionnalités prises en charge
-
Mappages de champs
-
Contrôle d'accès utilisateur
-
Filtres d'inclusion/exclusion
-
Synchronisation complète et incrémentielle du contenu
-
Cloud privé virtuel (VPC)
Prérequis
Avant de pouvoir Amazon Kendra indexer votre source de données Microsoft Teams, apportez ces modifications à vos AWS comptes et à vos équipes Microsoft.
Dans Microsoft Teams, assurez-vous que vous disposez des éléments suivants :
-
Création d'un compte Microsoft Teams dans Office 365.
-
Vous avez noté votre identifiant de client Microsoft 365. Vous pouvez trouver votre ID de locataire dans les propriétés de votre portail Azure Active Directory ou dans votre OAuth application.
-
J'ai configuré une OAuth application sur le portail Azure et noté l'ID du client et le secret du client ou les informations d'identification du client. Consultez le didacticiel Microsoft
et l'exemple d'application enregistrée pour plus d'informations. Note
Lorsque vous créez ou enregistrez une application sur le portail Azure, l'ID secret représente la valeur secrète réelle. Vous devez prendre note ou enregistrer la valeur secrète réelle immédiatement lors de la création du secret et de l'application. Vous pouvez accéder à votre secret en sélectionnant le nom de votre application sur le portail Azure, puis en accédant à l'option de menu sur les certificats et les secrets.
Vous pouvez accéder à votre ID client en sélectionnant le nom de votre application sur le portail Azure, puis en accédant à la page de présentation. L'ID de l'application (client) est l'ID du client.
Note
Nous vous recommandons d'actualiser ou de modifier régulièrement vos informations d'identification et votre code secret. Fournissez uniquement le niveau d'accès nécessaire pour votre propre sécurité. Nous vous déconseillons de réutiliser les informations d'identification et les secrets entre les sources de données et les versions 1.0 et 2.0 du connecteur (le cas échéant).
-
Les autorisations nécessaires ont été ajoutées. Vous pouvez choisir d'ajouter toutes les autorisations ou de limiter la portée en sélectionnant moins d'autorisations en fonction des entités que vous souhaitez explorer. Le tableau suivant répertorie les autorisations au niveau de l'application par entité correspondante :
Entité Autorisations requises pour la synchronisation des données Autorisations requises pour Identity Sync Publication sur la chaîne -
ChannelMessage. Lisez. Tout
-
Grouper. Tout lire
-
Utilisateur.Read
-
Utilisateur.Lisez.Tout
TeamMember. Lisez. Tout Attachement au canal -
ChannelMessage. Lisez. Tout
-
Grouper. Tout lire
-
Utilisateur.Read
-
Utilisateur.Lisez.Tout
TeamMember. Lisez. Tout Wiki de la chaîne -
Grouper. Tout lire
-
Utilisateur.Read
-
Utilisateur.Lisez.Tout
TeamMember. Lisez. Tout Message de chat -
Discuter. Tout lire
-
ChatMessage. Lisez. Tout
-
ChatMember. Lisez. Tout
-
Utilisateur.Read
-
Utilisateur.Lisez.Tout
-
Grouper. Tout lire
TeamMember. Lisez. Tout Chat de réunion -
Discuter. Tout lire
-
ChatMessage.Lire
-
ChatMember. Lisez. Tout
-
Utilisateur.Read
-
Utilisateur.Lisez.Tout
-
Grouper. Tout lire
TeamMember. Lisez. Tout Pièce jointe au chat -
Discuter. Tout lire
-
ChatMessage.Lire
-
ChatMember. Lisez. Tout
-
Utilisateur.Read
-
Utilisateur.Lisez.Tout
-
Grouper. Tout lire
TeamMember. Lisez. Tout Dossier de réunion -
Discuter. Tout lire
-
ChatMessage. Lisez. Tout
-
ChatMember. Lisez. Tout
-
Utilisateur.Read
-
Utilisateur.Lisez.Tout
-
Grouper. Tout lire
-
Fichiers.Lisez.Tout
TeamMember. Lisez. Tout Calendrier des réunions -
Discuter. Tout lire
-
ChatMessage. Lisez. Tout
-
ChatMember. Lisez. Tout
-
Utilisateur.Read
-
Utilisateur.Lisez.Tout
-
Grouper. Tout lire
-
Fichiers.Lisez.Tout
TeamMember. Lisez. Tout Notes de réunion -
Utilisateur.Read
-
Utilisateur.Lisez.Tout
-
Grouper. Tout lire
-
Fichiers.Lisez.Tout
TeamMember. Lisez. Tout -
-
Il est vérifié que chaque document est unique dans Microsoft Teams et dans les autres sources de données que vous prévoyez d'utiliser pour le même index. Chaque source de données que vous souhaitez utiliser pour un index ne doit pas contenir le même document dans toutes les sources de données. IDs Les documents sont globaux par rapport à un index et doivent être uniques par index.
Dans votre Compte AWS, assurez-vous d'avoir :
-
Création d'un Amazon Kendra index et, si vous utilisez l'API, notez l'ID de l'index.
-
Vous avez créé un IAM rôle pour votre source de données et, si vous utilisez l'API, notez l'ARN du IAM rôle.
Note
Si vous modifiez votre type d'authentification et vos informations d'identification, vous devez mettre à jour votre IAM rôle pour accéder au bon identifiant AWS Secrets Manager secret.
-
Stockez vos informations d'authentification Microsoft Teams dans un AWS Secrets Manager secret et, si vous utilisez l'API, notez l'ARN du secret.
Note
Nous vous recommandons d'actualiser ou de modifier régulièrement vos informations d'identification et votre code secret. Fournissez uniquement le niveau d'accès nécessaire pour votre propre sécurité. Nous vous déconseillons de réutiliser les informations d'identification et les secrets entre les sources de données et les versions 1.0 et 2.0 du connecteur (le cas échéant).
Si vous n'avez pas de IAM rôle ou de secret existant, vous pouvez utiliser la console pour créer un nouveau IAM rôle et un nouveau Secrets Manager secret lorsque vous connectez votre source de données Microsoft Teams à Amazon Kendra. Si vous utilisez l'API, vous devez fournir l'ARN d'un IAM rôle et d'un Secrets Manager secret existants, ainsi qu'un identifiant d'index.
Instructions de connexion
Pour vous connecter Amazon Kendra à votre source de données Microsoft Teams, vous devez fournir les informations nécessaires sur votre source de données Microsoft Teams afin de Amazon Kendra pouvoir accéder à vos données. Si vous n'avez pas encore configuré Microsoft Teams pour Amazon Kendra, consultezPrérequis.
Pour vous connecter Amazon Kendra à Microsoft Teams
-
Connectez-vous à la Amazon Kendra console AWS Management Console et ouvrez-la
. -
Dans le volet de navigation de gauche, choisissez Index, puis choisissez l'index que vous souhaitez utiliser dans la liste des index.
Note
Vous pouvez choisir de configurer ou de modifier vos paramètres de contrôle d'accès utilisateur dans les paramètres de l'index.
-
Sur la page de démarrage, choisissez Ajouter une source de données.
-
Sur la page Ajouter une source de données, choisissez le connecteur Microsoft Teams, puis sélectionnez Ajouter un connecteur. Si vous utilisez la version 2 (le cas échéant), choisissez le connecteur Microsoft Teams avec la balise « V2.0 ».
-
Sur la page Spécifier les détails de la source de données, entrez les informations suivantes :
-
Dans Nom et description, pour Nom de la source de données : entrez le nom de votre source de données. Vous pouvez inclure des traits d'union, mais pas des espaces.
-
(Facultatif) Description : entrez une description facultative pour votre source de données.
-
Dans la langue par défaut : choisissez une langue pour filtrer vos documents pour l'index. Sauf indication contraire, la langue par défaut est l'anglais. La langue spécifiée dans les métadonnées du document remplace la langue sélectionnée.
-
Dans Balises, pour Ajouter une nouvelle balise : incluez des balises facultatives pour rechercher et filtrer vos ressources ou suivre vos AWS coûts.
-
Choisissez Suivant.
-
-
Sur la page Définir l'accès et la sécurité, entrez les informations suivantes :
-
ID de locataire —Entrez votre identifiant de locataire Microsoft 365. Vous pouvez trouver votre ID de locataire dans les propriétés de votre portail Azure Active Directory ou dans votre OAuth application.
-
Autorisation : activez ou désactivez les informations de la liste de contrôle d'accès (ACL) pour vos documents, si vous disposez d'une ACL et que vous souhaitez l'utiliser pour le contrôle d'accès. L'ACL indique les documents auxquels les utilisateurs et les groupes peuvent accéder. Les informations ACL sont utilisées pour filtrer les résultats de recherche en fonction de l'accès de l'utilisateur ou de son groupe aux documents. Pour plus d'informations, consultez la section Filtrage du contexte utilisateur.
-
AWS Secrets Manager secret —Choisissez un secret existant ou créez-en un nouveau Secrets Manager pour stocker vos informations d'authentification Microsoft Teams. Si vous choisissez de créer un nouveau secret, une fenêtre AWS Secrets Manager secrète s'ouvre.
-
Entrez les informations suivantes dans la fenêtre Créer un AWS Secrets Manager secret :
-
Nom secret : le nom de votre secret. Le préfixe « AmazonKendra -Microsoft Teams-» est automatiquement ajouté à votre nom secret.
-
Pour l'ID client et le secret du client : entrez les informations d'authentification configurées dans Microsoft Teams sur le portail Azure.
-
-
Enregistrez et ajoutez votre secret.
-
-
Modèle de paiement : vous pouvez choisir un modèle de licence et de paiement pour votre compte Microsoft Teams. Les modèles de paiement du modèle A sont limités aux modèles de licence et de paiement qui nécessitent une conformité en matière de sécurité. Les modèles de paiement du modèle B conviennent aux modèles de licence et de paiement qui ne nécessitent pas de conformité en matière de sécurité.
-
Virtual Private Cloud (VPC) —Vous pouvez choisir d'utiliser un VPC. Dans ce cas, vous devez ajouter des sous-réseaux et des groupes de sécurité VPC.
-
Identity Crawler : spécifiez s'il faut activer l'explorateur Amazon Kendra d'identité. Le robot d'exploration d'identité utilise les informations de la liste de contrôle d'accès (ACL) de vos documents pour filtrer les résultats de recherche en fonction de l'accès de l'utilisateur ou de son groupe aux documents. Si vous disposez d'une ACL pour vos documents et que vous choisissez de l'utiliser, vous pouvez également choisir d'activer le robot d'exploration Amazon Kendra d'identité pour configurer le filtrage des résultats de recherche par contexte utilisateur. Sinon, si le robot d'identification est désactivé, tous les documents peuvent être consultés publiquement. Si vous souhaitez utiliser le contrôle d'accès pour vos documents et que le robot d'exploration d'identité est désactivé, vous pouvez également utiliser l'PutPrincipalMappingAPI pour télécharger les informations d'accès des utilisateurs et des groupes afin de filtrer le contexte utilisateur.
-
IAM rôle —Choisissez un IAM rôle existant ou créez-en un nouveau IAM pour accéder aux informations d'identification de votre référentiel et indexer le contenu.
Note
IAM les rôles utilisés pour les index ne peuvent pas être utilisés pour les sources de données. Si vous ne savez pas si un rôle existant est utilisé pour un index ou une FAQ, choisissez Créer un nouveau rôle pour éviter les erreurs.
-
Choisissez Suivant.
-
-
Sur la page Configurer les paramètres de synchronisation, entrez les informations suivantes :
-
Synchroniser le contenu : sélectionnez les types de contenu à analyser. Vous pouvez choisir d'explorer le contenu du chat, des équipes et du calendrier.
-
Configuration supplémentaire : spécifiez certaines dates de début et de fin du calendrier, les e-mails des utilisateurs, les noms des équipes, les noms des chaînes, les pièces jointes et OneNotes.
-
Mode de synchronisation : choisissez la manière dont vous souhaitez mettre à jour votre index lorsque le contenu de votre source de données change. Lorsque vous synchronisez votre source de données Amazon Kendra pour la première fois, tout le contenu est analysé et indexé par défaut. Vous devez exécuter une synchronisation complète de vos données en cas d'échec de la synchronisation initiale, même si vous ne choisissez pas l'option de synchronisation complète comme mode de synchronisation.
-
Synchronisation complète : Indexez tout le contenu fraîchement, en remplaçant le contenu existant chaque fois que votre source de données se synchronise avec votre index.
-
Nouvelle synchronisation modifiée : Indexez uniquement le contenu nouveau et modifié chaque fois que votre source de données se synchronise avec votre index. Amazon Kendra peut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
-
Synchronisation nouvelle, modifiée ou supprimée : Indexez uniquement le contenu nouveau, modifié et supprimé chaque fois que votre source de données se synchronise avec votre index. Amazon Kendra peut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
-
-
Dans Calendrier d'exécution de la synchronisation, pour Fréquence : choisissez la fréquence à laquelle vous souhaitez synchroniser le contenu de votre source de données et mettre à jour votre index.
-
Choisissez Suivant.
-
-
Sur la page Définir les mappages de champs, entrez les informations suivantes :
-
Champs de source de données par défaut : sélectionnez parmi les champs de source de données par défaut Amazon Kendra générés que vous souhaitez mapper à votre index.
-
Ajouter un champ —Pour ajouter des champs de source de données personnalisés afin de créer un nom de champ d'index à mapper et le type de données du champ.
-
Choisissez Suivant.
-
-
Sur la page Réviser et créer, vérifiez que les informations saisies sont correctes, puis sélectionnez Ajouter une source de données. Vous pouvez également choisir de modifier vos informations à partir de cette page. Votre source de données apparaîtra sur la page Sources de données une fois que la source de données aura été ajoutée avec succès.
En savoir plus
Pour en savoir plus sur l'intégration Amazon Kendra à votre source de données Microsoft Teams, consultez :