AWS, 베드록 에이전트코어 런타임에 세션 엔드포인트 추가해 코딩 에이전트 작업물 실시간 미리보기 지원
AWS가 아마존 베드록 에이전트코어 런타임에 세션 엔드포인트를 도입해, 코딩 에이전트가 웹 앱을 만드는 동안 개발자가 브라우저에서 바로 그 결과물을 미리 볼 수 있도록 했다.
한 줄 답
AWS는 아마존 베드록 에이전트코어에서 코딩 에이전트의 작업 결과를 미리보기 위해 무엇을 발표했나?
AWS는 아마존 베드록 에이전트코어 런타임이 이제 세션 엔드포인트를 지원한다고 밝혔다. 이는 인증된 URL로, 개발자가 코딩 에이전트가 격리된 세션 안에서 만들고 있는 웹 앱을 자신의 브라우저에서 직접 열어볼 수 있게 해준다. 이 엔드포인트는 HTTP와 웹소켓 트래픽을 개발자가 허용한 포트로 전달하기 때문에, 별도의 배포 과정을 거치지 않고도 변경 사항이 곧바로 화면에 나타난다.
핵심 요약
- AWS는 개발자가 에이전트 세션 내부에서 실행 중인 웹 앱을 브라우저에서 직접 열어볼 수 있게 해주는 아마존 베드록 에이전트코어 런타임의 기능, 세션 엔드포인트를 선보였다.
- 각 에이전트 세션은 독립된 마이크로VM에서 실행되며, 개발자는 `CreateAgentRuntime` 호출 시 `allowedPorts` 매개변수를 설정해 세션 엔드포인트가 접근할 수 있는 포트를 1개에서 5개까지, 8000-12000 범위 내에서 선택한다.
- AWS는 세션 엔드포인트를 통한 모든 요청이 인증을 거치며, IAM에 의존하는 런타임은 SigV4 서명을, JWT 인증자를 쓰는 런타임은 베어러 토큰을 사용한다고 밝혔다.
- AWS는 agentcore-samples 깃허브 저장소에 샘플을 공개했는데, 이는 코딩 에이전트가 Vite 웹사이트를 세션 안에서 계속 실행시켜 에이전트가 파일을 수정할 때마다 변경 사항이 브라우저에 바로 나타나는 모습을 보여준다.
- AWS는 세션 엔드포인트가 단일 세션에만 범위가 한정되며, 최종 사용자에게 앱을 서비스하기 위한 용도가 아니라 에이전트 작업물을 빌드·테스트·검토하기 위한 것이라고 밝혔다. 최종 사용자 서비스를 위해서는 AWS 앰플리파이 호스팅과 같은 별도의 호스팅 서비스에 배포해야 한다.
AWS의 발표 내용
아마존웹서비스(AWS)는 아마존 베드록 에이전트코어 런타임이 '세션 엔드포인트'라는 기능을 새롭게 지원한다고 밝혔다. 이 기능을 이용하면 개발자는 코딩 에이전트가 한창 작업 중인 웹 앱을 자신의 브라우저에서 직접 열어 상호작용할 수 있다.
AWS에 따르면 에이전트코어 런타임은 이미 각 에이전트 세션을 독립된 마이크로VM에서 실행하고 있었다. 세션 엔드포인트는 이러한 세션에 인증된 URL을 추가로 부여해, 각 요청의 HTTP 메서드, 경로, 쿼리 문자열, 본문은 물론 웹소켓 연결까지 개발자가 허용한 포트로 전달한다. AWS는 이를 통해 개발자가 에이전트가 파일을 저장할 때마다 페이지가 갱신되는 모습을 바로 지켜볼 수 있으며, 매번 검토할 때마다 앱을 복사해 다른 곳에 배포할 필요가 없어졌다고 설명했다.
세션 엔드포인트의 작동 방식
AWS는 세션 엔드포인트의 작동을 규정하는 여섯 가지 세부 사항을 설명했다.
- 포트 선택: 개발자는
CreateAgentRuntime을 호출할 때allowedPorts매개변수를 설정해 1개에서 5개까지의 항목을 지정할 수 있으며, 각 항목은 단일 포트 또는 8000-12000 범위 내의 포트 구간이어야 하고 플랫폼 예약 포트는 제외된다. AWS는 포트를 허용한다고 해서 서버가 자동으로 시작되는 것은 아니며, 애플리케이션이 해당 포트에서0.0.0.0으로 바인딩해 수신 대기해야 한다고 설명했다. - URL 전달:
InvokeAgentRuntime응답에는X-Amzn-Bedrock-AgentCore-Runtime-Session-Endpoint-Url헤더에 엔드포인트 URL이 담기며, 이를 지원하는 SDK는 이를sessionEndpointUrl로 노출한다. - 인증: AWS IAM을 사용하는 런타임의 경우, 모든 HTTP 요청, HTTP/2 스트림, 웹소켓 핸드셰이크에는 시그니처 버전 4(SigV4) 서명이 포함되며 호출자는
bedrock-agentcore:InvokeAgentRuntimeProxy권한을 가져야 한다고 AWS는 밝혔다. JWT 인증자를 사용하는 런타임의 경우에는 각 요청에 베어러 토큰이 포함된다. - 호스트 이름을 통한 포트 라우팅: AWS는 클라이언트가 항상 443번 포트로 연결하며, 호스트 이름 앞에 붙는 접두사가 세션 내부에서 대상 포트를 선택한다고 설명했다.
- 프로토콜 지원: AWS는 이 엔드포인트가 HTTP/1.1, HTTP/2(서버 전송 이벤트 및 gRPC 포함), 웹소켓 트래픽을 모두 처리한다고 밝혔다.
- 세션 범위: AWS는 이 URL이 모든 요청에 자격 증명을 요구하며 세션이 지속되는 동안에만 유효하고, 에이전트 작업물을 빌드하고 테스트하고 검토하기 위한 용도로 설계됐다고 설명했다. 최종 사용자에게 앱을 서비스하려면 AWS 앰플리파이 호스팅과 같은 호스팅 서비스에 배포해야 한다고 AWS는 덧붙였다.
AWS는 또한 브라우저가 자체적으로 SigV4 서명이나 베어러 토큰을 첨부할 수 없기 때문에, bedrock-agentcore SDK의 세션 엔드포인트 클라이언트가 개발자의 로컬 머신에 로컬 엔드포인트를 열어, 각 요청과 웹소켓 핸드셰이크에 자격 증명을 추가한 뒤 브라우저로 전달할 수 있다고 설명했다.
AWS는 이 세션 엔드포인트를 에이전트코어 런타임이 기존에 제공하던 런타임 엔드포인트와 구분했다. DEFAULT와 같은 런타임 엔드포인트는 호출자가 접근하는 에이전트 버전을 제어하며, 개발자가 개발용과 프로덕션용 버전을 별도로 유지할 수 있게 해준다. 반면 세션 엔드포인트는 해당 특정 세션에서 실행 중인 에이전트 버전을 그대로 반영하며, 세션이 종료되면 작동을 멈춘다.
샘플 코드 살펴보기
AWS는 네 부분으로 구성된 샘플을 공개했다. 목록·읽기·쓰기·편집 도구를 이용해 웹사이트 파일을 수정하는, 8080번 포트에서 실행되는 코딩 에이전트, 에이전트가 시작한 8090번 포트의 Vite 개발 서버(웹사이트를 서비스하며 저장된 변경 사항을 핫 리로드 웹소켓을 통해 브라우저로 전송), 미리보기 페이지를 서비스하고 InvokeAgentRuntime에 프롬프트를 전송하며 웹사이트용 로컬 엔드포인트를 여는 로컬 PreviewApp, 그리고 로컬 엔드포인트와 세션 엔드포인트를 통해 웹사이트를 불러오면서 에이전트에 프롬프트를 전송하는 미리보기 페이지 자체다. 이 글이 따르는 노트북을 포함한 전체 샘플은 agentcore-samples 깃허브 저장소의 14-remote-access 폴더에서 확인할 수 있다.
출처: AWS 머신러닝 블로그, 'Preview web apps live as your coding agent builds them with Amazon Bedrock AgentCore runtime', 2026년 10월 30일 게재.
자주 묻는 질문
- 아마존 베드록 에이전트코어 런타임의 세션 엔드포인트란 무엇인가?
- AWS는 이를 단일 에이전트 세션에 연결된 인증된 URL로, HTTP 요청과 웹소켓 연결을 개발자가 허용한 포트로 전달해 개발자가 에이전트가 만들고 있는 앱을 자신의 브라우저에서 열어볼 수 있게 해준다고 설명한다.
- AWS는 세션 엔드포인트 트래픽을 어떻게 보호하나?
- AWS는 모든 요청이 인증을 거친다고 밝혔다. IAM을 사용하는 런타임은 SigV4 서명과 `bedrock-agentcore:InvokeAgentRuntimeProxy` 권한을 요구하며, JWT 인증자를 사용하는 런타임은 각 요청에 베어러 토큰을 요구한다.
- 세션 엔드포인트를 최종 사용자에게 앱을 서비스하는 데 쓸 수 있나?
- 쓸 수 없다. AWS는 세션 엔드포인트 URL이 세션이 지속되는 동안에만 유효하며 에이전트 작업물을 빌드·테스트·검토하기 위한 용도라고 밝혔다. 사용자에게 앱을 서비스하려면 AWS 앰플리파이 호스팅과 같은 별도의 호스팅 서비스에 배포해야 한다.
- 이 기능의 샘플 코드는 어디서 찾을 수 있나?
- AWS는 agentcore-samples 깃허브 저장소의 14-remote-access 폴더를 안내했다. 여기에는 코딩 에이전트가 세션 안에서 Vite 웹사이트를 계속 실행시켜 실시간 미리보기를 보여주는 노트북이 포함돼 있다.