Amazon Bedrock 受管知識庫作為連接器目標

Amazon Bedrock 受管知識庫提供全受管擷取擴增產生 (RAG)：Amazon Bedrock 處理向量存放區、資料擷取和擷取最佳化，因此沒有擷取基礎設施可供您佈建或操作。Amazon Bedrock AgentCore 將受管知識庫公開為原生閘道連接器，您可以將其連接到 AgentCore Gateway，而您的代理程式會使用標準模型內容協定 (MCP) 呼叫來探索和查詢它，而不需要建置自訂擷取整合。如需建立和管理受管知識庫的詳細資訊，請參閱《Amazon Bedrock 使用者指南》中的 Amazon Bedrock 知識庫。

連接器會公開兩個工具。第一個是 AgenticRetrieveStream。它會規劃擷取策略，在受管知識庫中執行多個擷取步驟，選擇性地擴展到完整文件，並串流回支援的結果和合成的引述回的答案。 Retrieve會執行單一混合搜尋並傳回最相關的段落。

下列各節會逐步解說連接器的運作方式、深入客服人員擷取、常見使用案例、如何設定目標，以及這兩種工具的輸入和回應結構描述。

運作方式

Amazon Bedrock AgentCore 為 Amazon Bedrock 受管知識庫提供內建連接器。Gateway 會處理結構描述管理、端點解析和服務身分驗證。連接器會公開兩個工具，您的代理程式會使用 來探索這些工具tools/list：

單一Retrieve調用遵循此流程：

如需客服人員擷取流程，請參閱客服人員擷取。

代理程式擷取

AgenticRetrieveStream 會將問題視為任務： 而不是針對一個查詢Retrieve執行的單一混合搜尋，它會規劃擷取策略、跨受管知識庫執行多個擷取步驟，以及串流傳回支援結果和合成的引文後端答案 - 全都在一個工具呼叫中。預設會傳回合成的答案；將 generateResponse設定為 false僅傳回結果。

您的客服人員透過對話叫用它 (messages)。其查詢的擷取器 — 每個指向受管知識庫 — 由目標上的管理員設定，而不是由代理程式提供。透過 MCP 規劃和擷取進度串流，notifications/message結果和答案會在工具結果中傳回。

如需代理程式擷取運作方式的詳細資訊，請參閱《Amazon Bedrock 使用者指南》中的 Amazon Bedrock 知識庫。

如需請求和事件結構描述，請參閱 AgenticRetrieveStream 輸入結構描述和 AgenticRetrieveStream 回應格式。

使用案例

設定受管知識庫

如需如何使用 Amazon Bedrock 受管知識庫連接器組態建立閘道目標的指示，包括使用 Python SDK 和 CLI 的設定範例，請參閱目標組態指南中的設定受管知識庫。

設定閘道服務角色

Gateway 需要一個服務角色，允許 AgentCore 服務代表您在受管知識庫上執行擷取動作。如需必要的 IAM 許可和政策組態，請參閱目標組態指南中的設定閘道服務角色。

叫用工具

建立目標之後，您的客服人員會使用 探索工具tools/list，並使用 呼叫它們tools/call。每個工具名稱的字首都是目標名稱，格式為 <target-name>_<tool-name>_AgenticRetrieveStream或 managed-kb___Retrieve)。

對於 AgenticRetrieveStream，您的代理程式只會傳遞對話。擷取器是由管理員在目標上設定，因此代理程式不會傳送知識庫 IDs：

{
  "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?" } }
      ]
    }
  }
}

對於 Retrieve，受管知識庫識別符繫結至目標，因此您的代理程式只會傳遞查詢：

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

如果您將擷取參數公開給客服人員 （請參閱控制客服人員可以設定的參數)，客服人員可以在呼叫時覆寫管理員設定的預設值：

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

AgenticRetrieveStream 輸入結構描述

傳回的結構描述tools/list是您的客服人員在呼叫 時可以設定的欄位集AgenticRetrieveStream。根據預設，唯一的客服人員可見欄位為 messages。要查詢的擷取器和所有擷取組態都是目標上的管理員設定 — 請參閱設定受管知識庫。若要向客服人員公開更多欄位，請在目標parameterOverrides上設定 - 請參閱控制客服人員可以設定的參數。

{
  "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"]
}

如需管理員設定欄位 — retrievers、 agenticRetrieveConfiguration（基礎模型、重新排名maxAgentIteration、 和透過 的護欄policyConfiguration)，以及 generateResponse — 請參閱設定受管知識庫和組態參考。

AgenticRetrieveStream 回應格式

AgenticRetrieveStream 會串流一系列事件。透過 MCP，追蹤事件會以即時進度notifications/message的形式交付，擷取結果和合成的答案會在工具結果中交付。串流會發出下列事件類型：

result 事件具有下列結構：

{
  "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" } ]
        }
      ]
    }
  }
}

擷取輸入結構描述

傳回的結構描述tools/list是您的客服人員在呼叫 時可以設定的欄位集Retrieve。根據預設，唯一的客服人員可見欄位為 retrievalQuery.text。受管知識庫識別符和所有擷取設定都是目標上的管理員設定。若要filter向代理程式公開擷取設定，例如 numberOfResults或中繼資料，請在目標parameterOverrides上設定 - 請參閱控制代理程式可以設定的參數。

{
  "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"]
}

如需管理員集和可覆寫的欄位 — numberOfResults、中繼資料 filter、、overrideSearchType重新排名和多模式映像查詢 — 請參閱組態參考。

擷取回應格式

Retrieve 工具會傳回包裝在 JSON-RPC 信封中的 MCP tools/call結果。isError 和 content 欄位位於 內result，而 text 欄位包含序列化retrievalResults承載：

{
  "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\"}}]}"
      }
    ]
  }
}

中的每個項目retrievalResults都有下列結構：

組態參考

下列欄位是由管理員在 中設定parameterValues，或在建立目標parameterOverrides時向客服人員公開。如需設定它們的位置，請參閱設定受管知識庫和控制代理程式可以設定的參數。

AgenticRetrieveStream — agenticRetrieveConfiguration

Retrieve — managedSearchConfiguration

存取控制篩選

如果您的受管知識庫使用存取控制來篩選每個使用者或群組的結果，呼叫應用程式必須與請求userContext一起傳遞 。Gateway 會userContext傳遞至知識庫，根據其套用存取控制篩選。Gateway 不會userContext從發起人的 IAM 身分填入 - 您的應用程式必須明確提供。

若要使用它：

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