Ver aplicaciones web en vivo mientras un agente de código las construye con AgentCore

Amazon Bedrock AgentCore permite que agentes de código mantengan una app web en ejecución dentro de su sesión y expongan una URL autenticada para verla en el navegador. Esto acelera la revisión iterativa: ver, pedir cambios y observar cómo se aplican en segundos.

Por Redaccion TD
Ver aplicaciones web en vivo mientras un agente de código las construye con AgentCore

Introducción

Los equipos de producto y desarrollo necesitan revisar prototipos y cambios rápidos en aplicaciones web sin esperar despliegues completos. Amazon Bedrock AgentCore introduce una capacidad que facilita justamente eso: ejecutar agentes de código dentro de sesiones aisladas que exponen aplicaciones web en vivo mediante Session endpoints. El resultado es un flujo de trabajo donde pueden probar una página, pedir un cambio y ver la actualización inmediata, lo que reduce drásticamente la latencia de la retroalimentación.

¿Qué es AgentCore runtime y por qué importa?

Amazon Bedrock AgentCore es una plataforma diseñada para crear, conectar y optimizar agentes a escala, dejando libertad sobre el framework de agente y el modelo de base (FM). AgentCore runtime es una capacidad dentro de esa plataforma que ejecuta cada sesión de agente en su propia microVM aislada. Esa microVM puede ejecutar servidores, editar archivos y ejecutar procesos de desarrollo, como un servidor Vite para sitios web.

Para equipos que construyen productos digitales, esto significa que un agente puede no solo generar o editar código, sino mantener la aplicación en ejecución en el mismo entorno donde hace los cambios, permitiendo una revisión inmediata y fluida.

¿Qué son los Session endpoints y cómo funcionan?

Cada sesión administrada por AgentCore runtime recibe su propio Session endpoint: una URL autenticada que reenvía solicitudes HTTP (métodos, rutas, query strings y cuerpo) y conexiones WebSocket a puertos concretos dentro de la sesión. Los puntos clave son:

  • Puertos permitidos: al crear la sesión (CreateAgentRuntime) se define allowedPorts con entre 1 y 5 entradas, cada una indicando un puerto único o un rango dentro de 8000–12000, excluyendo puertos reservados de la plataforma. Permitir un puerto no inicia un servidor: su aplicación debe estar escuchando en 0.0.0.0.
  • La URL llega con la respuesta de inicio de sesión (InvokeAgentRuntime) en el encabezado X-Amzn-Bedrock-AgentCore-Runtime-Session-Endpoint-Url, y los SDKs lo exponen como sessionEndpointUrl.
  • Autenticación: todas las solicitudes están autenticadas. Si el runtime usa IAM, cada petición HTTP, stream HTTP/2 y handshake WebSocket debe llevar una firma SigV4; además, el llamador necesita permiso bedrock-agentcore:InvokeAgentRuntimeProxy sobre el runtime. Para runtimes con autorizador JWT entrante, las solicitudes llevan un token bearer.
  • Selección de puerto vía host: el cliente siempre conecta al puerto 443, pero el puerto destino dentro de la sesión se codifica como un prefijo en el nombre del host. Ejemplos de formato de URL vistos en la documentación:
  • Protocolos admitidos: HTTP/1.1, HTTP/2 (incluyendo server-sent events y gRPC) y WebSocket pasan a través del endpoint.

Importante: conocer la URL por sí sola no concede acceso. La URL es válida mientras la sesión esté activa y cada petición requiere credenciales válidas.

Arquitectura de la solución de ejemplo

El ejemplo de referencia incluido en el repositorio agentcore-samples (carpeta 14-remote-access) ilustra un flujo práctico con cuatro componentes:

  1. Un agente de código que corre en la sesión y expone servicios en el puerto 8080. Ese agente utiliza herramientas para listar, leer, escribir y editar archivos del proyecto.
  2. Un servidor de desarrollo Vite iniciado por el agente en el puerto 8090, que entrega la web y usa hot-reload por WebSocket para empujar cambios al navegador en tiempo real.
  3. PreviewApp, ejecutada en la máquina del desarrollador, que abre la sesión con InvokeAgentRuntime, obtiene la sessionEndpointUrl y crea un endpoint local para reenviar tráfico hacia el Session endpoint. PreviewApp también envía los prompts del usuario al agente.
  4. El navegador, que carga una página de vista previa con chat a la izquierda y el sitio en vivo a la derecha.

Flujo simplificado: PreviewApp inicia la sesión y abre un endpoint local (por ejemplo, http://localhost:8088). La página de vista previa carga el sitio desde Vite a través del endpoint local. Cuando usted solicita un cambio vía chat, PreviewApp envía el prompt a InvokeAgentRuntime (que alcanza al agente en el puerto 8080); el agente edita archivos y Vite actualiza el navegador por su WebSocket, mostrando la modificación sin refrescar la página.

Paso a paso de una interacción típica

  1. PreviewApp llama a InvokeAgentRuntime para iniciar la sesión. La respuesta incluye sessionEndpointUrl.
  2. PreviewApp abre un endpoint local para un puerto permitido (p. ej. 8090) y mapea las solicitudes del navegador hacia la Session endpoint. El endpoint local añade credenciales a cada solicitud.
  3. El usuario en el navegador envía una instrucción al agente (por ejemplo, “cambia la paleta a tema oscuro”) vía la interfaz de chat.
  4. PreviewApp reenvía ese prompt a InvokeAgentRuntime; el agente ejecuta las herramientas para editar archivos y guarda cambios.
  5. El servidor Vite detecta los archivos guardados y envía actualizaciones por WebSocket al navegador; el sitio cambia en segundos, sin necesidad de desplegar.

Seguridad y límites de uso

  • Cada petición al Session endpoint requiere autenticación y el permiso adecuado; para runtimes IAM esto implica firmas SigV4 y permisos bedrock-agentcore:InvokeAgentRuntimeProxy.
  • El alcance de lo accesible por la URL está regulado por allowedPorts y por la duración de la sesión: cuando la sesión termina, la URL deja de funcionar.
  • Un navegador por sí mismo no puede firmar peticiones SigV4 ni añadir tokens JWT a las solicitudes; por eso PreviewApp (o el cliente local del SDK) actúa como proxy local y añade las credenciales necesarias antes de reenviar.

Session endpoint vs runtime endpoint

Es importante distinguir ambos conceptos:

  • Runtime endpoint (por ejemplo DEFAULT) sirve para invocar al agente y controlar qué versión del runtime atiende las solicitudes; permite promover o revertir versiones sin cambiar los callers.
  • Session endpoint muestra lo que el agente está ejecutando en una sesión concreta (por ejemplo, una vista previa web). La Session endpoint está ligada a la sesión y solo permite el acceso a los puertos que se hayan autorizado.

Use runtime endpoints para llamadas de control y producción; use Session endpoints para revisar y probar lo que ocurre dentro de una sesión de desarrollo o de un agente específico.

¿Qué significa esto para equipos en América Latina?

Para organizaciones y equipos de producto en la región, esta capacidad puede acelerar ciclos de validación con stakeholders locales: PMs, diseñadores y clientes pueden interactuar con prototipos corriendo en la sesión del agente sin esperar despliegues. Además, facilita iteraciones rápidas en contextos donde coordinar infraestructura para despliegues frecuentes puede ser costoso o lento.

Al diseñar flujos de trabajo en la región, conviene integrar estas sesiones con procesos internos de revisión y pruebas, y recordar que para exponer una aplicación a usuarios finales seguirá siendo necesario desplegarla a un servicio de hosting (por ejemplo, AWS Amplify Hosting u otro), ya que un Session endpoint está pensado para pruebas y desarrollo y expira con la sesión.

Conclusión

Los Session endpoints de Amazon Bedrock AgentCore ofrecen una forma poderosa de revisar aplicaciones web mientras agentes de código las editan en tiempo real. Permiten un ciclo de ver–pedir cambio–ver resultado mucho más rápido que el flujo tradicional basado en despliegues. Para equipos que buscan acelerar la validación de prototipos y optimizar la colaboración entre desarrolladores, producto y diseño, esta funcionalidad reduce fricción y acelera decisiones. El ejemplo práctico disponible en agentcore-samples (14-remote-access) muestra cómo montar el flujo con Vite, un agente que edita archivos y un pequeño proxy local que añade las credenciales necesarias para el Session endpoint.

Fuente original: AWS ML Blog