Amazone Kendra est un service de recherche intelligent très précis et facile à utiliser, alimenté par l'apprentissage automatique (ML). Amazon Kendra propose une suite de connecteurs de source de données pour simplifier le processus d'ingestion et d'indexation de votre contenu, où qu'il se trouve.
Pour de nombreuses organisations, Box Content Cloud est au cœur de leur stratégie de stockage de contenu et de gestion du cycle de vie. Un compte Enterprise Box contient souvent un trésor d'actifs, tels que des documents, des présentations, des articles de connaissances, etc. Désormais, avec le nouveau connecteur de source de données Amazon Kendra pour Box, ces actifs et toutes les tâches ou commentaires associés peuvent être indexés par le service de recherche intelligent d'Amazon Kendra pour révéler le contenu et déverrouiller les réponses en réponse aux requêtes des utilisateurs.
Dans cet article, nous vous montrons comment configurer le nouveau connecteur Amazon Kendra Box pour indexer de manière sélective le contenu de votre référentiel Box Enterprise.
Vue d'ensemble de la solution
La solution consiste en les étapes de haut niveau suivantes :
- Créez une application Box pour Amazon Kendra via la Box Developer Console.
- Ajoutez des exemples de documents à votre compte Box.
- Créez une source de données Box via la console Amazon Kendra.
- Indexez les exemples de documents du compte Box.
Pré-requis
Pour essayer le connecteur Amazon Kendra pour Box, vous avez besoin des éléments suivants :
- An Compte AWS avec des privilèges pour créer Gestion des identités et des accès AWS (IAM) rôles et politiques. Pour plus d'informations, voir Présentation de la gestion des accès : autorisations et politiques.
- Connaissance de base d'AWS et connaissance pratique de l'administration de Box Enterprise.
- Accès administrateur à un espace de travail Box Enterprise.
Créer une application Box pour Amazon Kendra
Avant de configurer un connecteur de source de données Amazon Kendra Box, vous devez d'abord créer une application Box.
- Connectez-vous à la Box Entreprise Console développeur.
- Selectionnez Créer une nouvelle application.
- Selectionnez Application personnalisée.
- Selectionnez Authentification du serveur (avec JWT).
- Entrez un nom pour votre application. Par example,
KendraConnector
. - Selectionnez Créer une application.
- Dans votre application créée dans Mes applications, choisir la configuration languette.
- Dans le Niveau d'accès à l'application section, choisissez Application + accès entreprise.
- Dans le Champs d'application section, vérifiez que les autorisations suivantes sont activées :
- Dans le Fonctionnalités avancées section, sélectionnez Effectuer des appels d'API à l'aide de l'en-tête as-user.
- Dans le Ajouter et gérer des clés publiques section, choisissez Générer une paire de clés publique/privée.
Cela nécessite une vérification en deux étapes. Un fichier texte JSON est téléchargé sur votre ordinateur.
- Selectionnez OK pour accepter ce téléchargement.
- Selectionnez Enregistrer les modifications.
- Sur le Autorisation onglet, choisissez Revue et soumission.
- Sélectionnez Soumettre l'application au sein de cette entreprise et choisissez Envoyer.
Votre propriétaire Box Enterprise doit approuver l'application avant que vous puissiez l'utiliser.
Accédez au répertoire des téléchargements sur votre ordinateur pour consulter le fichier JSON téléchargé. Il contient l'ID client, la clé secrète client, l'ID de clé publique, la clé privée, la phrase de passe et l'ID d'entreprise. Vous aurez besoin de ces valeurs pour créer la source de données Box lors d'une étape ultérieure.
Ajouter des exemples de documents à votre compte Box
Au cours de cette étape, vous téléchargez des exemples de documents sur votre compte Box. Plus tard, nous utilisons la source de données Amazon Kendra Box pour explorer et indexer ces documents.
- Télécharger AWS_Whitepapers.zip à votre ordinateur.
- Extrayez les fichiers dans un dossier appelé
AWS_Whitepapers
.
- Télécharger le
AWS_Whitepapers
dossier sur votre compte Box.
Créer une source de données Box
Pour ajouter une source de données à votre index Amazon Kendra à l'aide du connecteur Box, vous pouvez utiliser un index Amazon Kendra existant, ou créer un nouvel index Amazon Kendra. Effectuez ensuite les étapes suivantes pour créer une source de données Box :
- Sur la console Amazon Kendra, choisissez Index dans le volet de navigation.
- Dans la liste des index, choisissez l'index auquel vous souhaitez ajouter la source de données.
- Selectionnez Ajouter des sources de données.
- Dans la liste des connecteurs de source de données, choisissez Ajouter un connecteur sous Box.
- Sur le Spécifier les détails de la source de données page, entrez un nom de source de données et une description facultative.
- Selectionnez Suivant.
- Ouvrez le fichier JSON que vous avez téléchargé depuis la Box Developer Console.
Il contient des valeurs pour clientID
, clientSecret
, publicKeyID
, privateKey
, passphrase
et enterpriseID
.
- Sur le Définir l'accès et la sécurité page, dans la Identifier section, pour ID d'entreprise Box, entrez la valeur du
enterpriseID
champ. - Dans le Authentification section, sous Secret du gestionnaire de secrets AWS, choisissez Créer et ajouter un nouveau secret.
- Pour Nom secret, entrez un nom pour le secret, par exemple,
boxsecret1
. - Pour les champs restants, saisissez les valeurs correspondantes à partir du fichier JSON téléchargé.
- Selectionnez Enregistrer et ajouter un secret.
- Dans le Rôle IAM section, choisissez Créer un nouveau rôle (recommandé) et entrez un nom de rôle, par exemple,
box-role
.
Pour plus d'informations sur les autorisations requises à inclure dans le rôle IAM, consultez Rôles IAM pour les sources de données.
- Selectionnez Suivant.
- Sur le Configurer les paramètres de synchronisation page, dans la Portée de la synchronisation , vous pouvez inclure des liens Web Box, des commentaires et des tâches dans votre index, en plus du contenu des fichiers. Utilisez le paramètre par défaut (non coché) pour ce message.
- Pour Configuration supplémentaire (journal des modifications) - optionnel, utilisez le paramètre par défaut (décoché).
- Pour Configuration supplémentaire (modèles regex) – facultatif, choisissez Inclure des modèles.
- Pour Type, choisissez Chemin
- Pour Chemin – facultatif, saisissez le chemin d'accès aux exemples de documents que vous avez importés précédemment :
AWS_Whitepapers/
. - Selectionnez Ajouter.
- Dans le Calendrier d'exécution de synchronisation section, choisissez Fonctionne à la demande.
- Selectionnez Suivant.
- Sur le Définir le mappage des champs , vous pouvez définir comment la source de données mappe les attributs des objets Box à votre index. Utilisez les paramètres par défaut pour ce message.
- Selectionnez Suivant.
- Sur le Examiner et créer page, vérifiez les détails de votre source de données Box.
- Pour apporter des modifications, choisissez le Modifier à côté de l'élément que vous souhaitez modifier.
- Lorsque vous avez terminé, choisissez Ajouter une source de données pour ajouter votre source de données Box.
Après avoir choisi Ajouter une source de données, Amazon Kendra commence à créer la source de données. La création de la source de données peut prendre plusieurs minutes. Lorsqu'elle est terminée, l'état de la source de données passe de Creating
à Active
.
Indexer des exemples de documents du compte Box
Vous avez configuré le calendrier d'exécution de la synchronisation de la source de données pour qu'il s'exécute à la demande, vous devez donc le démarrer manuellement.
- Sur la console Amazon Kendra, accédez à votre index.
- Choisissez votre nouvelle source de données.
- Selectionnez Synchroniser maintenant.
L'état de synchronisation actuel passe à Syncing – crawling
puis à Syncing – indexing
.
Après environ 10 minutes, l'état de synchronisation actuel passe à idle
, le dernier état de synchronisation passe à Successful
, et le Historique des exécutions de synchronisation panneau affiche plus de détails, y compris le nombre de documents ajoutés.
Testez la solution
Maintenant que vous avez intégré les livres blancs AWS de votre compte Box dans votre index Amazon Kendra, vous pouvez tester certaines requêtes.
- Sur la console Amazon Kendra, choisissez Rechercher du contenu indexé dans le volet de navigation.
- Dans le champ de requête, saisissez une requête de test, telle que
What databases are offered by AWS?
Vous pouvez également essayer vos propres requêtes.
Toutes nos félicitations! Vous avez utilisé avec succès Amazon Kendra pour afficher des réponses et des informations basées sur le contenu indexé à partir de votre compte Box.
Nettoyer
Pour éviter d'engager des coûts futurs, nettoyez les ressources que vous avez créées dans le cadre de cette solution.
- Si vous avez créé un nouvel index Amazon Kendra lors du test de cette solution, supprimez-le.
- Si vous avez ajouté une nouvelle source de données à l'aide du connecteur Amazon Kendra pour Box, supprimez cette source de données.
- Supprimer l'
AWS_Whitepapers
dossier et son contenu depuis votre compte Box.
Conclusion
Avec le connecteur Amazon Kendra Box, les organisations peuvent mettre à la disposition de leurs utilisateurs des informations précieuses piégées dans leurs comptes Box en toute sécurité à l'aide de la recherche intelligente optimisée par Amazon Kendra.
Dans cet article, nous vous avons présenté les bases, mais il existe de nombreuses fonctionnalités supplémentaires que nous n'avons pas couvertes. Par example:
- Vous pouvez activer le contrôle d'accès basé sur l'utilisateur pour votre index Amazon Kendra et restreindre l'accès aux documents Box en fonction des contrôles d'accès que vous avez déjà configurés dans Box.
- Vous pouvez indexer d'autres types d'objets Box, tels que des tâches, des commentaires et des liens Web.
- Vous pouvez mapper des attributs d'objet Box sur des attributs d'index Amazon Kendra et les activer pour le facettage, la recherche et l'affichage dans les résultats de la recherche.
- Vous pouvez intégrer la source de données Box avec la fonctionnalité Custom Document Enrichment (CDE) dans Amazon Kendra pour effectuer une logique de mappage d'attribut supplémentaire et même une transformation de contenu personnalisée lors de l'ingestion.
Pour en savoir plus sur ces possibilités et bien plus encore, reportez-vous au Guide du développeur Amazon Kendra.
À propos des auteurs
Bob Strahan est un architecte de solutions principal au sein de l'équipe AWS Language AI Services.
- "
- 10
- 100
- Qui sommes-nous
- accès
- Compte
- Avec cette connaissance vient le pouvoir de prendre
- ajout
- Supplémentaire
- administration
- AI
- Services d'IA
- Tous
- déjà
- Amazon
- api
- appli
- approuver
- sur notre blog
- Outils
- attributs
- Authentification
- disponibles
- AWS
- Basics
- Box
- Change
- Selectionnez
- le cloud
- commentaires
- configuration
- Console
- contient
- contenu
- contenu
- des bactéries
- Core
- Costs
- créée
- La création
- Courant
- Customiser
- données
- bases de données
- Demande
- Développeur
- Commande
- INSTITUTIONNELS
- téléchargements
- permettre
- Entrer
- Entreprise
- exemple
- Fonctionnalités:
- Des champs
- Prénom
- Abonnement
- avenir
- obtention
- très
- Comment
- How To
- HTTPS
- Active
- comprendre
- Y compris
- indice
- d'information
- idées.
- intégrer
- Intelligent
- IT
- ACTIVITES
- spécialisées
- langue
- APPRENTISSAGE
- apprentissage
- Gauche
- Liste
- click
- machine learning
- gestion
- manager
- manuellement
- Localisation
- Map
- ML
- PLUS
- Navigation
- nombre
- Offres Speciales
- organisations
- propre
- propriétaire
- politiques
- possibilités
- Présentations
- Directeur
- Privé
- Clé privée
- processus
- public
- Clé publique
- restant
- dépôt
- conditions
- Ressources
- réponse
- Avis
- Courir
- Rechercher
- en toute sécurité
- service
- Services
- set
- mise
- So
- sur mesure
- Solutions
- quelques
- Commencer
- j'ai commencé
- départs
- Région
- Statut
- storage
- de Marketing
- Avec succès
- Surface
- tâches
- équipe
- tester
- Essais
- Les bases
- De La Carrosserie
- ouvrir
- utilisé
- utilisateurs
- Plus-value
- Vérification
- web
- tout en
- Livres blancs
- dans les
- de travail