View a markdown version of this page

通过 AgentCore Gateway 连接到您的知识库 - Amazon Bedrock
使用 Strands 代理调用

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

通过 AgentCore Gateway 连接到您的知识库

AgentCore Gateway 允许您使用模型上下文协议 (MCP) 将您的 Amazon Bedrock 托管知识库作为工具公开。将知识库目标添加到网关后，任何 MCP-compatible 客户端都可以将知识库作为标准 MCP 工具进行查询。该连接器提供了两个工具：

  • AgenticRetrieveStream— 一种多步骤的流式代理检索，可通过迭代方式规划、检索和流式传输结果，还有一个可选的综合的、有引文支持的答案。

  • Retrieve— 一次搜索可返回最相关的段落以及参考文献。

网关充当中介，处理身份验证、参数注入和架构子集设置。作为管理员，您可以绑定知识库并控制哪些参数向呼叫代理公开，哪些参数使用预先配置的默认值隐藏。

注意

知识库网关目标仅支持托管知识库，并且仅支持 IAM-based 出站身份验证（GATEWAY_IAM_ROLE凭据提供者类型）。

先决条件

  • 托管知识库及其知识库 ID。

  • 具有从知识库（在知识库 ARN bedrock:Retrieve 上）检索权限的网关和网关服务角色。 AgentCore

有关完整说明（包括使用 AWS SDK 或 AWS CLI 创建网关目标、配置网关服务角色和信任策略、控制代理可以设置的检索参数、调用工具以及完整的输入和响应架构），请参阅 Amazon Bedrock 开发者指南中作为连接器目标的 Amazon Bedro AgentCore ck 托管知识库。

使用 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 客户机设置相比的主要变化是：

  • 将mcp包裹streamablehttp_client中的内容替换为 f aws_iam_streamablehttp_client rom mcp-proxy-for-aws。

  • 将设置endpoint为您的 AgentCore 网关 URL。

  • 指定 aws_service="bedrock-agentcore" SigV4 签名。

连接后，可以自动发现知识库工具tools/list，无需额外配置即可供代理使用。