Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Membuat bidang dokumen kustom
<a name="custom-attributes"></a>

**catatan**  
Dukungan fitur bervariasi menurut jenis indeks dan API pencarian yang digunakan. Untuk melihat apakah fitur ini didukung untuk jenis indeks dan API penelusuran yang Anda gunakan, lihat [Mencari indeks](https://docs.aws.amazon.com/kendra/latest/dg/hiw-index.html#index-searching).

Anda dapat membuat atribut atau bidang khusus untuk dokumen Anda di indeks Amazon Kendra Anda. Misalnya, Anda dapat membuat bidang atau atribut khusus yang disebut “Departemen” dengan nilai “HR”, “Penjualan”, dan “Manufaktur”. Jika Anda memetakan bidang atau atribut khusus ini ke indeks Amazon Kendra Anda, Anda dapat menggunakannya untuk memfilter hasil pencarian untuk menyertakan dokumen dengan atribut departemen “HR”, misalnya.

Sebelum Anda dapat menggunakan bidang atau atribut khusus, Anda harus terlebih dahulu membuat bidang dalam indeks. Gunakan konsol untuk mengedit pemetaan bidang sumber data untuk menambahkan bidang khusus atau menggunakan [UpdateIndex](https://docs.aws.amazon.com/kendra/latest/APIReference/API_UpdateIndex.html)API untuk membuat bidang indeks. Anda tidak dapat mengubah tipe data bidang setelah Anda membuat bidang.

Untuk sebagian besar sumber data, Anda memetakan bidang di sumber data eksternal ke bidang yang sesuai Amazon Kendra. Untuk informasi lebih lanjut, lihat [Memetakan bidang sumber data](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). Untuk sumber data S3, Anda dapat membuat bidang atau atribut khusus menggunakan file metadata JSON.

Anda dapat membuat hingga 500 bidang atau atribut khusus.

Anda juga dapat menggunakan bidang yang Amazon Kendra dipesan atau umum. Untuk informasi selengkapnya, lihat [Atribut atau bidang dokumen](https://docs.aws.amazon.com/kendra/latest/dg/hiw-document-attributes.html).

**Topics**
+ [Memperbarui bidang dokumen kustom](#update-attributes)

## Memperbarui bidang dokumen kustom
<a name="update-attributes"></a>

Dengan `UpdateIndex` API, Anda menambahkan bidang atau atribut khusus menggunakan `DocumentMetadataConfigurationUpdates` parameter.

Contoh JSON berikut digunakan `DocumentMetadataConfigurationUpdates` untuk menambahkan bidang yang disebut “Departemen” ke indeks.

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

Bagian berikut mencakup contoh untuk menambahkan atribut atau bidang khusus menggunakan [BatchPutDocument](https://docs.aws.amazon.com/kendra/latest/APIReference/API_BatchPutDocument.html)dan untuk sumber data Amazon S3.

**Topics**
+ [Menambahkan atribut atau bidang khusus dengan BatchPutDocument API](#custom-attributes-batch)
+ [Menambahkan atribut atau bidang khusus ke sumber Amazon S3 data](#custom-attributes-s3)

### Menambahkan atribut atau bidang khusus dengan BatchPutDocument API
<a name="custom-attributes-batch"></a>

Saat Anda menggunakan [BatchPutDocument](https://docs.aws.amazon.com/kendra/latest/APIReference/API_BatchPutDocument.html)API untuk menambahkan dokumen ke indeks, Anda menentukan bidang atau atribut khusus sebagai bagian dari`Attributes`. Anda dapat menambahkan beberapa bidang atau atribut saat memanggil API. Anda dapat membuat hingga 500 bidang atau atribut khusus. Contoh berikut adalah bidang atau atribut khusus yang menambahkan “Departemen” ke dokumen.

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

### Menambahkan atribut atau bidang khusus ke sumber Amazon S3 data
<a name="custom-attributes-s3"></a>

Saat Anda menggunakan bucket S3 sebagai sumber data untuk indeks Anda, Anda menambahkan metadata ke dokumen dengan file metadata pendamping. Letakkan file JSON metadata dalam struktur direktori yang paralel dengan dokumen Anda. Untuk informasi selengkapnya, lihat [metadata dokumen S3](https://docs.aws.amazon.com/kendra/latest/dg/s3-metadata.html).

Anda menentukan bidang kustom atau atribut dalam struktur `Attributes` JSON. Anda dapat membuat hingga 500 bidang atau atribut khusus. Misalnya, contoh berikut digunakan `Attributes` untuk menentukan tiga bidang atau atribut khusus dan satu bidang cadangan.

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

Langkah-langkah berikut memandu Anda untuk menambahkan atribut khusus ke sumber data Amazon S3.

**Topics**
+ [Langkah 1: Buat indeks Amazon Kendra](#custom-attributes-s3-1)
+ [Langkah 2: Perbarui indeks untuk menambahkan bidang dokumen khusus](#custom-attributes-s3-2)
+ [Langkah 3: Buat sumber data Amazon S3 dan petakan bidang sumber data ke atribut khusus](#custom-attributes-s3-3)

#### Langkah 1: Buat indeks Amazon Kendra
<a name="custom-attributes-s3-1"></a>

Ikuti langkah-langkah [Membuat Indeks](create-index.md) untuk membuat indeks Amazon Kendra Anda.

#### Langkah 2: Perbarui indeks untuk menambahkan bidang dokumen khusus
<a name="custom-attributes-s3-2"></a>

Setelah membuat indeks, Anda menambahkan bidang ke dalamnya. Prosedur berikut menunjukkan cara menambahkan bidang ke indeks menggunakan konsol dan CLI.

------
#### [ Console ]

**Untuk membuat bidang indeks**

1. Pastikan Anda telah [membuat indeks](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html).

1. Kemudian, dari menu navigasi kiri, dari **Manajemen data**, pilih **Definisi Facet**.

1. Di **Panduan pengaturan bidang Indeks**, dari **bidang Indeks**, pilih **Tambahkan bidang** untuk menambahkan bidang khusus.

1. Dalam kotak dialog **Add index field**, lakukan hal berikut:
   + **Nama bidang** - Tambahkan nama bidang.
   + **Tipe data** - Pilih tipe data, apakah **String**, **daftar String**, atau **Tanggal**.
   + **Jenis penggunaan** **— Pilih jenis penggunaan, apakah **Facetable, Searchable****, **Displayable****, dan Sortable.**

     Kemudian, pilih **Tambahkan**.

   Ulangi langkah terakhir untuk bidang lain yang ingin Anda petakan.

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

------

#### Langkah 3: Buat sumber data Amazon S3 dan petakan bidang sumber data ke atribut khusus
<a name="custom-attributes-s3-3"></a>

Untuk membuat sumber data Amazon S3 dan memetakan bidang ke sana, ikuti petunjuk di. [Amazon S3](data-source-s3.md)

Jika Anda menggunakan API, gunakan `fieldMappings` atribut di bawah `configuration` saat Anda menggunakan [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html)API.

Untuk gambaran umum tentang cara bidang sumber data dipetakan, lihat[Memetakan bidang sumber data](field-mapping.md).