Session-Operationen

Sobald eine Session existiert, kannst du diese Operationen verwenden, um sie zu lesen, zu aktualisieren, zu archivieren oder zu löschen. Siehe Eine Session starten, um eine Session zu erstellen und ihr Arbeit zu senden.

Session-Status

Sessions durchlaufen die folgenden Status. Siehe Eine Session starten für den Session-Lebenszyklus.

Aktualisieren der Agent-Konfiguration

Du kannst agent.tools und agent.mcp_servers einer Session, einschließlich der Berechtigungsrichtlinien, während einer laufenden Session aktualisieren, ohne eine neue Agent-Version zu erstellen. Aktualisierungen sind session-lokal und werden nicht auf den zugrunde liegenden Agent zurückübertragen.

Die Semantik einer Aktualisierung ist eine vollständige Ersetzung: Das bereitgestellte Array ist der neue Wert. Um bestehende Einträge beizubehalten, rufe die Session per GET ab, ändere das Array und sende es per POST zurück.

Die Session muss sich im Status idle befinden, um den Agent zu aktualisieren. Unterbreche die Session, wenn du den Agent aktualisieren musst, während er läuft.

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

Abrufen einer Session

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

Auflisten von Sessions

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

Archivieren einer Session

Archiviere eine Session, um zu verhindern, dass neue Events gesendet werden, während ihr Verlauf erhalten bleibt. Eine Session im Status running kann nicht archiviert werden; sende ein Interrupt-Event, wenn du sie sofort archivieren musst.

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

Löschen einer Session

Lösche eine Session, um ihren Datensatz, ihre Events und die zugehörige Sandbox dauerhaft zu entfernen. Eine Session im Status running kann nicht gelöscht werden; sende ein Interrupt-Event, wenn du sie sofort löschen musst.

Dateien, Memory Stores, Vaults, Skills, Environments und Agents sind unabhängige Ressourcen und werden durch das Löschen einer Session nicht beeinflusst.

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