View a markdown version of this page

Mengambil dokumen langsung ke basis pengetahuan - Amazon Bedrock

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

Mengambil dokumen langsung ke basis pengetahuan

Topik ini menjelaskan cara menelan dokumen langsung ke basis pengetahuan. Pembatasan berlaku untuk jenis dokumen yang dapat Anda konsumsi secara langsung tergantung pada sumber data Anda. Lihat tabel berikut untuk pembatasan metode yang dapat Anda gunakan untuk menentukan dokumen yang akan diserap:

Jenis sumber data Dokumen ditentukan secara in-line Dokumen di lokasi Amazon S3
Amazon S3 not-supported Tidak supported Ya
Khusus supported Ya supported 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 lebih lanjut tentang kuota ini, lihat kuota layanan Amazon Bedrock di panduan Refer AWS ensi Umum.

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.

  2. Di panel navigasi kiri, pilih Bas is pengetahuan.

  3. Di bagian Basis pengetahuan, pilih basis pengetahuan untuk memasukkan dokumen ke dalamnya.

  4. Di bagian Sumber data, pilih sumber data yang ingin Anda tambahkan, ubah, atau hapus dokumen.

  5. Di bagian Dokumen, pilih Tambahkan dokumen. Kemudian, lakukan salah satu hal berikut:

    • Untuk menambah atau memodifikasi dokumen secara langsung, pilih Tambahkan dokumen secara langsung. Kemudian, lakukan hal berikut:

      1. Di bidang Pengidentifikasi dokumen, tentukan nama unik untuk dokumen. Jika Anda menentukan nama yang sudah ada di sumber data, dokumen akan diganti.

      2. Untuk mengunggah dokumen, pilih Unggah. Untuk menentukan dokumen sebaris, pilih Tambahkan dokumen sebaris, pilih format, dan masukkan teks dokumen di kotak.

      3. (Opsional) Untuk mengaitkan metadata dengan dokumen, pilih Tambahkan metadata dan masukkan kunci, jenis, dan nilai.

    • Untuk menambah atau memodifikasi dokumen dengan menentukan lokasi S3-nya, pilih Tambahkan dokumen S3. Kemudian, lakukan hal berikut:

      1. Di bidang Pengidentifikasi dokumen, tentukan nama unik untuk dokumen. Jika Anda menentukan nama yang sudah ada di sumber data, dokumen akan diganti.

      2. Tentukan apakah lokasi S3 dokumen ada di AWS akun Anda saat ini atau yang berbeda. Kemudian tentukan URI S3 dokumen.

      3. (Opsional) Untuk mengaitkan metadata dengan dokumen, pilih sumber Metadata. Tentukan URI S3 metadata atau pilih Tambahkan metadata dan masukkan kunci, jenis, dan nilai.

  6. Untuk menelan dokumen dan metadata terkait, pilih Tam bah.

Untuk menyerap dokumen langsung ke basis pengetahuan menggunakan Amazon Bedrock API, kirim IngestKnowledgeBaseDocuments permintaan dengan titik akhir waktu pembuatan Agen untuk Amazon Bedrock dan tentukan ID basis pengetahuan dan sumber data yang terhubung dengannya.

catatan

Jika Anda menentukan pengidentifikasi dokumen atau lokasi S3 yang sudah ada di basis pengetahuan, dokumen akan diganti dengan konten baru.

Badan permintaan berisi satu bidangdocuments,, yang memetakan ke array KnowledgeBaseDocument objek, yang masing-masing mewakili konten dan metadata opsional dokumen untuk ditambahkan ke sumber data dan untuk diserap ke dalam basis pengetahuan. Ob KnowledgeBaseDocument jek berisi bidang berikut:

Pilih topik untuk mempelajari cara menelan dokumen untuk jenis sumber data yang berbeda atau untuk melihat contoh:

Menyerap dokumen ke dalam basis pengetahuan yang terhubung ke sumber data kustom

Jika yang dataSourceId Anda tentukan milik sumber data kustom, Anda dapat menambahkan konten dan metadata untuk setiap KnowledgeBaseDocument objek dalam documents array.

Isi dokumen yang ditambahkan ke sumber data kustom dapat didefinisikan dengan cara berikut:

Anda dapat menentukan jenis dokumen berikut secara in-line:

Text

Jika dokumen adalah teks, DocumentContent 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 lapangan dan teks dokumen di data lapangan.

Bytes

Jika dokumen berisi lebih dari teks, ubah menjadi a Base64-string. Ob DocumentContent jek 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.

Jika Anda mengambil dokumen dari lokasi S3, DocumentContent objek di content bidang harus berupa 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 lapangan, dan URI S3 dokumen di uri lapangan.

Metadata untuk dokumen dapat didefinisikan dengan cara berikut:

Jika Anda mendefinisikan metadata sebaris, DocumentMetadata 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 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"
    }
}

Anda juga dapat mengambil metadata dari file dengan ekstensi .metadata.json di lokasi S3. Untuk informasi selengkapnya tentang format file metadata, lihat bagian bidang metadata dokumen diConnect ke Amazon S3 untuk basis pengetahuan Anda.

Jika metadata berasal dari file S3, DocumentMetadata 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 uri lapangan.

Awas

Jika Anda mendefinisikan konten sebaris, Anda harus menentukan metadata sebaris.

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 objek dalam documents array.

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 objek dalam format berikut:

{ 
    "dataSourceType": "string",
    "s3": { 
        "s3Location": { 
            "uri": "string"
        }
    }
}

Sertakan pemilik bucket S3 yang berisi dokumen di bucketOwnerAccountId lapangan, dan URI S3 dokumen di uri lapangan.

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 serap langsung ke basis pengetahuan yang terhubung ke sumber data S3 tidak ditambahkan ke bucket S3 itu sendiri. Sebaiknya tambahkan dokumen-dokumen ini ke sumber data S3 juga agar tidak dihapus atau diganti jika Anda menyinkronkan sumber data Anda.

Contoh badan permintaan

Perluas bagian berikut untuk melihat badan permintaan untuk kasus penggunaan yang berbeda dengan: IngestKnowledgeBaseDocuments

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

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": "<Base64-encoded string>",
                     "mimeType": "application/pdf"
                  },
                  "type": "BYTE"
               },
               "sourceType": "IN_LINE"
            }
         }
     }
   ]
}

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

Contoh berikut menunjukkan penambahan sebaris 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"
         }
     }
   ]
}

Contoh berikut menunjukkan penambahan dokumen bersama metadata ke sumber data S3. Anda dapat menyertakan 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"
            }
        }
    ]
}