# Execução de shell
<a name="runtime-shell-execution"></a>

O Amazon Bedrock AgentCore Runtime permite que você execute comandos de shell dentro da sessão de um agente em execução. Dois modos estão disponíveis, dependendo do seu caso de uso:

One-shot execução de comando - `InvokeAgentRuntimeCommand`   
Executa um único comando, transmite stdout/stderr e retorna o código de saída. HTTP/2 Cada comando inicia um novo processo de shell sem estado persistente. Ideal para tubulações automatizadas, CI/CD portões e operações determinísticas.

Conchas interativas (terminais) - `InvokeAgentRuntimeCommandShell`   
Abre uma sessão de terminal persistente WebSocket com o estado completo do shell (variáveis de ambiente, diretório de trabalho, histórico). Suporta reconexão via`shellId`. Ideal para depuração, inspeção ambiental e interfaces de usuário de terminal.

 **Comparação de recursos** 


| Recurso | One-shot (`InvokeAgentRuntimeCommand`) | Interativo (`InvokeAgentRuntimeCommandShell`) | 
| --- | --- | --- | 
| Protocolo | HTTP/2 (fluxo de solicitação-resposta) | WebSocket (conexão persistente) | 
| Estado da Shell | Stateless — cada comando inicia um novo processo | Persistente — ambiente, diretório de trabalho e histórico são transferidos entre comandos | 
| Formato de saída | Eventos estruturados (`contentStart`,`contentDelta`, `contentStop` com código de saída) | Quadros binários (terminal bruto I/O — suporta cores, controle de cursor, aplicativos em tela cheia) | 
| Reconexão | Não — cada chamada é independente | Sim, via `shellId`  | 
| Duração | Tempo limite configurável (1—3.600 segundos) | Máximo de 1 hora (reconecte-se com o mesmo `shellId` para continuar) | 

 **Escolhendo o modo certo** 


| Use a execução única quando... | Use conchas interativas quando... | 
| --- | --- | 
| A operação tem um comando conhecido (`npm test`,`git push`) | Você precisa de um estado de shell persistente em vários comandos | 
| Você quer uma execução determinística com um código de saída estruturado | Você deseja explorar o ambiente de forma interativa | 
| Você está automatizando uma etapa do CI/CD pipeline ou uma porta de validação | Você está criando uma interface de usuário de terminal (Claude Code, Amazon Kiro, OpenAI Codex) | 
| Cada comando é independente, sem estado compartilhado | Você precisa de suporte de reconexão para trabalhos de longa duração | 
| Você está inicializando o ambiente antes que o agente comece | Você está depurando ou inspecionando um agente em execução | 

**Topics**
+ [Execute comandos shell em sessões AgentCore de tempo de execução](runtime-execute-command.md)
+ [Conchas interativas (terminais)](runtime-get-started-command-shell.md)