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à. # Aggiungere domande frequenti (FAQs) a un indice **Nota** Il supporto delle funzionalità varia in base al tipo di indice e all'API di ricerca utilizzata. Per verificare se questa funzionalità è supportata per il tipo di indice e l'API di ricerca che stai utilizzando, consulta [Tipi di indice](https://docs.aws.amazon.com/kendra/latest/dg/hiw-index-types.html). Puoi aggiungere le domande frequenti (FAQs) direttamente al tuo indice utilizzando la console o l'[CreateFaq](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateFaq.html)API. L'aggiunta FAQs a un indice è un'operazione asincrona. I dati per le domande frequenti vengono inseriti in un file archiviato in un bucket. Amazon Simple Storage Service Puoi usare file CSV o JSON come input per le tue FAQ: + CSV di base: un file CSV in cui ogni riga contiene una domanda, una risposta e un URI di origine opzionale. + CSV personalizzato: un file CSV che contiene domande, risposte e intestazioni personalizzate fields/attributes che puoi utilizzare per suddividere, visualizzare o ordinare le risposte alle domande frequenti. Puoi anche definire campi di controllo dell'accesso per limitare la risposta alle domande frequenti a determinati utenti e gruppi a cui è consentito visualizzare la risposta alle domande frequenti. + JSON: un file JSON che contiene domande, risposte e informazioni personalizzate fields/attributes che puoi utilizzare per sfaccettare, visualizzare o ordinare le risposte alle domande frequenti. Puoi anche definire campi di controllo dell'accesso per limitare la risposta alle domande frequenti a determinati utenti e gruppi a cui è consentito visualizzare la risposta alle domande frequenti. Ad esempio, quello che segue è un file CSV di base che fornisce risposte a domande sulle cliniche gratuite a Spokane, Washington USA e Mountain View, Missouri, USA. ``` How many free clinics are in Spokane WA?, 13 How many free clinics are there in Mountain View Missouri?, 7 ``` **Nota** Il file FAQ deve essere un file con codifica UTF-8. **Topics** + [Creazione di campi indice per un file di domande frequenti](#in-custom-fields-faq) + [File CSV di base](#faq-basic-csv) + [File CSV personalizzato](#faq-custom-csv) + [File JSON](#faq-custom-json) + [Utilizzo del file delle domande frequenti](#using-faq-file) + [File di domande frequenti in lingue diverse dall'inglese](#faq-languages) ## Creazione di campi indice per un file di domande frequenti **Nota** Il supporto delle funzionalità varia in base al tipo di indice e all'API di ricerca utilizzata. Per verificare se questa funzionalità è supportata per il tipo di indice e l'API di ricerca che stai utilizzando, consulta [Tipi di indice](https://docs.aws.amazon.com/kendra/latest/dg/hiw-index-types.html). Quando utilizzi un file [CSV o [JSON](https://docs.aws.amazon.com/kendra/latest/dg/in-creating-faq.html#faq-custom-json) personalizzato](https://docs.aws.amazon.com/kendra/latest/dg/in-creating-faq.html#faq-custom-csv) per l'input, puoi dichiarare campi personalizzati per le tue domande frequenti. Ad esempio, puoi creare un campo personalizzato che assegna a ogni domanda FAQ un reparto aziendale. Quando le domande frequenti vengono restituite in una risposta, puoi utilizzare il reparto come sfaccettatura per restringere la ricerca solo a «Risorse Umane» o «Finanze», ad esempio. Un campo personalizzato deve essere mappato a un campo indice. Nella console, si utilizza la pagina di **definizione di Facet** per creare un campo indice. Quando si utilizza l'API, è necessario innanzitutto creare un campo indice utilizzando l'[UpdateIndex](https://docs.aws.amazon.com/kendra/latest/APIReference/API_UpdateIndex.html)API. Il field/attribute tipo nel file delle domande frequenti deve corrispondere al tipo del campo indice associato. Ad esempio, il campo «Dipartimento» è un campo `STRING_LIST` di tipo. Pertanto, è necessario fornire i valori per il campo department come elenco di stringhe nel file delle domande frequenti. Puoi controllare il tipo di campi indice utilizzando la pagina di **definizione di Facet** nella console o utilizzando l'[DescribeIndex](https://docs.aws.amazon.com/kendra/latest/APIReference/API_DescribeIndex.html)API. Quando crei un campo indice mappato a un attributo personalizzato, puoi contrassegnarlo come visualizzabile, sfaccettato o ordinabile. Non puoi rendere ricercabile un attributo personalizzato. Oltre agli attributi personalizzati, puoi anche utilizzare i campi Amazon Kendra riservati o comuni in un file CSV o JSON personalizzato. Per ulteriori informazioni, consulta [Attributi o campi del documento](https://docs.aws.amazon.com/kendra/latest/dg/hiw-document-attributes.html). ## File CSV di base Usa un file CSV di base quando desideri utilizzare una struttura semplice per il tuo. FAQs In un file CSV di base, ogni riga contiene due o tre campi: una domanda, una risposta e un URI di origine opzionale che rimanda a un documento con ulteriori informazioni. Il contenuto del file deve essere conforme al [formato comune RFC 4180 e al tipo MIME per i file CSV (Comma-Separated](https://tools.ietf.org/html/rfc4180) Values). Di seguito è riportato un file di domande frequenti nel formato CSV di base. ``` How many free clinics are in Spokane WA?, 13, https://s3.region.company.com/bucket-name/directory/faq.csv How many free clinics are there in Mountain View Missouri?, 7, https://s3.region.company.com/bucket-name/directory/faq.csv ``` ## File CSV personalizzato Usa un file CSV personalizzato quando desideri aggiungere qualcosa di personalizzato fields/attributes alle tue domande frequenti. Per un file CSV personalizzato, usi una riga di intestazione nel file CSV per definire gli attributi aggiuntivi. Il file CSV deve contenere i seguenti due campi obbligatori: + `_question`—La domanda più frequente + `_answer`—La risposta alla domanda più frequente Il file CSV personalizzato può contenere sia campi Amazon Kendra riservati (tranne`_faq_id`, `_data_source_id``_document_title`, e`_file_type`) sia qualsiasi campo personalizzato. Di seguito è riportato un esempio di file CSV personalizzato. ``` _question,_answer,_last_updated_at,custom_string How many free clinics are in Spokane WA?, 13, 2012-03-25T12:30:10+01:00, Note: Some free clinics require you to meet certain criteria in order to use their services How many free clinics are there in Mountain View Missouri?, 7, 2012-03-25T12:30:10+01:00, Note: Some free clinics require you to meet certain criteria in order to use their services ``` Il contenuto del file personalizzato deve essere conforme al [formato comune RFC 4180 e al tipo MIME per i file CSV (Comma-Separated](https://tools.ietf.org/html/rfc4180) Values). Di seguito sono elencati i tipi di campi personalizzati: + Data: valori di data e ora con codifica ISO 8601. 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). + Lungo: numeri, ad `1234` esempio. + String—Valori di tipo String. Se la stringa contiene virgole, racchiudi l'intero valore tra virgolette doppie («) (ad esempio,). `"custom attribute, and more"` + Elenco stringhe: un elenco di valori di stringa. Elenca i valori in un elenco separato da virgole racchiuso tra virgolette («) (ad esempio,). `"item1, item2, item3"` Se l'elenco contiene solo una voce, è possibile omettere le virgolette (ad esempio,). `item1` Un file CSV personalizzato può contenere campi di controllo dell'accesso degli utenti. Puoi utilizzare questi campi per limitare l'accesso alle domande frequenti a determinati utenti e gruppi. Per filtrare in base al contesto dell'utente, l'utente deve fornire informazioni sull'utente e sul gruppo nella query. In caso contrario, FAQs vengono restituiti tutti i dati pertinenti. Per ulteriori informazioni, consulta [Filtraggio del contesto utente](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html). Di seguito sono elencati i filtri del contesto utente per FAQs: + `_acl_user_allow`—Gli utenti inclusi nell'elenco consentito possono visualizzare le domande frequenti nella risposta alla query. Le domande frequenti non vengono restituite agli altri utenti. + `_acl_user_deny`—Gli utenti nell'elenco degli utenti non autorizzati non possono visualizzare le domande frequenti nella risposta alla query. Le domande frequenti vengono restituite a tutti gli altri utenti quando sono pertinenti alla domanda. + `_acl_group_allow`—Gli utenti che sono membri di un gruppo consentito possono visualizzare le domande frequenti nella risposta alla query. Le domande frequenti non vengono restituite agli utenti che sono membri di un altro gruppo. + `_acl_group_deny`—Gli utenti che sono membri di un gruppo negato non possono visualizzare le domande frequenti nella risposta alla query. Le domande frequenti vengono restituite agli altri gruppi quando sono pertinenti alla query. Fornisci i valori per gli elenchi di autorizzazione e rifiuto in elenchi separati da virgole racchiusi tra virgolette (ad esempio,). `"user1,user2,user3"` È possibile includere un utente o un gruppo in un elenco consentito o in un elenco negato, ma non entrambi quando lo stesso utente è autorizzato individualmente ma anche in un gruppo negato. Se includi un utente o un gruppo in entrambi, riceverai un errore. Di seguito è riportato un esempio di file CSV personalizzato con informazioni sul contesto dell'utente. ``` _question, _answer, _acl_user_allow, _acl_user_deny, _acl_group_allow, _acl_group_deny How many free clinics are in Spokane WA?, 13, "userID6201,userID7552", "userID1001,userID2020", groupBasicPlusRate, groupPremiumRate ``` ## File JSON Puoi utilizzare un file JSON per fornire domande, risposte e campi per il tuo indice. Puoi aggiungere qualsiasi campo Amazon Kendra riservato o campo personalizzato alle domande frequenti. Di seguito è riportato lo schema per il file JSON. ``` { "SchemaVersion": 1, "FaqDocuments": [ { "Question": string, "Answer": string, "Attributes": { string: object additional attributes }, "AccessControlList": [ { "Name": string, "Type": enum( "GROUP" | "USER" ), "Access": enum( "ALLOW" | "DENY" ) }, additional user context ] }, additional FAQ documents ] } ``` Il seguente file JSON di esempio mostra due documenti di domande frequenti. Uno dei documenti contiene solo la domanda e la risposta richieste. L'altro documento include anche informazioni aggiuntive sul campo e sul contesto utente o sul controllo degli accessi. ``` { "SchemaVersion": 1, "FaqDocuments": [ { "Question": "How many free clinics are in Spokane WA?", "Answer": "13" }, { "Question": "How many free clinics are there in Mountain View Missouri?", "Answer": "7", "Attributes": { "_source_uri": "https://s3.region.company.com/bucket-name/directory/faq.csv", "_category": "Charitable Clinics" }, "AccessControlList": [ { "Name": "user@amazon.com", "Type": "USER", "Access": "ALLOW" }, { "Name": "Admin", "Type": "GROUP", "Access": "ALLOW" } ] } ] } ``` Di seguito sono elencati i tipi di campi personalizzati: + Data: un valore di stringa JSON con valori di data e ora codificati ISO 8601. 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). + Long: un valore numerico JSON, ad esempio. `1234` + Stringa: un valore di stringa JSON (ad esempio,). `"custom attribute"` + Elenco di stringhe: una matrice JSON di valori di stringa (ad esempio,). `["item1,item2,item3"]` Un file JSON può contenere campi di controllo dell'accesso degli utenti. Puoi utilizzare questi campi per limitare l'accesso alle domande frequenti a determinati utenti e gruppi. Per filtrare in base al contesto dell'utente, l'utente deve fornire informazioni sull'utente e sul gruppo nella query. In caso contrario, FAQs vengono restituiti tutti i dati pertinenti. Per ulteriori informazioni, consulta [Filtraggio del contesto utente](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html). È possibile includere un utente o un gruppo in un elenco consentito o in un elenco negato, ma non entrambi se lo stesso utente è autorizzato individualmente ma anche in un gruppo negato. Se includi un utente o un gruppo in entrambi, riceverai un errore. Di seguito è riportato un esempio di inclusione del controllo dell'accesso degli utenti in una domanda frequente su JSON. ``` "AccessControlList": [ { "Name": "group or user name", "Type": "GROUP | USER", "Access": "ALLOW | DENY" }, additional user context ] ``` ## Utilizzo del file delle domande frequenti Dopo aver archiviato il file di input delle FAQ in un bucket S3, usi la console o l'`CreateFaq`API per inserire le domande e le risposte nel tuo indice. Se desideri aggiornare una FAQ, elimina la FAQ e creala di nuovo. Utilizzi l'`DeleteFaq`API per eliminare una FAQ. Devi fornire un IAM ruolo che abbia accesso al bucket S3 che contiene i tuoi file sorgente. Specificate il ruolo nella console o nel `RoleArn` parametro. Di seguito è riportato un esempio di aggiunta di un file di domande frequenti a un indice. ------ #### [ Python ] ``` import boto3 kendra = boto3.client("kendra") # Provide the index ID index_id = "index-id" # Provide the IAM role ARN required to index documents in an S3 bucket role_arn = "arn:aws:iam::${accountId}:role/${roleName}" # Provide the S3 bucket path information to the FAQ file faq_path = { "Bucket": "bucket-name", "Key": "FreeClinicsUSA.csv" } response = kendra.create_faq( S3Path = faq_path, Name = "FreeClinicsUSA", IndexId = index_id, RoleArn = role_arn ) print(response) ``` ------ #### [ Java ] ``` package com.amazonaws.kendra; import software.amazon.awssdk.services.kendra.KendraClient; import software.amazon.awssdk.services.kendra.model.CreateFaqRequest; import software.amazon.awssdk.services.kendra.model.CreateFaqResponse; import software.amazon.awssdk.services.kendra.model.S3Path; public class AddFaqExample { public static void main(String[] args) { KendraClient kendra = KendraClient.builder().build(); String indexId = "yourIndexId"; String roleArn = "your role for accessing S3 files"; CreateFaqRequest createFaqRequest = CreateFaqRequest .builder() .indexId(indexId) .name("FreeClinicsUSA") .roleArn(roleArn) .s3Path( S3Path .builder() .bucket("amzn-s3-demo-bucket") .key("FreeClinicsUSA.csv") .build()) .build(); CreateFaqResponse response = kendra.createFaq(createFaqRequest); System.out.println(String.format("The result of creating FAQ: %s", response)); } } ``` ------ ## File di domande frequenti in lingue diverse dall'inglese Puoi indicizzare una FAQ in una lingua supportata. Amazon Kendra gli indici sono FAQs in inglese per impostazione predefinita se non si specifica una lingua. È possibile specificare il codice della lingua quando si richiama l'[CreateFaq](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateFaq.html)operazione oppure è possibile includere il codice della lingua per una FAQ nei metadati delle domande frequenti come campo. Se una FAQ non ha un codice di lingua nei metadati specificati in un campo di metadati, le domande frequenti vengono indicizzate utilizzando il codice della lingua specificato al momento della chiamata dell'operazione. `CreateFAQ` **Per indicizzare un documento di domande frequenti in una lingua supportata nella console, vai a **FAQs**e seleziona Aggiungi domande frequenti.** Scegli una lingua dal menu a discesa **Lingua**.