Conceptos básicos de Amazon Bedrock Gateway AgentCore

Un AgentCore Gateway proporciona un punto de acceso único y seguro para que un agente pueda acceder a las herramientas, a otros agentes y a los modelos. Una puerta de enlace puede tener varios objetivos en tres categorías: MCP, HTTP e inferencia. En el caso de los destinos MCP, la puerta de enlace funciona en modo de agregación y actúa como un servidor MCP que combina las capacidades de todos sus objetivos MCP en un servidor MCP virtual unificado. En el caso de los destinos HTTP, la puerta de enlace envía el tráfico directamente al destino (por ejemplo, a otro agente o un servicio A2A) sin agregación ni traducción de protocolos. En el caso de los objetivos de inferencia, la puerta de enlace dirige las solicitudes de LLM a uno o más proveedores de modelos a través de un punto final de enrutamiento unificado y basado en modelos.

Un objetivo define el backend al que se conecta una puerta de enlace. Hay tres categorías de objetivos. Los objetivos de MCP definen las API, las funciones de Lambda, los servidores MCP o las definiciones de herramientas que la puerta de enlace agrega en un servidor MCP unificado. Los objetivos HTTP definen los HTTP-based servicios, como los agentes de AgentCore tiempo de ejecución y otros agentes, a los que los proxies de la puerta de enlace solicitan directamente. Los objetivos de inferencia dirigen el tráfico de LLM a uno o más proveedores de modelos a través de un punto final unificado y seleccionan el destino en función del modelo solicitado.

Cada puerta de enlace debe tener una configuración de autorización entrante para controlar el acceso de los clientes. La puerta de enlace admite los siguientes tipos de autorización entrante: OAuth (JWT) para la autorización basada en tokens, IAM (AWS Signature versión 4) para la autorización basada en la AWS identidad, autenticar solo para validar los tokens y delegar la autorización en el destino, y ninguna autorización para los escenarios de desarrollo y prueba. Puede configurar el autorizador al crear o actualizar una puerta de enlace.

Cuando Gateway realiza llamadas a sus API o funciones de Lambda, debe usar algunas credenciales para acceder a esas funcionalidades. Al crear un objetivo de Smithy o Lambda, Gateway usa el rol de ejecución adjunto para realizar llamadas a esos objetivos. Al crear un destino de servidor OpenAPI o MCP, puede adjuntar un proveedor de AgentCore credenciales que almacene la clave de API o las credenciales de OAuth, configurar la IAM-based autorización con la firma SIGv4 o no utilizar ninguna autorización para los terminales de acceso público.

Los objetivos MCP funcionan en modo de agregación. La puerta de enlace combina las capacidades de todos los objetivos MCP en un único servidor MCP virtual unificado. Los clientes ven una tools/list respuesta consolidada que incluye las herramientas de todos los objetivos MCP conectados. Los objetivos de MCP admiten la sincronización de capacidades, la búsqueda semántica de herramientas y el OAuth triple (3LO) en el nivel objetivo. Los tipos de objetivos de MCP incluyen las funciones de Lambda, las API REST de API Gateway, las especificaciones de OpenAPI, los modelos de Smithy, los servidores MCP, las plantillas de proveedores de integración integradas y los conectores a las herramientas integrados.

Los destinos HTTP envían el tráfico directamente al destino sin agregación ni traducción de protocolos. Los destinos HTTP no admiten la sincronización de capacidades ni la búsqueda con herramientas semánticas. Los clientes abordan cada objetivo de forma individual mediante un enrutamiento basado en rutas. Los tipos de destino HTTP incluyen los agentes de Amazon Bedrock AgentCore Runtime, otros agentes (incluidos los servicios Agent-to-Agent (A2A)), los servidores MCP externos y cualquier punto final HTTP al que se llegue a través de un destino de acceso directo.

Los objetivos de inferencia dirigen el tráfico de modelos lingüísticos de gran tamaño (LLM) a uno o más proveedores de modelos a través de un punto final unificado. La pasarela selecciona el proveedor de destino en función del model campo de la solicitud, lo que brinda a los agentes una interfaz única y uniforme para todos los proveedores, como Amazon Bedrock, OpenAI y Anthropic.

Transforme las API REST existentes en MCP-compatible herramientas proporcionando una especificación de OpenAPI. La puerta de enlace gestiona automáticamente la traducción entre los formatos MCP y REST.

Connect Lambda funciona como herramientas, lo que le permite implementar una lógica empresarial personalizada en su lenguaje de programación preferido. La puerta de enlace invoca la función Lambda y traduce la respuesta al formato MCP.

Utilice los modelos de Smithy para definir sus interfaces de API y generar MCP-compatible herramientas. Smithy es un lenguaje para definir los servicios y los SDK que se pueden usar con los servicios. AWS La pasarela puede usar modelos de Smithy para generar herramientas que interactúen con AWS los servicios o las API personalizadas.

Utilice servidores MCP remotos para conectar herramientas, solicitudes y recursos al tiempo de ejecución de su agente. Gateway admite las funciones de herramientas, instrucciones y recursos de MCP. Se requieren herramientas; las indicaciones y los recursos son opcionales. Las solicitudes proporcionan plantillas de solicitudes reutilizables con argumentos. Los recursos proporcionan datos contextuales identificados mediante URI. Durante la sincronización, la puerta de enlace descubre todas las capacidades que anuncia el servidor MCP.

Utilice plantillas preconfiguradas de los proveedores de integración.

Utilice conectores integrados para las herramientas.