View a markdown version of this page

透過 AgentCore Gateway 連接到您的知識庫 - Amazon Bedrock
使用 Strands 代理程式調用

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

透過 AgentCore Gateway 連接到您的知識庫

AgentCore Gateway 可讓您使用模型內容通訊協定 (MCP)，將 Amazon Bedrock 受管知識庫公開為工具。將知識庫目標新增至閘道後，任何與 MCP 相容的用戶端都可以查詢知識庫做為標準 MCP 工具。連接器會公開兩個工具：

  • AgenticRetrieveStream — 多步驟的串流代理程式擷取，可規劃、反覆擷取和串流回結果，以及選用的合成引述後端答案。

  • Retrieve — 單一搜尋，傳回具有來源參考的最相關段落。

閘道充當處理身分驗證、參數注入和結構描述子集的中介裝置。身為管理員，您可以繫結知識庫，並控制哪些參數公開給呼叫代理程式，以及哪些參數使用預先設定的預設值隱藏。

注意

知識庫閘道目標僅支援受管知識庫，且僅支援 IAM 型傳出身分驗證 (GATEWAY_IAM_ROLE登入資料提供者類型）。

先決條件

  • 受管知識庫及其知識庫 ID。

  • AgentCore Gateway 和閘道服務角色，具有從知識庫擷取 (bedrock:Retrieve在知識庫 ARN 上） 的許可。

如需完整說明，包括使用 AWS SDK 或 AWS CLI 建立閘道目標、設定閘道服務角色和信任政策、控制代理程式可以設定的擷取參數、叫用工具，以及完整的輸入和回應結構描述，請參閱《Amazon Bedrock AgentCore 開發人員指南》中的將 Amazon Bedrock 受管知識庫作為連接器目標。 AgentCore

使用 Strands 代理程式調用

如果您有使用 Strands Agents SDK 和 AgentCore 入門工具組建置的現有代理程式，您可以透過切換 MCP 用戶端來對閘道端點使用 SigV4 身分驗證，將其連接到知識庫閘道目標。

安裝 mcp-proxy-for-aws 套件：

pip install mcp-proxy-for-aws

然後，更新您的 MCP 用戶端以使用 IAM 身分驗證指向閘道 URL：

from mcp_proxy_for_aws.client import aws_iam_streamablehttp_client
from strands.tools.mcp.mcp_client import MCPClient

GATEWAY_URL = "https://your-gateway-url/mcp"

def get_streamable_http_mcp_client() -> MCPClient:
    """Returns an MCP Client with SigV4 auth for AgentCore Gateway."""
    return MCPClient(lambda: aws_iam_streamablehttp_client(
        endpoint=GATEWAY_URL,
        aws_region="us-west-2",
        aws_service="bedrock-agentcore",
    ))

標準 MCP 用戶端設定的金鑰變更如下：

  • 將 streamablehttp_client mcp套件中的 取代aws_iam_streamablehttp_client為 mcp-proxy-for-aws。

  • 將 endpoint設定為 AgentCore Gateway URL。

  • aws_service="bedrock-agentcore" 為 SigV4 簽署指定 。

連線後，知識庫工具會透過 自動探索tools/list，並可供代理程式使用，無需額外的組態。