AWS, AgentCore Session endpoints 소개: 코딩 에이전트가 수정하는 웹 앱을 브라우저에서 실시간 미리보기

무슨 일이 있었나

AWS는 2026년 10월 30일 블로그 글에서 Amazon Bedrock AgentCore runtime의 Session endpoints를 소개했습니다. Amazon Bedrock AgentCore는 AWS가 AI 에이전트를 만들고 연결하고 최적화하는 플랫폼이라고 설명하는 서비스이고, AgentCore runtime은 그 기능 중 하나로 에이전트를 실행합니다. '코딩 에이전트'는 스스로 코드를 작성하고 수정하는 AI이고, 에이전트가 작업을 수행하는 한 번의 작업 기간을 '세션(session)'이라고 합니다. AWS에 따르면 AgentCore runtime은 각 세션을 서로 격리된 경량 가상 머신인 microVM에서 실행하며, Session endpoints를 쓰면 사용자가 자신의 브라우저에서 그 세션 안에서 실행 중인 앱을 열 수 있습니다.

AWS가 설명한 배경은 이렇습니다. 앱을 다른 곳으로 복사해 배포해야 한다면 수정할 때마다 배포를 기다려야 해서 검토 속도가 느려집니다. 반면 앱이 에이전트가 편집하는 바로 그 자리에서 계속 실행되면, 수정 후 몇 초 안에 브라우저에서 결과를 볼 수 있습니다.

AWS의 데모는 코딩 에이전트입니다. 사용자가 웹사이트를 다크 테마로 바꿔 달라고 요청하고 에이전트가 스타일시트(웹페이지의 모양을 정하는 파일)를 저장하면, 브라우저의 사이트가 새로고침 없이 갱신됩니다. 이하 내용은 모두 AWS의 설명입니다.

작동 방식과 제한

AWS 설명에 따르면 Session endpoints는 세션마다 인증이 필요한 URL을 제공하며, 각 요청의 HTTP 메서드, 경로, 쿼리 문자열, 본문과 WebSocket 연결(서버가 브라우저로 업데이트를 먼저 보낼 수 있는 장시간 연결)을 사용자가 허용한 포트로 전달합니다. 포트(port)는 한 컴퓨터 안의 서로 다른 서비스를 구분하는 '문 번호'로 이해하면 됩니다.

• 포트: AWS에 따르면 runtime을 만들 때 allowedPorts로 설정하며, 1~5개 항목이고 각 항목은 단일 포트 또는 8000–12000 범위의 구간입니다. 플랫폼 예약 포트는 제외되며, 앱은 해당 포트에서 수신 대기하고 0.0.0.0에 바인딩해야 합니다.
• URL: AWS에 따르면 URL은 InvokeAgentRuntime 응답 헤더에 담겨 전달됩니다.
• 인증: AWS에 따르면 IAM(AWS의 ID 및 접근 권한 관리 서비스)을 쓰는 runtime은 모든 요청에 SigV4 서명(AWS에서 요청자 신원을 증명하는 서명 방식)이 필요하고, 호출자는 bedrock-agentcore:InvokeAgentRuntimeProxy 권한도 있어야 합니다. JWT(JSON Web Token) 인증을 쓰는 runtime은 bearer token(접근 자격 증명의 일종)을 사용합니다. AWS는 URL을 안다고 해서 접근 권한이 생기는 것은 아니라고 강조했습니다.
• 범위: AWS에 따르면 URL은 단일 세션에만 유효하고 세션이 끝나면 만료됩니다. 외부에 서비스하려면 AWS Amplify Hosting 같은 호스팅 서비스에 배포해야 합니다.
• 로컬 엔드포인트: AWS에 따르면 브라우저는 페이지 요청에 스스로 서명이나 토큰을 붙일 수 없으므로, bedrock-agentcore SDK의 클라이언트가 로컬에 엔드포인트를 열어 요청에 자격 증명을 덧붙여 전달할 수 있습니다.

AWS는 Session endpoint와 기존 runtime endpoint도 구분했습니다. 후자는 에이전트 자체를 호출하는 진입점이고, 전자는 에이전트가 세션 안에서 실행하는 앱 등을 보기 위한 것입니다.

개발 팀에 주는 의미

AWS의 설명대로라면 개발 팀은 AI 에이전트가 만든 웹 프로토타입을 검토할 때, 에이전트가 일하는 같은 환경에서 결과를 바로 볼 수 있고 매번 먼저 배포할 필요가 없습니다. AWS는 이 기능이 빌드·테스트·검토용이며 최종 사용자에게 서비스를 제공하는 방법은 아니라고도 당부했습니다.

AWS는 다른 사람도 코딩 에이전트에 지시를 내릴 수 있다면 Amazon Bedrock Guardrails로 유해한 지시와 응답을 걸러내고, 게시 전에 에이전트의 수정 내용을 검토하는 방안을 고려하라고 덧붙였습니다. 또한 데모 에이전트의 파일 도구는 웹사이트 폴더 밖의 경로를 거부한다고 설명했습니다.

요청이 거부될 때 나타나는 응답

AWS는 또한 요청이 AWS CloudTrail에 InvokeAgentRuntimeProxy 이벤트로 기록되며, runtime이 전달 전에 자체 인증 헤더를 제거하므로 웹사이트는 사용자의 서명을 받지 않는다고 밝혔습니다.

적용 조건과 알려진 제한

• AWS에 따르면 Session endpoints는 microVM runtime에 적용되며 Instances 컴퓨팅 유형은 지원하지 않습니다.
• AWS에 따르면 URL은 공개 HTTPS로 접근하며, 인바운드 연결에는 AWS PrivateLink를 지원하지 않습니다.
• AWS 데모에는 Session endpoints를 제공하는 AWS 리전의 계정, Python 3.10 이상, bedrock-agentcore 1.25.2 이상, boto3 1.43.122 이상, Node.js 22 이상, Amazon Bedrock의 Claude Haiku 5.5 접근 권한이 필요합니다.
• AWS는 agentcore-samples GitHub 저장소에 전체 예제와 노트북을 제공합니다. 지속적인 과금을 피하려면 끝난 뒤 미리보기를 중지하고 예제가 만든 runtime, 업로드한 코드, IAM 역할을 삭제하라고 AWS는 권장합니다.

이 주제의 최신 뉴스 보기

• AI 뉴스