Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Une session est une instance d'agent en cours d'exécution dans un environnement. Chaque session référence un agent et un environnement (tous deux créés séparément), et maintient l'historique de conversation sur plusieurs interactions.
Toutes les demandes de l'API Managed Agents nécessitent l'en-tête bêta managed-agents-2026-04-01. Le SDK définit automatiquement l'en-tête bêta.
Une session nécessite un ID agent et un ID environment. Les agents sont des ressources versionnées ; passer l'ID agent en tant que chaîne de caractères démarre la session avec la dernière version de l'agent.
session = client.beta.sessions.create(
agent=agent.id,
environment_id=environment.id,
)Pour épingler une session à une version d'agent spécifique, passez un objet. Cela vous permet de contrôler exactement quelle version s'exécute et de mettre en scène les déploiements de nouvelles versions indépendamment.
L'agent définit le comportement de Claude au sein de la session, y compris le modèle, l'invite système, les outils et les serveurs MCP. Voir Configuration de l'agent pour plus de détails.
Si votre agent utilise des outils MCP qui nécessitent une authentification, passez vault_ids lors de la création de la session pour référencer un coffre-fort contenant les identifiants OAuth stockés. Anthropic gère l'actualisation des jetons en votre nom. Voir S'authentifier avec les coffres-forts pour savoir comment créer des coffres-forts et enregistrer les identifiants.
La création d'une session provisionne l'environnement et l'agent mais ne démarre aucun travail. Pour déléguer une tâche, envoyez des événements à la session en utilisant un événement utilisateur. La session agit comme une machine d'état qui suit la progression tandis que les événements pilotent l'exécution réelle.
Voir Événements et streaming pour savoir comment diffuser les réponses de l'agent et gérer les confirmations d'outils.
Les sessions progressent à travers ces statuts :
| Statut | Description |
|---|---|
idle | L'agent attend une entrée, y compris les messages utilisateur ou les confirmations d'outils. Les sessions commencent en idle. |
running | L'agent exécute activement |
rescheduling | Une erreur transitoire s'est produite, nouvelle tentative automatique |
terminated | La session s'est terminée en raison d'une erreur irrécupérable |
Archivez une session pour empêcher l'envoi de nouveaux événements tout en préservant son historique :
Supprimez une session pour supprimer définitivement son enregistrement, ses événements et son conteneur associé. Une session running ne peut pas être supprimée ; envoyez un événement d'interruption si vous devez la supprimer immédiatement.
Les fichiers, les magasins de mémoire, les environnements et les agents sont des ressources indépendantes et ne sont pas affectés par la suppression de session.
Was this page helpful?
pinned_session = client.beta.sessions.create(
agent={"type": "agent", "id": agent.id, "version": 1},
environment_id=environment.id,
)vault_session = client.beta.sessions.create(
agent=agent.id,
environment_id=environment.id,
vault_ids=[vault.id],
)client.beta.sessions.events.send(
session.id,
events=[
{
"type": "user.message",
"content": [
{"type": "text", "text": "List the files in the working directory."}
],
},
],
)retrieved = client.beta.sessions.retrieve(session.id)
print(f"Status: {retrieved.status}")for session in client.beta.sessions.list():
print(f"{session.id}: {session.status}")client.beta.sessions.archive(session.id)client.beta.sessions.delete(session.id)