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

Creazione di campi di documento personalizzati

Puoi creare attributi o campi personalizzati per i tuoi documenti nel tuo indice Amazon Kendra. Ad esempio, puoi creare un campo o un attributo personalizzato chiamato «Dipartimento» con i valori di «HR», «Sales» e «Manufacturing». Se mappi questi campi o attributi personalizzati al tuo indice Amazon Kendra, puoi utilizzarli per filtrare i risultati della ricerca e includere documenti in base all'attributo del dipartimento «HR», ad esempio.

Prima di poter utilizzare un campo o un attributo personalizzato, devi prima creare il campo nell'indice. Usa la console per modificare le mappature dei campi dell'origine dati per aggiungere un campo personalizzato o usa la UpdateIndexAPIper creare il campo indice. Non è possibile modificare il tipo di dati del campo dopo averlo creato.

Per la maggior parte delle fonti di dati, i campi dell'origine dati esterna vengono mappati ai campi corrispondenti in Amazon Kendra. Per ulteriori informazioni, consulta la sezione Mappatura dei campi di origine dei dati. Per le sorgenti dati S3, puoi creare campi o attributi personalizzati utilizzando un JSON file di metadati.

Puoi creare fino a 500 campi o attributi personalizzati.

Puoi anche utilizzare campi Amazon Kendra riservati o comuni. Per ulteriori informazioni, consulta Attributi o campi del documento.

Aggiornamento dei campi personalizzati del documento

Con UpdateIndexAPI, si aggiungono campi o attributi personalizzati utilizzando il DocumentMetadataConfigurationUpdates parametro.

L'JSONesempio seguente utilizza DocumentMetadataConfigurationUpdates l'aggiunta di un campo chiamato «Dipartimento» all'indice.

"DocumentmetadataConfigurationUpdates": [
   {
       "Name": "Department",
       "Type": "STRING_VALUE"
   }
]

Le seguenti sezioni includono esempi per aggiungere attributi o campi personalizzati utilizzando BatchPutDocumente per un'origine dati Amazon S3.

Aggiungere attributi o campi personalizzati con BatchPutDocument API

Quando si utilizza il BatchPutDocumentAPIper aggiungere un documento all'indice, si specificano campi o attributi personalizzati come parte diAttributes. È possibile aggiungere più campi o attributi quando si chiama ilAPI. È possibile creare fino a 500 campi o attributi personalizzati. L'esempio seguente è un campo o un attributo personalizzato che aggiunge «Dipartimento» a un documento.

"Attributes": 
    {
        "Department": "HR",
        "_category": "Vacation policy"
    }

Aggiungere attributi o campi personalizzati a un'origine Amazon S3 dati

Quando usi un bucket S3 come fonte di dati per il tuo indice, aggiungi metadati ai documenti con file di metadati complementari. I JSON file di metadati vengono inseriti in una struttura di directory parallela ai documenti. Per ulteriori informazioni, consulta Metadati dei documenti S3.

È possibile specificare campi o attributi personalizzati nella Attributes JSON struttura. È possibile creare fino a 500 campi o attributi personalizzati. Ad esempio, l'esempio seguente utilizza Attributes per definire tre campi o attributi personalizzati e un campo riservato.

"Attributes": {
        "brand": "Amazon Basics",
        "price": 1595,
        "_category": "sports",
        "subcategories": ["outdoors", "electronics"]
    }

I passaggi seguenti illustrano come aggiungere attributi personalizzati a un'origine dati Amazon S3.

Passaggio 1: creare un indice Amazon Kendra

Segui i passaggi indicati Creazione di un indice per creare il tuo indice Amazon Kendra.

Passaggio 2: aggiorna l'indice per aggiungere campi di documento personalizzati

Dopo aver creato un indice, aggiungete dei campi ad esso. La procedura seguente mostra come aggiungere campi a un indice utilizzando la console e ilCLI.

Console

Per creare campi indice

1. Assicurati di aver creato un indice.

2. Quindi, dal menu di navigazione a sinistra, da Gestione dati, scegli Definizione delle sfaccettature.

3. Nella guida alle impostazioni dei campi Indice, da Campi indice, scegli Aggiungi campo per aggiungere campi personalizzati.

4. Nella finestra di dialogo Aggiungi campo indice, procedi come segue:

   • Nome campo: aggiungi un nome di campo.

   • Tipo di dati: seleziona il tipo di dati, che si tratti di stringa, elenco di stringhe o data.

   • Tipi di utilizzo: seleziona i tipi di utilizzo, che siano Facetable, Ricercabili, Visualizzabili e Ordinabili.

     Quindi, seleziona Aggiungi.

   Ripeti l'ultimo passaggio per tutti gli altri campi che desideri mappare.

CLI

aws kendra update-index  \
--region $region \
--endpoint-url $endpoint \
--application-id $applicationId \
--index-id $indexId  \
--document-metadata-configuration-updates \
"[
    {
        "Name": "string",
        "Type": "STRING_VALUE"|"STRING_LIST_VALUE"|"LONG_VALUE"|"DATE_VALUE",
        "Relevance": {
            "Freshness": true|false,
            "Importance": integer,
            "Duration": "string",
            "RankOrder": "ASCENDING"|"DESCENDING",
            "ValueImportanceMap": {"string": integer
            ...}
    },
    "Search": {
        "Facetable": true|false,
        "Searchable": true|false,
        "Displayable": true|false,
        "Sortable": true|false
        }
    }
...
]"

Fase 3: creare un'origine dati Amazon S3 e mappare i campi dell'origine dati su attributi personalizzati

Per creare un'origine dati Amazon S3 e mappare i campi su di essa, segui le istruzioni riportate in. Amazon S3

Se utilizzi ilAPI, usa l'fieldMappingsattributo sotto configuration quando usi il CreateDataSourceAPI.

Per una panoramica di come vengono mappati i campi delle sorgenti dati, vediMappatura dei campi delle fonti di dati.