Agregación de una API de REST de API Gateway como destino para la puerta de enlace de Amazon Bedrock AgentCore - Amazon API Gateway
ConsideracionesAgregación de una etapa de una API como destino para una puerta de enlace AgentCore

Agregación de una API de REST de API Gateway como destino para la puerta de enlace de Amazon Bedrock AgentCore

Una puerta de enlace de Amazon Bedrock AgentCore proporciona a los desarrolladores de agentes de IA una forma segura de exponer las API de REST de API Gateway como herramientas compatibles con el protocolo de contexto para modelos (MCP). La puerta de enlace AgentCore utiliza los objetivos para definir las herramientas. Cuando agrega la etapa como un destino, la puerta de enlace se convierte en una única URL de MCP que permite el acceso de un agente a las herramientas. Para obtener más información, consulte Etapas de la API de REST de API Gateway como destinos en la Guía para desarrolladores de la puerta de enlace de Amazon Bedrock AgentCore.

Los destinos de API Gateway conectan la puerta de enlace AgentCore con las etapas de las API de REST. Puede incluir la etapa completa como objetivo o seleccionar recursos. Tras crear el destino de API Gateway, la puerta de enlace AgentCore traduce las solicitudes de MCP entrantes en solicitudes HTTP y gestiona el formato de las respuestas. Los clientes de MCP pueden recuperar la documentación de la API mediante el método tools/list e invocar las API mediante el método tools/call.

Consideraciones

Es posible que las siguientes consideraciones afecten al uso de la agregación de una etapa como destino a una puerta de enlace AgentCore:

  • Ya debe tener una puerta de enlace AgentCore.

  • Solo se admiten API de REST públicas.

  • El punto de conexión predeterminado de la API no se puede desactivar.

  • Cada método de la API debe tener un nombre de operación definido para ello o debe crear una invalidación de nombre cuando agregue la etapa como destino. Este nombre se utiliza como el nombre de la herramienta que utilizan los agentes para interactuar con el método.

  • Puede usar los tipos de proveedor de credenciales API_KEY, NO_AUTH o GATEWAY_IAM_ROLE para la autenticación saliente a fin de permitir que la puerta de enlace acceda a la API. El proveedor de credenciales API_KEY lo define la puerta de enlace AgentCore. Puede usar la clave de API Gateway existente. Para obtener más información, consulte Configuración de la autenticación saliente.

  • Si utiliza un autorizador de Lambda o un grupo de usuarios de Amazon Cognito para controlar el acceso a la API, los clientes de MCP no pueden acceder.

  • La API debe estar en la misma cuenta y región que la puerta de enlace AgentCore.

Agregación de una etapa de una API como destino para una puerta de enlace AgentCore

En el siguiente procedimiento se muestra cómo agregar una etapa de una API como destino para una puerta de enlace AgentCore.

Agregación de una etapa de una API como destino para una puerta de enlace AgentCore

  1. Inicie sesión en la consola de API Gateway, en https://console.aws.amazon.com/apigateway.

  2. Elija una API de REST que se implemente en una etapa.

  3. En el panel de navegación principal, elija Etapas.

  4. Elija Acciones de etapa y, a continuación, elija Crear destino de MCP.

  5. Para Puerta de enlace AgentCore, seleccione una puerta de enlace AgentCore.

  6. Para Nombre de destino, escriba un nombre de destino.

  7. Para Descripción de destino, ingrese una descripción.

  8. Conserve la API y la etapa proporcionados.

  9. Para seleccionar los recursos de la API, seleccione los recursos de la API a los que pueden acceder los agentes que utilizan la puerta de enlace AgentCore.

    Si no selecciona un recurso, el agente no podrá ver la documentación ni invocar el punto de conexión.

  10. La combinación del recurso y el método son las operaciones de la herramienta. Si la operación no tiene un nombre, cree una invalidación de nombre.

    También puede definir un nombre de operación para un método al crearlo.

  11. Para configuración de autenticación saliente, elija rol de IAM, sin autorización o clave de la API.

  12. Elija Crear destino.

Para ver todas las puertas de enlace AgentCore que tienen acceso a las API, elija la sección de destinos de MCP en el panel de navegación principal. En esta sección, puede crear un destino de MCP para cualquier API de la región implementada en una etapa. Elija Crear un destino de MCP y siga los pasos anteriores.

También puede ver las herramientas disponibles para el destino y editarlo en la consola de puerta de enlace AgentCore. Para obtener más información, consulte Agregación de destinos a una puerta de enlace AgentCore existente.