쉘 실행
Amazon Bedrock AgentCore 런타임을 사용하면 실행 중인 에이전트의 세션 내에서 셸 명령을 실행할 수 있습니다. 사용 사례에 따라 두 가지 모드를 사용할 수 있습니다.
- 원샷 명령 실행 -
InvokeAgentRuntimeCommand -
단일 명령을 실행하고, HTTP/2를 통해 stdout/stderr를 스트리밍하고, 종료 코드를 반환합니다. 각 명령은 영구 상태 없이 새 셸 프로세스를 시작합니다. 자동화된 파이프라인, CI/CD 게이트 및 결정적 작업에 가장 적합합니다.
- 대화형 셸(터미널) -
InvokeAgentRuntimeCommandShell -
전체 쉘 상태(환경 변수, 작업 디렉터리, 기록)로 WebSocket을 통해 영구 터미널 세션을 엽니다. 를 통한 재연결을 지원합니다
shellId. 디버깅, 환경 검사 및 터미널 UIs 가장 적합합니다.
기능 비교
| 기능 | 원샷(InvokeAgentRuntimeCommand) |
대화형(InvokeAgentRuntimeCommandShell) |
|---|---|---|
|
프로토콜 |
HTTP/2(요청-응답 스트림) |
WebSocket(영구 연결) |
|
쉘 상태 |
상태 비저장 - 각 명령이 새 프로세스를 시작합니다. |
영구 - 환경, 작업 디렉터리 및 기록이 명령 간에 전달됩니다. |
|
출력 형식 |
구조화된 이벤트( |
바이너리 프레임(원시 터미널 I/O - 색상, 커서 제어, 전체 화면 앱 지원) |
|
재연결 |
아니요 - 각 호출은 독립적입니다. |
예,를 통해 |
|
지속 시간 |
구성 가능한 제한 시간(1~3,600초) |
최대 1시간(계속 |
올바른 모드 선택
| 다음과 같은 경우 원샷 실행을 사용합니다. | 다음과 같은 경우 대화형 셸을 사용합니다. |
|---|---|
|
작업에 알려진 명령( |
여러 명령에 걸쳐 영구 쉘 상태가 필요합니다. |
|
구조화된 종료 코드를 사용하여 결정론적 실행을 원할 경우 |
대화형으로 환경을 탐색하려는 경우 |
|
CI/CD 파이프라인 단계 또는 검증 게이트를 자동화하는 경우 |
터미널 UI(Claude Code, Amazon Kiro, OpenAI Codex)를 빌드하고 있습니다. |
|
각 명령은 공유 상태 없이 독립적입니다. |
장기 실행 작업에 대한 재연결 지원이 필요합니다. |
|
에이전트가 시작되기 전에 환경을 부트스트래핑하는 경우 |
실행 중인 에이전트를 디버깅하거나 검사하는 경우 |
