Opérations sur les sessions

Une fois qu'une session existe, utilisez ces opérations pour la lire, la mettre à jour, l'archiver ou la supprimer. Consultez Démarrer une session pour créer une session et lui envoyer du travail.

Statuts de session

Les sessions progressent à travers ces statuts. Consultez Démarrer une session pour le cycle de vie d'une session.

Mise à jour de la configuration de l'agent

Vous pouvez mettre à jour les champs agent.tools et agent.mcp_servers d'une session, y compris les politiques d'autorisation, en cours de session sans créer une nouvelle version de l'agent. Les mises à jour sont locales à la session et ne se propagent pas à l'agent sous-jacent.

La sémantique d'une mise à jour est un remplacement complet : le tableau fourni devient la nouvelle valeur. Pour préserver les entrées existantes, effectuez un GET sur la session, modifiez le tableau, puis renvoyez-le avec un POST.

La session doit être idle pour mettre à jour l'agent. Interrompez la session si vous devez mettre à jour l'agent pendant qu'elle est en cours d'exécution.

ant beta:sessions update --session-id "$SESSION_ID" <<'YAML'
agent:
  tools:
    - type: agent_toolset_20260401
    - type: mcp_toolset
      mcp_server_name: linear
  mcp_servers:
    - type: url
      name: linear
      url: https://mcp.linear.app/sse
YAML

Récupération d'une session

ant beta:sessions retrieve --session-id "$SESSION_ID"

Liste des sessions

ant beta:sessions list --agent-id "$AGENT_ID"

Archivage d'une session

Archivez une session pour empêcher l'envoi de nouveaux événements tout en préservant son historique. Une session running ne peut pas être archivée ; envoyez un événement d'interruption si vous devez l'archiver immédiatement.

ant beta:sessions archive \
  --session-id "$SESSION_ID"

Suppression d'une session

Supprimez une session pour effacer définitivement son enregistrement, ses événements et le bac à sable 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 coffres-forts, les compétences, les environnements et les agents sont des ressources indépendantes et ne sont pas affectés par la suppression d'une session.

ant beta:sessions delete \
  --session-id "$SESSION_ID"