Creazione di campi di documento personalizzati

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

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

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 l'UpdateIndexAPI per 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 file di metadati JSON.

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 l'UpdateIndexAPI, aggiungi campi o attributi personalizzati utilizzando il DocumentMetadataConfigurationUpdates parametro.

Il seguente esempio JSON 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 l'API BatchPutDocument

Quando utilizzi l'BatchPutDocumentAPI per aggiungere un documento all'indice, specifichi campi o attributi personalizzati come parte diAttributes. Puoi aggiungere più campi o attributi quando chiami l'API. Puoi 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 file JSON 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 struttura Attributes JSON. È 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 la CLI.

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
        }
    }
...
]"

anchoranchor

• Console
• CLI

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.

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 l'API, usa l'fieldMappingsattributo sotto configuration quando usi l'CreateDataSourceAPI.

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