Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Exécution du shell
Amazon Bedrock AgentCore Runtime vous permet d'exécuter des commandes shell dans la session d'un agent en cours d'exécution. Deux modes sont disponibles en fonction de votre cas d'utilisation :
- One-shot exécution de commandes -
InvokeAgentRuntimeCommand -
Exécute une seule commande HTTP/2, stdout/stderr diffuse et renvoie le code de sortie. Chaque commande lance un nouveau processus shell sans état persistant. Idéal pour les pipelines automatisés, les CI/CD vannes et les opérations déterministes.
- Coques interactives (bornes) -
InvokeAgentRuntimeCommandShell -
Ouvre une session de terminal persistante WebSocket avec l'état complet du shell (variables d'environnement, répertoire de travail, historique). Supporte la reconnexion via
shellId. Idéal pour le débogage, l'inspection de l'environnement et les interfaces utilisateur des terminaux.
Comparaison des fonctionnalités
| Fonctionnalité | One-shot (InvokeAgentRuntimeCommand) |
Interactif (InvokeAgentRuntimeCommandShell) |
|---|---|---|
|
Protocole |
HTTP/2 (flux demande-réponse) |
WebSocket (connexion permanente) |
|
État de la coque |
Stateless : chaque commande lance un nouveau processus |
Persistant : l'environnement, le répertoire de travail et l'historique transfèrent les commandes |
|
Format de sortie |
Événements structurés ( |
Trames binaires (terminal brut I/O — prend en charge les couleurs, le contrôle du curseur, les applications en plein écran) |
|
Reconnexion |
Non, chaque appel est indépendant |
Oui, via |
|
Duration |
Délai d'attente configurable (1 à 3 600 secondes) |
1 heure maximum (reconnectez-vous avec le même appareil |
Choisir le bon mode
| Utilisez l'exécution en un coup lorsque... | Utilisez des shells interactifs lorsque... |
|---|---|
|
L'opération possède une commande connue ( |
Vous avez besoin d'un état de shell persistant pour plusieurs commandes |
|
Vous souhaitez une exécution déterministe avec un code de sortie structuré |
Vous souhaitez explorer l'environnement de manière interactive |
|
Vous automatisez une étape du CI/CD pipeline ou une porte de validation |
Vous créez une interface utilisateur de terminal (Claude Code, Amazon Kiro, OpenAI Codex) |
|
Chaque commande est indépendante et n'a aucun état partagé |
Vous avez besoin d'une aide à la reconnexion pour les travaux de longue durée |
|
Vous démarrez l'environnement avant que l'agent ne démarre |
Vous êtes en train de déboguer ou d'inspecter un agent en cours d'exécution |
Rubriques
