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 AgentCore Runtime para AWS Marketplace

Este documento proporciona información para AWS Marketplace los vendedores que desean publicar agentes o herramientas de IA que se pueden implementar en Amazon Bedrock AgentCore Runtime. En él se describen los requisitos técnicos, las pautas de configuración y las mejores prácticas para preparar su contenedor compatible con Bedrock AgentCore Runtime. AWS Marketplace

Descripción general de

Amazon Bedrock AgentCore Runtime proporciona un entorno de alojamiento seguro, sin servidores y diseñado específicamente para implementar y ejecutar agentes o herramientas de IA. Cuando publiques tu contenedor de Bedrock AgentCore Runtime AWS Marketplace, debes asegurarte de que cumpla con los requisitos específicos para que funcione correctamente en el entorno de Bedrock. AgentCore

Requisitos técnicos del AgentCore contenedor Bedrock

Amazon Bedrock AgentCore Runtime tiene diferentes requisitos técnicos para publicar agentes de IA, servidores MCP y servidores A2A.

Requisitos del agente

Su agente contenedorizado debe cumplir los siguientes requisitos básicos:

/ping - GET

Este punto de conexión verifica que el agente esté operativo y preparado para gestionar las solicitudes.

Respuesta de ejemplo:

{
  "status": "Healthy"
}
                

/invocations - POST

Este es el punto final principal de la interacción entre los agentes cuando los clientes llaman al agente y le envían una InvokeAgentRuntime acción con la carga útil en formato JSON. InvokeAgentRuntime admite la transmisión de respuestas, lo que permite a los clientes recibir respuestas parciales a medida que estén disponibles.

Solicitud de ejemplo:

Content-Type: application/json
{
  "prompt": "What's the weather today?"
}
                

Respuestas de ejemplo:

Requisitos del servidor MCP

Amazon Bedrock AgentCore Runtime le permite implementar y ejecutar servidores del Model Context Protocol (MCP). Al configurar Amazon Bedrock AgentCore Runtime con el protocolo MCP, el servicio espera que los contenedores del servidor MCP estén en la ruta. 0.0.0.0:8000/mcp Esta es la ruta predeterminada que admiten la mayoría de los servidores MCP oficiales. SDKs

Como Amazon Bedrock AgentCore Runtime proporciona aislamiento de sesiones de forma predeterminada, requiere servidores HTTP transmisibles sin estado. El tiempo de ejecución añade automáticamente un encabezado de Mcp-Session-Id para cualquier solicitud que no lo incluya. Esto permite a los clientes MCP mantener la continuidad de la conexión con la misma sesión de Amazon Bedrock AgentCore Runtime.

La API InvokeAgentRuntime transmite directamente los datos de la carga útil, lo que permite utilizar un proxy sencillo para los mensajes RPC en protocolos como el MCP.

Requisitos:

Para obtener más información sobre los requisitos del servidor MCP, consulte Implementación de servidores MCP en tiempo de ejecución. AgentCore

/mcp - POST

Este es el punto final principal de interacción con el agente con el que los clientes llaman al servidor MCP. InvokeAgentRuntime

Solicitud de lista de ejemplo:

Content-Type: application/json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/list",
}
                

Respuesta de lista de ejemplo:

Respuesta JSON (sin streaming):

Content-Type: application/json
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "tools": [
      {
        "name": "get_weather",
        "title": "Weather Information Provider",
        "description": "Get current weather information for a location",
        "inputSchema": {
          "type": "object",
          "properties": {
            "location": {
              "type": "string",
              "description": "City name or zip code"
            }
          },
          "required": ["location"]
        }
      }
    ],
    "nextCursor": "next-page-cursor"
  }
}
                

Solicitud de activación de herramienta de ejemplo:

Content-Type: application/json
{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "get_weather",
    "arguments": {
      "location": "New York"
    }
  }
}
                

Respuesta de activación de herramienta de ejemplo:

Respuesta JSON (sin streaming):

Content-Type: application/json
{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "Current weather in New York:\nTemperature: 72°F\nConditions: Partly cloudy"
      }
    ],
    "isError": false
  }
}
                

Requisitos del servidor A2A

Amazon Bedrock AgentCore Runtime le permite implementar y ejecutar servidores Agent-to-Agent (A2A) en el AgentCore entorno de ejecución. La compatibilidad con el protocolo A2A AgentCore de Amazon Bedrock permite una integración perfecta con los servidores A2A al actuar como una capa de proxy transparente. Cuando se configura para A2A, Amazon Bedrock AgentCore espera que los contenedores ejecuten servidores HTTP sin estado y con capacidad de transmisión en el puerto de la ruta raíz (0.0.0.0:9000/), lo que se 9000 alinea con la configuración predeterminada del servidor A2A.

El servicio proporciona un aislamiento de sesiones de nivel empresarial y, al mismo tiempo, mantiene la transparencia del protocolo: las cargas JSON-RPC de la API se transfieren directamente al InvokeAgentRuntime contenedor A2A sin modificaciones. Esta arquitectura conserva las funciones estándar del protocolo A2A, como la detección de agentes integrada mediante tarjetas de agente y la comunicación JSON-RPC, al tiempo que añade autenticación empresarial (SiGV4/ 2.0) /.well-known/agent-card.json y escalabilidad. OAuth

Los principales diferenciadores de otros protocolos son el puerto (9000 frente a 8080 para HTTP), la ruta de montaje y el mecanismo estandarizado de descubrimiento de agentes, lo que convierte a Amazon Bedrock en AgentCore una plataforma de implementación ideal para los agentes de A2A en entornos de producción. / /invocations

Requisitos:

Para obtener más información sobre los requisitos del servidor A2A, consulte Implementación de servidores A2A en tiempo de ejecución. AgentCore

/ - POST

Este es el punto final principal de interacción con el agente con el que los clientes llaman al servidor A2A. InvokeAgentRuntime

Ejemplo de solicitud de invocación de un agente:

Content-Type: application/json
{  
  "jsonrpc": "2.0",  
  "id": "req-001",  
  "method": "message/send",  
  "params": {  
    "message": {  
      "role": "user",  
      "parts": [  
        {  
          "kind": "text",  
          "text": "what is 101 * 11?"  
        }  
      ],  
      "messageId": "12345678-1234-1234-1234-123456789012"  
    }  
  } 
}
                

Ejemplo de respuesta de invocación de un agente:

Respuesta JSON (sin streaming):

Content-Type: application/json
{
  "jsonrpc": "2.0",
  "id": "req-001",
  "result": {
    "artifacts": [
      {
        "parts": [
          {
            "kind": "text",
            "text": "101 * 11 is 1111"
          }
        ]
      }
    ]
  }
}
                

Ejemplo de recuperación de una tarjeta de agente:

curl https://bedrock-agentcore.<REGION>.amazonaws.com/runtimes/{escaped_agent_arn}/invocations/.well-known/agent-card.json
                

/ping - GET

Este es el punto final para realizar los controles de estado.

Probando su contenedor Bedrock AgentCore Runtime

Antes de enviar su contenedor a AWS Marketplace, pruébelo minuciosamente:

Pruebas de agente local

Pruebe el agente de forma local usando Docker

docker run -p 8080:8080 <your-container-image>

# Test ping endpoint
curl http://localhost:8080/ping

# Test agent invocation endpoint
curl -X POST http://localhost:8080/invocations \
     -H "Content-Type: application/json" \
     -d '{"prompt": "Hello world!"}'
            

Pruebas de servidor MCP local

Pruebe el servidor MCP de forma local usando Docker

docker run -p 8000:8000 <your-container-image>

# Test ping endpoint
curl http://localhost:8000/ping

# Test MCP endpoint with tools/list
curl -X POST http://localhost:8000/mcp \
     -H "Content-Type: application/json" \
     -d '{"jsonrpc": "2.0","id": 1,"method": "tools/list"}'

# Test MCP endpoint with tools/call
curl -X POST http://localhost:8000/mcp \
     -H "Content-Type: application/json" \
     -d '{ "jsonrpc": "2.0", "id": 2, "method": "tools/call", "params": {"name": "get_weather", "arguments": {"location": "New York"}}}'
            

Prueba de servidor A2A local

Pruebe su servidor A2A localmente mediante Docker

docker run -p 9000:9000 <your-container-image>

# Test ping endpoint
curl http://localhost:9000/ping

# Retrieve agent card
curl http://localhost:9000/.well-known/agent-card.json

# Test A2A endpoint with message/send
curl -X POST http://localhost:9000/ \
     -H "Content-Type: application/json" \
     -d '{ "jsonrpc": "2.0", "id": "req-001", "method": "message/send", "params": { "message": {  "role": "user",  "parts": [  {  "kind": "text",  "text": "what is 101 * 11?"}],"messageId": "12345678-1234-1234-1234-123456789012" }}}'
            

Probando en Bedrock Runtime AgentCore

Después de probar el contenedor localmente, cárguelo en Amazon Elastic Container Registry (Amazon ECR) e impleméntelo en Amazon Bedrock Runtime. AgentCore Puede realizar la implementación mediante la consola Amazon Bedrock AgentCore Runtime o con AWS Command Line Interface (AWS CLI).

Prácticas recomendadas para la configuración del contenedor

Consideraciones de seguridad

Optimización del rendimiento

Gestión de errores

Requisitos de presentación AWS Marketplace

Cuando envíes tu contenedor AgentCore Runtime a AWS Marketplace, incluye:

Recursos adicionales

Para obtener más información, consulte los siguientes temas:

Support for AgentCore Runtime on AWS Marketplace

Si tienes preguntas relacionadas con la inclusión AgentCore de tu contenedor Runtime en AWS Marketplace, consulta Cómo obtener soporte para AWS Marketplace.

Si tiene preguntas técnicas sobre AgentCore Runtime, consulte nuestro servicio AWS Support de atención al cliente.