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.
Slack
Slack est une application de communication d'entreprise qui permet aux utilisateurs d'envoyer des messages et des pièces jointes via différents canaux publics et privés. Vous pouvez l'utiliser Amazon Kendra pour indexer vos chaînes publiques et privées Slack, automatiser et archiver des messages, des fichiers et des pièces jointes, des messages directs et de groupe. Vous pouvez également choisir un contenu spécifique à filtrer.
Amazon Kendra prend désormais en charge un connecteur Slack amélioré.
La console a été automatiquement mise à niveau pour vous. Tous les nouveaux connecteurs que vous créez dans la console utiliseront l'architecture mise à niveau. Si vous utilisez l'API, vous devez désormais utiliser l'TemplateConfigurationobjet au lieu de l'SlackConfigurationobjet pour configurer votre connecteur.
Les connecteurs configurés à l'aide de l'ancienne console et de l'ancienne architecture d'API continueront de fonctionner tels qu'ils ont été configurés. Toutefois, vous ne pourrez ni les modifier ni les mettre à jour. Si vous souhaitez modifier ou mettre à jour la configuration de votre connecteur, vous devez créer un nouveau connecteur.
Nous vous recommandons de migrer le flux de travail de votre connecteur vers la version mise à niveau. Support pour les connecteurs configurés à l'aide de l'ancienne architecture devrait prendre fin en juin 2024.
Vous pouvez vous connecter Amazon Kendra à votre source de données Slack à l'aide de la Amazon Kendra console ou de l'TemplateConfigurationAPI.
Pour résoudre les problèmes liés à votre connecteur de source de données Amazon Kendra Slack, consultezDépannage des sources de données.
Fonctionnalités prises en charge
Amazon Kendra Le connecteur de source de données Slack prend en charge les fonctionnalités suivantes :
-
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 Slack, apportez ces modifications à votre compte Slack et AWS à vos comptes.
Dans Slack, assurez-vous d'avoir :
-
Vous avez configuré un jeton OAuth Slack Bot User ou un jeton Slack User OAuth. Vous pouvez choisir l'un ou l'autre des jetons pour vous connecter Amazon Kendra à votre source de données Slack. Vous devez utiliser un jeton comme identifiant d'authentification. Consultez la documentation Slack sur les jetons d'accès pour plus d'informations.
Si vous utilisez le jeton de bot dans vos informations d'identification Slack, vous ne pouvez pas indexer les messages directs et les messages de groupe et vous devez ajouter le jeton de bot à la chaîne que vous souhaitez indexer.
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).
-
Vous avez noté votre identifiant d'équipe Slack sur l'URL de la page principale de votre espace de travail Slack. Par exemple, https://app.slack.com/client/T0123456789/... où T0123456789 est l'identifiant de l'équipe.
-
Les étendues et autorisations Oauth suivantes ont été ajoutées :
| Portée du jeton utilisateur |
Portée du jeton bot |
-
chaînes : historique
-
chaînes : lire
-
emoji : lire
-
fichiers:lire
-
groupes : historique
-
groupes : lire
-
im : histoire
-
im : lire
-
mpim : histoire
-
mpim : lire
-
team:read
-
users.profile : read
-
utilisateurs:read
-
utilisateurs:read.email
|
-
chaînes : historique
-
canaux:gérer
-
chaînes : lire
-
conversations.connect : gérer
-
conversations.connect : lire
-
fichiers:lire
-
groupes : historique
-
groupes : lire
-
im : histoire
-
im : lire
-
mpim : histoire
-
mpim : lire
-
réactions : lire
-
team:read
-
groupes d'utilisateurs : lire
-
users.profile : read
-
utilisateurs:read
-
utilisateurs:read.email
|
-
Il est vérifié que chaque document est unique dans Slack 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. Les identifiants de document sont globaux à 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.
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 Slack dans un AWS Secrets Manager secret et, si vous utilisez l'API, notez l'ARN du secret.
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 Slack à 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 Slack, vous devez fournir les informations nécessaires sur votre source de données Slack afin de Amazon Kendra pouvoir accéder à vos données. Si vous n'avez pas encore configuré Slack pour Amazon Kendra, consultezPrérequis.
- Console
-
Pour vous connecter Amazon Kendra à Slack
-
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.
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 Slack, puis sélectionnez Ajouter un connecteur. Si vous utilisez la version 2 (le cas échéant), choisissez le connecteur Slack avec le tag « 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 :
-
Pour l'identifiant d'équipe de l'espace de travail Slack : l'identifiant d'équipe de votre espace de travail Slack. Vous trouverez votre identifiant d'équipe sur l'URL de la page principale de votre espace de travail Slack. Par exemple, https://app.slack.com/client/T0123456789/... où T0123456789 est l'identifiant de l'équipe.
-
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 Slack. 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 -Slack » est automatiquement ajouté à votre nom secret.
-
Pour le jeton Slack : entrez les valeurs des informations d'authentification que vous avez configurées dans Slack.
-
Enregistrez et ajoutez votre secret.
-
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.
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 :
-
Sélectionnez le type de contenu : sélectionnez les entités ou les types de contenu Slack que vous souhaitez analyser. Vous pouvez choisir parmi toutes les chaînes, les chaînes publiques, les chaînes privées, les messages de groupe et les messages privés.
-
Sélectionnez la date de début de l'analyse : entrez la date à laquelle vous souhaitez commencer à analyser votre contenu.
-
Pour une configuration supplémentaire : choisissez d'inclure les messages du bot et les messages archivés et d'utiliser des modèles d'expressions régulières pour inclure ou exclure certains contenus.
Si vous choisissez d'inclure à la fois les identifiants et les noms des chaînes, le connecteur Amazon Kendra Slack donnera la priorité aux identifiants des chaînes par rapport aux noms des chaînes.
Si vous avez choisi d'inclure certains messages privés et de groupe, le connecteur Amazon Kendra Slack ignorera tous les messages privés et de groupe et n'analysera que les messages privés et de groupe que vous spécifiez.
-
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.
-
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 depuis 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.
- API
-
Pour vous connecter Amazon Kendra à Slack
Vous devez spécifier un JSON du schéma de source de données à l'aide de l'TemplateConfigurationAPI. Vous devez fournir les informations suivantes :
-
Source de données —Spécifiez le type de source de données tel que SLACK lorsque vous utilisez le schéma TemplateConfigurationJSON. Spécifiez également la source de données TEMPLATE lorsque vous appelez l'CreateDataSourceAPI.
-
ID d'équipe Slack Workspace : identifiant d'équipe Slack que vous avez copié à partir de l'URL de votre page principale de Slack.
-
Depuis la date : date à laquelle vous avez commencé à analyser vos données auprès de votre équipe Slack Workspace. La date doit suivre ce format : yyyy-mm-dd.
-
Mode de synchronisation : spécifiez comment Amazon Kendra 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. Vous pouvez choisir entre :
-
FORCED_FULL_CRAWLpour indexer à nouveau tout le contenu, en remplaçant le contenu existant chaque fois que votre source de données se synchronise avec votre index.
-
FULL_CRAWLpour indexer 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.
-
CHANGE_LOGpour indexer 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.
-
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.
-
Nom de ressource Amazon (ARN) secret : indiquez le nom de ressource Amazon (ARN) d'un Secrets Manager secret contenant les informations d'authentification de votre compte Slack. Le secret est stocké dans une structure JSON avec les clés suivantes :
{
"slackToken": "token"
}
-
IAM role —Spécifiez à quel RoleArn moment vous appelez CreateDataSource pour fournir à un IAM rôle les autorisations nécessaires pour accéder à votre Secrets Manager secret et pour appeler les API publiques requises pour le connecteur Slack et. Amazon Kendra Pour plus d'informations, consultez la section IAM Rôles des sources de données Slack.
Vous pouvez également ajouter les fonctionnalités optionnelles suivantes :
-
Virtual Private Cloud (VPC) VpcConfiguration —Spécifiez le moment de votre appel. CreateDataSource Pour plus d’informations, consultez Configuration Amazon Kendra pour utiliser un Amazon VPC.
-
Chaînes spécifiques : filtrez par chaînes publiques ou privées et spécifiez certaines chaînes en fonction de leur identifiant.
-
Types de chaînes et de messages : indiquez si vous Amazon Kendra devez indexer vos chaînes publiques et privées, vos messages de groupe et directs, ainsi que votre bot et vos messages archivés. Si vous utilisez un jeton de bot dans le cadre de vos identifiants d'authentification Slack, vous devez ajouter le jeton de bot à la chaîne que vous souhaitez indexer. Vous ne pouvez pas indexer les messages directs et les messages de groupe à l'aide d'un jeton de bot.
-
Rétrospective : vous pouvez choisir de configurer un lookBack paramètre afin que le connecteur Slack analyse le contenu mis à jour ou supprimé jusqu'à un certain nombre d'heures avant la dernière synchronisation de votre connecteur.
-
Filtres d'inclusion et d'exclusion : indiquez si vous souhaitez inclure ou exclure certains contenus de Slack. Si vous utilisez un jeton de bot dans le cadre de vos identifiants d'authentification Slack, vous devez ajouter le jeton de bot à la chaîne que vous souhaitez indexer. Vous ne pouvez pas indexer les messages directs et les messages de groupe à l'aide d'un jeton de bot.
La plupart des sources de données utilisent des modèles d'expressions régulières, qui sont des modèles d'inclusion ou d'exclusion appelés filtres. Si vous spécifiez un filtre d'inclusion, seul le contenu correspondant au filtre d'inclusion est indexé. Tout document qui ne correspond pas au filtre d'inclusion n'est pas indexé. Si vous spécifiez un filtre d'inclusion et d'exclusion, les documents correspondant au filtre d'exclusion ne sont pas indexés, même s'ils correspondent au filtre d'inclusion.
-
Mappages de champs : choisissez de mapper les champs de votre source de données Slack à vos Amazon Kendra champs d'index. Pour plus d'informations, veuillez consulter la rubrique Mappage des champs de source de données.
Le champ du corps du document ou l'équivalent du corps du document pour vos documents est requis pour Amazon Kendra effectuer une recherche dans vos documents. Vous devez associer le nom du champ du corps du document dans votre source de données au nom du champ d'index_document_body. Tous les autres champs sont facultatifs.
Pour obtenir la liste des autres clés JSON importantes à configurer, consultez le schéma du Slack modèle.
En savoir plus
Pour en savoir plus sur l'intégration Amazon Kendra à votre source de données Slack, consultez :
