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

Menggunakan pengambilan agentik untuk mengueri basis pengetahuan

Pengambilan agentic menggunakan model dasar untuk secara cerdas menguraikan kueri kompleks menjadi sub-kueri, secara berulang mengambil informasi yang relevan dari basis pengetahuan Anda, dan mengevaluasi apakah hasil yang diambil cukup untuk menjawab kueri asli. Pendekatan ini meningkatkan akurasi pengambilan untuk pertanyaan multi-langkah yang kompleks yang mungkin tidak sepenuhnya ditangani oleh satu jalur pengambilan.

Misalnya, mengingat pertanyaan “Majalah mana yang dimulai lebih dulu, Majalah Arthur atau Pertama untuk Wanita?” , pengambilan agen memecah ini menjadi sub-kueri terpisah seperti “Kapan Majalah Arthur didirikan?” dan “Kapan First for Women didirikan?” , mengambil hasil untuk masing-masing, dan mengevaluasi apakah hasil gabungan cukup.

Cara kerja pengambilan agen

Saat Anda mengirim permintaan ke AgenticRetrieveStream API, proses berikut terjadi:

Prasyarat

Sebelum Anda dapat menggunakan agentic retrieval, Anda harus memiliki yang berikut:

Kueri basis pengetahuan dengan pengambilan agen

Untuk menggunakan pengambilan agen, kirim permintaan. AgenticRetrieveStream Respons adalah aliran yang mencakup hasil pengambilan dan peristiwa pelacakan.

Tabel berikut menjelaskan bidang permintaan kunci:

Untuk sintaks permintaan dan respons lengkap, lihat AgenticRetrieveStream di referensi API.

Respon pengambilan agen

Resp AgenticRetrieveStream onsnya adalah aliran yang berisi jenis peristiwa berikut:

Gunakan AgentCore Memori dengan pengambilan agen

Anda dapat memberikan akses pengambilan agen ke sumber daya Amazon Bedrock Memory AgentCore . Dengan akses memori, pengambilan dapat melanjutkan sesi sebelumnya dan memanfaatkan apa yang telah dipelajari agen di sesi sebelumnya. Menye memoryConfiguration diakan bidang dengan sumber daya memori di akun Anda yang ada di ACTIVE negara bagian. memoryId

Memori adalah opsional. A memoryConfiguration yang menetapkan hanya a memoryId tidak valid. Saat Anda memas memoryConfiguration ok, Anda harus menggunakan sumber daya memori setidaknya dalam salah satu dari dua cara berikut:

Menyediakan ruang nama persis seperti yang dikonfigurasi pada strategi memori, dengan placeholder sudah diselesaikan. Misalnya, jika strategi mendefinisikan namespace/strategy/{memoryStrategyId}/actor/{actorId}, berikan nilai yang diselesaikan daripada template. Untuk informasi selengkapnya tentang ruang nama, strategi, dan catatan memori, lihat Terminologi memori di Panduan Pengembang Amazon Bedrock AgentCore .

Ketika sessionBinding diatur, gunakan persistenceMode untuk mengontrol apakah pertukaran saat ini ditulis kembali ke sesi:

Contoh berikut mengembalikan sesi sebelumnya, memberikan agen akses ke memori jangka panjang aktor tersebut, dan mempertahankan pertukaran kembali ke sesi:

{
    "messages": [
        {
            "content": {
                "text": "What did we decide about the migration timeline?"
            },
            "role": "user"
        }
    ],
    "retrievers": [
        {
            "configuration": {
                "knowledgeBase": {
                    "knowledgeBaseId": "KB12345678"
                }
            }
        }
    ],
    "agenticRetrieveConfiguration": {
        "foundationModelType": "MANAGED",
        "rerankingModelType": "MANAGED"
    },
    "memoryConfiguration": {
        "memoryId": "projectAssistantMemory-1a2b3c4d5e",
        "sessionBinding": {
            "actorId": "user-123",
            "sessionId": "session-456"
        },
        "retrievalConfigs": [
            {
                "namespace": "/strategy/summarization-1a2b3c4d5e/actor/user-123"
            }
        ],
        "persistenceMode": "DEFAULT"
    }
}

Aliran respons melaporkan aktivitas memori. Pemulihan muncul sebagai peristiwa pel acakan pemuatan riwayat sesi. Catatan yang dikembalikan memori jangka panjang muncul pada peristiwa pel acakan pengambilan dengan jenis sumberBedrockAgentCoreMemory, langkah mana pun yang mengambilnya.

Bagaimana pengambilan itu sendiri muncul tergantung pada kapan itu terjadi. Ketika model dasar memilih untuk mencari memori (tipikal pada sesi lanjutan), pengambilan muncul sebagai memoryRetrieve tindakan pada peristiwa pelac akan perencanaan. Pada sesi baru, agen malah dapat mengambil memori jangka panjang selama pengambilan Spekulatif, sebelum langkah perencanaan pertama, dalam hal ini ia tidak memoryRetrieve mengeluarkan tindakan. Untuk informasi selengkapnya, lihat Respon pengambilan agen.

Izin yang diperlukan untuk pengambilan agen

Untuk menggunakan AgenticRetrieveStream API, identitas IAM yang memanggil harus memiliki izin berikut:

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "bedrock:AgenticRetrieveStream",
            "Resource": "*"
        },
        {
            "Effect": "Allow",
            "Action": [
                "bedrock:Retrieve",
                "bedrock:GetDocumentContent"
            ],
            "Resource": "arn:aws:bedrock:region:account-id:knowledge-base/*"
        },
        {
            "Effect": "Allow",
            "Action": "bedrock:InvokeModelWithResponseStream",
            "Resource": "*"
        }
    ]
}

Jika Anda menggunakan pagar pembatas dengan pengambilan agentic, tambahkan izin berikut:

{
    "Effect": "Allow",
    "Action": [
        "bedrock:GetGuardrail",
        "bedrock:ApplyGuardrail"
    ],
    "Resource": "*"
}

Jika Anda menggunakan sumber daya AgentCore Memori dengan pengambilan agentic, tambahkan izin berikut:

{
    "Effect": "Allow",
    "Action": [
        "bedrock-agentcore:GetMemory",
        "bedrock-agentcore:ListEvents",
        "bedrock-agentcore:RetrieveMemoryRecords",
        "bedrock-agentcore:CreateEvent"
    ],
    "Resource": "arn:aws:bedrock-agentcore:region:account-id:memory/memory-id"
}

bedrock-agentcore:ListEventsdiperlukan hanya ketika Anda mengatursessionBinding. bedrock-agentcore:RetrieveMemoryRecordsdiperlukan hanya ketika Anda mengaturretrievalConfigs. bedrock-agentcore:CreateEventdiperlukan hanya ketika persistenceMode adaDEFAULT.

Jika sumber daya memori dienkripsi dengan kunci yang dikelola pelanggan, tambahkan izin berikut pada kunci tersebut:

{
    "Effect": "Allow",
    "Action": "kms:Decrypt",
    "Resource": "arn:aws:kms:region:account-id:key/key-id"
}

Pertimbangan-pertimbangan

Ingatlah hal berikut saat menggunakan pengambilan agen: