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

# 透過 AgentCore Gateway 連接到您的知識庫
<a name="kb-gateway-target"></a>

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 受管知識庫作為連接器目標](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)建置的現有代理程式，您可以透過切換 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`，並可供代理程式使用，無需額外的組態。