Operasi sesi

Setelah sesi dibuat, gunakan operasi ini untuk membaca, memperbarui, mengarsipkan, atau menghapusnya. Lihat Memulai sesi untuk membuat sesi dan mengirimkan pekerjaan kepadanya.

Status sesi

Sesi berjalan melalui status-status berikut. Lihat Memulai sesi untuk siklus hidup sesi.

Memperbarui konfigurasi agen

Anda dapat memperbarui agent.tools dan agent.mcp_servers milik sesi, termasuk kebijakan izin, di tengah sesi tanpa membuat versi agen baru. Pembaruan bersifat lokal untuk sesi dan tidak disebarkan kembali ke agen yang mendasarinya.

Semantik pembaruan adalah penggantian penuh: array yang diberikan menjadi nilai baru. Untuk mempertahankan entri yang sudah ada, lakukan GET pada sesi, modifikasi array-nya, lalu kirim kembali dengan POST.

Sesi harus dalam status idle untuk memperbarui agen. Interupsi sesi jika Anda perlu memperbarui agen saat sesi sedang berjalan.

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

Mengambil sesi

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

Membuat daftar sesi

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

Mengarsipkan sesi

Arsipkan sesi untuk mencegah event baru dikirim sambil tetap mempertahankan riwayatnya. Sesi dengan status running tidak dapat diarsipkan; kirim event interupsi jika Anda perlu segera mengarsipkannya.

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

Menghapus sesi

Hapus sesi untuk menghapus secara permanen catatannya, event-nya, dan sandbox yang terkait. Sesi dengan status running tidak dapat dihapus; kirim event interupsi jika Anda perlu segera menghapusnya.

File, memory store, vault, skill, environment, dan agen adalah sumber daya independen dan tidak terpengaruh oleh penghapusan sesi.

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