本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# Amazon 基岩网关 AgentCore
<a name="bedrock-agentcore-gateway"></a>

本文档为想要 AWS Marketplace 发布可与 Amazon Bedrock AgentCore Gateway 集成的 A API-based I 代理产品或工具的卖家提供信息。

**Topics**
+ [概述](#agentcore-overview)
+ [与基岩网关 AgentCore 集成](#bedrock-agentcore-integration)

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

Amazon Bedrock AgentCore Gateway 可帮助开发人员大规模构建、部署、发现和连接工具。借助该服务，您能够：
+ 将 API、Lambda 函数和现有服务转换为与模型上下文协议（MCP）兼容的工具
+ 通过网关端点向代理提供工具
+ 在完全托管的服务中使用全面的入口和出口身份验证

人工智能代理使用这些工具来执行多项任务，包括：
+ 查询数据库
+ 发送消息
+ 分析文档

有关更多信息，请参阅 [Amazon Bedrock AgentCore 开发者指南](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/gateway.html)。

## 与基岩网关 AgentCore 集成
<a name="bedrock-agentcore-integration"></a>

根据您的产品，您可以通过以下方式之一为 SaaS API-based 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 服务器必须满足以下要求：
+ Two-legged 使用以下配置之一进行 OAuth 身份验证：
  + 客户端 ID、客户端密钥和发现 URL
  + 客户端 ID、客户端密钥、发布者、授权端点和令牌端点。
+ MCP 服务器必须具有工具功能。
+ 支持的 MCP 协议版本：**2025-06-18** 和 **2025-03-26**。
+ 对于服务器提供的 URL 或端点，应对 URL 进行编码。网关使用同一 URL 来调用服务器。

### OpenAPI 规范要求
<a name="openapi-requirements"></a>

OpenAPI 规范必须：
+ 为所有操作包含 `operationId` 字段
+ 无语义错误
+ 在服务器属性中包含有效的安全（https）端点 URL

下表显示了支持和不支持的 OpenAPI 功能：


| 类别 | 支持 | 不支持 | 
| --- | --- | --- | 
| 版本 | 3.0 和 3.1 | 2 | 
| 架构定义 | 基本数据类型（字符串、数字、布尔值等） | oneOf 规范 | 
|  | 必填字段验证 | anyOf 规范 | 
|  | 嵌套对象 |  | 
|  | 带项目规范的数组 |  | 
|  | 标准 HTTP 方法 |  | 
| 媒体类型 | application/json | 自定义媒体类型 | 
|  | application/xml | 二进制媒体类型 | 
|  | multipart/form-数据 |  | 
|  | x-www-form-urlencoded |  | 
| 参数 | 简单路径参数和基本查询参数，例如 string/number /boolean 类型 | 复杂路径参数序列化 | 
|  |  | 复杂查询参数数组 | 
|  |  | 请求头参数序列化 | 
|  |  | Cookie 参数序列化 | 
| 请求和响应 | JSON 正文 |  | 
|  | XML 正文 |  | 
|  | 标准 HTTP 状态码 |  | 
| 验证 | 基本字段验证 | 正则表达式模式验证 | 
|  |  | Min/max 值验证 | 
| 安全性 | N/A | 规范级安全方案 | 
|  |  | 多安全方案 | 
|  |  | 规范级 OAuth 2.0 | 
|  |  | 规范级 API 密钥 | 
|  |  | 规范级 HTTP 基础认证 | 
| 服务器配置 | 基本 URL |  | 
|  | 带占位符的 URL |  | 

### 启用 Bedrock 网关 AgentCore
<a name="enabling-bedrock-agentcore"></a>

在启用网关集成之前，请完成以下任务，使用 Amazon Bedrock Gate AgentCore way 测试您的 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. 登录 A [WS 合作伙伴中心](https://us-east-1.console.aws.amazon.com/partnercentral/home)。

1. 打开[人工智能代理和工具](https://aws.amazon.com/marketplace/management/products/aiagents)页面。

1. 在**人工智能代理与工具类产品**选项卡上，选择要修改的产品。

1. 从**请求更改**下拉列表中，选择**更新交付选项**。

1. 选择 “**启用 Amazon Bedrock AgentCore 集成工具**”。

1. 上传你的 OpenAPI 规范。对于支持双腿 OAuth 的 MCP 服务器产品，这不是必需的，只需要 MCP 端点。

1. 选择**提交**。

提交后，请求状态将在**请求**选项卡中显示为**正在审核中**。处理完成后，状态将变为**已成功**。