Basis Pengetahuan Dikelola Amazon Bedrock sebagai Target Konektor

Amazon Bedrock Managed Knowledge Bases menyediakan full managed retrieval-augmented generation (RAG): Amazon Bedrock menangani penyimpanan vektor, konsumsi data, dan pengoptimalan pengambilan, sehingga tidak ada infrastruktur pengambilan untuk Anda sediakan atau operasikan. Amazon Bedrock AgentCore mengekspos basis pengetahuan terkelola sebagai konektor Gateway asli — Anda melampirkannya ke AgentCore Gateway dan agen Anda menemukan dan menanyainya dengan panggilan Model Context Protocol (MCP) standar, tanpa integrasi pengambilan kustom untuk dibuat. Untuk detail tentang membuat dan mengelola basis pengetahuan terkelola, lihat Basis pengetahuan untuk Amazon Bedrock di Panduan Pengguna Amazon Bedrock.

Konektor memperlihatkan dua alat. Yang pertama adalahAgenticRetrieveStream. Alih-alih satu pencarian, ia merencanakan strategi pengambilan, menjalankan beberapa langkah pengambilan di seluruh basis pengetahuan terkelola Anda, secara opsional memperluas ke dokumen lengkap, dan mengalirkan kembali hasil pendukung dan jawaban yang disintesis dan didukung kutipan. Retrievemelakukan pencarian hibrida tunggal dan mengembalikan bagian yang paling relevan.

Bagian berikut berjalan melalui cara kerja konektor, pengambilan agen secara mendalam, kasus penggunaan umum, cara mengatur target, dan skema input dan respons untuk kedua alat.

Cara kerjanya

Amazon Bedrock AgentCore menyediakan konektor bawaan ke Pangkalan Pengetahuan Terkelola Amazon Bedrock. Gateway menangani manajemen skema, resolusi titik akhir, dan otentikasi layanan. Konektor memperlihatkan dua alat, yang ditemukan agen Anda dengan: tools/list

Sebuah Retrieve doa tunggal mengikuti alur ini:

Untuk aliran pengambilan agen, lihat Pengambilan agen.

Pengambilan agen

AgenticRetrieveStreammemperlakukan pertanyaan sebagai tugas: alih-alih pencarian hibrida tunggal yang Retrieve berjalan untuk satu kueri, ia merencanakan strategi pengambilan, menjalankan beberapa langkah pengambilan di seluruh basis pengetahuan terkelola Anda, dan mengalirkan kembali hasil pendukung dan jawaban yang disintesis dan didukung kutipan — semuanya dalam satu panggilan alat. Jawaban yang disintesis dikembalikan secara default; diatur generateResponse false untuk mengembalikan hasil saja.

Agen Anda memanggilnya dengan percakapan (messages). Retriever yang ditanyainya — masing-masing menunjuk pada basis pengetahuan terkelola — dikonfigurasi oleh administrator pada target, bukan disediakan oleh agen. Proses perencanaan dan pengambilan mengalir melalui MCP sebagainotifications/message, dan hasil serta jawaban dikembalikan dalam hasil alat.

Untuk selengkapnya tentang cara kerja pengambilan agen, lihat Basis pengetahuan untuk Amazon Bedrock di Panduan Pengguna Amazon Bedrock.

Untuk skema permintaan dan acara, lihat skema AgenticRetrieveStream masukan dan format AgenticRetrieveStream respons.

Kasus penggunaan

Siapkan basis pengetahuan yang dikelola

Untuk petunjuk tentang cara membuat Target Gateway dengan konfigurasi konektor Pangkalan Pengetahuan Terkelola Amazon Bedrock, termasuk contoh penyiapan menggunakan Python SDK dan CLI, lihat Menyiapkan basis pengetahuan terkelola dalam panduan konfigurasi target.

Konfigurasikan Peran Layanan Gateway

Gateway memerlukan peran layanan yang memungkinkan AgentCore layanan melakukan tindakan pengambilan pada basis pengetahuan terkelola atas nama Anda. Untuk izin IAM dan konfigurasi kebijakan yang diperlukan, lihat Mengonfigurasi Peran Layanan Gateway dalam panduan konfigurasi target.

Memanggil alat

Setelah Anda membuat target, agen Anda menemukan alat dengan tools/list dan memanggil mereka dengantools/call. Setiap nama alat diawali dengan nama target, dalam bentuk <target-name>_<tool-name>_AgenticRetrieveStream ataumanaged-kb___Retrieve).

KarenaAgenticRetrieveStream, agen Anda hanya melewati percakapan. Retriever dikonfigurasi pada target oleh administrator, sehingga agen tidak mengirim ID basis pengetahuan:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "managed-kb___AgenticRetrieveStream",
    "arguments": {
      "messages": [
        { "role": "user", "content": { "text": "How do I configure a knowledge base target?" } }
      ]
    }
  }
}

UntukRetrieve, pengenal basis pengetahuan terkelola terikat pada target, jadi agen Anda hanya meneruskan kueri:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "managed-kb___Retrieve",
    "arguments": {
      "retrievalQuery": { "text": "What is Amazon Bedrock AgentCore?" }
    }
  }
}

Jika Anda mengekspos parameter pengambilan ke agen (lihat Mengontrol parameter mana yang dapat disetel agen), agen dapat mengganti default yang dikonfigurasi administrator pada waktu panggilan:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "managed-kb___Retrieve",
    "arguments": {
      "retrievalQuery": { "text": "insurance benefits" },
      "retrievalConfiguration": {
        "managedSearchConfiguration": { "numberOfResults": 2 }
      }
    }
  }
}

AgenticRetrieveStream skema masukan

Skema yang dikembalikan oleh tools/list adalah kumpulan bidang yang dapat disetel agen Anda saat memanggilAgenticRetrieveStream. Secara default, satu-satunya bidang yang terlihat agen adalah. messages Retriever untuk kueri dan semua konfigurasi pengambilan ditetapkan administrator pada target — lihat Menyiapkan basis pengetahuan terkelola. Untuk mengekspos lebih banyak bidang ke agen, konfigurasikan parameterOverrides pada target — lihat Mengontrol parameter mana yang dapat ditetapkan agen.

{
  "type": "object",
  "properties": {
    "messages": {
      "description": "The messages for the agentic retrieval conversation. Contains the user query and conversation history.",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "role": {
            "description": "The role of the message sender (user or assistant).",
            "type": "string",
            "enum": ["user", "assistant"]
          },
          "content": {
            "description": "The content of the message.",
            "type": "object",
            "properties": {
              "text": {
                "description": "The text content of the message.",
                "type": "string"
              }
            }
          }
        },
        "required": ["content", "role"]
      }
    }
  },
  "required": ["messages"]
}

Untuk bidang yang ditetapkan administrator —retrievers, agenticRetrieveConfiguration (model dasar, reranking, dan pagar pembatas melaluipolicyConfiguration)maxAgentIteration, dan generateResponse — lihat Menyiapkan basis pengetahuan terkelola dan referensi Konfigurasi.

AgenticRetrieveStream format respons

AgenticRetrieveStreammengalirkan urutan peristiwa. Melalui MCP, peristiwa jejak dikirimkan notifications/message untuk kemajuan waktu nyata, dan hasil pengambilan serta jawaban yang disintesis disampaikan dalam hasil alat. Aliran memancarkan jenis acara berikut:

Sebuah result acara memiliki struktur sebagai berikut:

{
  "result": {
    "results": [
      {
        "content": {
          "text": "Amazon Bedrock AgentCore manages the storage, indexing, and retrieval infrastructure for a managed knowledge base...",
          "mimeType": "text/plain"
        },
        "sourceRetriever": { "identifier": "kb-retriever-1" },
        "metadata": { "x-amz-bedrock-kb-source-uri": "s3://example-bucket/docs/overview.pdf" }
      }
    ],
    "generatedResponse": {
      "answer": "A managed knowledge base lets Amazon Bedrock AgentCore handle the vector store, ingestion, and retrieval for you.",
      "citations": [
        {
          "startIndex": 0,
          "endIndex": 98,
          "references": [ { "..." : "references to supporting results" } ]
        }
      ]
    }
  }
}

Ambil skema masukan

Skema yang dikembalikan oleh tools/list adalah kumpulan bidang yang dapat disetel agen Anda saat memanggilRetrieve. Secara default, satu-satunya bidang yang terlihat agen adalah. retrievalQuery.text Pengidentifikasi basis pengetahuan terkelola dan semua pengaturan pengambilan ditetapkan administrator pada target. Untuk mengekspos pengaturan pengambilan seperti numberOfResults atau metadata filter ke agen, konfigurasikan parameterOverrides pada target — lihat Mengontrol parameter mana yang dapat ditetapkan agen.

{
  "type": "object",
  "properties": {
    "retrievalQuery": {
      "description": "Contains the query to send the managed knowledge base.",
      "type": "object",
      "properties": {
        "text": {
          "description": "The text of the query made to the managed knowledge base.",
          "type": "string"
        }
      }
    }
  },
  "required": ["retrievalQuery"]
}

Untuk bidang yang ditetapkan administrator dan overridable —numberOfResults, metadata,, reranking, dan kueri gambar filter multimodal overrideSearchType — lihat Referensi konfigurasi.

Ambil format respons

RetrieveAlat mengembalikan hasil MCP tools/call dibungkus dalam JSON-RPC amplop. contentBidang isError dan ada di dalamresult, dan text bidang berisi retrievalResults muatan serial:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "isError": false,
    "content": [
      {
        "type": "text",
        "text": "{\"retrievalResults\":[{\"content\":{\"type\":\"TEXT\",\"text\":\"Amazon Bedrock AgentCore manages the storage, indexing, and retrieval infrastructure for a managed knowledge base...\"},\"location\":{\"type\":\"S3\",\"s3Location\":{\"uri\":\"s3://example-bucket/docs/overview.pdf\"}},\"score\":0.87,\"metadata\":{\"x-amz-bedrock-kb-source-uri\":\"s3://example-bucket/docs/overview.pdf\"}}]}"
      }
    ]
  }
}

Setiap item retrievalResults memiliki struktur sebagai berikut:

Referensi konfigurasi

Bidang berikut ditetapkan oleh administrator diparameterValues, atau diekspos ke agen denganparameterOverrides, saat Anda membuat target. Untuk tempat mengaturnya, lihat Mengatur basis pengetahuan terkelola dan Mengontrol parameter mana yang dapat ditetapkan agen.

AgenticRetrieveStream — agenticRetrieveConfiguration

Retrieve — managedSearchConfiguration

Pemfilteran kontrol akses

Jika basis pengetahuan terkelola Anda menggunakan kontrol akses untuk memfilter hasil per pengguna atau grup, aplikasi panggilan harus lulus userContext dengan permintaan tersebut. Gateway userContext melewati basis pengetahuan, yang menerapkan pemfilteran kontrol akses berdasarkan itu. Gateway tidak terisi userContext dari identitas IAM pemanggil — aplikasi Anda harus menyediakannya secara eksplisit.

Untuk menggunakannya:

{
  "arguments": {
    "retrievalQuery": { "text": "insurance benefits" },
    "userContext": {
      "userId": "user@example.com"
    }
  }
}