View a markdown version of this page

AgentCore Gateway を介してナレッジベースに接続する - Amazon Bedrock
Strands エージェントを使用して を呼び出す

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

AgentCore Gateway を介してナレッジベースに接続する

AgentCore Gateway を使用すると、Model Context Protocol (MCP) を使用して Amazon Bedrock マネージドナレッジベースをツールとして公開できます。ナレッジベースターゲットをゲートウェイに追加すると、どの MCP 互換クライアントも標準 MCP ツールとしてナレッジベースをクエリできます。コネクタは 2 つのツールを公開します。

  • AgenticRetrieveStream — 複数ステップのストリーミングエージェント取り出しで、結果を計画、反復、ストリーミングバックし、オプションの合成された引用ベースの回答を返します。

  • Retrieve — ソース参照を含む最も関連性の高いパッセージを返す単一の検索。

ゲートウェイは、認証、パラメータインジェクション、スキーマのサブ設定を処理する仲介として機能します。管理者は、ナレッジベースをバインドし、呼び出し元のエージェントに公開されるパラメータと、事前設定されたデフォルトで非表示になるパラメータを制御します。

注記

ナレッジベースのゲートウェイターゲットは、マネージドナレッジベースでのみサポートされ、IAM ベースのアウトバウンド認証 (GATEWAY_IAM_ROLE認証情報プロバイダータイプ) でのみサポートされます。

前提条件

  • マネージドナレッジベースとそのナレッジベース ID。

  • AgentCore Gateway と、ナレッジベース (bedrock:Retrieveナレッジベース ARN の ) から を取得するアクセス許可を持つゲートウェイサービスロール。

AWS SDK または AWS CLI を使用したゲートウェイターゲットの作成、ゲートウェイサービスロールと信頼ポリシーの設定、エージェントが設定できる取り出しパラメータの制御、ツールの呼び出し、完全な入力スキーマとレスポンススキーマなど、詳細な手順については、「Amazon Bedrock AgentCore デベロッパーガイド」の「Amazon Bedrock Managed Knowledge Bases as Connector Target」を参照してください。 AgentCore

Strands エージェントを使用して を呼び出す

Strands Agents SDK と AgentCore スターターツールキットを使用して構築された既存のエージェントがある場合は、ゲートウェイエンドポイントに対して SigV4 認証を使用するように MCP クライアントを切り替えることで、ナレッジベースゲートウェイターゲットに接続できます。

mcp-proxy-for-aws パッケージをインストールします。

pip install mcp-proxy-for-aws

次に、IAM 認証でゲートウェイ URL を指すように MCP クライアントを更新します。

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の を の に置き換えaws_iam_streamablehttp_clientますmcp-proxy-for-aws。

  • endpoint を AgentCore Gateway URL に設定します。

  • SigV4 署名aws_service="bedrock-agentcore"に を指定します。

接続すると、ナレッジベースツールは を介して自動的に検出tools/listされ、エージェントは追加の設定なしで使用できます。