목록으로

Programming Notes

Amazon Bedrock AgentCore Runtime, 에이전트 세션 터미널 접속을 위한 대화형 셸(Interactive Shell) 출시

Amazon Bedrock AgentCore Runtime이 새로운 InvokeAgentRuntimeCommandShell API를 통해 대화형 셸을 지원합니다. 이 API는 WebSocket을 통해 실행 중인 에이전트 세션에 직접 연결되는 지속적인 PTY 기반 터미널을 제공합니다. 이는 단발성 명령 실행을 위한 기존의 InvokeAgentRuntimeCommand API를 보완하며, 개발자에게 색상 지원, 탭 자동 완성, Ctrl+C, 터미널 크기 조정 및 네트워크 끊김 시 자동 재연결 기능을 갖춘 격리된 마이크로VM(microVM) 내의 완전한 터미널 환경을 제공합니다.

이 기능은 특히 Claude Code, OpenAI Codex, Amazon Kiro와 같은 코딩 에이전트를 AgentCore Runtime에서 호스팅하는 개발자들에게 매우 중요합니다. 기존의 비동기 명령 실행 기능에 더해, 이제 개발자는 인증을 거쳐 코딩 에이전트를 호스팅하는 마이크로VM에 직접 접속하여 로컬 터미널처럼 상호 작용할 수 있습니다. 에이전트와 대화하고, 파일을 검사하며, 임의의 명령을 실행하거나 환경 상태를 디버깅하는 것이 가능해집니다. 셸은 동일한 세션 내에서 명령 간의 지속적인 상태를 유지하므로, 환경 변수, 작업 디렉터리, 명령 기록이 모두 의도한 대로 작동합니다.

각 대화형 세션은 런타임 세션 ID와 셸 ID로 식별됩니다. 재연결 시 이 두 ID를 함께 전달하면 정확히 이전에 사용하던 셸로 다시 접속할 수 있습니다. 짧은 네트워크 끊김은 자동으로 재연결되며, 장시간 연결이 끊긴 경우에도 동일한 ID를 사용하여 수동으로 세션을 재개할 수 있습니다. 단일 에이전트 런타임은 최대 10개의 동시 셸을 지원하므로, 개발자는 동일한 또는 여러 마이크로VM에 대해 여러 개의 터미널을 열고 에이전트가 서로 다른 브랜치에서 작업하는 과정을 병렬로 관찰할 수 있습니다.

AgentCore CLI를 사용하여 시작하려면 다음 명령어를 입력하세요: agentcore exec --it --runtime <runtime-arn>. 자세한 내용은 대화형 셸(터미널)AgentCore Runtime의 셸 실행에서 두 가지 셸 모드에 대한 비교를 확인하시기 바랍니다.