Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Buat basis pengetahuan Amazon Bedrock dengan grafik Amazon Neptune Analytics
GraphRAG sepenuhnya terintegrasi ke dalam Amazon Bedrock Knowledge Bases dan menggunakan Amazon Neptune Analytics untuk penyimpanan grafik dan vektor. Anda dapat mulai menggunakan GraphRag di basis pengetahuan Anda dengan Konsol Manajemen AWS, the AWS CLI, atau AWS SDK.
Anda tidak memerlukan infrastruktur grafik yang ada untuk mulai menggunakan GraphRag. Amazon Bedrock Knowledge Bases secara otomatis mengelola pembuatan dan pemeliharaan grafik dari Amazon Neptunus. Sistem akan secara otomatis membuat dan memperbarui grafik dengan mengekstraksi entitas, fakta, dan hubungan dari dokumen yang Anda unggah ke bucket Amazon S3 Anda. sehingga Anda dapat memberikan tanggapan yang relevan kepada pengguna akhir Anda, tanpa pengetahuan sebelumnya dalam pemodelan grafik. Grafik akan disimpan di Amazon Neptune Analytics.
Saat Anda membuat basis pengetahuan, Anda mengatur atau menentukan yang berikut:
-
Informasi umum yang mendefinisikan dan mengidentifikasi basis pengetahuan.
-
Peran layanan dengan izin ke basis pengetahuan.
-
Konfigurasi untuk basis pengetahuan, termasuk model penyematan yang akan digunakan saat mengonversi data dari sumber data, dan konfigurasi penyimpanan untuk layanan tempat menyimpan penyematan.
Anda tidak dapat membuat basis pengetahuan dengan pengguna root. Masuk dengan pengguna IAM sebelum memulai langkah-langkah ini.
Berikut ini menunjukkan cara membuat basis pengetahuan untuk menggunakan Neptune GraphRag dari konsol dan menggunakan CLI.
- Console
-
Untuk membuat basis pengetahuan untuk Neptune Analytics dari konsol
-
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.
-
Di panel navigasi kiri, pilih Bas is pengetahuan.
-
Di bagian Basis pengetahuan, pilih Buat, lalu pilih Pangkalan Pengetahuan dengan penyimpanan vektor.
-
(Opsional) Di bawah Detail Pangkalan Penget ahuan, ubah nama default dan berikan deskripsi untuk basis pengetahuan Anda.
-
Di bawah izin IAM, pilih peran IAM yang memberikan izin Amazon Bedrock untuk mengakses lainnya yang diperlukan. Layanan AWS Anda dapat meminta Amazon Bedrock membuat peran layanan untuk Anda, atau Anda dapat memilih untuk menggunakan peran khusus Anda sendiri yang telah Anda buat untuk Neptune Analytics. Sebagai contoh, lihat Izin untuk mengakses database vektor Anda di Amazon Neptune Analytics.
-
Pastikan untuk memilih Amazon S3 sebagai sumber data Anda dan pilih Ber ikutnya untuk mengonfigurasi sumber data Anda.
-
Berikan URI S3 dari file yang akan digunakan sebagai sumber data untuk menghubungkan basis pengetahuan Anda ke dan untuk diintegrasikan dengan Amazon Neptune Analytics. Untuk langkah-langkah tambahan dan informasi opsional yang dapat Anda berikan, lihatHubungkan sumber data ke basis pengetahuan Anda.
-
Di bagian model Embeddings, pilih model embeddings untuk mengonversi data Anda menjadi penyematan vektor. Secara opsional, Anda dapat menggunakan bagian Konfigurasi tambahan untuk menentukan dimensi vektor. Untuk jenis penyematan, sebaiknya gunakan penyematan vektor floating-point.
Dimensi vektor model embeddings harus sesuai dengan dimensi vektor yang Anda tentukan saat membuat grafik Neptune Analytics.
-
Di bagian database vektor, pilih metode untuk membuat penyimpanan vektor, lalu pilih Amazon Neptune Analytics (GraphRag) sebagai penyimpanan vektor Anda untuk menyimpan penyematan yang akan digunakan untuk kueri. Untuk membuat toko vektor Anda, Anda dapat menggunakan salah satu metode berikut:
-
Kami menyarankan Anda menggunakan metode Cepat buat penyimpanan vektor baru untuk memulai dengan cepat membuat toko vektor Anda. Pilih Amazon Neptune Analytics (GraphRag) sebagai toko vektor Anda. Opsi ini tidak mengharuskan Anda memiliki sumber daya Neptune Analytics yang ada. Basis pengetahuan secara otomatis menghasilkan dan menyimpan penyematan dokumen di Amazon Neptunus, bersama dengan representasi grafik entitas dan hubungannya yang berasal dari korpus dokumen.
-
Atau, jika Anda telah membuat grafik Neptune Analytics dan indeks vektor, Anda dapat menggunakan opsi Pilih toko vektor yang telah Anda buat. Pilih Amazon Neptune Analytics (GraphRAG) sebagai penyimpanan vektor Anda, dan identifikasi grafik ARN, nama bidang vektor, dan nama bidang metadata dalam indeks vektor. Untuk informasi selengkapnya, lihat Prasyarat untuk menggunakan penyimpanan vektor yang Anda buat untuk basis pengetahuan.
-
Di bagian Model untuk konstruksi grafik, pilih model pondasi yang akan digunakan untuk mengekstraksi entitas dan hubungan dari dokumen Anda selama penyerapan. Izin yang diperlukan untuk model yang dipilih secara otomatis ditambahkan ke peran layanan basis pengetahuan.
Beberapa model hanya didukung melalui profil inferensi lintas wilayah. Saat Anda memanggil profil inferensi lintas wilayah di Amazon Bedrock, permintaan dan data yang akan dicerna berasal dari Wilayah sumber dan secara otomatis dialihkan ke salah satu Wilayah tujuan yang ditentukan dalam profil tersebut, mengoptimalkan kinerja. Wilayah tujuan untuk profil inferensi Lintas wilayah Global mencakup semua Wilayah komersial. Misalnya, Anda dapat menentukan modelArn untuk panggilan Lintas wilayah berbasis AS dari Wilayah us-west-2 menggunakan format. arn:aws:bedrock:us-west-2:account-id:inference-profile/us.anthropic.claude-haiku-4-5-20251001-v1:0
Untuk panduan tentang cara menggunakan profil inferensi untuk memilih Wilayah sumber dan tujuan, lihat Wilayah dan model yang Didukung untuk profil inferensi. Data Anda hanya disimpan di Wilayah sumber yang sesuai dengan basis pengetahuan Amazon Bedrock dan instans Amazon Neptune Analytics. Wilayah tujuan digunakan untuk inferensi saja.
-
Pilih Berikutnya dan tinjau detail basis pengetahuan Anda. Anda dapat mengedit bagian apa pun sebelum melanjutkan dan membuat basis pengetahuan Anda.
Waktu yang dibutuhkan untuk membuat basis pengetahuan tergantung pada konfigurasi spesifik Anda. Ketika pembuatan basis pengetahuan telah selesai, status basis pengetahuan berubah menjadi menyatakan siap atau tersedia.
Setelah basis pengetahuan Anda siap dan tersedia, sinkronkan sumber data Anda untuk pertama kalinya dan kapan pun Anda ingin memperbarui konten Anda. Pilih basis pengetahuan Anda di konsol dan pilih Sin kronisasi di bagian ikhtisar sumber data.
-
Pilih Buat basis pengetahuan. Sementara Amazon Bedrock membuat basis pengetahuan, Anda akan melihat status Sedang berjalan. Anda harus menunggu pembuatan selesai sebelum Anda dapat menyinkronkan sumber data.
-
Setelah Amazon Bedrock selesai membuat basis pengetahuan, untuk mengonfigurasi sumber data, ikuti instruksi diHubungkan sumber data ke basis pengetahuan Anda.
- API
-
Untuk membuat basis pengetahuan untuk Neptune Analytics menggunakan AWS CLI
-
Pertama buat sumber data menggunakan konfigurasi pengayaan konteks. Untuk melakukan operasi ini, kirim CreateDataSource permintaan dengan titik akhir waktu pembuatan A gen untuk Amazon Bedrock. Berikut ini menunjukkan contoh perintah CLI.
aws bedrock-agent create-data-source \
--name graph_rag_source \
--description data_source_for_graph_rag \
--knowledge-base-id LDBBY2K5AG \
--cli-input-json "file://input.json"
Kode berikut menunjukkan isi input.json file.
{
"dataSourceConfiguration": {
"s3Configuration": {
"bucketArn": "arn:aws:s3:::<example-graphrag-datasets>",
"bucketOwnerAccountId": "<ABCDEFGHIJ>",
"inclusionPrefixes": [ <"example-dataset"> ]
},
"type": "S3",
},
"VectorIngestionConfiguration": {
"contextEnrichmentConfiguration":
"type": "BEDROCK_FOUNDATION_MODEL",
"bedrockFoundationModelConfiguration": {
"modelArn": "arn:aws:bedrock:<region>::foundation-model/anthropic.claude-3-haiku-20240307-v1:0",
"enrichmentStrategyConfiguration": {
"method": "CHUNK_ENTITY_EXTRACTION"
}
}
}
}
Untuk yang modelArn digunakan untuk membuat grafik dari dokumen Anda, Anda dapat menggunakan Claude 3 Haiku (seperti yang ditunjukkan pada contoh sebelumnya), Claude Haiku 4.5, dan keluarga Amazon Nova (termasuk model Nova 2 dan Nova dengan modalitas input teks). Untuk melihat model pondasi yang tersedia di Wilayah Anda, lihat Model pondasi yang didukung di Amazon Bedrock.
Beberapa model hanya didukung melalui profil inferensi lintas wilayah. Saat Anda memanggil profil inferensi lintas wilayah di Amazon Bedrock, permintaan dan data yang akan dicerna berasal dari Wilayah sumber dan secara otomatis dialihkan ke salah satu Wilayah tujuan yang ditentukan dalam profil tersebut, mengoptimalkan kinerja. Wilayah tujuan untuk profil inferensi Lintas wilayah Global mencakup semua Wilayah komersial. Misalnya, Anda dapat menentukan modelArn untuk panggilan Lintas wilayah berbasis AS dari Wilayah us-west-2 menggunakan format. arn:aws:bedrock:us-west-2:account-id:inference-profile/us.anthropic.claude-haiku-4-5-20251001-v1:0
Untuk melihat persyaratan kebijakan peran Anda untuk menggunakan profil inferensi, lihat Pras yarat untuk profil inferensi lintas wilayah. Untuk panduan tentang cara menggunakan profil inferensi untuk memilih Wilayah sumber dan tujuan, lihat Wilayah dan model yang Didukung untuk profil inferensi. Data Anda hanya disimpan di Wilayah sumber yang sesuai dengan basis pengetahuan Amazon Bedrock dan instans Amazon Neptune Analytics. Wilayah tujuan digunakan untuk inferensi saja.
-
Untuk membuat basis pengetahuan, kirim CreateKnowledgeBase permintaan dengan titik akhir waktu pembuatan Agen untuk Amazon Bedrock. Berikut ini menunjukkan contoh perintah CLI.
aws bi create-knowledge-base \
--name <"knowledge-base-graphrag"> \
--role-arn arn:aws:iam::<accountId>:role/<BedrockExecutionRoleForKnowledgeBase> \
--cli-input-json "file://input.json"
Berikut ini menunjukkan isi file input.json.
{
"storageConfiguration": {
"type": "NEPTUNE_ANALYTICS"
"neptuneAnalyticsConfiguration": {
"graphArn": "arn:aws:neptune-graph:<region>:<>:graph/<graphID>",
"fieldMapping": {
"metadataField": "metadata",
"textField": "text"
},
}
},
"knowledgeBaseConfiguration": {
"type": "VECTOR",
"vectorKnowledgeBaseConfiguration": {
"embeddingModelArn": "arn:aws:bedrock:<region>::foundation-model/cohere.embed-english-v3"
}
}
}
-
Saat GraphRAG-based aplikasi Anda berjalan, Anda dapat terus menggunakan operasi API Basis Pengetahuan untuk memberikan tanggapan yang lebih komprehensif, relevan, dan dapat dijelaskan kepada pengguna akhir. Bagian berikut menunjukkan cara memulai penyerapan dan melakukan kueri pengambilan menggunakan perintah CLI.
Pilih dan perbarui model konstruksi grafik
GraphRag menggunakan model dasar selama konsumsi untuk mengekstrak entitas dan hubungan dari dokumen Anda. Anda memilih model ini saat Anda membuat basis pengetahuan atau saat Anda mengonfigurasi sumber data. Memilih model konstruksi grafik secara otomatis memungkinkan pengayaan kontekstual.
Model pondasi dapat mencapai akhir masa pakai atau tidak digunakan lagi. Misalnya, Claude 3 Haiku telah pindah ke status Legacy. Kami menyarankan Anda memilih model yang saat ini didukung untuk konstruksi grafik. Untuk memeriksa status model yang tersedia, lihat Siklus hidup model.
Saat Anda memilih model konstruksi grafik, izin yang diperlukan secara otomatis ditambahkan ke peran layanan basis pengetahuan.
Beberapa model hanya tersedia melalui profil inferensi lintas wilayah.
Saat menggunakan inferensi lintas wilayah, data yang akan dicerna berasal dari Wilayah sumber dan dialihkan ke Wilayah tujuan untuk inferensi. Data disimpan hanya di Wilayah sumber yang sesuai dengan basis pengetahuan Amazon Bedrock dan instans Amazon Neptune Analytics.
Pilih model selama pembuatan basis pengetahuan (konsol)
Pada Langkah 3 alur kerja Buat Pangkalan Pengetahuan (konfigurasikan penyimpanan dan pemrosesan data), saat Anda memilih Amazon Neptune Analytics (GraphRag) sebagai jenis penyimpanan vektor, bagian Model untuk konstruksi grafik muncul. Pilih Pilih model untuk memilih model yang akan digunakan untuk mengekstraksi entitas dan hubungan dari dokumen Anda selama proses penyerapan.
Memperbarui model pada sumber data yang ada (konsol)
Arahkan ke halaman detail Pangkalan Pengetahuan. Di bagian Sumber data, pilih sumber data dan pilih Edit. Di halaman edit, di bawah Model untuk konstruksi grafik, pilih model baru. Pilih Kirim untuk menyimpan perubahan Anda.
Pilih model selama pembuatan basis pengetahuan (API)
Saat membuat sumber data melalui CreateDataSource API, tentukan modelArn di bedrockFoundationModelConfiguration dalamcontextEnrichmentConfiguration. Lihat tab API di bagian pembuatan di atas untuk contoh lengkap.
Perbarui model pada sumber data (API) yang ada
Untuk memperbarui model konstruksi grafik pada sumber data yang ada, gunakan update-data-source perintah. Contoh berikut menunjukkan cara menentukan model baru ARN dicontextEnrichmentConfiguration.
aws bedrock-agent update-data-source \
--data-source-id data-source-id \
--knowledge-base-id knowledge-base-id \
--name data-source-name \
--data-source-configuration '{"type":"S3","s3Configuration":{"bucketArn":"arn:aws:s3:::bucket-name"}}' \
--vector-ingestion-configuration '{"contextEnrichmentConfiguration":{"type":"BEDROCK_FOUNDATION_MODEL","bedrockFoundationModelConfiguration":{"modelArn":"model-arn","enrichmentStrategyConfiguration":{"method":"CHUNK_ENTITY_EXTRACTION"}}}}' \
--region region
Misalnya, untuk menggunakan Claude Haiku 4.5 melalui profil inferensi US-based lintas wilayah dari Wil us-west-2 ayah, tentukan modelArn dalam format berikut:
arn:aws:bedrock:us-west-2:account-id:inference-profile/us.anthropic.claude-haiku-4-5-20251001-v1:0
Untuk melihat persyaratan kebijakan peran Anda untuk menggunakan profil inferensi, lihat Pras yarat untuk profil inferensi lintas wilayah. Untuk panduan tentang cara menggunakan profil inferensi untuk memilih Wilayah sumber dan tujuan, lihat Wilayah yang Di dukung dan model untuk profil inferensi.
Sinkronkan sumber data Anda
Setelah Anda membuat basis pengetahuan Anda, Anda menelan atau menyinkronkan data Anda sehingga data dapat ditanyakan. Penyerapan mengekstrak struktur grafis dan mengubah data mentah di sumber data Anda menjadi penyematan vektor, berdasarkan model penyematan vektor dan konfigurasi yang Anda tentukan.
Perintah berikut menunjukkan contoh cara memulai pekerjaan penyerapan menggunakan CLI.
aws bedrock-agent start-ingestion-job \
--data-source-id <"ABCDEFGHIJ"> \
--knowledge-base-id <"EFGHIJKLMN">
Untuk informasi selengkapnya dan cara menyinkronkan sumber data Anda menggunakan konsol dan API, lihatSinkronkan data Anda dengan basis pengetahuan Amazon Bedrock.
Menyerap perubahan ke dalam basis pengetahuan Anda
Saat menggunakan Amazon S3 sebagai sumber data, Anda dapat memodifikasi sumber data dan menyinkronkan perubahan dalam satu langkah. Dengan penyerapan langsung, Anda dapat langsung menambahkan, memperbarui, atau menghapus file dalam basis pengetahuan dalam satu tindakan dan basis pengetahuan Anda dapat memiliki akses ke dokumen tanpa perlu menyinkronkan. Penyerapan langsung menggunakan operasi KnowledgeBaseDocuments API untuk mengindeks dokumen yang Anda kirimkan langsung ke penyimpanan vektor yang disiapkan untuk basis pengetahuan. Anda juga dapat melihat dokumen di basis pengetahuan Anda secara langsung dengan operasi ini, daripada perlu menavigasi ke sumber data yang terhubung untuk melihatnya. Untuk informasi selengkapnya, lihat Ingest berubah langsung menjadi basis pengetahuan.
Uji basis pengetahuan Anda
Sekarang setelah Anda mengatur basis pengetahuan Anda, Anda dapat mengujinya dengan mengirim kueri dan menghasilkan tanggapan.
Kode berikut menunjukkan contoh perintah CLI.
aws bedrock-agent-runtime retrieve \
--knowledge-base-id <"ABCDEFGHIJ"> \
--retrieval-query="{\"text\": \"What are the top three video games available now?\"}"
Lihat informasi yang lebih lengkap di Kueri basis pengetahuan yang terhubung ke grafik Amazon Neptunus Analytics.