Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Come Amazon Kendra funziona
Amazon Kendra fornisce funzionalità di ricerca e recupero di generazione aumentata (RAG) per l'applicazione. Indicizza i documenti direttamente o da un archivio di documenti di terze parti e fornisce in modo intelligente le informazioni pertinenti agli utenti. È possibile utilizzarlo Amazon Kendra per creare un indice aggiornabile di documenti di vari tipi. Per un elenco dei tipi di documenti supportati da Amazon Kendra, vedere [Tipi di documenti](https://docs.aws.amazon.com/kendra/latest/dg/index-document-types.html).
Amazon Kendra si integra con altri servizi. Puoi collegare un indice Amazon Kendra GenAI Enterprise Edition [Amazon Q Business](https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/what-is.html)e [Amazon](https://docs.aws.amazon.com/bedrock/latest/userguide/what-is-bedrock.html) Bedrock per creare la tua soluzione di chat RAG. In alternativa, puoi potenziare i [Amazon Lex chatbot](https://docs.aws.amazon.com/lexv2/latest/dg/faq-bot-kendra-search.html) con la funzione di Amazon Kendra ricerca per fornire risposte utili alle domande degli utenti. Puoi anche usare un [Amazon Simple Storage Service bucket](https://docs.aws.amazon.com/kendra/latest/dg/data-source-s3.html) come fonte di dati per Amazon Kendra connetterti e indicizzare i tuoi documenti.
Amazon Kendra ha i seguenti componenti:
+ Un [https://docs.aws.amazon.com//kendra/latest/dg/create-index.html](https://docs.aws.amazon.com//kendra/latest/dg/create-index.html) che contiene i documenti e li rende ricercabili.
+ Una [https://docs.aws.amazon.com/kendra/latest/dg/data-source.html](https://docs.aws.amazon.com/kendra/latest/dg/data-source.html) che archivia i documenti e a cui Amazon Kendra si connette. Puoi sincronizzare automaticamente un'origine dati con un Amazon Kendra indice in modo che l'indice rimanga aggiornato con l'archivio di origine.
+ Un'[https://docs.aws.amazon.com/kendra/latest/dg/in-adding-documents.html](https://docs.aws.amazon.com/kendra/latest/dg/in-adding-documents.html) che aggiunge documenti direttamente a un indice.
+ Un'[https://docs.aws.amazon.com/kendra/latest/APIReference/API_Retrieve.html](https://docs.aws.amazon.com/kendra/latest/APIReference/API_Retrieve.html) i passaggi o gli estratti di testo pertinenti a seguito di una query di input.
+ Un'[https://docs.aws.amazon.com/kendra/latest/APIReference/API_Query.html](https://docs.aws.amazon.com/kendra/latest/APIReference/API_Query.html) che cerca un indice in base a una query di input.
È possibile utilizzare Amazon Kendra tramite la console o l'API. Puoi creare, aggiornare ed eliminare indici. L'eliminazione di un indice comporta l'eliminazione di tutti i relativi connettori di origine dati e l'eliminazione definitiva di tutte le informazioni relative al documento. Amazon Kendra
**Topics**
+ [Indici in Amazon Kendra](hiw-index.md)
+ [Documenti](hiw-documents.md)
+ [Origini dati](hiw-data-source.md)
+ [Query](hiw-query.md)
+ [Tag](tagging.md)
# Indici in Amazon Kendra
Un indice contiene il contenuto dei tuoi documenti ed è strutturato in modo da renderli ricercabili. Questa sezione fornisce una panoramica dei tipi di indice supportati e delle funzionalità degli indici.
**Topics**
+ [Tipi di indice in Amazon Kendra](hiw-index-types.md)
+ [Aggiungere documenti a un indice in Amazon Kendra](hiw-index-adding-docs.md)
+ [Utilizzo di campi di Amazon Kendra documento riservati o comuni](index-reserved-fields-hiw.md)
+ [Recupero delle risposte dagli indici in Amazon Kendra](index-searching.md)
# Tipi di indice in Amazon Kendra
Amazon Kendra ha tre tipi di indice: indice GenAI Enterprise Edition, indice Enterprise Edition e indice Developer Edition. Le seguenti sezioni descrivono le caratteristiche di ciascun indice.
**Topics**
+ [Indice Amazon Kendra GenAI Enterprise Edition](#kendra-gen-ai-index)
+ [Indice Amazon Kendra Enterprise Edition](#kendra-enterprise-index)
+ [Indice Amazon Kendra Developer Edition](#kendra-developer-index)
## Indice Amazon Kendra GenAI Enterprise Edition
Un indice Amazon Kendra GenAI Enterprise Edition offre la massima precisione per il funzionamento dell'API Retrieve e per i casi d'uso di Retrieval Augmented Generation (RAG). È basato sulle più recenti tecnologie di recupero delle informazioni, come la ricerca ibrida (parole chiave e vettori), l'incorporamento semantico e i modelli di riordinamento, ed è stato testato su una varietà di set di dati. L'operazione Query API offre una precisione simile per un indice Amazon Kendra GenAI Enterprise Edition rispetto agli indici Amazon Kendra Developer Edition e Amazon Kendra Enterprise Edition.
Un indice Amazon Kendra GenAI Enterprise Edition consente la mobilità dei dati indicizzati tra servizi di intelligenza artificiale generativa. AWS Con questa funzionalità, puoi riutilizzare senza problemi i tuoi investimenti senza dover ricostruire gli indici. Puoi utilizzarlo in una [knowledge base di Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/userguide/knowledge-base.html) come managed retriever e integrarlo con strumenti di Amazon Bedrock come agenti e flussi di prompt per creare assistenti AI avanzati. Puoi anche usarlo con un assistente digitale completamente [Amazon Q Business](https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/what-is.html)gestito.
Un indice Amazon Kendra GenAI Enterprise Edition offre unità con capacità più piccola e più granulare e un prezzo iniziale inferiore rispetto agli altri due tipi di indice. Questo ti aiuta a essere più efficiente nell'utilizzo della capacità.
**Nota**
Per un'esperienza e una precisione ottimali, ti consigliamo di scegliere un indice Amazon Kendra GenAI Enterprise Edition.
**Topics**
+ [Funzionalità supportate](#kendra-gen-ai-index-features)
+ [Limitazioni](#genai-index-limitations)
### Funzionalità supportate
Le seguenti funzionalità sono supportate per un indice Amazon Kendra GenAI Enterprise Edition se utilizzi l'operazione dell'API Retrieve per [i](https://docs.aws.amazon.com/kendra/latest/APIReference/API_Retrieve.html) casi d'uso RAG:
+ **Supporto completo: elenchi** [https://docs.aws.amazon.com/kendra/latest/dg/custom-attributes.html](https://docs.aws.amazon.com/kendra/latest/dg/custom-attributes.html)
+ **Supporto parziale** [https://docs.aws.amazon.com/kendra/latest/dg/data-source.html](https://docs.aws.amazon.com/kendra/latest/dg/data-source.html) Per ulteriori informazioni sulle funzionalità parzialmente supportate, consulta [Limitazioni](https://docs.aws.amazon.com/kendra/latest/dg/hiw-index-types.html#genai-index-limitations).
Le seguenti funzionalità sono supportate per un indice Amazon Kendra GenAI Enterprise Edition se utilizzi [l'](https://docs.aws.amazon.com/kendra/latest/APIReference/API_Query.html)operazione Query API per casi d'uso di ricerca:
+ **Supporto completo**: [classificazione dei documenti](https://docs.aws.amazon.com/kendra/latest/dg/search-service-rerank.html), [risposta estrattiva alle domande](https://docs.aws.amazon.com/kendra/latest/dg/searching-example.html), intervalli di [punteggi di confidenza](https://docs.aws.amazon.com/kendra/latest/APIReference/API_QueryResultItem.html#Kendra-Type-QueryResultItem-ScoreAttributes), [filtraggio](https://docs.aws.amazon.com/kendra/latest/dg/filtering.html), [sfaccettatura](https://docs.aws.amazon.com/kendra/latest/dg/filtering.html#search-facets)[, ordinamento](https://docs.aws.amazon.com/kendra/latest/dg/tuning-sorting-responses.html#sorting-responses), [compressione ed espansione dei risultati delle query](https://docs.aws.amazon.com/kendra/latest/dg/expand-collapse-query-results.html), [navigazione nell'indice](https://docs.aws.amazon.com/kendra/latest/dg/browsing.html), [query booleane](https://docs.aws.amazon.com/kendra/latest/dg/searching-example.html#searching-index-query-syntax), [corrispondenza esatta](https://docs.aws.amazon.com/kendra/latest/dg/searching-example.html#searching-index-query-syntax), [query jolly, [suggerimenti di query](https://docs.aws.amazon.com/kendra/latest/dg/query-suggestions.html)[, correttore ortografico](https://docs.aws.amazon.com/kendra/latest/dg/query-spell-check.html) delle](https://docs.aws.amazon.com/kendra/latest/dg/searching-example.html#searching-index-query-syntax) query, [ottimizzazione della pertinenza](https://docs.aws.amazon.com/kendra/latest/dg/tuning.html), [apprendimento incrementale](https://docs.aws.amazon.com/kendra/latest/dg/submitting-feedback.html), [documento personalizzato ](https://docs.aws.amazon.com/kendra/latest/dg/custom-document-enrichment.html)[arricchimento[, metadati](https://docs.aws.amazon.com/kendra/latest/dg/adjusting-capacity.html) personalizzati, [regolazione](https://docs.aws.amazon.com/kendra/latest/dg/deploying.html) della capacità di interrogazione e della capacità dei documenti ed esperienza di ricerca.](https://docs.aws.amazon.com/kendra/latest/dg/custom-attributes.html)
+ **Supporto parziale**: [connettori di origine dati](https://docs.aws.amazon.com/kendra/latest/dg/data-source.html) e filtraggio del contesto [utente](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html). Per ulteriori informazioni sulle funzionalità parzialmente supportate, consulta [Limitazioni](https://docs.aws.amazon.com/kendra/latest/dg/hiw-index-types.html#kendra-gen-ai-index).
### Limitazioni
Di seguito sono descritte le limitazioni note di un indice Amazon Kendra GenAI Enterprise Edition:
+ Gli indici Amazon Kendra GenAI Enterprise Edition sono disponibili solo negli Stati Uniti orientali (Virginia settentrionale) e negli Stati Uniti occidentali (Oregon).
+ Gli indici Amazon Kendra GenAI Enterprise Edition supportano solo contenuti in lingua inglese.
+ Gli indici Amazon Kendra GenAI Enterprise Edition supportano solo i connettori di origine dati Amazon Kendra v2.0.
+ In un indice Amazon Kendra GenAI Enterprise Edition, puoi [utilizzare solo gli attributi utente per filtrare i risultati della ricerca in base al contesto dell'utente](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-attribute).
+ Gli indici Amazon Kendra GenAI Enterprise Edition non [supportano il controllo dell'accesso utente basato su token o il controllo dell'accesso utente ai documenti basato su](https://docs.aws.amazon.com/kendra/latest/dg/create-index-access-control.html) [ID utente](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources) e gruppo.
+ Il funzionamento dell'[CreateAccessControlConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateAccessControlConfiguration.html)API è disabilitato per gli indici Amazon Kendra GenAI Enterprise Edition.
+ Se utilizzi un indice Amazon Kendra GenAI Enterprise Edition Amazon Q Business con, tieni presente quanto segue sul controllo dell'accesso degli utenti finali ai documenti:
Amazon Q Business utilizza l'ID e-mail dell'utente per determinare l'accesso dell'utente finale ai documenti in un indice. Quando colleghi un indice Amazon Kendra Amazon Q Business a Amazon Q Business , inoltra l'ID e-mail identificativo dell'utente ad Amazon Kendra per abilitare il filtraggio dei documenti per gli utenti finali. Se le fonti di dati collegate al tuo indice Amazon Kendra non utilizzano il filtro dei documenti basato sull'ID e-mail o l'ID e-mail non è presente Amazon Q Business , genera risposte solo da documenti pubblici.
## Indice Amazon Kendra Enterprise Edition
Un indice Amazon Kendra Enterprise Edition offre funzionalità di ricerca semantica e offre un servizio ad alta disponibilità adatto ai carichi di lavoro di produzione.
**Topics**
+ [Funzionalità supportate](#kendra-ent-index-features)
+ [Limitazioni](#ent-index-limitations)
### Funzionalità supportate
[https://docs.aws.amazon.com/kendra/latest/dg/query-suggestions.html](https://docs.aws.amazon.com/kendra/latest/dg/query-suggestions.html)
Tutte le funzionalità sono supportate per un indice Amazon Kendra Enterprise Edition se utilizzi [l'](https://docs.aws.amazon.com/kendra/latest/APIReference/API_Query.html)operazione Query API per casi d'uso di ricerca.
### Limitazioni
Di seguito sono descritte le limitazioni note di un indice Amazon Kendra Enterprise Edition:
+ Se utilizzi un indice Amazon Kendra Enterprise Edition Amazon Q Business con, tieni presente quanto segue sul controllo dell'accesso degli utenti finali ai documenti:
Amazon Q Business utilizza l'ID e-mail dell'utente per determinare l'accesso dell'utente finale ai documenti in un indice. Quando colleghi un indice Amazon Kendra Amazon Q Business a Amazon Q Business , inoltra l'ID e-mail identificativo dell'utente ad Amazon Kendra per abilitare il filtraggio dei documenti per gli utenti finali. Se le fonti di dati collegate al tuo indice Amazon Kendra non utilizzano il filtro dei documenti basato sull'ID e-mail o l'ID e-mail non è presente Amazon Q Business , genera risposte solo da documenti pubblici.
## Indice Amazon Kendra Developer Edition
Un indice Amazon Kendra Developer Edition fornisce anche funzionalità di ricerca semantica per testare i tuoi casi d'uso. Tuttavia, non lo consigliamo per casi d'uso in produzione.
**Topics**
+ [Funzionalità supportate](#kendra-dev-index-features)
+ [Limitazioni](#dev-index-limitations)
### Funzionalità supportate
[https://docs.aws.amazon.com/kendra/latest/dg/query-suggestions.html](https://docs.aws.amazon.com/kendra/latest/dg/query-suggestions.html)
Tutte le funzionalità sono supportate per un indice Amazon Kendra Developer Edition se utilizzi [l'](https://docs.aws.amazon.com/kendra/latest/APIReference/API_Query.html)operazione Query API per casi d'uso di ricerca.
### Limitazioni
Di seguito sono descritte le limitazioni note di un indice Amazon Kendra Developer Edition:
+ Se utilizzi un indice Amazon Kendra Developer Edition Amazon Q Business con, tieni presente quanto segue sul controllo dell'accesso degli utenti finali ai documenti:
Amazon Q Business utilizza l'ID e-mail dell'utente per determinare l'accesso dell'utente finale ai documenti in un indice. Quando colleghi un indice Amazon Kendra Amazon Q Business a Amazon Q Business , inoltra l'ID e-mail identificativo dell'utente ad Amazon Kendra per abilitare il filtraggio dei documenti per gli utenti finali. Se le fonti di dati collegate al tuo indice Amazon Kendra non utilizzano il filtro dei documenti basato sull'ID e-mail o l'ID e-mail non è presente Amazon Q Business , genera risposte solo da documenti pubblici.
# Aggiungere documenti a un indice in Amazon Kendra
Il modo in cui aggiungi documenti a un indice dipende da come vengono archiviati i documenti.
+ Se si archiviano i documenti in un tipo di archivio, ad esempio un Amazon S3 bucket o un SharePoint sito Microsoft, si utilizza un [connettore di origine dati](https://docs.aws.amazon.com/kendra/latest/dg/data-source.html) per indicizzare i documenti dal repository.
+ Se non archiviate i documenti in un archivio, utilizzate l'operazione [BatchPutDocument](https://docs.aws.amazon.com/kendra/latest/APIReference/API_BatchPutDocument.html)API per indicizzare direttamente i documenti.
+ Per le domande e le risposte alle FAQ, che devono essere archiviate in un bucket Amazon Kendra (Amazon S3), le carichi dal bucket.
Puoi creare indici con la Amazon Kendra console, il AWS CLI o un SDK. AWS [Per informazioni sui tipi di documenti che possono essere indicizzati, consulta Tipi di documento.](https://docs.aws.amazon.com/kendra/latest/dg/index-document-types.html)
# Utilizzo di campi di Amazon Kendra documento riservati o comuni
Con l'operazione [UpdateIndex](https://docs.aws.amazon.com/kendra/latest/APIReference/API_UpdateIndex.html)API, puoi creare campi riservati o comuni. A tale scopo`DocumentMetadataConfigurationUpdates`, utilizzate e specificate il nome del campo indice Amazon Kendra riservato da mappare al attribute/field nome del documento equivalente. È inoltre possibile creare campi personalizzati.
Se utilizzi un connettore di origine dati, la maggior parte include mappature di campi che mappano i campi del documento di origine dati ai campi Amazon Kendra indice. Se utilizzi la console, aggiorni i campi selezionando l'origine dati, selezionando l'azione di modifica e quindi procedendo accanto alla sezione delle mappature dei campi per configurare l'origine dati.
Puoi configurare l'`Search`oggetto per impostare un campo come visualizzabile, personalizzabile, ricercabile e ordinabile. È possibile configurare l'`Relevance`oggetto in modo da impostare l'ordine di classificazione, la durata dell'incremento o il periodo di tempo di un campo da applicare al valore di potenziamento, freschezza, importanza e ai valori di importanza mappati a valori di campo specifici.
Se utilizzi la console, puoi configurare le impostazioni di ricerca per un campo selezionando l'opzione facet nel menu di navigazione. Per impostare l'ottimizzazione della pertinenza, seleziona l'opzione di ricerca nell'indice nel menu di navigazione, inserisci una query e utilizza le opzioni del pannello laterale per regolare la pertinenza della ricerca. Non è possibile modificare il tipo di campo dopo averlo creato.
Amazon Kendracontiene i seguenti campi di documento riservati o comuni che puoi utilizzare:
+ `_authors`: un elenco di uno o più autori responsabili del contenuto del documento.
+ `_category`: una categoria che colloca un documento in un gruppo specifico.
+ `_created_at`: la data e l’ora di creazione del documento, nel formato ISO 8601. Ad esempio, 2012-03-25T 12:30:10 \$1 01:00 è il formato data-ora ISO 8601 per il 25 marzo 2012 alle 12:30 (più 10 secondi) nell'ora dell'Europa centrale.
+ `_data_source_id`: l’identificatore dell’origine dati che contiene il documento.
+ `_document_body`: il contenuto del documento.
+ `_document_id`: l’identificatore univoco per un documento.
+ `_document_title`: il titolo del documento.
+ `_excerpt_page_number`— Il numero di pagina in un file PDF in cui viene visualizzato l'estratto del documento. Se l'indice è stato creato prima dell'8 settembre 2020, è necessario reindicizzare i documenti prima di poter utilizzare questo attributo.
+ `_faq_id`— Se si tratta di un documento di tipo domanda-risposta (FAQ), un identificatore univoco per le domande frequenti.
+ `_file_type`— Il tipo di file del documento, ad esempio pdf o doc.
+ `_last_updated_at`: la data e l’ora dell’ultimo aggiornamento del documento, nel formato ISO 8601. Ad esempio, 2012-03-25T 12:30:10 \$1 01:00 è il formato data-ora ISO 8601 per il 25 marzo 2012 alle 12:30 (più 10 secondi) nell'ora dell'Europa centrale.
+ `_source_uri`— L'URI in cui è disponibile il documento, ad esempio l'URI del documento sul sito Web di un'azienda.
+ `_version`: un identificatore per la versione specifica di un documento.
+ `_view_count`: il numero di volte in cui il documento è stato visualizzato.
+ `_language_code`(String) — Il codice per una lingua che si applica al documento. Se non specifichi una lingua, il valore predefinito è l’inglese. Per ulteriori informazioni sulle lingue supportate, compresi i relativi codici, consulta [Aggiungere documenti in lingue diverse dall'inglese](https://docs.aws.amazon.com/kendra/latest/dg/in-adding-languages.html).
Puoi creare campi personalizzati utilizzando `DocumentMetadataConfigurationUpdates` l'operazione `UpdateIndex` API, proprio come quando crei un campo riservato o comune. È necessario impostare il tipo di dati appropriato per il campo personalizzato.
Se utilizzi la console, aggiorni i campi selezionando l'origine dati, selezionando l'azione di modifica e quindi procedendo accanto alla sezione delle mappature dei campi per configurare l'origine dati. Alcune fonti di dati non supportano l'aggiunta di nuovi campi o campi personalizzati. Non puoi modificare il tipo di campo dopo averlo creato.
Di seguito sono riportati i tipi che puoi impostare per i campi personalizzati:
+ Data
+ Numero
+ Stringa
+ Elenco stringhe
Se hai aggiunto documenti a un indice utilizzando l'operazione [BatchPutDocument](https://docs.aws.amazon.com/kendra/latest/APIReference/API_BatchPutDocument.html)API, `Attributes` elenca fields/attributes i tuoi documenti e crei campi utilizzando l'`DocumentAttribute`oggetto.
Per i documenti indicizzati da un'origine Amazon S3 dati, crei campi utilizzando un [file di metadati JSON](https://docs.aws.amazon.com/kendra/latest/dg/s3-metadata.html) che include le informazioni sui campi.
[Se utilizzi un database supportato come fonte di dati, puoi configurare i campi utilizzando l'opzione di mappatura dei campi.](https://docs.aws.amazon.com/kendra/latest/dg/data-source-database.html#data-source-procedure-database)
# Recupero delle risposte dagli indici in Amazon Kendra
Dopo aver creato un indice, puoi iniziare a cercare i tuoi documenti.
Per cercare un Amazon Kendra indice, si utilizza l'operazione API [Retrieve](https://docs.aws.amazon.com/kendra/latest/APIReference/API_Retrieve.html) o l'operazione API [Query](https://docs.aws.amazon.com/kendra/latest/APIReference/API_Query.html).
L'operazione Retrieve API è ideale per i casi d'uso di Retrieval Augmented Generation (RAG). Per una determinata query, restituisce un elenco classificato di passaggi semanticamente rilevanti composto da un massimo di 200 parole chiave. Puoi inviarli a un modello linguistico di grandi dimensioni (LLM) per generare una risposta utilizzando RAG. Per ulteriori informazioni, vedete [Ricerca in un indice](https://docs.aws.amazon.com/kendra/latest/dg/searching.html).
L'operazione dell'API Query è ideale per i casi d'uso della ricerca di documenti. Per una determinata query, restituisce un elenco di documenti classificati con estratti di 100 parole pertinenti alla query. Ciò è utile per i casi d'uso tradizionali della ricerca di documenti in cui gli utenti sfogliano un elenco di documenti classificati.
Per vedere quali funzionalità sono supportate dalle operazioni delle API Retrieve e Query per ogni tipo di indice, consulta Tipi di [indice](https://docs.aws.amazon.com/kendra/latest/dg/hiw-index-types.html).
# Documenti
Questa sezione spiega come Amazon Kendra indicizza i numerosi formati di documenti supportati e i diversi fields/attributes documenti.
**Topics**
+ [Tipi o formati di documenti](#index-document-types)
+ [Attributi o campi del documento](#hiw-document-attributes)
## Tipi o formati di documenti
Amazon Kendra supporta i tipi o i formati di documenti più diffusi come PDF, HTML PowerPoint, Word e altri. Un indice può contenere più formati di documenti.
Amazon Kendra estrae il contenuto all'interno dei documenti per renderli ricercabili. I documenti vengono analizzati in modo da ottimizzare la ricerca sul testo estratto e su qualsiasi contenuto tabulare (tabelle HTML) all'interno dei documenti. Ciò significa strutturare i documenti in campi o attributi utilizzati per la ricerca. I metadati del documento, come la data dell'ultima modifica, possono essere campi utili per la ricerca.
I documenti possono essere organizzati in righe e colonne. Ad esempio, ogni documento è una riga e ogni campo/attributo del documento, come il titolo e il contenuto del corpo, è una colonna. Ad esempio, se si utilizza un database come fonte di dati, i dati devono essere strutturati o organizzati in righe e colonne.
Puoi aggiungere documenti all'indice nei seguenti modi:
+ API [BatchPutDocument](https://docs.aws.amazon.com/kendra/latest/dg/in-adding-documents.html)
+ [Connettore di origine dati](https://docs.aws.amazon.com/kendra/latest/dg/data-sources.html)
Se desideri aggiungere un file di domande frequenti, utilizzi l'[CreateFaq](https://docs.aws.amazon.com/kendra/latest/dg/in-creating-faq.html)API per aggiungere il file archiviato in un Amazon S3 bucket. Puoi scegliere tra un formato CSV di base, un formato CSV che include elementi personalizzati fields/attributes in un'intestazione e un formato JSON che include campi personalizzati. Il formato predefinito è CSV di base.
Di seguito vengono fornite informazioni su ogni formato di documento supportato e su come viene Amazon Kendra trattato ogni formato durante l'indicizzazione dei documenti.
| Formato del documento | Trattata come | Come viene trattato | Struttura originale |
| --- | --- | --- | --- |
| Portable Document Format (PDF) | HTML | Convertito in HTML, quindi il contenuto viene estratto. | Non strutturato |
| HyperText Linguaggio di markup (HTML) | HTML | I tag HTML vengono filtrati per estrarre il contenuto. Il contenuto deve essere compreso tra i tag di HTML inizio e di chiusura principali (content). | Semistrutturato |
| Extensible Markup Language (XML) | XML | I tag XML vengono filtrati per estrarre il contenuto. | Semistrutturato |
| Trasformazione del linguaggio XSLT (Extensible Stylesheet Language Transformation) | XSLT | I tag vengono filtrati per estrarre il contenuto. | Semistrutturato |
| MarkDown (MD) | Testo semplice | Il contenuto viene estratto con la MarkDown sintassi inclusa. | Semistrutturato |
| Comma Separated Values (CSV) | CSV | Contenuto estratto da ogni cella, con un singolo file trattato come risultato di un unico documento. | Strutturato per i file delle domande frequenti, altrimenti semistrutturato |
| Microsoft Excel (XLS e XLSX) | XLS e XLSX | Contenuto estratto da ogni cella, con un singolo file trattato come risultato di un unico documento. | Semi-strutturato |
| JavaScript Notazione di oggetti (JSON) | Testo semplice | Il contenuto viene estratto con la sintassi JSON inclusa. | Semistrutturato |
| Rich Text Format (RTF) | RTF | La sintassi RTF viene filtrata per estrarre il contenuto. | Semistrutturato |
| Microsoft PowerPoint (PPT) | PPT, PPTX | Solo il contenuto testuale viene estratto dalle PowerPoint diapositive per la ricerca. Le immagini e gli altri contenuti non vengono estratti. | Non strutturato |
| Microsoft Word | DOC, DOCX | Solo il contenuto testuale viene estratto dalle pagine di Word per la ricerca. Le immagini e gli altri contenuti non vengono estratti. | Non strutturato |
| Testo normale (.txt) | TXT | Viene estratto tutto il testo del documento di testo. | Non strutturato |
## Attributi o campi del documento
A un documento sono associati attributi o campi. I campi di un documento sono le proprietà di un documento o ciò che è contenuto nella struttura di un documento. Ad esempio, ogni documento potrebbe contenere titolo, corpo del testo e autore. Puoi anche aggiungere campi personalizzati per documenti specifici. Ad esempio, se nell'indice vengono ricercate documenti fiscali, è possibile specificare un campo personalizzato per il tipo di documento fiscale, ad esempio W-2, 1099 e così via.
Prima di poter utilizzare un campo di documento in una query, è necessario mapparlo a un campo indice. Ad esempio, il campo del titolo può essere mappato al campo. `_document_title` Per ulteriori informazioni, vedere [Mappatura](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html) dei campi. Per aggiungere un nuovo campo, devi creare un campo indice a cui mappare il campo. I campi indice vengono creati utilizzando la console o l'[UpdateIndex](https://docs.aws.amazon.com/kendra/latest/APIReference/API_UpdateIndex.html)API.
Puoi utilizzare i campi del documento per filtrare le risposte e creare risultati di ricerca sfaccettati. Ad esempio, puoi filtrare una risposta per restituire solo una versione specifica di un documento oppure puoi filtrare le ricerche per restituire solo 1099 tipi di documenti fiscali che corrispondono al termine di ricerca. Per ulteriori informazioni, consulta [Filtraggio e](https://docs.aws.amazon.com/kendra/latest/dg/filtering.html) ricerca sfaccettata.
Puoi anche utilizzare i campi del documento per ottimizzare manualmente la risposta alla query. Ad esempio, puoi scegliere di aumentare l'importanza del campo del titolo per aumentare il peso che viene Amazon Kendra assegnato al campo nel determinare quali documenti restituire nella risposta. Per ulteriori informazioni, consulta [Ottimizzazione della pertinenza della ricerca](https://docs.aws.amazon.com/kendra/latest/dg/tuning.html).
Se aggiungete un documento direttamente a un indice, specificate i campi nel parametro di input del [documento](https://docs.aws.amazon.com/kendra/latest/APIReference/API_Document.html) all'[BatchPutDocument](https://docs.aws.amazon.com/kendra/latest/APIReference/API_BatchPutDocument.html)API. Si specificano i valori dei campi personalizzati in un array di [DocumentAttribute](https://docs.aws.amazon.com/kendra/latest/APIReference/API_DocumentAttribute.html)oggetti. Se si utilizza un'origine dati, il metodo utilizzato per aggiungere i campi del documento dipende dall'origine dati. Per ulteriori informazioni, consulta la sezione [Mappatura dei campi di origine dei dati](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html).
### Utilizzo di campi di documento Amazon Kendra riservati o comuni
Con l'[UpdateIndex API](https://docs.aws.amazon.com/kendra/latest/APIReference/API_UpdateIndex.html), puoi creare campi riservati o comuni utilizzando `DocumentMetadataConfigurationUpdates` e specificando il nome del campo indice Amazon Kendra riservato da mappare al attribute/field nome del documento equivalente. Puoi anche creare campi personalizzati. Se utilizzi un connettore di origine dati, la maggior parte include mappature di campi che mappano i campi del documento di origine dati ai campi Amazon Kendra indice. Se utilizzi la console, aggiorni i campi selezionando l'origine dati, selezionando l'azione di modifica e quindi procedendo accanto alla sezione delle mappature dei campi per configurare l'origine dati.
Puoi configurare l'`Search`oggetto per impostare un campo come visualizzabile, personalizzabile, ricercabile e ordinabile. È possibile configurare l'`Relevance`oggetto in modo da impostare l'ordine di classificazione, la durata dell'incremento o il periodo di tempo di un campo da applicare al valore di potenziamento, freschezza, importanza e ai valori di importanza mappati a valori di campo specifici. Se utilizzi la console, puoi configurare le impostazioni di ricerca per un campo selezionando l'opzione facet nel menu di navigazione. Per impostare l'ottimizzazione della pertinenza, seleziona l'opzione di ricerca nell'indice nel menu di navigazione, inserisci una query e utilizza le opzioni del pannello laterale per ottimizzare la pertinenza della ricerca. Non è possibile modificare il tipo di campo dopo averlo creato.
Amazon Kendra contiene i seguenti campi di documento riservati o comuni che è possibile utilizzare:
+ `_authors`—Un elenco di uno o più autori responsabili del contenuto del documento.
+ `_category`—Una categoria che colloca un documento in un gruppo specifico.
+ `_created_at`—La data e l'ora in formato ISO 8601 in cui è stato creato il documento. Ad esempio, 2012-03-25T12:30:10\$101:00 è il formato data/ora ISO 8601 per il 25 marzo 2012 alle 12:30 (più 10 secondi) nel fuso orario dell'Europa centrale (CET).
+ `_data_source_id`—L'identificatore della fonte di dati che contiene il documento.
+ `_document_body`—Il contenuto del documento.
+ `_document_id`—Un identificatore univoco per il documento.
+ `_document_title`—Il titolo del documento.
+ `_excerpt_page_number`—Il numero di pagina in un file PDF in cui viene visualizzato l'estratto del documento. Se l'indice è stato creato prima dell'8 settembre 2020, è necessario reindicizzare i documenti prima di poter utilizzare questo attributo.
+ `_faq_id`—Se si tratta di un documento di tipo domanda-risposta (FAQ), un identificatore univoco per le domande frequenti.
+ `_file_type`—Il tipo di file del documento, ad esempio pdf o doc.
+ `_last_updated_at`—La data e l'ora in formato ISO 8601 dell'ultimo aggiornamento del documento. Ad esempio, 2012-03-25T12:30:10\$101:00 è il formato data/ora ISO 8601 per il 25 marzo 2012 alle 12:30 (più 10 secondi) nel fuso orario dell'Europa centrale (CET).
+ `_source_uri`—L'URI in cui è disponibile il documento. Ad esempio, l’URI del documento su un sito web aziendale.
+ `_version`—Un identificatore per la versione specifica di un documento.
+ `_view_count`—Il numero di volte in cui il documento è stato visualizzato.
+ `_language_code`(String) —Il codice per una lingua che si applica al documento. Il valore predefinito è l'inglese se non si specifica una lingua. Per ulteriori informazioni sulle lingue supportate, compresi i relativi codici, consulta [Aggiungere documenti in lingue diverse dall'inglese](https://docs.aws.amazon.com/kendra/latest/dg/in-adding-languages.html).
Per i campi personalizzati, puoi creare questi campi utilizzando `DocumentMetadataConfigurationUpdates` l'`UpdateIndex`API, proprio come quando crei un campo riservato o comune. È necessario impostare il tipo di dati appropriato per il campo personalizzato. Se utilizzi la console, aggiorni i campi selezionando l'origine dati, selezionando l'azione di modifica e quindi procedendo accanto alla sezione delle mappature dei campi per configurare l'origine dati. Alcune fonti di dati non supportano l'aggiunta di nuovi campi o campi personalizzati. Non è possibile modificare il tipo di campo dopo averlo creato.
Di seguito sono riportati i tipi che è possibile impostare per i campi personalizzati:
+ Data
+ Numero
+ Stringa
+ Elenco stringhe
Se hai aggiunto documenti all'indice utilizzando l'[BatchPutDocument](https://docs.aws.amazon.com/kendra/latest/APIReference/API_BatchPutDocument.html)API, `Attributes` elenca fields/attributes i tuoi documenti e crei campi utilizzando l'`DocumentAttribute`oggetto.
Per i documenti indicizzati da un'origine Amazon S3 dati, crei i campi utilizzando un [file di metadati JSON](https://docs.aws.amazon.com/kendra/latest/dg/s3-metadata.html) che include le informazioni sui campi.
[Se utilizzi un database supportato come fonte di dati, puoi configurare i campi utilizzando l'opzione di mappatura dei campi.](https://docs.aws.amazon.com/kendra/latest/dg/data-source-database.html#data-source-procedure-database)
# Origini dati
Un'origine dati è un archivio o una posizione di dati che Amazon Kendra si collega e indicizza i documenti o i contenuti. Ad esempio, è possibile configurare la connessione Amazon Kendra a Microsoft per SharePoint eseguire la scansione e l'indicizzazione dei documenti archiviati in questa fonte. È inoltre possibile indicizzare le pagine Web fornendo il modulo URLs Amazon Kendra per la scansione. È possibile sincronizzare automaticamente un'origine dati con un Amazon Kendra indice in modo che i documenti aggiunti, aggiornati o eliminati nell'origine dati vengano aggiunti, aggiornati o eliminati anche nell'indice.
Le fonti di dati supportate sono:
+ [Adobe Experience Manager](https://docs.aws.amazon.com/kendra/latest/dg/data-source-aem.html)
+ [Alfresco](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 (Finestre)](https://docs.aws.amazon.com/kendra/latest/dg/data-source-fsx.html)
+ [Amazon FSx (NetApp SU TAP)](https://docs.aws.amazon.com/kendra/latest/dg/data-source-fsx-ontap.html)
+ [Fonti di dati del database](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 secchi](https://docs.aws.amazon.com/kendra/latest/dg/data-source-s3.html)
+ [Amazon Kendra Web crawler](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)
+ [Confluenza](https://docs.aws.amazon.com/kendra/latest/dg/data-source-confluence.html)
+ [Fonti di dati personalizzate](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)
+ [Google Workspace Drives](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)
+ [Banca dati 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)
Per un elenco dei tipi o dei formati di documento supportati da, Amazon Kendra vedere [Tipi di documento](https://docs.aws.amazon.com/kendra/latest/dg/index-document-types.html). È necessario creare un indice prima di creare un connettore di origine dati per indicizzare i documenti dalla fonte dati.
**Nota**
Per creare un indice di documenti, non è necessario utilizzare una fonte di dati. Puoi aggiungere documenti direttamente a un indice con il caricamento in batch. Per ulteriori informazioni, consulta [Aggiungere documenti direttamente a un indice](https://docs.aws.amazon.com/kendra/latest/dg/in-adding-documents.html).
[Per una procedura dettagliata sull'utilizzo della Amazon Kendra console, della AWS CLI o SDKs, consulta la Guida introduttiva.](https://docs.aws.amazon.com/kendra/latest/dg/getting-started.html)
# Query
Per ottenere risposte, gli utenti eseguono una query su un indice. Gli utenti possono utilizzare il linguaggio naturale nelle loro interrogazioni. La risposta contiene informazioni, come il titolo, un estratto di testo e la posizione dei documenti nell'indice che forniscono la risposta migliore.
Amazon Kendra utilizza tutte le informazioni fornite sui documenti, non solo il contenuto dei documenti, per determinare se un documento è pertinente alla query. Ad esempio, se l'indice contiene informazioni sulla data dell'ultimo aggiornamento dei documenti, è possibile Amazon Kendra assegnare una maggiore rilevanza ai documenti che sono stati aggiornati più di recente.
Una query può anche contenere criteri su come filtrare la risposta in modo da Amazon Kendra restituire solo i documenti che soddisfano i criteri di filtro. Ad esempio, se è stato creato un campo indice denominato *dipartimento*, è possibile filtrare la risposta in modo che vengano restituiti solo i documenti con il campo reparto impostato su *legale*. Per ulteriori informazioni, vedere [Filtraggio della ricerca](https://docs.aws.amazon.com/kendra/latest/dg/filtering.html).
È possibile influenzare i risultati di una query regolando la pertinenza dei singoli campi dell'indice. L'ottimizzazione modifica l'importanza di un campo nei risultati. Ad esempio, se si aumenta l'importanza dei documenti inserendo la *nuova* categoria, è più probabile che i documenti con questa categoria vengano inclusi nella risposta. Per ulteriori informazioni, consulta [Ottimizzazione della pertinenza della ricerca](https://docs.aws.amazon.com/kendra/latest/dg/tuning.html).
Per ulteriori informazioni sull'utilizzo delle query, vedere [Ricerca](https://docs.aws.amazon.com/kendra/latest/dg/searching.html) in un indice.
# Tag
Gestisci gli indici e le fonti di dati FAQs assegnando tag o etichette. Puoi utilizzare i tag per classificare le tue Amazon Kendra risorse in vari modi. Ad esempio, per scopo, proprietario, applicazione o qualsiasi combinazione. Ogni tag consiste di una *chiave* e di un *valore*, entrambi personalizzabili.
I tag ti aiutano a:
+ Identifica e organizza AWS le tue risorse. Molti AWS servizi supportano l'etichettatura, quindi puoi assegnare lo stesso tag a risorse di servizi diversi per indicare che le risorse sono correlate. Ad esempio, puoi etichettare un indice e il Amazon Lex bot che utilizza l'indice con lo stesso tag.
+ Assegnare i costi. Puoi attivare i tag nella Gestione dei costi e fatturazione AWS dashboard. AWS utilizza i tag per classificare i costi e fornirti un rapporto mensile sull'allocazione dei costi. Per ulteriori informazioni, consulta [Allocazione dei costi e etichettatura](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) in *Informazioni su AWS Billing* and Cost Management.
+ Controllare l’accesso alle risorse. Puoi utilizzare i tag nelle politiche AWS Identity and Access Management (IAM) che controllano l'accesso alle risorse. Amazon Kendra Puoi associare queste politiche a un IAM ruolo o a un utente per attivare il controllo degli accessi basato su tag. Per ulteriori informazioni, consulta [Autorizzazione basata sui tag](https://docs.aws.amazon.com/kendra/latest/dg/security_iam_service-with-iam.html#security_iam_service-with-iam-tags).
Puoi creare e gestire i tag utilizzando Console di gestione AWS, the AWS Command Line Interface (AWS CLI) o l' Amazon Kendra API.
## Applicazione di tag alle risorse
Se utilizzi la Amazon Kendra console, puoi taggare le risorse quando le crei o aggiungerle in un secondo momento. Puoi anche utilizzare la console per aggiornare o rimuovere i tag.
Se utilizzi AWS Command Line Interface (AWS CLI) o l' Amazon Kendra API, utilizza le seguenti operazioni per gestire i tag per le tue risorse:
+ [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html)—Applica i tag quando crei un'origine dati.
+ [CreateFaq](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateFaq.html)—Applica tag quando crei una FAQ.
+ [CreateIndex](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateIndex.html)—Applica tag quando crei un indice.
+ [ListTagsForResource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_ListTagsForResource.html)—Visualizza i tag associati a una risorsa.
+ [TagResource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TagResource.html)—Aggiunge e modifica i tag per una risorsa.
+ [UntagResource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_UntagResource.html)—Rimuove i tag da una risorsa.
## Limitazioni applicate ai tag
Le seguenti restrizioni si applicano ai tag sulle Amazon Kendra risorse:
+ Numero massimo di tag: 50
+ Lunghezza massima della chiave: 128 caratteri
+ Lunghezza massima del valore: 256 caratteri
+ Caratteri validi per chiave e valore—a—z, A—Z, spazio e i seguenti caratteri: \$1.:/= \$1 - e @
+ Le chiavi e i valori fanno distinzione tra lettere maiuscole
+ Non utilizzare `aws:` come prefisso per le chiavi; l’utilizzo di questo prefisso è riservato per AWS