Amazon Kendra tidak akan lagi terbuka untuk pelanggan baru mulai 30 Juli 2026. Jika Anda ingin menggunakan layanan ini, silakan mendaftar sebelum 30 Juli. Untuk kemampuan yang mirip dengan Amazon Kendra, jelajahi Pangkalan Pengetahuan Amazon Bedrock. Pelajari selengkapnya.

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

Amazon Kendra perubahan ketersediaan

Gambaran umum

Setelah mempertimbangkan dengan cermat, kami telah membuat keputusan untuk dimasukkan Amazon Kendra ke dalam Mode Pemeliharaan, efektif 30 Juni 2026. Sampai tanggal ini, tidak akan ada fitur baru atau pengembangan kemampuan untuk layanan ini, dan mulai 30 Juli 2026, layanan akan berhenti menerima pelanggan baru.

Selama Mode Pemeliharaan, layanan tetap didukung penuh dan AWS akan terus memberikan perbaikan bug dan pembaruan keamanan untuk pelanggan yang sudah ada, namun permintaan fitur baru tidak lagi dipertimbangkan.

Kami menyarankan agar pelanggan memigrasikan aplikasi Kendra mereka dan mengimplementasikan aplikasi pencarian baru apa pun di Amazon Bedrock Managed Knowledge Base (BMKB) untuk kemampuan serupa dengan Kendra dan fitur yang lebih canggih untuk kasus penggunaan AI generatif dan AI agen. Basis Pengetahuan Terkelola Bedrock adalah solusi RAG yang dikelola sepenuhnya, dengan konektor bawaan, penguraian cerdas, penyimpanan vektor terkelola dengan pencarian hibrida, bersama dengan kemampuan untuk menghasilkan respons (dengan Retrieve and Generate API) dan melakukan penalaran multi-langkah di berbagai basis pengetahuan (dengan API Pengambilan Agentik). BMKB juga memberi Anda kemampuan untuk menyesuaikan strategi chunking dan menyematkan model untuk mengoptimalkan aplikasi spesifik Anda serta memilih model dasar untuk pembuatan respons. Tingkat fitur dan fleksibilitas baru ini hadir dengan biaya yang dapat diprediksi berdasarkan ukuran basis pengetahuan yang dicerna, jumlah kueri yang dilakukan, dan penggunaan LLM.

Panduan Migrasi

Migrasi dari Amazon Kendra Amazon Bedrock Managed Knowledge Base (BMKB) dapat dilakukan untuk sebagian besar pencarian perusahaan dan beban kerja RAG dengan beberapa perencanaan yang cermat. Tidak semua fitur Kendra tersedia langsung di Basis Pengetahuan Terkelola Batuan Dasar, tetapi banyak yang dapat diimplementasikan melalui solusi. Panduan ini menyediakan jalur migrasi langkah demi langkah yang komprehensif bagi pelanggan Kendra yang ada untuk mentransisikan aplikasi mereka ke BMKB, termasuk pemetaan arsitektur, terjemahan API, contoh kode, analisis kesenjangan fitur, dan solusi yang direkomendasikan.

Fitur Basis Pengetahuan Terkelola Amazon Bedrock

BMKB mengelola seluruh pipa RAG dari ujung ke ujung. Ini mendukung model penyematan termasuk Amazon Titan Text Embeddings V2, Cohere Embed English v3, Cohere Embed Multilingual v3, Cohere Embed v4, dan Amazon Nova Multimodal Embeddings — semuanya diperbaiki pada 1024 dimensi dengan vektor float32. Toko vektor terkelola sepenuhnya dioperasikan oleh Bedrock, menghilangkan kebutuhan untuk menyediakan atau mengelola OpenSearch, Aurora, atau database vektor lainnya. Strategi chunking meliputi Default (ukuran tetap sekitar 300 token), Fixed-size (maxTokens dan OverlapPercentage yang dapat dikonfigurasi), Hierarkis (orangtua-anak dengan konfigurasi level), dan Tanpa Chunking; potongan semantik tidak didukung untuk basis pengetahuan terkelola.

BMKB saat ini mendukung tujuh konektor sumber data: Amazon S3, Confluence, SharePoint Microsoft, Web Crawler, Google Drive, OneDrive Microsoft, dan konektor Kustom. Layanan ini selalu melakukan pencarian hybrid (kata kunci plus semantik) dan tidak menawarkan mode pencarian semantik saja.

Langkah migrasi

Pengaturan Basis Pengetahuan Terkelola Amazon Bedrock

Langkah 1: Konfigurasikan Peran IAM

Buat peran IAM yang memberikan izin Bedrock untuk mengakses sumber data Anda dan memanggil model penyematan. Kebijakan trust harus mengizinkan bedrock.amazonaws.com untuk mengambil peran, dan kebijakan izin harus menyertakan akses ke bucket S3 Anda dan model penyematan yang dipilih.

Konfigurasi IAM (kode Python):

import boto3
import json

iam = boto3.client('iam')

trust_policy = {
    "Version": "2012-10-17",
    "Statement": [{
        "Effect": "Allow",
        "Principal": {"Service": "bedrock.amazonaws.com"},
        "Action": "sts:AssumeRole"
    }]
}

iam.create_role(
    RoleName="BedrockKBRole",
    AssumeRolePolicyDocument=json.dumps(trust_policy),
    Description="Role for Bedrock Managed Knowledge Base"
)

permissions_policy = {
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": ["s3:GetObject", "s3:ListBucket"],
            "Resource": [
                "arn:aws:s3:::your-bucket-name",
                "arn:aws:s3:::your-bucket-name/*"
            ]
        },
        {
            "Effect": "Allow",
            "Action": ["bedrock:InvokeModel"],
            "Resource": ["arn:aws:bedrock:*::foundation-model/amazon.titan-embed-text-v2:0"]
        }
    ]
}

iam.put_role_policy(
    RoleName="BedrockKBRole",
    PolicyName="BedrockKBPermissions",
    PolicyDocument=json.dumps(permissions_policy)
)
                

Langkah 2: Buat Basis Pengetahuan yang Dikelola

Gunakan CreateKnowledgeBase API dengan tipe MANAGED untuk membuat basis pengetahuan:

import boto3

bedrock_agent = boto3.client("bedrock-agent", region_name="us-east-1")

response = bedrock_agent.create_knowledge_base(
    name="my-managed-kb",
    description="Migrated from Kendra index",
    roleArn="arn:aws:iam::123456789012:role/BedrockKBRole",
    knowledgeBaseConfiguration={
        "type": "MANAGED",
        "managedKnowledgeBaseConfiguration": {
            "embeddingModelArn": "arn:aws:bedrock:us-east-1::foundation-model/amazon.titan-embed-text-v2:0",
            "embeddingModelConfiguration": {
                "bedrockEmbeddingModelConfiguration": {
                    "embeddingDataType": "FLOAT32"
                }
            }
        }
    }
)

kb_id = response["knowledgeBase"]["knowledgeBaseId"]
print(f"Created knowledge base: {kb_id}")
                

Langkah 3: Konfigurasikan Sumber Data

Buat sumber data S3 dengan konfigurasi konektor terkelola:

response = bedrock_agent.create_data_source(
    knowledgeBaseId=kb_id,
    name="my-s3-data-source",
    description="Product documentation from S3",
    dataSourceConfiguration={
        "type": "MANAGED_KNOWLEDGE_BASE_CONNECTOR",
        "managedKnowledgeBaseConnectorConfiguration": {
            "connectorParameters": {
                "type": "S3",
                "version": "1",
                "connectionConfiguration": {
                    "bucketName": "your-bucket-name",
                    "bucketOwnerAccountId": "123456789012"
                },
                "filterConfiguration": {
                    "inclusionPrefixes": ["documents/"]
                }
            }
        }
    },
    vectorIngestionConfiguration={
        "parsingConfiguration": {
            "parsingStrategy": "SMART_PARSING"
        }
    }
)

data_source_id = response["dataSource"]["dataSourceId"]
print(f"Created data source: {data_source_id}")
                

Langkah 4: Mulai dan Pantau Tertelan

Memicu konsumsi dokumen dan jajak pendapat untuk penyelesaian:

import time

ingestion_response = bedrock_agent.start_ingestion_job(
    knowledgeBaseId=kb_id,
    dataSourceId=data_source_id,
    description="Initial ingestion"
)

ingestion_job_id = ingestion_response["ingestionJob"]["ingestionJobId"]
print(f"Started ingestion job: {ingestion_job_id}")

while True:
    job_response = bedrock_agent.get_ingestion_job(
        knowledgeBaseId=kb_id,
        dataSourceId=data_source_id,
        ingestionJobId=ingestion_job_id
    )
    job = job_response["ingestionJob"]
    status = job["status"]
    stats = job.get("statistics", {})

    print(f"Status: {status} | Scanned: {stats.get('numberOfDocumentsScanned', 0)} | "
          f"Indexed: {stats.get('numberOfNewDocumentsIndexed', 0)} | "
          f"Failed: {stats.get('numberOfDocumentsFailed', 0)}")

    if status == "COMPLETE":
        print("Ingestion complete!")
        break
    elif status in ("FAILED", "STOPPED"):
        print(f"Ingestion {status}: {job.get('failureReasons', [])}")
        break

    time.sleep(30)
                

Pemetaan Migrasi API dan Contoh Kode

Pemetaan Operasi API

Migrasi Retrieve API

Sebelum (Kendra):

kendra_client = boto3.client("kendra")

response = kendra_client.retrieve(
    IndexId="your-kendra-index-id",
    QueryText="How do I configure VPC endpoints?",
    AttributeFilter={
        "EqualsTo": {
            "Key": "_category",
            "Value": {"StringValue": "networking"}
        }
    },
    PageSize=10
)

for item in response["ResultItems"]:
    print(item["DocumentTitle"])
    print(item["Content"])
            

Setelah (BMKB):

bedrock_runtime = boto3.client("bedrock-agent-runtime", region_name="us-east-1")

response = bedrock_runtime.retrieve(
    knowledgeBaseId="your-kb-id",
    retrievalQuery={
        "text": "How do I configure VPC endpoints?"
    },
    retrievalConfiguration={
        "managedSearchConfiguration": {
            "numberOfResults": 10,
            "filter": {
                "equals": {
                    "key": "category",
                    "value": "networking"
                }
            }
        }
    }
)

for result in response["retrievalResults"]:
    print(f"Score: {result['score']}")
    print(f"Content: {result['content']['text']}")
    print(f"Source: {result['location']['s3Location']['uri']}")
            

Perbedaan utamanya adalah: teks kueri bergerak dari parameter tingkat atas ke Query.text bidang pengambilan bersarang; AttributeFilter menjadi filter dalam dikelolaSearchConfiguration; dan hasilnya menyertakan bidang skor relevansi.

Menggunakan RetrieveAndGenerate untuk RAG

BMKB menyediakan kemampuan RAG asli yang menghilangkan kebutuhan untuk memanggil LLM secara terpisah setelah pengambilan:

response = bedrock_runtime.retrieve_and_generate(
    input={
        "text": "Explain how to configure VPC endpoints for S3 access"
    },
    retrieveAndGenerateConfiguration={
        "type": "KNOWLEDGE_BASE",
        "knowledgeBaseConfiguration": {
            "knowledgeBaseId": "your-kb-id",
            "modelArn": "arn:aws:bedrock:us-east-1::foundation-model/anthropic.claude-3-sonnet-20240229-v1:0",
            "retrievalConfiguration": {
                "managedSearchConfiguration": {
                    "numberOfResults": 5
                }
            }
        }
    }
)

# Generated answer with citations
print(response["output"]["text"])

# Source citations
for citation in response.get("citations", []):
    for ref in citation.get("retrievedReferences", []):
        print(f"Source: {ref['location']['s3Location']['uri']}")
            

API ini mengembalikan respons bahasa alami yang dihasilkan bersama dengan kutipan yang menunjuk kembali ke dokumen sumber, menyediakan RAG bawaan yang tidak ditawarkan Kendra secara asli.

Terjemahan Sintaks Filter Metadata

Kesenjangan Fitur dan Solusi

Tidak semua fitur Kendra tersedia di BMKB. Saran Kueri, Pencarian Segi, Sinonim Kustom, Pemeriksaan Ejaan, Pembelajaran Inkremental, dan Pengayaan Dokumen adalah fitur yang memerlukan solusi di BMKB. Bagian ini membahas solusi tersebut.

Strategi Migrasi Sumber Data

Kesenjangan Cakupan Konektor

Kendra mendukung 32 konektor asli sementara BMKB mendukung 7. Untuk sumber data yang tidak didukung secara langsung oleh BMKB, pendekatan yang disarankan adalah mengekspor konten ke Amazon S3 dan mengonfigurasi sumber data S3 di BMKB.

Pola migrasi untuk konektor yang tidak didukung: Buat pipeline otomatis (menggunakan AWS Lambda, Step Functions, atau EventBridge Amazon Scheduler) yang secara berkala mengekstrak konten dari sistem sumber melalui API-nya, menulis dokumen ke bucket S3 dengan file sespan JSON metadata yang sesuai, dan memicu pekerjaan penyerapan BMKB. Ini mereplikasi perilaku sinkronisasi periodik konektor Kendra.

Migrasi Metadata

Atribut dokumen Kendra harus diterjemahkan ke format metadata BMKB. Di Kendra, atribut didefinisikan pada tingkat indeks dan dilampirkan pada dokumen selama konsumsi. Dalam BMKB, metadata didefinisikan melalui file sidecar .metadata.json yang disimpan bersama dokumen sumber di S3, dengan ukuran maksimum 10 KB per file. Setiap atribut harus diketik sebagai STRING, NUMBER, atau BOOLEAN.

Pemilihan Strategi Chunking

Saat bermigrasi dari Kendra (yang menangani chunking secara internal), Anda harus secara eksplisit memilih strategi chunking untuk BMKB. Untuk sebagian besar skenario migrasi, Fixed-size strategi dengan 200 token dan 30% tumpang tindih memberikan titik awal yang baik. Jika dokumen Anda memiliki struktur hierarkis yang jelas (chapter, section, subsection), pertimbangkan Hirarchical chunking untuk meningkatkan pengambilan konteks luas dan detail spesifik.

Pengujian dan Validasi

Untuk mengevaluasi kinerja, jalankan Kendra dan BMKB secara paralel. Kirim kueri identik ke kedua layanan dan bandingkan hasil menggunakan dimensi berikut: kualitas relevansi (diukur dengan NDCG atau MRR terhadap set uji emas), latensi (p50, p95, waktu respons p99), throughput (kueri per detik di bawah beban), dan kelengkapan (persentase dokumen yang diharapkan diambil).

Buat test harness yang mengevaluasi kualitas pengambilan:

def compare_retrieval(query, kendra_index_id, bmkb_kb_id):
    # Query Kendra
    kendra_results = kendra_client.retrieve(
        IndexId=kendra_index_id,
        QueryText=query,
        PageSize=10
    )

    # Query BMKB
    bmkb_results = bedrock_runtime.retrieve(
        knowledgeBaseId=bmkb_kb_id,
        retrievalQuery={"text": query},
        retrievalConfiguration={
            "managedSearchConfiguration": {"numberOfResults": 10}
        }
    )

    # Compare overlap in top-10 results
    kendra_docs = {r["DocumentId"] for r in kendra_results["ResultItems"]}
    bmkb_docs = {r["location"]["s3Location"]["uri"] for r in bmkb_results["retrievalResults"]}

    overlap = len(kendra_docs.intersection(bmkb_docs))
    print(f"Query: {query}")
    print(f"Result overlap: {overlap}/10 documents in common")
    return overlap
        

Sebelum mengalihkan lalu lintas produksi ke BMKB, verifikasi hal berikut: semua sumber data dicerna dan diperbarui tanpa dokumen yang gagal; filter metadata menghasilkan hasil yang diharapkan untuk semua pola filter aplikasi; solusi kontrol akses membatasi akses yang tidak sah dengan benar; tolok ukur relevansi memenuhi atau melampaui kualitas dasar Kendra; penanganan kesalahan aplikasi memproses format respons BMKB dengan benar; dan pemantauan dan peringatan dikonfigurasi untuk kesalahan dan latensi BMKB API.

Ringkasan

Migrasi dari Amazon Kendra Basis Pengetahuan Terkelola Batuan Dasar membutuhkan dua upaya utama: memasukkan kembali sumber data ke BMKB dan menulis ulang kode aplikasi untuk menggunakan API BMKB. Sementara BMKB memperkenalkan RAG-native kemampuan yang kuat termasuk RetrieveAndGenerate dan pengambilan agen, pelanggan yang menggunakan fitur pencarian perusahaan seperti faceting, saran kueri, sinonim khusus, dan pembelajaran inkremental perlu menerapkan solusi seperti yang dijelaskan dalam panduan ini.

Silakan hubungi AWS Support jika ada pertanyaan tambahan.