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.
# Comment Amazon Kendra fonctionne
Amazon Kendra fournit une fonctionnalité de génération augmentée (RAG) de recherche et de récupération pour votre application. Il indexe vos documents directement, ou à partir de votre référentiel de documents tiers, et fournit intelligemment des informations pertinentes à vos utilisateurs. Vous pouvez l'utiliser Amazon Kendra pour créer un index actualisable de documents de différents types. Pour obtenir la liste des types de documents pris en charge par Amazon Kendra, voir [Types de documents](https://docs.aws.amazon.com/kendra/latest/dg/index-document-types.html).
Amazon Kendra s'intègre à d'autres services. Vous pouvez connecter un index Amazon Kendra GenAI Enterprise Edition à [Amazon Q Business](https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/what-is.html)[Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/userguide/what-is-bedrock.html) pour créer votre solution de chat RAG. Vous pouvez également activer les [robots de Amazon Lex discussion](https://docs.aws.amazon.com/lexv2/latest/dg/faq-bot-kendra-search.html) avec Amazon Kendra la recherche pour fournir des réponses utiles aux questions des utilisateurs. Vous pouvez également utiliser un [Amazon Simple Storage Service bucket](https://docs.aws.amazon.com/kendra/latest/dg/data-source-s3.html) comme source de données pour vous connecter Amazon Kendra à vos documents et les indexer.
Amazon Kendra comporte les éléments suivants :
+ Un [https://docs.aws.amazon.com//kendra/latest/dg/create-index.html](https://docs.aws.amazon.com//kendra/latest/dg/create-index.html) qui contient vos documents et les rend consultables.
+ [https://docs.aws.amazon.com/kendra/latest/dg/data-source.html](https://docs.aws.amazon.com/kendra/latest/dg/data-source.html) qui stocke vos documents et qui Amazon Kendra se connecte à. Vous pouvez synchroniser automatiquement une source de données avec un Amazon Kendra index afin que votre index reste à jour avec votre référentiel source.
+ [https://docs.aws.amazon.com/kendra/latest/dg/in-adding-documents.html](https://docs.aws.amazon.com/kendra/latest/dg/in-adding-documents.html) qui ajoute des documents directement à un index.
+ Une [https://docs.aws.amazon.com/kendra/latest/APIReference/API_Retrieve.html](https://docs.aws.amazon.com/kendra/latest/APIReference/API_Retrieve.html) de récupération qui récupère des passages ou des extraits de texte pertinents à la suite d'une requête d'entrée.
+ Une [https://docs.aws.amazon.com/kendra/latest/APIReference/API_Query.html](https://docs.aws.amazon.com/kendra/latest/APIReference/API_Query.html) qui recherche un index en fonction d'une requête d'entrée.
Vous pouvez l'utiliser Amazon Kendra via la console ou l'API. Vous pouvez créer, mettre à jour et supprimer des index. La suppression d'un index supprime tous ses connecteurs de source de données et supprime définitivement toutes les informations de votre document. Amazon Kendra
**Topics**
+ [Index dans Amazon Kendra](hiw-index.md)
+ [Documents](hiw-documents.md)
+ [Sources de données](hiw-data-source.md)
+ [Requêtes](hiw-query.md)
+ [Étiquettes](tagging.md)
# Index dans Amazon Kendra
Un index contient le contenu de vos documents et est structuré de manière à rendre les documents consultables. Cette section fournit une vue d'ensemble des types d'index et des fonctionnalités d'index pris en charge.
**Topics**
+ [Types d'index dans Amazon Kendra](hiw-index-types.md)
+ [Ajouter des documents à un index dans Amazon Kendra](hiw-index-adding-docs.md)
+ [Utilisation de champs de document Amazon Kendra réservés ou communs](index-reserved-fields-hiw.md)
+ [Récupération de réponses à partir d'index dans Amazon Kendra](index-searching.md)
# Types d'index dans Amazon Kendra
Amazon Kendra possède trois types d'index : l'index GenAI Enterprise Edition, l'index Enterprise Edition et l'index Developer Edition. Les sections suivantes décrivent les fonctionnalités de chaque indice.
**Topics**
+ [Index de l'édition Enterprise d'Amazon Kendra GenAI](#kendra-gen-ai-index)
+ [Index Amazon Kendra Enterprise Edition](#kendra-enterprise-index)
+ [Index de l'édition Amazon Kendra Developer](#kendra-developer-index)
## Index de l'édition Enterprise d'Amazon Kendra GenAI
Un index Amazon Kendra GenAI Enterprise Edition offre la plus grande précision pour le fonctionnement de l'API Retrieve et pour les cas d'utilisation de la génération augmentée de récupération (RAG). Il repose sur les dernières technologies de récupération d'informations, telles que la recherche hybride (mot-clé et vecteur), l'intégration sémantique et les modèles de reclassement, et a été testé sur divers ensembles de données. Le fonctionnement de l'API Query offre une précision similaire pour un index Amazon Kendra GenAI Enterprise Edition par rapport aux index Amazon Kendra Developer Edition et Amazon Kendra Enterprise Edition.
Un index Amazon Kendra GenAI Enterprise Edition permet la mobilité de vos données indexées entre AWS les services d'IA générative. Grâce à cette fonctionnalité, vous pouvez réutiliser facilement vos investissements sans avoir à reconstruire les index. Vous pouvez l'utiliser dans une [base de connaissances Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/userguide/knowledge-base.html) en tant que retriever géré, et l'intégrer aux outils Amazon Bedrock tels que les agents et les flux rapides pour créer des assistants d'intelligence artificielle avancés. Vous pouvez également l'utiliser [Amazon Q Business](https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/what-is.html)pour un assistant numérique entièrement géré.
Un indice Amazon Kendra GenAI Enterprise Edition propose des unités de capacité plus petites et plus granulaires et un prix de départ inférieur à celui des deux autres types d'indices. Cela vous permet d'utiliser vos capacités de manière plus efficace.
**Note**
Pour une expérience et une précision optimales, nous vous recommandons de choisir un index Amazon Kendra GenAI Enterprise Edition.
**Topics**
+ [Fonctionnalités prises en charge](#kendra-gen-ai-index-features)
+ [Limitations](#genai-index-limitations)
### Fonctionnalités prises en charge
Les fonctionnalités suivantes sont prises en charge pour un index Amazon Kendra GenAI Enterprise Edition si vous utilisez l'opération d'API [Retrieve](https://docs.aws.amazon.com/kendra/latest/APIReference/API_Retrieve.html) pour les cas d'utilisation de RAG :
+ **Support complet** : [compartiments de scores de confiance](https://docs.aws.amazon.com/kendra/latest/APIReference/API_QueryResultItem.html#Kendra-Type-QueryResultItem-ScoreAttributes), [filtrage](https://docs.aws.amazon.com/kendra/latest/dg/filtering.html), [facettage](https://docs.aws.amazon.com/kendra/latest/dg/filtering.html#search-facets), [réglage de la pertinence](https://docs.aws.amazon.com/kendra/latest/dg/tuning.html), [enrichissement personnalisé des documents](https://docs.aws.amazon.com/kendra/latest/dg/custom-document-enrichment.html), [métadonnées personnalisées](https://docs.aws.amazon.com/kendra/latest/dg/custom-attributes.html) et [ajustement de la capacité des requêtes et de la capacité des documents](https://docs.aws.amazon.com/kendra/latest/dg/adjusting-capacity.html).
+ **Support partiel** : [connecteurs de source de données](https://docs.aws.amazon.com/kendra/latest/dg/data-source.html) et [filtrage du contexte utilisateur](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html). Pour plus d'informations sur les fonctionnalités partiellement prises en charge, consultez la section [Limitations](https://docs.aws.amazon.com/kendra/latest/dg/hiw-index-types.html#genai-index-limitations).
Les fonctionnalités suivantes sont prises en charge pour un index Amazon Kendra GenAI Enterprise Edition si vous utilisez l'opération [Query](https://docs.aws.amazon.com/kendra/latest/APIReference/API_Query.html) API pour des cas d'utilisation de recherche :
+ **Support complet** [https://docs.aws.amazon.com/kendra/latest/dg/tuning.html](https://docs.aws.amazon.com/kendra/latest/dg/tuning.html) [https://docs.aws.amazon.com/kendra/latest/dg/custom-document-enrichment.html](https://docs.aws.amazon.com/kendra/latest/dg/custom-document-enrichment.html)enrichissement, [métadonnées personnalisées](https://docs.aws.amazon.com/kendra/latest/dg/custom-attributes.html), [ajustement de la capacité de requête et de la capacité des documents](https://docs.aws.amazon.com/kendra/latest/dg/adjusting-capacity.html), et [expérience de recherche](https://docs.aws.amazon.com/kendra/latest/dg/deploying.html).
+ **Support partiel** : [connecteurs de source de données](https://docs.aws.amazon.com/kendra/latest/dg/data-source.html) et [filtrage du contexte utilisateur](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html). Pour plus d'informations sur les fonctionnalités partiellement prises en charge, consultez la section [Limitations](https://docs.aws.amazon.com/kendra/latest/dg/hiw-index-types.html#kendra-gen-ai-index).
### Limitations
Ce qui suit décrit les limites connues d'un index Amazon Kendra GenAI Enterprise Edition :
+ Les index Amazon Kendra GenAI Enterprise Edition ne sont disponibles que dans l'est des États-Unis (Virginie du Nord) et dans l'ouest des États-Unis (Oregon).
+ Les index Amazon Kendra GenAI Enterprise Edition ne prennent en charge que le contenu en anglais.
+ Les index Amazon Kendra GenAI Enterprise Edition ne prennent en charge que les connecteurs de source de données Amazon Kendra v2.0.
+ Dans un index Amazon Kendra GenAI Enterprise Edition, vous ne pouvez utiliser les [attributs utilisateur](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-attribute) que pour filtrer les résultats de recherche en fonction du contexte utilisateur.
+ Les index Amazon Kendra GenAI Enterprise Edition ne prennent pas en charge le contrôle d'[accès utilisateur basé sur des jetons ni le contrôle d'accès utilisateur aux documents](https://docs.aws.amazon.com/kendra/latest/dg/create-index-access-control.html) basé sur [l'ID utilisateur et le groupe.](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources)
+ Le fonctionnement de l'[CreateAccessControlConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateAccessControlConfiguration.html)API est désactivé pour les index Amazon Kendra GenAI Enterprise Edition.
+ Si vous utilisez un index Amazon Kendra GenAI Enterprise Edition avec Amazon Q Business, notez ce qui suit concernant le contrôle de l'accès des utilisateurs finaux aux documents :
Amazon Q Business utilise l'adresse e-mail de l'utilisateur pour déterminer l'accès de l'utilisateur final aux documents d'un index. Lorsque vous connectez un index Amazon Kendra à Amazon Kendra Amazon Q Business, il Amazon Q Business transmet l'adresse e-mail d'identification de l'utilisateur à Amazon Kendra afin de permettre le filtrage des documents pour les utilisateurs finaux. Si les sources de données connectées à votre index Amazon Kendra n'utilisent pas le filtrage des documents basé sur l'identifiant d'e-mail, ou si l'identifiant d'e-mail n'est pas présent, Amazon Q Business génère des réponses uniquement à partir de documents publics.
## Index Amazon Kendra Enterprise Edition
Un index Amazon Kendra Enterprise Edition fournit des fonctionnalités de recherche sémantique et propose un service de haute disponibilité adapté aux charges de travail de production.
**Topics**
+ [Fonctionnalités prises en charge](#kendra-ent-index-features)
+ [Limitations](#ent-index-limitations)
### Fonctionnalités prises en charge
[Les fonctionnalités suivantes sont prises en charge pour un index Amazon Kendra Enterprise Edition si vous utilisez l'opération d'API [Retrieve](https://docs.aws.amazon.com/kendra/latest/APIReference/API_Retrieve.html) pour les cas d'utilisation de RAG : requêtes utilisant une [syntaxe de requête avancée](https://docs.aws.amazon.com/kendra/latest/dg/searching-example.html#searching-index-query-syntax), [corrections orthographiques suggérées](https://docs.aws.amazon.com/kendra/latest/dg/query-spell-check.html) pour les requêtes, [facettage](https://docs.aws.amazon.com/kendra/latest/dg/filtering.html#search-facets), [suggestions de requêtes pour compléter automatiquement les requêtes](https://docs.aws.amazon.com/kendra/latest/dg/query-suggestions.html) de recherche et apprentissage progressif.](https://docs.aws.amazon.com/kendra/latest/dg/submitting-feedback.html)
Toutes les fonctionnalités sont prises en charge pour un index Amazon Kendra Enterprise Edition si vous utilisez l'opération [Query](https://docs.aws.amazon.com/kendra/latest/APIReference/API_Query.html) API pour les cas d'utilisation de la recherche.
### Limitations
Ce qui suit décrit les limites connues d'un index Amazon Kendra Enterprise Edition :
+ Si vous utilisez un index Amazon Kendra Enterprise Edition avec Amazon Q Business, notez ce qui suit concernant le contrôle de l'accès des utilisateurs finaux aux documents :
Amazon Q Business utilise l'adresse e-mail de l'utilisateur pour déterminer l'accès de l'utilisateur final aux documents d'un index. Lorsque vous connectez un index Amazon Kendra à Amazon Kendra Amazon Q Business, il Amazon Q Business transmet l'adresse e-mail d'identification de l'utilisateur à Amazon Kendra afin de permettre le filtrage des documents pour les utilisateurs finaux. Si les sources de données connectées à votre index Amazon Kendra n'utilisent pas le filtrage des documents basé sur l'identifiant d'e-mail, ou si l'identifiant d'e-mail n'est pas présent, Amazon Q Business génère des réponses uniquement à partir de documents publics.
## Index de l'édition Amazon Kendra Developer
Un index Amazon Kendra Developer Edition fournit également des fonctionnalités de recherche sémantique vous permettant de tester vos cas d'utilisation. Cependant, nous ne le recommandons pas pour les cas d'utilisation en production.
**Topics**
+ [Fonctionnalités prises en charge](#kendra-dev-index-features)
+ [Limitations](#dev-index-limitations)
### Fonctionnalités prises en charge
[Les fonctionnalités suivantes sont prises en charge pour un index Amazon Kendra Developer Edition si vous utilisez l'opération de l'API [Retrieve](https://docs.aws.amazon.com/kendra/latest/APIReference/API_Retrieve.html) pour les cas d'utilisation de RAG : requêtes utilisant une [syntaxe de requête avancée](https://docs.aws.amazon.com/kendra/latest/dg/searching-example.html#searching-index-query-syntax), [corrections orthographiques suggérées](https://docs.aws.amazon.com/kendra/latest/dg/query-spell-check.html) pour les requêtes, [facettage](https://docs.aws.amazon.com/kendra/latest/dg/filtering.html#search-facets), [suggestions de requêtes pour compléter automatiquement les requêtes](https://docs.aws.amazon.com/kendra/latest/dg/query-suggestions.html) de recherche et apprentissage progressif.](https://docs.aws.amazon.com/kendra/latest/dg/submitting-feedback.html)
Toutes les fonctionnalités sont prises en charge pour un index Amazon Kendra Developer Edition si vous utilisez l'opération [Query](https://docs.aws.amazon.com/kendra/latest/APIReference/API_Query.html) API pour les cas d'utilisation de la recherche.
### Limitations
Ce qui suit décrit les limites connues d'un index Amazon Kendra Developer Edition :
+ Si vous utilisez un index Amazon Kendra Developer Edition avec Amazon Q Business, notez ce qui suit concernant le contrôle de l'accès des utilisateurs finaux aux documents :
Amazon Q Business utilise l'adresse e-mail de l'utilisateur pour déterminer l'accès de l'utilisateur final aux documents d'un index. Lorsque vous connectez un index Amazon Kendra à Amazon Kendra Amazon Q Business, il Amazon Q Business transmet l'adresse e-mail d'identification de l'utilisateur à Amazon Kendra afin de permettre le filtrage des documents pour les utilisateurs finaux. Si les sources de données connectées à votre index Amazon Kendra n'utilisent pas le filtrage des documents basé sur l'identifiant d'e-mail, ou si l'identifiant d'e-mail n'est pas présent, Amazon Q Business génère des réponses uniquement à partir de documents publics.
# Ajouter des documents à un index dans Amazon Kendra
La façon dont vous ajoutez des documents à un index dépend de la manière dont vous les stockez.
+ Si vous stockez vos documents dans un référentiel, tel qu'un Amazon S3 bucket ou un SharePoint site Microsoft, vous utilisez un [connecteur de source de données](https://docs.aws.amazon.com/kendra/latest/dg/data-source.html) pour indexer vos documents à partir de votre référentiel.
+ Si vous ne stockez pas vos documents dans un référentiel, vous utilisez l'opération [BatchPutDocument](https://docs.aws.amazon.com/kendra/latest/APIReference/API_BatchPutDocument.html)API pour les indexer directement.
+ Pour les questions et réponses aux FAQ, qui doivent être stockées dans un compartiment Amazon Kendra (Amazon S3), vous les téléchargez depuis le compartiment.
Vous pouvez créer des index avec la Amazon Kendra console AWS CLI, le ou un AWS SDK. Pour plus d'informations sur les types de documents pouvant être indexés, consultez la section [Types de documents](https://docs.aws.amazon.com/kendra/latest/dg/index-document-types.html).
# Utilisation de champs de document Amazon Kendra réservés ou communs
Grâce au fonctionnement de l'[UpdateIndex](https://docs.aws.amazon.com/kendra/latest/APIReference/API_UpdateIndex.html)API, vous pouvez créer des champs réservés ou communs. Pour ce faire, vous devez utiliser `DocumentMetadataConfigurationUpdates` et spécifier le nom du champ d'index Amazon Kendra réservé à mapper à votre attribute/field nom de document équivalent. Vous pouvez également créer des champs personnalisés.
Si vous utilisez un connecteur de source de données, la plupart incluent des mappages de champs qui font correspondre les champs de votre document de source de données aux champs d' Amazon Kendra index. Si vous utilisez la console, vous mettez à jour les champs en sélectionnant votre source de données, en sélectionnant l'action de modification, puis en passant à côté de la section des mappages de champs pour configurer la source de données.
Vous pouvez configurer l'`Search`objet pour définir un champ comme affichable, facetable, consultable ou triable. Vous pouvez configurer l'`Relevance`objet pour définir l'ordre de classement d'un champ, la durée d'augmentation ou la période à appliquer aux valeurs de renforcement, de fraîcheur, de valeur d'importance et d'importance mappées à des valeurs de champ spécifiques.
Si vous utilisez la console, vous pouvez configurer les paramètres de recherche d'un champ en sélectionnant l'option à facettes dans le menu de navigation. Pour définir le réglage de la pertinence, sélectionnez l'option permettant de rechercher votre index dans le menu de navigation, entrez une requête et utilisez les options du panneau latéral pour ajuster la pertinence de la recherche. Vous ne pouvez pas modifier le type de champ après l'avoir créé.
Amazon Kendrapossède les champs de document réservés ou communs suivants que vous pouvez utiliser :
+ `_authors` : liste des auteurs responsables du contenu du document.
+ `_category` : catégorie qui place un document dans un groupe spécifique.
+ `_created_at` : date et heure de création du document, au format ISO 8601. Par exemple, 2012-03-25T 12:30:10 \$1 01:00 est le format date-heure ISO 8601 pour le 25 mars 2012 à 12h30 (plus 10 secondes) en heure d'Europe centrale.
+ `_data_source_id` : identifiant de la source de données qui contient le document.
+ `_document_body` : contenu du document.
+ `_document_id` : identifiant unique du document.
+ `_document_title` : titre du document.
+ `_excerpt_page_number`— Numéro de page dans un fichier PDF où apparaît l'extrait du document. Si votre index a été créé avant le 8 septembre 2020, vous devez réindexer vos documents avant de pouvoir utiliser cet attribut.
+ `_faq_id`— S'il s'agit d'un document de type question-réponse (FAQ), un identifiant unique pour la FAQ.
+ `_file_type`— Le type de fichier du document, tel que pdf ou doc.
+ `_last_updated_at` : date et heure auxquelles le document a été mis à jour pour la dernière fois, au format ISO 8601. Par exemple, 2012-03-25T 12:30:10 \$1 01:00 est le format date-heure ISO 8601 pour le 25 mars 2012 à 12h30 (plus 10 secondes) en heure d'Europe centrale.
+ `_source_uri`— L'URI où le document est disponible, par exemple, l'URI du document sur le site Web d'une entreprise.
+ `_version` : identifiant de la version spécifique d’un document.
+ `_view_count` : nombre de fois que le document a été consulté.
+ `_language_code`(String) — Code d'une langue qui s'applique au document. Par défaut, il correspond à l’anglais si vous ne spécifiez aucune langue. Pour plus d'informations sur les langues prises en charge, y compris leurs codes, voir [Ajout de documents dans des langues autres que l'anglais](https://docs.aws.amazon.com/kendra/latest/dg/in-adding-languages.html).
Vous créez des champs personnalisés à l'`DocumentMetadataConfigurationUpdates`aide de l'opération `UpdateIndex` API, comme vous le faites lors de la création d'un champ réservé ou commun. Vous devez définir le type de données approprié pour votre champ personnalisé.
Si vous utilisez la console, vous mettez à jour les champs en sélectionnant votre source de données, en sélectionnant l'action de modification, puis en passant à côté de la section des mappages de champs pour configurer la source de données. Certaines sources de données ne prennent pas en charge l'ajout de nouveaux champs ou de champs personnalisés. Vous ne pouvez pas modifier le type de champ après l'avoir créé.
Les types que vous pouvez définir pour les champs personnalisés sont les suivants :
+ Date
+ Number
+ String
+ Liste de chaînes
Si vous avez ajouté des documents à un index à l'aide de l' fields/attributes opération [BatchPutDocument](https://docs.aws.amazon.com/kendra/latest/APIReference/API_BatchPutDocument.html)API, `Attributes` répertorie vos documents et vous créez des champs à l'aide de l'`DocumentAttribute`objet.
Pour les documents indexés à partir d'une source de Amazon S3 données, vous créez des champs à l'aide d'un [fichier de métadonnées JSON](https://docs.aws.amazon.com/kendra/latest/dg/s3-metadata.html) qui inclut les informations des champs.
Si vous utilisez une base de données prise en charge comme source de données, vous pouvez configurer vos champs à l'aide de l'[option de mappage de champs](https://docs.aws.amazon.com/kendra/latest/dg/data-source-database.html#data-source-procedure-database).
# Récupération de réponses à partir d'index dans Amazon Kendra
Après avoir créé un index, vous pouvez commencer à rechercher vos documents.
Pour rechercher un Amazon Kendra index, vous devez utiliser l'opération d'API [Retrieve](https://docs.aws.amazon.com/kendra/latest/APIReference/API_Retrieve.html) ou l'opération d'API [Query](https://docs.aws.amazon.com/kendra/latest/APIReference/API_Query.html).
L'opération de l'API Retrieve est idéale pour les cas d'utilisation de la génération augmentée de récupération (RAG). Pour une requête donnée, il renvoie une liste classée de passages sémantiquement pertinents contenant jusqu'à 200 mots symboliques. Vous pouvez les envoyer à un grand modèle de langage (LLM) pour générer une réponse à l'aide de RAG. Pour plus d'informations, consultez [la section Recherche dans un index](https://docs.aws.amazon.com/kendra/latest/dg/searching.html).
L'opération Query API est idéale pour les cas d'utilisation de la recherche de documents. Pour une requête donnée, il renvoie une liste de documents classés avec des extraits de 100 mots pertinents pour la requête. Cela est utile pour les cas d'utilisation traditionnels de la recherche de documents où les utilisateurs parcourent une liste de documents classés.
Pour connaître les fonctionnalités prises en charge par les opérations des API Retrieve et Query pour chaque type d'index, consultez la section [Types d'index](https://docs.aws.amazon.com/kendra/latest/dg/hiw-index-types.html).
# Documents
Cette section explique comment Amazon Kendra indexer les nombreux formats de documents pris en charge et les différents fields/attributes documents.
**Topics**
+ [Types ou formats de documents](#index-document-types)
+ [Attributs ou champs du document](#hiw-document-attributes)
## Types ou formats de documents
Amazon Kendra prend en charge les types ou formats de documents courants tels que PDF, HTML PowerPoint, Word, etc. Un index peut contenir plusieurs formats de document.
Amazon Kendra extrait le contenu des documents afin de les rendre consultables. Les documents sont analysés de manière à optimiser la recherche sur le texte extrait et sur tout contenu tabulaire (tableaux HTML) dans les documents. Cela implique de structurer les documents en champs ou attributs utilisés pour la recherche. Les métadonnées du document, telles que la date de dernière modification, peuvent être des champs utiles pour la recherche.
Les documents peuvent être organisés en lignes et en colonnes. Par exemple, chaque document est une ligne et chaque champ/attribut du document, tel que le titre et le corps du contenu, est une colonne. Par exemple, si vous utilisez une base de données comme source de données, les données doivent être structurées ou organisées en lignes et en colonnes.
Vous pouvez ajouter des documents à votre index de différentes manières :
+ API [BatchPutDocument](https://docs.aws.amazon.com/kendra/latest/dg/in-adding-documents.html)
+ [Connecteur de source de données](https://docs.aws.amazon.com/kendra/latest/dg/data-sources.html)
Si vous souhaitez ajouter un fichier de FAQ, vous devez utiliser l'[CreateFaq](https://docs.aws.amazon.com/kendra/latest/dg/in-creating-faq.html)API pour ajouter le fichier stocké dans un Amazon S3 bucket. Vous pouvez choisir entre un format CSV de base, un format CSV qui inclut des éléments personnalisés fields/attributes dans un en-tête et un format JSON qui inclut des champs personnalisés. Le format par défaut est le CSV de base.
Vous trouverez ci-dessous des informations sur chaque format de document pris en charge et sur le traitement Amazon Kendra de chaque format lors de l'indexation de documents.
| Format du document | Traité comme | Comment le document est traité | Structure originale |
| --- | --- | --- | --- |
| Format de document portable (PDF) | HTML | Converti en HTML, puis le contenu est extrait. | Non structuré |
| HyperText Langage de balisage (HTML) | HTML | Les balises HTML sont filtrées pour extraire le contenu. Le contenu doit être compris entre les balises de HTML début et de fermeture principales (content). | Semi-structuré |
| XML (Extensible Markup Language) | xml | Les balises XML sont filtrées pour extraire le contenu. | Semi-structuré |
| Transformation du langage des feuilles de style extensibles (XSLT) | XSLT | Les balises sont filtrées pour extraire le contenu. | Semi-structuré |
| MarkDown (MARYLAND) | Texte brut | Le contenu est extrait avec MarkDown la syntaxe incluse. | Semi-structuré |
| Valeurs séparées par des virgules (CSV) | CSV | Contenu extrait de chaque cellule, avec un seul fichier traité comme un résultat de document unique. | Structuré pour les fichiers FAQ, sinon semi-structuré |
| Microsoft Excel (XLS et XLSX) | XLS et XLSX | Contenu extrait de chaque cellule, avec un seul fichier traité comme un résultat de document unique. | Semi-structuré |
| JavaScript Notation d'objets (JSON) | Texte brut | Le contenu est extrait avec la syntaxe JSON incluse. | Semi-structuré |
| Format de texte enrichi (RTF) | RTF | La syntaxe RTF est filtrée pour extraire le contenu. | Semi-structuré |
| Microsoft PowerPoint (PPT) | PPT, PPTX | Seul le contenu textuel est extrait des PowerPoint diapositives à des fins de recherche. Les images et autres contenus ne sont pas extraits. | Non structuré |
| Microsoft Word | DOC, DOCX | Seul le contenu textuel est extrait des pages Word à des fins de recherche. Les images et autres contenus ne sont pas extraits. | Non structuré |
| Texte brut (TXT) | TXT | Tout le texte du document texte est extrait. | Non structuré |
## Attributs ou champs du document
Des attributs ou des champs sont associés à un document. Les champs d'un document sont les propriétés d'un document ou le contenu de sa structure. Par exemple, chacun de vos documents peut contenir le titre, le corps du texte et l'auteur. Vous pouvez également ajouter des champs personnalisés pour vos documents spécifiques. Par exemple, si votre index recherche des documents fiscaux, vous pouvez spécifier un champ personnalisé pour le type de document fiscal tel que W-2, 1099, etc.
Avant de pouvoir utiliser un champ de document dans une requête, il doit être mappé à un champ d'index. Par exemple, le champ de titre peut être mappé au champ`_document_title`. Pour plus d'informations, consultez la section [Mappage des champs](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). Pour ajouter un nouveau champ, vous devez créer un champ d'index auquel mapper le champ. Vous créez des champs d'index à l'aide de la console ou de l'[UpdateIndex](https://docs.aws.amazon.com/kendra/latest/APIReference/API_UpdateIndex.html)API.
Vous pouvez utiliser les champs du document pour filtrer les réponses et créer des résultats de recherche à facettes. Par exemple, vous pouvez filtrer une réponse pour renvoyer uniquement une version spécifique d'un document, ou vous pouvez filtrer les recherches pour ne renvoyer que les documents fiscaux de type 1099 correspondant au terme de recherche. Pour plus d'informations, consultez la section [Filtrage et recherche par facettes](https://docs.aws.amazon.com/kendra/latest/dg/filtering.html).
Vous pouvez également utiliser les champs du document pour ajuster manuellement la réponse à la requête. Par exemple, vous pouvez choisir d'augmenter l'importance du champ de titre pour augmenter le poids qui lui est Amazon Kendra attribué lors de la détermination des documents à renvoyer dans la réponse. Pour plus d'informations, consultez la section [Optimisation de la pertinence de la recherche](https://docs.aws.amazon.com/kendra/latest/dg/tuning.html).
Si vous ajoutez un document directement à un index, vous devez spécifier les champs dans le paramètre d'entrée [Document](https://docs.aws.amazon.com/kendra/latest/APIReference/API_Document.html) de l'[BatchPutDocument](https://docs.aws.amazon.com/kendra/latest/APIReference/API_BatchPutDocument.html)API. Vous spécifiez les valeurs des champs personnalisés dans un tableau d'[DocumentAttribute](https://docs.aws.amazon.com/kendra/latest/APIReference/API_DocumentAttribute.html)objets. Si vous utilisez une source de données, la méthode que vous utilisez pour ajouter les champs du document dépend de la source de données. Pour plus d’informations, consultez [Mappage des champs de source de données](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html).
### Utilisation de champs de document Amazon Kendra réservés ou communs
Avec l'[UpdateIndex API](https://docs.aws.amazon.com/kendra/latest/APIReference/API_UpdateIndex.html), vous pouvez créer des champs réservés ou communs en utilisant `DocumentMetadataConfigurationUpdates` et en spécifiant le nom du champ d'index Amazon Kendra réservé à mapper à votre attribute/field nom de document équivalent. Vous pouvez également créer des champs personnalisés. Si vous utilisez un connecteur de source de données, la plupart incluent des mappages de champs qui font correspondre les champs de votre document de source de données aux champs d' Amazon Kendra index. Si vous utilisez la console, vous mettez à jour les champs en sélectionnant votre source de données, en sélectionnant l'action de modification, puis en passant à côté de la section des mappages de champs pour configurer la source de données.
Vous pouvez configurer l'`Search`objet pour définir un champ comme affichable, facetable, consultable ou triable. Vous pouvez configurer l'`Relevance`objet pour définir l'ordre de classement d'un champ, la durée d'augmentation ou la période à appliquer aux valeurs de renforcement, de fraîcheur, de valeur d'importance et d'importance mappées à des valeurs de champ spécifiques. Si vous utilisez la console, vous pouvez définir les paramètres de recherche d'un champ en sélectionnant l'option à facettes dans le menu de navigation. Pour définir le réglage de la pertinence, sélectionnez l'option permettant de rechercher votre index dans le menu de navigation, entrez une requête et utilisez les options du panneau latéral pour ajuster la pertinence de la recherche. Vous ne pouvez pas modifier le type de champ une fois que vous l'avez créé.
Amazon Kendra possède les champs de document réservés ou communs suivants que vous pouvez utiliser :
+ `_authors`—Une liste d'un ou de plusieurs auteurs responsables du contenu du document.
+ `_category`: catégorie qui place un document dans un groupe spécifique.
+ `_created_at`: date et heure au format ISO 8601 auxquelles le document a été créé. Par exemple, 2012-03-25T12:30:10\$101:00 est le format de date et d'heure ISO 8601 pour le 25 mars 2012 à 12 h 30 (plus 10 secondes) à l'heure d'Europe centrale.
+ `_data_source_id`: identifiant de la source de données contenant le document.
+ `_document_body`: le contenu du document.
+ `_document_id`—Un identifiant unique pour le document.
+ `_document_title`: le titre du document.
+ `_excerpt_page_number`: le numéro de page d'un fichier PDF où apparaît l'extrait du document. Si votre index a été créé avant le 8 septembre 2020, vous devez réindexer vos documents avant de pouvoir utiliser cet attribut.
+ `_faq_id`—S'il s'agit d'un document de type question-réponse (FAQ), un identifiant unique pour la FAQ.
+ `_file_type`: le type de fichier du document, tel que pdf ou doc.
+ `_last_updated_at`: date et heure au format ISO 8601 auxquelles le document a été mis à jour pour la dernière fois. Par exemple, 2012-03-25T12:30:10\$101:00 est le format de date et d'heure ISO 8601 pour le 25 mars 2012 à 12 h 30 (plus 10 secondes) à l'heure d'Europe centrale.
+ `_source_uri`: l'URI où le document est disponible. Par exemple, l’URI du document sur le site Web d’une entreprise.
+ `_version`—Identifiant pour la version spécifique d'un document.
+ `_view_count`: le nombre de fois que le document a été consulté.
+ `_language_code`(String) : code d'une langue qui s'applique au document. La valeur par défaut est l'anglais si vous ne spécifiez aucune langue. Pour plus d'informations sur les langues prises en charge, y compris leurs codes, voir [Ajout de documents dans des langues autres que l'anglais](https://docs.aws.amazon.com/kendra/latest/dg/in-adding-languages.html).
Pour les champs personnalisés, vous pouvez les créer à l'`DocumentMetadataConfigurationUpdates`aide de l'`UpdateIndex`API, comme vous le faites lorsque vous créez un champ réservé ou commun. Vous devez définir le type de données approprié pour votre champ personnalisé. Si vous utilisez la console, vous mettez à jour les champs en sélectionnant votre source de données, en sélectionnant l'action de modification, puis en passant à côté de la section des mappages de champs pour configurer la source de données. Certaines sources de données ne prennent pas en charge l'ajout de nouveaux champs ou de champs personnalisés. Vous ne pouvez pas modifier le type de champ une fois que vous l'avez créé.
Les types que vous pouvez définir pour les champs personnalisés sont les suivants :
+ Date
+ Number
+ String
+ Liste de chaînes
Si vous avez ajouté des documents à l'index à l'aide fields/attributes de l'[BatchPutDocument](https://docs.aws.amazon.com/kendra/latest/APIReference/API_BatchPutDocument.html)API, `Attributes` répertorie vos documents et créez des champs à l'aide de l'`DocumentAttribute`objet.
Pour les documents indexés à partir d'une source de Amazon S3 données, vous créez des champs à l'aide d'un [fichier de métadonnées JSON](https://docs.aws.amazon.com/kendra/latest/dg/s3-metadata.html) qui inclut les informations des champs.
Si vous utilisez une base de données prise en charge comme source de données, vous pouvez configurer vos champs à l'aide de l'[option de mappage de champs](https://docs.aws.amazon.com/kendra/latest/dg/data-source-database.html#data-source-procedure-database).
# Sources de données
Une source de données est un référentiel ou un emplacement de données qui Amazon Kendra se connecte à vos documents ou à votre contenu et les indexe. Par exemple, vous pouvez configurer pour vous connecter Amazon Kendra à Microsoft SharePoint afin d'explorer et d'indexer vos documents stockés dans cette source. Vous pouvez également indexer des pages Web en fournissant le URLs formulaire Amazon Kendra à explorer. Vous pouvez synchroniser automatiquement une source de données avec un Amazon Kendra index afin que les documents ajoutés, mis à jour ou supprimés dans la source de données soient également ajoutés, mis à jour ou supprimés dans l'index.
Les sources de données prises en charge sont les suivantes :
+ [Gestionnaire d'expérience Adobe](https://docs.aws.amazon.com/kendra/latest/dg/data-source-aem.html)
+ [En plein air](https://docs.aws.amazon.com/kendra/latest/dg/data-source-alfresco.html)
+ [Aurora (MySQL)](https://docs.aws.amazon.com/kendra/latest/dg/data-source-aurora-mysql.html)
+ [Aurora (PostgreSQL)](https://docs.aws.amazon.com/kendra/latest/dg/data-source-aurora-postgresql.html)
+ [Amazon FSx (Fenêtres)](https://docs.aws.amazon.com/kendra/latest/dg/data-source-fsx.html)
+ [Amazon FSx (NetApp ONTAP)](https://docs.aws.amazon.com/kendra/latest/dg/data-source-fsx-ontap.html)
+ [Sources de données de base de données](https://docs.aws.amazon.com/kendra/latest/dg/data-source-database.html)
+ [Amazon RDS (Microsoft SQL Server)](https://docs.aws.amazon.com/kendra/latest/dg/data-source-rds-ms-sql-server.html)
+ [Amazon RDS (MySQL)](https://docs.aws.amazon.com/kendra/latest/dg/data-source-rds-mysql.html)
+ [Amazon RDS (Oracle)](https://docs.aws.amazon.com/kendra/latest/dg/data-source-rds-oracle.html)
+ [Amazon RDS (PostgreSQL)](https://docs.aws.amazon.com/kendra/latest/dg/data-source-rds-postgresql.html)
+ [Amazon S3 seaux](https://docs.aws.amazon.com/kendra/latest/dg/data-source-s3.html)
+ [Amazon Kendra Explorateur Web](https://docs.aws.amazon.com/kendra/latest/dg/data-source-web-crawler.html)
+ [Box](https://docs.aws.amazon.com/kendra/latest/dg/data-source-box.html)
+ [Confluence](https://docs.aws.amazon.com/kendra/latest/dg/data-source-confluence.html)
+ [Sources de données personnalisées](https://docs.aws.amazon.com/kendra/latest/dg/data-source-custom.html)
+ [Dropbox](https://docs.aws.amazon.com/kendra/latest/dg/data-source-dropbox.html)
+ [Drupal](https://docs.aws.amazon.com/kendra/latest/dg/data-source-drupal.html)
+ [GitHub](https://docs.aws.amazon.com/kendra/latest/dg/data-source-github.html)
+ [Gmail](https://docs.aws.amazon.com/kendra/latest/dg/data-source-gmail.html)
+ [Disques durs Google Workspace](https://docs.aws.amazon.com/kendra/latest/dg/data-source-google-drive.html)
+ [IBM DB2](https://docs.aws.amazon.com/kendra/latest/dg/data-source-ibm-db2.html)
+ [Jira](https://docs.aws.amazon.com/kendra/latest/dg/data-source-jira.html)
+ [Microsoft Exchange](https://docs.aws.amazon.com/kendra/latest/dg/data-source-exchange.html)
+ [Microsoft OneDrive](https://docs.aws.amazon.com/kendra/latest/dg/data-source-onedrive.html)
+ [Microsoft SharePoint](https://docs.aws.amazon.com/kendra/latest/dg/data-source-sharepoint.html)
+ [Microsoft Teams](https://docs.aws.amazon.com/kendra/latest/dg/data-source-teams.html)
+ [Microsoft SQL Server](https://docs.aws.amazon.com/kendra/latest/dg/data-source-ms-sql-server.html)
+ [Microsoft Yammer](https://docs.aws.amazon.com/kendra/latest/dg/data-source-yammer.html)
+ [MySQL](https://docs.aws.amazon.com/kendra/latest/dg/data-source-mysql.html)
+ [Base de données Oracle](https://docs.aws.amazon.com/kendra/latest/dg/data-source-oracle-database.html)
+ [PostgreSQL](https://docs.aws.amazon.com/kendra/latest/dg/data-source-postgresql.html)
+ [Quip](https://docs.aws.amazon.com/kendra/latest/dg/data-source-quip.html)
+ [Salesforce](https://docs.aws.amazon.com/kendra/latest/dg/data-source-salesforce.html)
+ [ServiceNow](https://docs.aws.amazon.com/kendra/latest/dg/data-source-servicenow.html)
+ [Slack](https://docs.aws.amazon.com/kendra/latest/dg/data-source-slack.html)
+ [Zendesk](https://docs.aws.amazon.com/kendra/latest/dg/data-source-zendesk.html)
Pour une liste des types de documents ou des formats pris en charge par la Amazon Kendra section [Types de documents](https://docs.aws.amazon.com/kendra/latest/dg/index-document-types.html). Vous devez d'abord créer un index avant de créer un connecteur de source de données pour indexer vos documents à partir de votre source de données.
**Note**
Pour créer un index de documents, il n'est pas nécessaire d'utiliser une source de données. Vous pouvez ajouter des documents directement à un index grâce au téléchargement par lots. Pour plus d'informations, voir [Ajouter des documents directement à un index](https://docs.aws.amazon.com/kendra/latest/dg/in-adding-documents.html).
Pour une présentation détaillée de l'utilisation de la Amazon Kendra console, de la AWS CLI ou SDKs consultez [Getting started](https://docs.aws.amazon.com/kendra/latest/dg/getting-started.html).
# Requêtes
Pour obtenir des réponses, les utilisateurs interrogent un index. Les utilisateurs peuvent utiliser le langage naturel dans leurs requêtes. La réponse contient des informations, telles que le titre, un extrait de texte et l'emplacement des documents dans l'index qui fournissent la meilleure réponse.
Amazon Kendra utilise toutes les informations que vous fournissez sur vos documents, et pas seulement le contenu des documents, pour déterminer si un document est pertinent pour la requête. Par exemple, si votre index contient des informations sur la date de dernière mise à jour des documents, vous pouvez indiquer Amazon Kendra d'attribuer une plus grande pertinence aux documents mis à jour plus récemment.
Une requête peut également contenir des critères permettant de filtrer la réponse afin que Amazon Kendra seuls les documents qui répondent aux critères de filtrage soient renvoyés. Par exemple, si vous avez créé un champ d'index appelé *département*, vous pouvez filtrer la réponse afin que seuls les documents dont le champ département est défini sur *légal* soient renvoyés. Pour plus d'informations, consultez la section [Filtrage de la recherche](https://docs.aws.amazon.com/kendra/latest/dg/filtering.html).
Vous pouvez influencer les résultats d'une requête en ajustant la pertinence des différents champs de l'index. Le réglage modifie l'importance d'un champ sur les résultats. Par exemple, si vous soulignez l'importance des documents avec la catégorie *nouveau*, les documents de cette catégorie sont plus susceptibles d'être inclus dans la réponse. Pour plus d'informations, consultez la section [Optimisation de la pertinence de la recherche](https://docs.aws.amazon.com/kendra/latest/dg/tuning.html).
Pour plus d'informations sur l'utilisation des requêtes, voir [Recherche dans un index](https://docs.aws.amazon.com/kendra/latest/dg/searching.html).
# Étiquettes
Gérez vos index, vos sources de données et FAQs en attribuant des balises ou des étiquettes. Vous pouvez utiliser des balises pour classer vos Amazon Kendra ressources de différentes manières. Par exemple, par objectif, par propriétaire ou par application, ou par une combinaison quelconque. Chaque balise est constituée d’une *clé* et d’une *valeur* que vous définissez toutes deux.
Les balises vous aident à :
+ Identifiez et organisez vos AWS ressources. De nombreux AWS services prennent en charge le balisage. Vous pouvez donc attribuer le même tag aux ressources de différents services pour indiquer que les ressources sont liées. Par exemple, vous pouvez attribuer la même balise à un index et au Amazon Lex bot qui l'utilise.
+ Répartir les coûts. Vous activez les tags sur le AWS Billing and Cost Management tableau de bord. AWS utilise des balises pour classer vos coûts et vous fournir un rapport mensuel de répartition des coûts. Pour plus d'informations, consultez la section [Allocation et balisage des coûts](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) dans *About AWS Billing and Cost Management*.
+ Contrôler l'accès à vos ressources . Vous pouvez utiliser des balises dans les politiques Gestion des identités et des accès AWS (IAM) qui contrôlent l'accès aux Amazon Kendra ressources. Vous pouvez associer ces politiques à un IAM rôle ou à un utilisateur pour activer le contrôle d'accès basé sur des balises. Pour plus d’informations, consultez [Autorisation basée sur les balises](https://docs.aws.amazon.com/kendra/latest/dg/security_iam_service-with-iam.html#security_iam_service-with-iam-tags).
Vous pouvez créer et gérer des balises à l'aide de l'API AWS Management Console, de la AWS Command Line Interface (AWS CLI) ou de l' Amazon Kendra API.
## Balisage de ressources
Si vous utilisez la Amazon Kendra console, vous pouvez étiqueter les ressources lorsque vous les créez ou les ajoutez ultérieurement. Vous pouvez également utiliser la console pour mettre à jour ou supprimer des balises.
Si vous utilisez le AWS Command Line Interface (AWS CLI) ou l' Amazon Kendra API, utilisez les opérations suivantes pour gérer les balises de vos ressources :
+ [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html)—Appliquez des balises lorsque vous créez une source de données.
+ [CreateFaq](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateFaq.html)—Appliquez des balises lorsque vous créez une FAQ.
+ [CreateIndex](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateIndex.html)—Appliquez des balises lorsque vous créez un index.
+ [ListTagsForResource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_ListTagsForResource.html)—Afficher les balises associées à une ressource.
+ [TagResource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TagResource.html)—Ajoutez et modifiez les balises d'une ressource.
+ [UntagResource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_UntagResource.html)—Supprime les balises d'une ressource.
## Restrictions liées aux étiquettes
Les restrictions suivantes s'appliquent aux balises sur les Amazon Kendra ressources :
+ Nombre maximum de balises : 50
+ Longueur de clé maximale : 128 caractères
+ Longueur maximale de la valeur : 256 caractères
+ Caractères valides pour la clé et la valeur : a—z, A—Z, espace, et les caractères suivants : \$1. :/= \$1 - et @
+ Les clés et les valeurs distinguent les majuscules et minuscules
+ N’utilisez pas `aws:` comme préfixe pour les clés ; seul AWS peut utiliser cette valeur.