View a markdown version of this page

Amazon 基岩网关 AgentCore - AWS Marketplace
概述与基岩网关 AgentCore 集成

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

Amazon 基岩网关 AgentCore

本文档为想要 AWS Marketplace 发布基于 API 的 AI 代理产品或可与 Amazon Bedro AgentCore ck Gateway 集成的工具的卖家提供信息。

概述

Amazon Bedrock AgentCore Gateway 可帮助开发人员大规模构建、部署、发现和连接工具。借助该服务，您能够：

  • 将 APIs Lambda 函数和现有服务转换为与模型上下文协议 (MCP) 兼容的工具

  • 通过网关端点向代理提供工具

  • 在完全托管的服务中使用全面的入口和出口身份验证

人工智能代理使用这些工具来执行多项任务，包括：

  • 查询数据库

  • 发送消息

  • 分析文档

有关更多信息，请参阅 Amazon Bedrock AgentCore 开发者指南。

与基岩网关 AgentCore 集成

根据您的产品，您可以通过以下方式之一为基于 SaaS API 的人工智能代理产品启用 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 进行编码。网关使用同一 URL 来调用服务器。

OpenAPI 规范要求

OpenAPI 规范必须：

  • 为所有操作包含 operationId 字段

  • 无语义错误

  • 在服务器属性中包含有效的安全（https）端点 URL

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

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

启用基岩网关 AgentCore

在启用网关集成之前，请完成以下任务，使用 Amazon Bedrock Gate AgentCore way 测试您的 OpenAPI 规范或 MCP 服务器：

启用网关集成

  1. 登录到 AWS Marketplace 管理门户。

  2. 打开人工智能代理和工具页面。

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

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

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

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

  7. 选择提交。

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