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

# AgentCore Gateway を介してナレッジベースに接続する
<a name="kb-gateway-target"></a>

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](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/gateway-target-connector-managed-kb.html)」を参照してください。 * AgentCore *

## Strands エージェントを使用して を呼び出す
<a name="kb-gateway-target-invoke-strands"></a>

[Strands Agents SDK](https://strandsagents.com/latest/) と [AgentCore スターターツールキット](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/runtime-get-started-toolkit.html)を使用して構築された既存のエージェントがある場合は、ゲートウェイエンドポイントに対して 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`され、エージェントは追加の設定なしで使用できます。