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

Basis Pengetahuan yang Dikelola Amazon Bedrock sebagai Target Konektor

Amazon Bedrock Managed Knowledge Bases menyediakan pemanfaatan tambahan generasi (RAG) yang dikelola sepenuhnya: Amazon Bedrock menangani penyimpanan vektor, penyerapan data, dan pengoptimalan pengambilan, sehingga tidak ada infrastruktur pengambilan untuk Anda sediakan atau operasikan. Amazon Bedrock meng AgentCore ekspos basis pengetahuan terkelola sebagai konektor Gateway asli — Anda melampirkannya ke AgentCore Gateway Anda dan agen Anda menemukan dan menanyainya dengan panggilan Protokol Konteks Model (MCP) standar, tanpa integrasi pengambilan khusus untuk dibuat. Untuk detail tentang membuat dan mengelola basis pengetahuan terkelola, lihat Bas is pengetahuan untuk Amazon Bedrock di Panduan Pengguna Amazon Bedrock.

Konektor mengekspos dua alat. Yang pertama adalahAgenticRetrieveStream. Alih-alih pencarian tunggal, 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 membahas 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 Basis Pengetahuan Terkelola Amazon Bedrock. Gateway menangani manajemen skema, resolusi titik akhir, dan otentikasi layanan. Konektor mengekspos dua alat, yang ditemukan agen Anda dengantools/list:

Satu pem Retrieve anggilan mengikuti aliran 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; dis generateResponse et false el untuk mengembalikan hasil saja.

Agen Anda memanggilnya dengan percakapan ()messages. Pengambil yang dikueri — masing-masing menunjuk pada basis pengetahuan terkelola — dikonfigurasi oleh administrator pada target, tidak disediakan oleh agen. Alur kemajuan perencanaan dan pengambilan melalui MCP asnotifications/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 input dan format AgenticRetrieveStream respons.

Kasus penggunaan

Menyiapkan basis pengetahuan terkelola

Untuk petunjuk tentang cara membuat Target Gateway dengan konfigurasi konektor Amazon Bedrock Managed Knowledge Bases, termasuk contoh penyiapan menggunakan Python SDK dan CLI, lihat Menyi apkan basis pengetahuan terkelola di 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 yang diperlukan dan konfigurasi kebijakan, lihat Meng onfigurasi Peran Layanan Gateway di panduan konfigurasi target.

Memanggil alat

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

KarenaAgenticRetrieveStream, agen Anda hanya melewati percakapan. Pengambil 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 ke target, sehingga 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 diatur 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 diatur agen Anda saat dipanggilAgenticRetrieveStream. Secara default, satu-satunya bidang yang terlihat agen adalah. messages Pengambil untuk kueri dan semua konfigurasi pengambilan diatur administrator pada target — lihat Menyiapkan basis pengetahuan terkel ola. Untuk mengekspos lebih banyak bidang ke agen, konfigurasikan parameterOverrides pada target — lihat Mengontrol parameter mana yang dapat diatur 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, rangking ulang, dan pagar pembatas melaluipolicyConfiguration)maxAgentIteration, dan generateResponse — lihat Menyiapkan basis pengetahuan terkelola dan referensi Konfigurasi. Referensi konfigurasi

AgenticRetrieveStream format tanggapan

AgenticRetrieveStreammengalirkan serangkaian peristiwa. Melalui MCP, peristiwa pelacakan disampaikan notifications/message untuk kemajuan waktu nyata, dan hasil pengambilan dan jawaban yang disintesis disampaikan dalam hasil alat. Stream memancarkan jenis peristiwa berikut:

Suatu 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 diatur agen Anda saat dipanggilRetrieve. 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 Mengon trol parameter mana yang dapat disetel 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 bidang yang dapat diganti —numberOfResults, metadata, rangking ulang, dan ku filter eri overrideSearchType gambar multimodal — lihat Referensi konfigurasi. Referensi konfigurasi

Ambil format respons

RetrieveAlat mengembalikan tools/call hasil MCP yang dibungkus dalam JSON-RPC amplop. contentBid isError ang dan ada di dalamresult, dan text bidang berisi retrievalResults payload 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 dalam retrievalResults memiliki struktur sebagai berikut:

Referensi konfigurasi

Bidang berikut ditetapkan oleh administrator diparameterValues, atau diekspos ke agen denganparameterOverrides, saat Anda membuat target. Untuk mengetahui tempat menyetelnya, lihat Men yiapkan basis pengetahuan terkelola dan Mengon trol parameter mana yang dapat disetel agen.

AgenticRetrieveStream — agenticRetrieveConfiguration

Retrieve — managedSearchConfiguration

Penyaringan kontrol akses

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

Untuk menggunakannya:

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