AWS, 코딩 에이전트가 만든 웹앱을 세션 엔드포인트로 실시간 미리보기하는 방법 공개
Preview web apps live as your coding agent builds them with Amazon Bedrock AgentCore runtime
Amazon Bedrock AgentCore 런타임의 Session endpoints를 이용하면 코딩 에이전트가 웹앱을 만드는 동안 배포 없이 같은 세션에서 바로 실행 중인 앱을 브라우저로 확인할 수 있다. 에이전트가 파일을 저장할 때마다 화면이 갱신되어 변경 사항을 즉시 검토할 수 있다. 각 세션은 격리된 microVM에서 실행되며, 세션마다 별도의 Session endpoint URL이 발급된다. 생성 시 allowedPorts로 1~5개의 포트(8000~12000 범위, 예약된 플랫폼 포트 제외)를 지정하고, 애플리케이션은 0.0.0.0에 바인딩해 해당 포트에서 리스닝해야 한다. 호스트 이름의 접두사(예: 8090--<session-endpoint-id>...)로 세션 내부 포트를 선택하며, HTTP/1.1, HTTP/2, WebSocket 연결이 통과한다. 모든 요청에는 IAM 인증 기준 SigV4 서명 또는 JWT 인증 기준 베어러 토큰이 필요하며, URL만으로는 접근할 수 없다. 브라우저가 서명을 직접 붙일 수 없어 bedrock-agentcore SDK의 Session endpoint 클라이언트가 로컬 엔드포인트(http://localhost:8088)를 열어 자격 증명을 추가해 전달한다. 기사는 Session endpoint가 세션 범위로 한정되어 URL 자격 증명과 수명이 세션에 묶인다고 설명한다. 따라서 이 기능은 에이전트가 만든 결과물을 빌드·테스트·검토하는 용도이며, 사용자에게 앱을 제공하려면 AWS Amplify Hosting 같은 호스팅 서비스에 배포해야 한다고 명시한다.
InvokeAgentRuntime 응답 헤더 X-Amzn-Bedrock-AgentCore-Runtime-Session-Endpoint-Url과 bedrock-agentcore:InvokeAgentRuntimeProxy 권한을 활용하면 에이전트 세션 안의 Vite 개발 서버를 로컬 브라우저에서 바로 검토하는 흐름을 구성할 수 있다.
원문 출처
AWS Machine Learning Blog