Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Menyerap dokumen langsung ke basis pengetahuan
Topik ini menjelaskan cara mencerna dokumen langsung ke basis pengetahuan. Pembatasan berlaku untuk jenis dokumen yang dapat Anda konsumsi langsung tergantung pada sumber data Anda. Lihat tabel berikut untuk pembatasan metode yang dapat Anda gunakan untuk menentukan dokumen yang akan dicerna:
****
| Jenis sumber data | Dokumen didefinisikan secara in-line | Dokumen di lokasi Amazon S3 |
| --- | --- | --- |
| Amazon S3 | Tidak | Ya |
| Khusus | Ya | Ya |
Perluas bagian yang sesuai dengan kasus penggunaan Anda:
**catatan**
Saat Anda menggunakan konsol, Anda dapat menelan hingga 10 dokumen langsung ke basis pengetahuan Anda. Jika Anda menggunakan `IngestKnowledgeBaseDocuments` API sebagai gantinya, Anda dapat memasukkan hingga 25 dokumen ke dalam basis pengetahuan Anda. Untuk informasi selengkapnya tentang kuota ini, lihat [kuota layanan Amazon Bedrock di panduan Referensi AWS](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#limits_bedrock) *Umum*.
## Gunakan konsol
Untuk menambah atau memodifikasi dokumen secara langsung di Konsol Manajemen AWS, lakukan hal berikut:
1. Masuk ke Konsol Manajemen AWS dengan identitas IAM yang memiliki izin untuk menggunakan konsol Amazon Bedrock. Kemudian, buka konsol Amazon Bedrock di [https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock).
1. Di panel navigasi kiri, pilih **Basis pengetahuan**.
1. Di bagian **Basis pengetahuan**, pilih basis pengetahuan untuk mencerna dokumen.
1. Di bagian **Sumber data**, pilih sumber data yang ingin Anda tambahkan, ubah, atau hapus dokumen.
1. Di bagian **Dokumen**, pilih **Tambahkan dokumen**. Kemudian, lakukan salah satu hal berikut:
+ Untuk menambahkan atau memodifikasi dokumen secara langsung, pilih **Tambahkan dokumen secara langsung**. Kemudian, lakukan hal berikut:
1. Di bidang **Pengenal dokumen**, tentukan nama unik untuk dokumen tersebut. Jika Anda menentukan nama yang sudah ada di sumber data, dokumen akan diganti.
1. Untuk mengunggah dokumen, pilih **Unggah**. Untuk menentukan dokumen sebaris, pilih **Tambahkan dokumen sebaris**, pilih format, dan masukkan teks dokumen di dalam kotak.
1. (Opsional) Untuk mengaitkan metadata dengan dokumen, pilih **Tambahkan metadata** dan masukkan kunci, ketik, dan nilai.
+ Untuk menambah atau memodifikasi dokumen dengan menentukan lokasi S3-nya, pilih **Tambahkan dokumen S3**. Kemudian, lakukan hal berikut:
1. Di bidang **Pengenal dokumen**, tentukan nama unik untuk dokumen tersebut. Jika Anda menentukan nama yang sudah ada di sumber data, dokumen akan diganti.
1. Tentukan apakah **lokasi S3** dokumen ada di AWS akun Anda saat ini atau yang lain. Kemudian tentukan URI S3 dokumen.
1. (Opsional) Untuk mengaitkan metadata dengan dokumen, pilih sumber **Metadata**. Tentukan URI S3 dari metadata atau pilih **Tambahkan metadata** dan masukkan kunci, ketik, dan nilai.
1. **Untuk mencerna dokumen dan metadata terkait, pilih Tambah.**
## Gunakan API
Untuk memasukkan dokumen secara langsung ke basis pengetahuan menggunakan Amazon Bedrock API, kirim [IngestKnowledgeBaseDocuments](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_IngestKnowledgeBaseDocuments.html)permintaan dengan [titik akhir waktu pembuatan Agen untuk Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) dan tentukan ID basis pengetahuan dan sumber data yang terhubung dengannya.
**catatan**
Jika Anda menentukan pengenal dokumen atau lokasi S3 yang sudah ada di basis pengetahuan, dokumen akan ditimpa dengan konten baru.
Badan permintaan berisi satu bidang,`documents`, yang memetakan ke array [KnowledgeBaseDocument](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_KnowledgeBaseDocument.html)objek, yang masing-masing mewakili konten dan metadata opsional dokumen untuk ditambahkan ke sumber data dan untuk diserap ke dalam basis pengetahuan. Sebuah [KnowledgeBaseDocument](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_KnowledgeBaseDocument.html)objek berisi bidang-bidang berikut:
+ konten — Peta ke [DocumentContent](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_DocumentContent.html)objek yang berisi informasi tentang isi dokumen yang akan ditambahkan.
+ metadata — (Opsional) Memetakan ke [DocumentMetadata](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_DocumentMetadata.html)objek yang berisi informasi tentang metadata dokumen yang akan ditambahkan. Untuk informasi selengkapnya tentang cara menggunakan metadata selama pengambilan, lihat bagian **Metadata dan pemfilteran** di. [Konfigurasikan dan sesuaikan kueri dan pembuatan respons](kb-test-config.md)
Pilih topik untuk mempelajari cara menelan dokumen untuk tipe sumber data yang berbeda atau untuk melihat contoh:
**Topics**
+ [Menyerap dokumen ke dalam basis pengetahuan yang terhubung ke sumber data khusus](#kb-direct-ingestion-add-custom)
+ [Menyerap dokumen ke dalam basis pengetahuan yang terhubung ke sumber data Amazon S3](#kb-direct-ingestion-add-s3)
+ [Contoh badan permintaan](#w2aac32c12c23c19c17c11b3c19)
### Menyerap dokumen ke dalam basis pengetahuan yang terhubung ke sumber data khusus
Jika yang `dataSourceId` Anda tentukan milik sumber data kustom, Anda dapat menambahkan konten dan metadata untuk setiap [KnowledgeBaseDocument](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_KnowledgeBaseDocument.html)objek dalam array. `documents`
Isi dokumen yang ditambahkan ke sumber data kustom dapat didefinisikan dengan cara berikut:
#### Tentukan dokumen secara in-line
Anda dapat menentukan jenis dokumen berikut secara in-line:
------
#### [ Text ]
Jika dokumen adalah teks, [DocumentContent](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_DocumentContent.html)objek harus dalam format berikut:
```
{
"custom": {
"customDocumentIdentifier": {
"id": "string"
},
"inlineContent": {
"textContent": {
"data": "string"
},
"type": "TEXT"
},
"sourceType": "IN_LINE"
},
"dataSourceType": "CUSTOM"
}
```
Sertakan ID untuk dokumen di `id` bidang dan teks dokumen di `data` lapangan.
------
#### [ Bytes ]
Jika dokumen berisi lebih dari teks, ubah menjadi file Base64-string. [DocumentContent](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_DocumentContent.html)Objek kemudian harus dalam format berikut:
```
{
"custom": {
"customDocumentIdentifier": {
"id": "string"
},
"inlineContent": {
"byteContent": {
"data": blob,
"mimeType": "string"
},
"type": "BYTE"
},
"sourceType": "IN_LINE"
},
"dataSourceType": "CUSTOM"
}
```
Sertakan ID untuk dokumen di `id` bidang, Base64-encoded dokumen di `data` bidang, dan jenis MIME di `mimeType` bidang.
------
#### Menelan dokumen dari S3
Jika Anda menelan dokumen dari lokasi S3, [DocumentContent](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_DocumentContent.html)objek di `content` bidang harus dari bentuk berikut:
```
{
"custom": {
"customDocumentIdentifier": {
"id": "string"
},
"s3Location": {
"bucketOwnerAccountId": "string",
"uri": "string"
},
"sourceType": "S3"
},
"dataSourceType": "CUSTOM"
}
```
Sertakan ID untuk dokumen di `id` bidang, pemilik bucket S3 yang berisi dokumen di `bucketOwnerAccountId` bidang, dan URI S3 dokumen di `uri` bidang.
Metadata untuk dokumen dapat didefinisikan dengan cara berikut:
#### Tentukan metadata in-line
Jika Anda mendefinisikan metadata inline, [DocumentMetadata](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_DocumentMetadata.html)objek di `metadata` bidang harus dalam format berikut:
```
{
"inlineAttributes": [
{
"key": "string",
"value": {
"stringValue": "string",
"booleanValue": boolean,
"numberValue": number,
"stringListValue": [ "string" ],
"type": "STRING" | "BOOLEAN" | "NUMBER" | "STRING_LIST"
}
}
],
"type": "IN_LINE_ATTRIBUTE"
}
```
Untuk setiap atribut yang Anda tambahkan, tentukan kunci di `key` bidang. Tentukan tipe data dari nilai di `type` bidang dan sertakan bidang yang sesuai dengan tipe data. Misalnya, jika Anda menyertakan string, atribut akan dalam format berikut:
```
{
"key": "string",
"value": {
"stringValue": "string",
"type": "STRING"
}
}
```
#### Menelan metadata dari S3
Anda juga dapat menelan metadata dari file dengan ekstensi `.metadata.json` di lokasi S3. Untuk informasi selengkapnya tentang format file metadata, lihat bagian Bidang **metadata dokumen** di. [Connect ke Amazon S3 untuk basis pengetahuan Anda](s3-data-source-connector.md)
Jika metadata berasal dari file S3, [DocumentMetadata](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_DocumentMetadata.html)objek di `metadata` bidang harus dalam format berikut:
```
{
"s3Location": {
"bucketOwnerAccountId": "string",
"uri": "string"
},
"type": "S3_LOCATION"
}
}
```
Sertakan pemilik bucket S3 yang berisi file metadata di `bucketOwnerAccountId` bidang, dan URI S3 dari file metadata di bidang. `uri`
**Awas**
Jika Anda mendefinisikan konten sebaris, Anda harus menentukan metadata inline.
### Menyerap dokumen ke dalam basis pengetahuan yang terhubung ke sumber data Amazon S3
Jika yang `dataSourceId` Anda tentukan milik sumber data S3, Anda dapat menambahkan konten dan metadata untuk setiap [KnowledgeBaseDocument](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_KnowledgeBaseDocument.html)objek dalam array. `documents`
**catatan**
Untuk sumber data S3, Anda dapat menambahkan konten dan metadata hanya dari lokasi S3.
Isi dokumen S3 untuk ditambahkan ke S3 harus ditambahkan ke [DocumentContent](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_DocumentContent.html)objek dalam format berikut:
```
{
"dataSourceType": "string",
"s3": {
"s3Location": {
"uri": "string"
}
}
}
```
Sertakan pemilik bucket S3 yang berisi dokumen di `bucketOwnerAccountId` bidang, dan URI S3 dokumen di `uri` bidang.
Metadata untuk dokumen yang ditambahkan ke sumber data kustom dapat didefinisikan dalam format berikut:
```
{
"s3Location": {
"bucketOwnerAccountId": "string",
"uri": "string"
},
"type": "S3_LOCATION"
}
}
```
**Awas**
Dokumen yang Anda konsumsi langsung ke basis pengetahuan yang terhubung ke sumber data S3 tidak ditambahkan ke bucket S3 itu sendiri. Kami menyarankan Anda menambahkan dokumen-dokumen ini ke sumber data S3 juga sehingga tidak dihapus atau ditimpa jika Anda menyinkronkan sumber data Anda.
### Contoh badan permintaan
Perluas bagian berikut untuk melihat badan permintaan untuk kasus penggunaan yang berbeda dengan`IngestKnowledgeBaseDocuments`:
#### Menambahkan dokumen teks kustom ke sumber data kustom dan menelannya
Contoh berikut menunjukkan penambahan satu dokumen teks ke sumber data kustom:
```
PUT /knowledgebases/{{KB12345678}}/datasources/{{DS12345678}}/documents HTTP/1.1
Content-type: application/json
{
"documents": [
{
"content": {
"dataSourceType": "CUSTOM",
"custom": {
"customDocumentIdentifier": {
"id": "MyDocument"
},
"inlineContent": {
"textContent": {
"data": "Hello world!"
},
"type": "TEXT"
},
"sourceType": "IN_LINE"
}
}
}
]
}
```
#### Menambahkan Base64-encoded dokumen ke sumber data kustom dan menelannya
Contoh berikut menunjukkan penambahan dokumen PDF ke sumber data kustom:
```
PUT /knowledgebases/{{KB12345678}}/datasources/{{DS12345678}}/documents HTTP/1.1
Content-type: application/json
{
"documents": [
{
"content": {
"dataSourceType": "CUSTOM",
"custom": {
"customDocumentIdentifier": {
"id": "MyDocument"
},
"inlineContent": {
"byteContent": {
"data": "",
"mimeType": "application/pdf"
},
"type": "BYTE"
},
"sourceType": "IN_LINE"
}
}
}
]
}
```
#### Tambahkan dokumen dari lokasi S3 ke basis pengetahuan yang terhubung ke sumber data khusus dan menelannya
Contoh berikut menunjukkan penambahan satu dokumen teks ke sumber data kustom dari lokasi S3:
```
PUT /knowledgebases/{{KB12345678}}/datasources/{{DS12345678}}/documents HTTP/1.1
Content-type: application/json
{
"documents": [
{
"content": {
"dataSourceType": "CUSTOM",
"custom": {
"customDocumentIdentifier": {
"id": "MyDocument"
},
"s3": {
"s3Location": {
"uri": "amzn-s3-demo-bucket"
}
},
"sourceType": "S3"
}
}
}
]
}
```
#### Tambahkan dokumen inline ke basis pengetahuan yang terhubung ke sumber data kustom dan sertakan metadata inline
Contoh berikut menunjukkan penambahan inline ke sumber data kustom dokumen bersama metadata yang berisi dua atribut:
```
PUT /knowledgebases/{{KB12345678}}/datasources/{{DS12345678}}/documents HTTP/1.1
Content-type: application/json
{
"documents": [
{
"content": {
"dataSourceType": "CUSTOM",
"custom": {
"customDocumentIdentifier": {
"id": "MyDocument"
},
"inlineContent": {
"textContent": {
"data": "Hello world!"
},
"type": "TEXT"
},
"sourceType": "IN_LINE"
}
},
"metadata": {
"inlineAttributes": [
{
"key": "genre",
"value": {
"stringValue": "pop",
"type": "STRING"
}
},
{
"key": "year",
"value": {
"numberValue": 1988,
"type": "NUMBER"
}
}
],
"type": "IN_LINE_ATTRIBUTE"
}
}
]
}
```
#### Tambahkan dokumen ke basis pengetahuan yang terhubung ke sumber data S3 dan sertakan metadata untuknya
Contoh berikut menunjukkan penambahan dokumen bersama metadata ke sumber data S3. Anda dapat memasukkan metadata hanya melalui S3:
```
PUT /knowledgebases/{{KB12345678}}/datasources/{{DS12345678}}/documents HTTP/1.1
Content-type: application/json
{
"documents": [
{
"content": {
"dataSourceType": "S3",
"s3": {
"s3Location": {
"uri": "amzn-s3-demo-bucket"
}
}
},
"metadata": {
"s3Location": {
"bucketOwnerId": "111122223333",
"uri": "amzn-s3-demo-bucket"
},
"type": "S3_LOCATION"
}
}
]
}
```