AWS presenta Session endpoints en Amazon Bedrock AgentCore para visualizar aplicaciones web mientras los agentes de IA las desarrollan
AWS muestra cómo visualizar aplicaciones web mientras un agente de IA las modifica
Amazon Web Services (AWS) publicó el 30 de octubre de 2026 una explicación técnica sobre los Session endpoints de Amazon Bedrock AgentCore runtime, una capacidad que permite acceder desde el navegador a aplicaciones web que se ejecutan dentro de las sesiones de agentes de inteligencia artificial.
La propuesta está orientada, entre otros escenarios, al desarrollo de software asistido por IA. En lugar de limitarse a recibir respuestas de un agente de programación, el usuario puede observar una aplicación web en funcionamiento mientras el agente modifica su código.
Según el blog oficial de AWS Machine Learning, cada sesión de AgentCore runtime funciona dentro de una microVM aislada. Los Session endpoints permiten conectar el navegador con los servidores que se ejecutan en ese entorno mediante direcciones autenticadas y puertos previamente autorizados.
La demostración presentada por AWS utiliza un agente que edita un sitio desarrollado con Vite y muestra los resultados en una vista previa que se actualiza sin necesidad de recargar la página.
Una vista previa en vivo junto al chat del agente
El ejemplo publicado por AWS presenta una interfaz dividida en dos áreas: a la izquierda aparece una conversación con el agente de programación y a la derecha se muestra la aplicación web que el agente está desarrollando.
Durante la demostración, el usuario solicita cambiar la apariencia del sitio a un tema oscuro. El agente modifica los archivos correspondientes y el navegador refleja los cambios automáticamente.
Esta actualización se consigue mediante el servidor de desarrollo de Vite y su conexión WebSocket de recarga en caliente (hot reload), que transmite al navegador los cambios guardados.
La arquitectura del ejemplo distribuye las funciones entre distintos componentes:
| Componente | Función en el ejemplo |
|---|---|
| Agente de programación | Recibe instrucciones y modifica los archivos del sitio |
| Puerto 8080 | Ejecuta el agente dentro de AgentCore runtime |
| Herramientas list, read, write y edit | Permiten al agente consultar y modificar archivos |
| Vite en el puerto 8090 | Mantiene activo el servidor de desarrollo web |
| WebSocket de Vite | Envía los cambios guardados al navegador |
| PreviewApp | Presenta el chat y la vista previa del sitio |
| Claude Haiku 5.5 | Modelo utilizado por el agente mediante Amazon Bedrock |
La aplicación PreviewApp también se encarga de enviar las instrucciones del usuario mediante InvokeAgentRuntime y abrir un endpoint local para visualizar el sitio.
De esta forma, el chat y la vista previa funcionan como partes de una misma experiencia, aunque el agente y el servidor web utilizan mecanismos de comunicación diferentes.
Cómo funcionan los Session endpoints de AgentCore runtime
Los Session endpoints permiten acceder a servicios web que se ejecutan dentro de una sesión de AgentCore runtime.
Cuando se crea un runtime mediante CreateAgentRuntime, es posible definir los puertos a los que se permitirá acceder utilizando el parámetro allowedPorts.
AWS establece las siguientes condiciones para esa configuración:
- Se admiten entre una y cinco entradas.
- Cada entrada puede representar un puerto individual o un rango.
- Los puertos deben encontrarse entre el 8000 y el 12000.
- Los puertos reservados por la plataforma quedan excluidos.
Autorizar un puerto no significa que AgentCore inicie automáticamente un servidor. La aplicación debe ejecutar su propio servicio, escuchar en el puerto correspondiente y vincularse a la dirección 0.0.0.0.
Una vez iniciada la sesión, la respuesta de InvokeAgentRuntime proporciona la dirección del Session endpoint mediante la cabecera:
X-Amzn-Bedrock-AgentCore-Runtime-Session-Endpoint-Url
Esta dirección permite dirigir solicitudes al servicio que se ejecuta dentro de la sesión.
El sistema conserva el método HTTP, la ruta, los parámetros de consulta y el cuerpo de cada solicitud. También admite conexiones WebSocket, necesarias en escenarios como la actualización en vivo de aplicaciones web.
Una dirección HTTPS que identifica el puerto de destino
AWS utiliza un mecanismo en el que el nombre de host determina el puerto de destino dentro de la sesión.
El cliente establece la conexión HTTPS mediante el puerto 443, mientras que un prefijo del nombre de host identifica el puerto interno al que se enviará el tráfico.
El blog presenta una estructura de URL como la siguiente:
https://8090--<session-endpoint-id>.runtime.bedrock-agentcore.<region>.on.aws/index.html
En este ejemplo, el prefijo 8090 identifica el puerto donde se ejecuta el servidor web de Vite.
Los Session endpoints admiten HTTP/1.1, HTTP/2 y WebSocket. El soporte HTTP/2 incluye mecanismos como los eventos enviados por el servidor (Server-Sent Events) y gRPC.
Autenticación en cada solicitud: IAM y JWT
Uno de los aspectos centrales del funcionamiento de los Session endpoints es que cada solicitud requiere autenticación.
AWS describe dos mecanismos, según la configuración de entrada del runtime.
Autenticación mediante IAM
Cuando se utiliza IAM, cada solicitud HTTP, flujo HTTP/2 y establecimiento inicial de conexión WebSocket debe incorporar una firma SigV4.
Además, la identidad que realiza la solicitud necesita el permiso:
bedrock-agentcore:InvokeAgentRuntimeProxy
Autenticación mediante JWT
Cuando el runtime utiliza un autorizador JWT de entrada, cada petición debe incluir un token bearer.
Esta autenticación tiene implicaciones para las aplicaciones que se abren directamente en un navegador, ya que el navegador no añade por sí mismo firmas SigV4 ni tokens bearer a las solicitudes.
Para resolver esa necesidad en la experiencia presentada, AWS utiliza el cliente de Session endpoint del SDK bedrock-agentcore.
Este cliente puede abrir un endpoint local en la máquina del usuario. En el ejemplo, el navegador accede a:
http://localhost:8088
El endpoint local incorpora las credenciales correspondientes a cada petición y al establecimiento de las conexiones WebSocket antes de reenviar el tráfico al Session endpoint de AgentCore.
Así, la aplicación web puede visualizarse desde el navegador mientras el cliente local gestiona la autenticación de las conexiones.
Cómo se conectan el agente, Vite y la vista previa
En la implementación descrita por AWS, el agente de programación y el servidor web se ejecutan dentro de la misma sesión de AgentCore runtime, pero utilizan puertos diferentes.
El agente escucha en el puerto 8080 y recibe las instrucciones enviadas mediante InvokeAgentRuntime.
Por su parte, el servidor Vite utiliza el puerto 8090 para mostrar la aplicación y transmitir los cambios mediante WebSocket.
La configuración de despliegue incluye los siguientes puertos autorizados:
| Puerto | Utilización | Configuración |
|---|---|---|
| 8080 | Ejecución del agente de programación | No se incluye en allowedPorts |
| 8081 | Ruta de estado del agente | Incluido en allowedPorts |
| 8090 | Servidor de desarrollo Vite | Incluido en allowedPorts |
AWS explica que el puerto 8080 no necesita figurar en allowedPorts porque las solicitudes de InvokeAgentRuntime llegan al agente sin utilizar el Session endpoint.
En cambio, el puerto 8090 debe estar autorizado para permitir el acceso al sitio web desde el navegador.
La aplicación PreviewApp coordina ambas comunicaciones: envía los mensajes del usuario al agente y establece el acceso local a la aplicación web.
Cuando el agente modifica un archivo mediante sus herramientas, el servidor Vite transmite el cambio a la página abierta, lo que permite seguir la evolución del sitio mientras continúa la conversación.
Alcance y limitaciones de los Session endpoints
AWS distingue entre acceder temporalmente a una aplicación dentro de una sesión de desarrollo y publicar una aplicación para sus usuarios finales.
Las direcciones generadas mediante Session endpoints están vinculadas a una sesión concreta. Requieren credenciales en cada solicitud y su duración está limitada al tiempo de vida de esa sesión.
Por ello, AWS señala que una aplicación destinada a usuarios finales debe desplegarse en un servicio de alojamiento, como AWS Amplify Hosting.
También existen restricciones relacionadas con la infraestructura y la conectividad:
| Característica | Compatibilidad o condición |
|---|---|
| Runtime basado en microVM | Compatible |
| Tipo de cómputo Instances | No compatible |
| Acceso mediante HTTPS pública | Disponible |
| AWS PrivateLink para conexiones entrantes | No compatible |
| Duración de la URL | Limitada a la sesión |
| Autenticación | Requerida en cada petición |
| Publicación permanente de la aplicación | Requiere un servicio de hosting |
Estas condiciones delimitan el uso de los Session endpoints como mecanismo de acceso a servicios ejecutados dentro de sesiones de agentes.
Requisitos técnicos y código del ejemplo publicado por AWS
El blog oficial también detalla el entorno utilizado para reproducir la demostración.
Entre los requisitos se encuentran una cuenta de AWS en una región con disponibilidad de Session endpoints para AgentCore runtime y permisos IAM para crear roles, subir archivos a Amazon S3 y crear un runtime.
Además, se requieren los permisos bedrock-agentcore:InvokeAgentRuntime y bedrock-agentcore:InvokeAgentRuntimeProxy.
Las dependencias indicadas por AWS son:
| Herramienta o servicio | Requisito |
|---|---|
| Python | Versión 3.10 o superior |
| bedrock-agentcore | Versión 1.25.2 o superior |
| boto3 | Versión 1.43.122 o superior |
| Node.js | Versión 22 o superior |
| npm | Requerido |
| Git | Requerido |
| Jupyter | Entorno requerido |
| Amazon Bedrock | Acceso a Claude Haiku 5.5 |
| Cuenta AWS | Región con Session endpoints disponibles |
AWS publica el ejemplo en el repositorio agentcore-samples de GitHub.
La ruta de despliegue mostrada en el anuncio es:
agentcore-samples/01-features/02-host-your-agent/01-runtime/03-advanced/16-session-endpoints
Dentro de esta ubicación se encuentra el notebook session_endpoints_preview.ipynb, utilizado en la explicación de la vista previa.
La documentación también hace referencia a la carpeta 14-remote-access del repositorio como ubicación del ejemplo completo.
El material reúne los componentes necesarios para ilustrar la comunicación entre el agente, el servidor Vite, PreviewApp y los Session endpoints.
Amazon Bedrock AgentCore en contexto
Amazon Bedrock AgentCore es una plataforma de AWS destinada a construir, conectar y optimizar agentes de inteligencia artificial a escala. Permite trabajar con el framework de agentes y el modelo fundacional que se elijan.
Su componente AgentCore runtime proporciona sesiones de ejecución aisladas mediante microVM, sobre las que funcionan los Session endpoints descritos en el anuncio.
Una experiencia de desarrollo con resultados visibles durante la conversación
El ejemplo publicado por AWS muestra cómo los agentes de programación pueden combinar la edición de archivos con una visualización interactiva del resultado.
La separación entre InvokeAgentRuntime, utilizado para comunicarse con el agente, y los Session endpoints, utilizados para acceder al servidor web, permite mantener un sitio en ejecución dentro de la sesión mientras se realizan modificaciones.
Con el soporte de HTTP, WebSocket y autenticación por solicitud, Amazon Bedrock AgentCore ofrece una vía para integrar vistas previas en vivo en experiencias de desarrollo asistidas por agentes de IA.
Fuente: AWS Machine Learning Blog, 30 de octubre de 2026. Preview web apps live as your coding agent builds them with Amazon Bedrock AgentCore runtime.
