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
**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, vedi [Ricerca negli indici](https://docs.aws.amazon.com/kendra/latest/dg/hiw-index.html#index-searching).
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'[UpdateIndex](https://docs.aws.amazon.com/kendra/latest/APIReference/API_UpdateIndex.html)API 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](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). 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](https://docs.aws.amazon.com/kendra/latest/dg/hiw-document-attributes.html).
**Topics**
+ [Aggiornamento dei campi personalizzati del documento](#update-attributes)
## Aggiornamento dei campi personalizzati del documento
Con l'`UpdateIndex`API, aggiungi campi o attributi personalizzati utilizzando il `DocumentMetadataConfigurationUpdates` parametro.
Il seguente esempio JSON utilizza `DocumentMetadataConfigurationUpdates` per aggiungere un campo denominato “Department” all’indice.
```
"DocumentmetadataConfigurationUpdates": [
{
"Name": "Department",
"Type": "STRING_VALUE"
}
]
```
Le seguenti sezioni includono esempi per aggiungere attributi o campi personalizzati utilizzando [BatchPutDocument](https://docs.aws.amazon.com/kendra/latest/APIReference/API_BatchPutDocument.html)e per un'origine dati Amazon S3.
**Topics**
+ [Aggiungere attributi o campi personalizzati con l'API BatchPutDocument](#custom-attributes-batch)
+ [Aggiungere attributi o campi personalizzati a un'origine Amazon S3 dati](#custom-attributes-s3)
### Aggiungere attributi o campi personalizzati con l'API BatchPutDocument
Quando utilizzi l'[BatchPutDocument](https://docs.aws.amazon.com/kendra/latest/APIReference/API_BatchPutDocument.html)API per aggiungere un documento all'indice, specifichi campi o attributi personalizzati come parte di`Attributes`. 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 “Department” 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](https://docs.aws.amazon.com/kendra/latest/dg/s3-metadata.html).
È possibile specificare campi o attributi personalizzati nella struttura JSON `Attributes`. Puoi 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.
**Topics**
+ [Passaggio 1: creare un indice Amazon Kendra](#custom-attributes-s3-1)
+ [Passaggio 2: aggiorna l'indice per aggiungere campi di documento personalizzati](#custom-attributes-s3-2)
+ [Fase 3: creare un'origine dati Amazon S3 e mappare i campi dell'origine dati su attributi personalizzati](#custom-attributes-s3-3)
#### Passaggio 1: creare un indice Amazon Kendra
Segui i passaggi indicati [Creazione di un indice](create-index.md) 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](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html).
1. Quindi, dal menu di navigazione a sinistra, da **Gestione dati**, scegli **Definizione delle sfaccettature**.
1. Nella **guida alle impostazioni dei campi Indice**, da **Campi indice**, scegli **Aggiungi campo** per aggiungere campi personalizzati.
1. 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](data-source-s3.md)
Se utilizzi l'API, usa l'`fieldMappings`attributo sotto `configuration` quando usi l'[CreateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html)API.
Per una panoramica di come vengono mappati i campi delle sorgenti dati, consulta[Mappatura dei campi dell’origine dati](field-mapping.md).