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

# Amazon Bedrock AgentCore Gateway
<a name="bedrock-agentcore-gateway"></a>

本文件為想要列出可與 Amazon Bedrock AgentCore Gateway 整合之 API 型 AI 代理程式產品或工具的 AWS Marketplace 賣方提供資訊。

**Topics**
+ [概觀](#agentcore-overview)
+ [與 Bedrock AgentCore Gateway 整合](#bedrock-agentcore-integration)

## 概觀
<a name="agentcore-overview"></a>

Amazon Bedrock AgentCore Gateway 可協助開發人員大規模建置、部署、探索和連線至工具。服務可讓您：
+ 將 APIs、Lambda 函數和現有服務轉換為與模型內容通訊協定 (MCP) 相容的工具
+ 透過閘道端點為客服人員提供工具
+ 在全受管服務中使用全面的輸入和輸出身分驗證

AI 代理器使用這些工具來執行任務，例如：
+ 查詢資料庫
+ 傳送訊息
+ 分析文件

如需詳細資訊，請參閱 [Amazon Bedrock AgentCore 開發人員指南](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/gateway.html)。

## 與 Bedrock AgentCore Gateway 整合
<a name="bedrock-agentcore-integration"></a>

視您的產品而定，您可以透過下列其中一種方式為您的 SaaS API AI 代理程式產品啟用 Amazon Bedrock AgentCore Gateway 整合：
+ 如果您列出支援兩邊 OAuth 身分驗證的 MCP 伺服器，您可以選擇加入，為買方提供整合，無需額外的要求。您在列出程序中提供的 MCP 伺服器端點將用於整合。不過，您必須確保您的 MCP 伺服器符合下列要求。如需詳細資訊，請參閱 [MCP 伺服器目標](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/gateway-target-MCPservers.html)。
+ 對於所有其他代理程式或工具，您可以提供 OpenAPI 規格來啟用整合。

### MCP 伺服器需求
<a name="gateway-mcp-server-requirements"></a>

您的 MCP 伺服器必須符合下列要求：
+ 使用下列其中一個組態的雙邊 OAuth 身分驗證：
  + 用戶端 ID、用戶端秘密和探索 URL
  + 用戶端 ID、用戶端秘密、發行者、授權端點和字符端點。
+ MCP 伺服器必須具有工具功能。
+ 支援的 MCP 通訊協定版本：**2025-06-18** 和 **2025-03-26**。
+ 對於提供的 URL 或伺服器的端點，應該對 URL 進行編碼。Gateway 使用相同的 URL 來叫用伺服器。

### OpenAPI 規格要求
<a name="openapi-requirements"></a>

您的 OpenAPI 規格必須：
+ 包含所有操作`operationId`的欄位
+ 避免語意錯誤
+ 在伺服器屬性中包含有效的安全 (https) 端點 URL

下表顯示支援和不支援的 OpenAPI 功能：


| Category | 支援 | 不支援 | 
| --- | --- | --- | 
| 版本 | 3.0 和 3.1 | 2 | 
| 結構描述定義 | 基本資料類型 （字串、數字、布林值等） | oneOf 規格 | 
|  | 必要欄位驗證 | anyOf 規格 | 
|  | 巢狀物件 |  | 
|  | 具有項目規格的陣列 |  | 
|  | 標準 HTTP 方法 |  | 
| 媒體類型 | application/json | 自訂媒體類型 | 
|  | application/xml | 二進位媒體類型 | 
|  | 分段/表單資料 |  | 
|  | x-www-form-urlencoded |  | 
| Parameters | 簡單路徑參數和基本查詢參數，例如 string/number/boolean 類型 | 複雜路徑參數序列化 | 
|  |  | 複雜的查詢參數陣列 | 
|  |  | 標頭參數序列化 | 
|  |  | Cookie 參數序列化 | 
| 請求與回應 | JSON 內文 |  | 
|  | XML 內文 |  | 
|  | 標準 HTTP 狀態碼 |  | 
| 驗證 | 基本欄位驗證 | Regex 模式驗證 | 
|  |  | 最小/最大值驗證 | 
| 安全 | N/A | 規格層級的安全機制 | 
|  |  | 多個安全機制 | 
|  |  | 在規格層級的 OAuth 2.0 | 
|  |  | 指定層級的 API 金鑰 | 
|  |  | 指定層級的 HTTP 基本身分驗證 | 
| 伺服器組態 | 基本 URL |  | 
|  | 具有預留位置的 URL |  | 

### 啟用 Bedrock AgentCore Gateway
<a name="enabling-bedrock-agentcore"></a>

啟用閘道整合之前，請先完成下列任務，以 Amazon Bedrock AgentCore Gateway 測試您的 OpenAPI 規格或 MCP 伺服器：
+ [建立閘道](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/gateway-building.html)
+ [連接目標](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/gateway-building-adding-targets.html)
+ [測試您的閘道](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/gateway-building-testing.html)

**啟用閘道整合**

1. 登入 [AWS Partner Central](https://us-east-1.console.aws.amazon.com/partnercentral/home)。

1. 開啟 [AI 代理器和工具](https://aws.amazon.com/marketplace/management/products/aiagents)頁面。

1. 在 **AI 代理器和工具產品**索引標籤上，選取要修改的產品。

1. 從**請求變更**下拉式清單中，選取**更新履行選項**。

1. 選擇**啟用 Amazon Bedrock AgentCore 整合的工具**。

1. 上傳您的 OpenAPI 規格。對於啟用雙邊 OAuth 的 MCP 伺服器產品，這並非必要項目，而且只需要 MCP 端點。

1. 選擇**提交**。

提交後，請求狀態會在**請求**索引標籤中顯示為**審核中**。處理完成時，狀態會變更為**成功**。