View a markdown version of this page

Usa una AgentCore puerta de enlace - Base amazónica AgentCore

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.

Usa una AgentCore puerta de enlace

Tras configurar la puerta de enlace con los destinos, puede configurar la aplicación o el agente para que usen la puerta de enlace mediante el Protocolo de contexto modelo (MCP). El MCP proporciona una forma estandarizada para que los agentes descubran e invoquen herramientas.

nota

AgentCore Gateway admite las siguientes versiones del MCP: 2026-07-28, 2025-11-25, 2025-06-18 y 2025-03-26.

2026-07-28La versión es una revisión del protocolo sin estado. Los clientes no dan un initialize apretón de manos. Cada solicitud incluye su versión de protocolo en el MCP-Protocol-Version encabezado y en el _meta campo (io.modelcontextprotocol/protocolVersion). La puerta de enlace descubre las capacidades a través deserver/discover. La versión 2025-11-25 y las anteriores siguen utilizando el initialize protocolo de enlace.

Puede utilizar las siguientes operaciones de MCP con una AgentCore puerta de enlace:

Operación Description (Descripción)

tools/call

Invoca una herramienta específica con los argumentos proporcionados

tools/list

Enumera todas las herramientas disponibles proporcionadas por la puerta de enlace

prompts/list

Enumera todas las solicitudes disponibles proporcionadas por la puerta de enlace

prompts/get

Recupera una plantilla de solicitud específica, representada con los argumentos proporcionados

resources/list

Muestra todos los recursos disponibles proporcionados por la puerta de enlace

resources/read

Lee el contenido de un recurso específico por URI

resources/templates/list

Muestra todas las plantillas de recursos disponibles proporcionadas por la puerta de enlace

elicitation/create

Solicita información adicional del cliente durante una llamada a una herramienta (iniciada por el servidor)

sampling/createMessage

Solicita al cliente que complete un LLM durante una llamada a la herramienta (iniciada por el servidor)

notifications/progress

Informa sobre el progreso de las llamadas a herramientas de larga duración (iniciadas por el servidor)

notifications/message

Envía mensajes de registro desde el servidor durante la ejecución de la herramienta (iniciada por el servidor)

En la versión2026-07-28, las interacciones iniciadas por el servidor (elicitation/createysampling/createMessage) utilizan el patrón de solicitudes de ida y vuelta múltiples (MRTR):

  1. El servidor devuelve un resultado provisional con resultType el valor establecido en. input_required

  2. El cliente proporciona la entrada solicitada al reintentar la solicitud original.

La pasarela envía notificaciones (notifications/progressynotifications/message) solo a las solicitudes que las aceptan. En la versión 2025-11-25 y en las anteriores, la puerta de enlace entrega estas interacciones como mensajes iniciados por el servidor en la transmisión abierta.

En los siguientes temas se describe cómo invocar la puerta de enlace: AgentCore

Temas