Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Amazon Bedrock Gateway AgentCore
Este documento proporciona información para AWS Marketplace los vendedores que desean publicar productos o herramientas de agentes de IA basados en API que se puedan integrar con Amazon Bedrock Gateway AgentCore .
Descripción general de
Amazon Bedrock AgentCore Gateway ayuda a los desarrolladores a crear, implementar, descubrir y conectarse a herramientas a escala. El servicio le permite:
-
Convierta APIs funciones Lambda y servicios existentes en herramientas compatibles con el Model Context Protocol (MCP)
-
Poner las herramientas a disposición de los agentes a través de los puntos de conexión de la puerta de enlace
-
Utilizar la autenticación integral de entrada y salida en un servicio totalmente administrado
Los agentes de IA utilizan estas herramientas para realizar tareas como:
-
Consultas a bases de datos
-
Envío de mensajes
-
Análisis de documentos
Para obtener más información, consulte la Guía para AgentCore desarrolladores de Amazon Bedrock.
Integración con Bedrock Gateway AgentCore
Puede habilitar la integración de Amazon Bedrock AgentCore Gateway para sus productos de agentes de IA basados en API de SaaS de una de las siguientes maneras, según el producto:
-
Si anuncias un servidor MCP que admite la OAuth autenticación de doble vía, puedes optar por ofrecer la integración a tus compradores sin requisitos adicionales. El punto de conexión del servidor MCP que proporcione como parte del proceso de descripción se utilizará para la integración. Sin embargo, debe asegurarse de que su servidor MCP cumpla con los requisitos que se indican a continuación. Para obtener más información, consulte los destinos de los servidores MCP.
Para todos los demás agentes o herramientas, puede proporcionar una especificación de OpenAPI para permitir la integración.
Requisitos del servidor MCP
El servidor MCP debe cumplir los siguientes requisitos:
-
OAuth Autenticación de dos vías con una de las siguientes configuraciones:
-
ID del cliente, secreto del cliente y URL de detección
-
ID del cliente, secreto del cliente, emisor, punto de conexión de autorización y punto de conexión de token.
-
-
El servidor MCP debe tener capacidades de herramienta.
-
Versiones del protocolo MCP compatibles: 2025-06-18 y 2025-03-26.
-
La URL debe estar codificada para la URL proporcionada o el punto de conexión del servidor. La puerta de enlace utiliza la misma URL para invocar al servidor.
Requisitos de especificación de OpenAPI
Su especificación de OpenAPI debe:
-
Incluir campos de
operationIdpara todas las operaciones -
Estar libre de errores semánticos
-
Incluir una URL de punto de conexión final segura (https) válida en el atributo del servidor
En la siguiente tabla se muestran las características de OpenAPI admitidas y no admitidas:
| Categoría | compatible | No es compatible |
|---|---|---|
| Versión | 3.0 y 3.1 | 2 |
| Definiciones de esquema | Tipos de datos básicos (cadena, número, booleano, etc.) | Especificaciones oneOf |
| Validación de campo obligatoria | Especificaciones anyOf | |
| Objetos anidados | ||
| Matrices con especificaciones de artículos | ||
| Métodos HTTP estándar | ||
| Tipos de contenido multimedia | application/json | Tipos de contenido personalizado |
| application/xml | Tipos de medios binarios | |
| datos multipartes/formularios | ||
| x-www-form-urlencoded | ||
| Parameters | Parámetros de ruta simples y parámetros de consulta básicos, como los tipos string/number/boolean | Serialización de parámetros de ruta compleja |
| Matrices de parámetros de consultas complejas | ||
| Serialización de parámetros de encabezado | ||
| Serialización de parámetros de cookie | ||
| Solicitud y respuesta | Cuerpos JSON | |
| Cuerpos XML | ||
| Códigos de estado HTTP estándar | ||
| Validación | Validación de campo básica | Validación de patrones de expresiones regulares |
| Validación de valores mínimo/máximo | ||
| Seguridad | N/A | Esquemas de seguridad de la especificación |
| Esquemas de seguridad múltiples | ||
| OAuth 2.0 a nivel de especificación | ||
| Clave de API de la especificación | ||
| Autenticación HTTP básica de la especificación | ||
| Configuración del servidor | URL básica | |
| URL con marcadores de posición |
Habilitación de Bedrock Gateway AgentCore
Antes de habilitar la integración de Gateway, pruebe su especificación OpenAPI o servidor MCP con Amazon Bedrock AgentCore Gateway realizando estas tareas:
Para habilitar la integración de Puerta de enlace
-
Inicie sesión en AWS Marketplace Management Portal
. -
Abra la página de agentes y herramientas de IA
. -
En la pestaña Productos de agentes IA y herramientas, seleccione el producto que desee modificar.
-
En la lista desplegable Solicitar cambios, seleccione Actualizar opciones de cumplimiento.
-
Elija la herramienta Habilitar para la AgentCore integración de Amazon Bedrock.
-
Cargue su especificación de OpenAPI. En el caso de los productos de servidor MCP OAuth compatibles con dos componentes, esto no es obligatorio y solo se requiere el terminal MCP.
-
Seleccione Enviar.
Una vez enviada, el estado de la solicitud aparece como En revisión en la pestaña Solicitudes. Cuando el proceso finaliza, el estado cambiará a Succeeded.
