Amazon WorkDocs - Amazon Kendra
Fonctionnalités prises en chargePrérequisInstructions de connexionEn savoir plus

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.

Amazon WorkDocs

Amazon WorkDocs est un service de collaboration de contenu sécurisé permettant de créer, de modifier, de stocker et de partager du contenu. Vous pouvez l'utiliser Amazon Kendra pour indexer votre source de Amazon WorkDocs données.

Vous pouvez vous connecter Amazon Kendra à votre source de Amazon WorkDocs données à l'aide de la Amazon Kendra console et de l'WorkDocsConfigurationAPI.

Amazon WorkDocs est disponible dans les régions de l'Oregon, de la Virginie du Nord, de Sydney, de Singapour et de l'Irlande.

Pour résoudre les problèmes liés à votre connecteur de source de Amazon Kendra WorkDocs données, consultezDépannage des sources de données.

Fonctionnalités prises en charge

Amazon Kendra WorkDocs le connecteur de source de données prend en charge les fonctionnalités suivantes :

  • Mappages de champs

  • Contrôle d'accès des utilisateurs

  • Filtres d'inclusion/exclusion

  • Journal des modifications

Prérequis

Avant de pouvoir Amazon Kendra indexer votre source de WorkDocs données, apportez ces modifications à vos AWS comptes WorkDocs and.

Dans WorkDocs, assurez-vous d'avoir :

  • Vous avez noté l'ID de Amazon WorkDocs répertoire (ID d'organisation) de votre Amazon WorkDocs référentiel.

  • Il est vérifié que chaque document est unique dans WorkDocs et entre 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 AWS compte, assurez-vous d'avoir :

Si vous n'avez pas de IAM rôle existant, vous pouvez utiliser la console pour créer un nouveau IAM rôle lorsque vous connectez votre source de WorkDocs données à Amazon Kendra. Si vous utilisez l'API, vous devez fournir l'ARN d'un IAM rôle existant et un identifiant d'index.

Instructions de connexion

Pour vous connecter Amazon Kendra à votre source de WorkDocs données, vous devez fournir les informations nécessaires sur votre source de WorkDocs données afin de Amazon Kendra pouvoir accéder à vos données. Si vous n'avez pas encore configuré WorkDocs pour Amazon Kendra, consultezPrérequis.

Console

Pour vous connecter Amazon Kendra à Amazon WorkDocs

  1. Connectez-vous à la Amazon Kendra console AWS Management Console et ouvrez-la.

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

  3. Sur la page de démarrage, choisissez Ajouter une source de données.

  4. Sur la page Ajouter une source de données, choisissez WorkDocs connecteur, puis sélectionnez Ajouter un connecteur. Si vous utilisez la version 2 (le cas échéant), choisissez le WorkDocs connecteur avec la balise « V2.0 ».

  5. Sur la page Spécifier les détails de la source de données, entrez les informations suivantes :

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

    2. (Facultatif) Description : entrez une description facultative pour votre source de données.

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

    4. Dans Balises, pour Ajouter une nouvelle balise : incluez des balises facultatives pour rechercher et filtrer vos ressources ou suivre vos AWS coûts.

    5. Choisissez Suivant.

  6. Sur la page Définir l'accès et la sécurité, entrez les informations suivantes :

    1. ID d'organisation spécifique à votre Amazon WorkDocs site : sélectionnez l'identifiant du Amazon WorkDocs site que vous souhaitez indexer. Vous devez déjà avoir créé un site.

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

    3. Choisissez Suivant.

  7. Sur la page Configurer les paramètres de synchronisation, entrez les informations suivantes :

    1. Analyser les commentaires du document : Amazon WorkDocs entités ou types de contenu que vous souhaitez analyser.

    2. Utiliser les journaux des modifications : sélectionnez cette option pour mettre à jour votre index uniquement avec du contenu nouveau ou modifié au lieu de synchroniser tous vos fichiers.

    3. Modèles Regex : modèles d'expressions régulières permettant d'inclure ou d'exclure certains fichiers.

    4. Dans Synchroniser le calendrier d'exécution pour la fréquence : choisissez la fréquence à laquelle vous souhaitez synchroniser le contenu de votre source de données et mettre à jour votre index.

    5. Choisissez Suivant.

  8. Sur la page Définir les mappages de champs, entrez les informations suivantes :

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

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

    3. Choisissez Suivant.

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

API

Pour vous connecter Amazon Kendra à Amazon WorkDocs

Vous devez spécifier les éléments suivants à l'aide de l'WorkDocsConfigurationAPI :

  • Amazon WorkDocs ID de répertoire —Spécifiez l'ID d'organisation de votre Amazon WorkDocs annuaire. Vous pouvez trouver l'ID de l'organisation dans AWS Directory Service en accédant à Active Directory, puis à Directories.

  • Rôle IAM : spécifiez à quel RoleArn moment vous appelez CreateDataSource pour fournir à un IAM rôle les autorisations d'accès au WorkDocs répertoire et pour appeler les API publiques requises pour le connecteur et. WorkDocs Amazon Kendra Pour plus d'informations, consultez la section Rôles IAM pour les sources WorkDocs de données.

Vous pouvez également ajouter les fonctionnalités optionnelles suivantes :

  • Journal des modifications : Amazon Kendra faut-il utiliser le mécanisme du journal des modifications de la source de WorkDocs données pour déterminer si un document doit être mis à jour dans l'index.

    Note

    Utilisez le journal des modifications si vous ne Amazon Kendra souhaitez pas numériser tous les documents. Si votre journal des modifications est volumineux, la numérisation des documents de la source de WorkDocs données peut prendre Amazon Kendra moins de temps que le traitement du journal des modifications. Si vous synchronisez votre source de WorkDocs données avec votre index pour la première fois, tous les documents sont numérisés.

  • Filtres d'inclusion et d'exclusion : indiquez si vous souhaitez inclure ou exclure certains documents et commentaires de documents. Chaque commentaire est indexé en tant que document distinct.

    Note

    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.

  • Filtrage du contexte utilisateur et contrôle d'accèsAmazon Kendra  : analyse la liste de contrôle d'accès (ACL) de vos documents, si vous disposez d'une ACL pour vos documents. 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.

  • Mappages de champs : choisissez de mapper les champs de votre source de WorkDocs données à vos champs d' Amazon Kendra index. Pour plus d'informations, veuillez consulter la rubrique Mappage des champs de source de données.

    Note

    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.

En savoir plus

Pour en savoir plus sur l'intégration Amazon Kendra à votre source de WorkDocs données, consultez :