本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
Amazon Bedrock AgentCore Gateway
本文件為想要列出可與 Amazon Bedrock AgentCore Gateway 整合之 API 型 AI 代理程式產品或工具的 AWS Marketplace 賣方提供資訊。
概觀
Amazon Bedrock AgentCore Gateway 可協助開發人員大規模建置、部署、探索和連線至工具。服務可讓您：
-
將 APIs、Lambda 函數和現有服務轉換為與模型內容通訊協定 (MCP) 相容的工具
-
透過閘道端點為客服人員提供工具
-
在全受管服務中使用全面的輸入和輸出身分驗證
AI 代理器使用這些工具來執行任務，例如：
-
查詢資料庫
-
傳送訊息
-
分析文件
如需詳細資訊，請參閱 Amazon Bedrock AgentCore 開發人員指南。
與 Bedrock AgentCore Gateway 整合
視您的產品而定，您可以透過下列其中一種方式為您的 SaaS API AI 代理程式產品啟用 Amazon Bedrock AgentCore Gateway 整合：
-
如果您列出支援兩邊 OAuth 身分驗證的 MCP 伺服器，您可以選擇加入，為買方提供整合，無需額外的要求。您在列出程序中提供的 MCP 伺服器端點將用於整合。不過，您必須確保您的 MCP 伺服器符合下列要求。如需詳細資訊，請參閱 MCP 伺服器目標。
對於所有其他代理程式或工具，您可以提供 OpenAPI 規格來啟用整合。
MCP 伺服器需求
您的 MCP 伺服器必須符合下列要求：
-
使用下列其中一個組態的雙邊 OAuth 身分驗證：
-
用戶端 ID、用戶端秘密和探索 URL
-
用戶端 ID、用戶端秘密、發行者、授權端點和字符端點。
-
-
MCP 伺服器必須具有工具功能。
-
支援的 MCP 通訊協定版本：2025-06-18 和 2025-03-26。
-
對於提供的 URL 或伺服器的端點，應該對 URL 進行編碼。Gateway 使用相同的 URL 來叫用伺服器。
OpenAPI 規格要求
您的 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
啟用閘道整合之前，請先完成下列任務，以 Amazon Bedrock AgentCore Gateway 測試您的 OpenAPI 規格或 MCP 伺服器：
啟用閘道整合
-
開啟 AI 代理器和工具
頁面。 -
在 AI 代理器和工具產品索引標籤上，選取要修改的產品。
-
從請求變更下拉式清單中，選取更新履行選項。
-
選擇啟用 Amazon Bedrock AgentCore 整合的工具。
-
上傳您的 OpenAPI 規格。對於啟用雙邊 OAuth 的 MCP 伺服器產品，這並非必要項目，而且只需要 MCP 端點。
-
選擇提交。
提交後，請求狀態會在請求索引標籤中顯示為審核中。處理完成時，狀態會變更為成功。
