Shell-Ausführung
Mit Amazon Bedrock AgentCore Runtime können Sie Shell-Befehle innerhalb der Sitzung eines laufenden Agenten ausführen. Je nach Anwendungsfall sind zwei Modi verfügbar:
- One-shot Befehlsausführung -
InvokeAgentRuntimeCommand -
Führt einen einzelnen Befehl aus, streamt stdout/stderr über HTTP/2 und gibt den Exit-Code zurück. Jeder Befehl startet einen neuen Shell-Prozess ohne persistenten Status. Am besten für automatisierte Pipelines, CI/CD Gates und deterministische Operationen geeignet.
- Interaktive Shells (Terminals) -
InvokeAgentRuntimeCommandShell -
Öffnet eine persistente Terminalsitzung WebSocket mit vollständigem Shell-Status (Umgebungsvariablen, Arbeitsverzeichnis, Verlauf). Unterstützt die Wiederverbindung über
shellId. Ideal für Debugging, Umgebungsinspektion und Terminal-Benutzeroberflächen.
Vergleich der Funktionen
| Feature | One-shot (InvokeAgentRuntimeCommand) |
Interaktiv (InvokeAgentRuntimeCommandShell) |
|---|---|---|
|
Protocol (Protokoll) |
HTTP/2 (Anfrage-Antwort-Stream) |
WebSocket (persistente Verbindung) |
|
Shell-Status |
Zustandslos — jeder Befehl startet einen neuen Prozess |
Persistent — Umgebung, Arbeitsverzeichnis und Verlauf werden für alle Befehle übernommen |
|
Ausgabeformat |
Strukturierte Ereignisse ( |
Binäre Frames (Raw-Terminal I/O — unterstützt Farben, Cursorsteuerung und Vollbild-Apps) |
|
Wiederverbindung |
Nein — jeder Anruf ist unabhängig |
Ja, über |
|
Dauer |
Konfigurierbares Timeout (1—3.600 Sekunden) |
Maximal 1 Stunde (stellen Sie die Verbindung erneut her, um fortzufahren) |
Den richtigen Modus wählen
| Verwenden Sie die One-Shot-Ausführung, wenn... | Verwenden Sie interaktive Shells, wenn... |
|---|---|
|
Die Operation hat einen bekannten Befehl ( |
Sie benötigen einen persistenten Shell-Status für mehrere Befehle |
|
Sie möchten eine deterministische Ausführung mit einem strukturierten Exit-Code |
Sie möchten die Umgebung interaktiv erkunden |
|
Sie automatisieren einen CI/CD Pipeline-Schritt oder ein Validierungs-Gate |
Sie erstellen eine Terminal-Benutzeroberfläche (Claude Code, Amazon Kiro, OpenAI Codex) |
|
Jeder Befehl ist unabhängig und hat keinen gemeinsamen Status |
Sie benötigen Unterstützung bei der Wiederherstellung der Verbindung für lang andauernde Arbeiten |
|
Sie booten die Umgebung, bevor der Agent gestartet wird |
Sie debuggen oder inspizieren einen laufenden Agenten |
