Operasi sesi

Setelah sebuah sesi ada, gunakan operasi-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 sebuah sesi, termasuk kebijakan izin, di tengah sesi tanpa membuat versi agen baru. Pembaruan bersifat lokal untuk sesi tersebut dan tidak disebarkan kembali ke agen yang mendasarinya.

Hanya tools dan mcp_servers milik agen yang dapat diubah setelah sesi dibuat. Untuk menjalankan sesi dengan nilai model, system, atau skills yang berbeda dari milik agen, gunakan override konfigurasi agen saat Anda membuat sesi. Field system yang dikonfigurasi pada agen bersifat tetap selama masa hidup sesi. Pada model yang mendukungnya, Anda tetap dapat mengganti prompt sistem efektif di antara giliran dengan mengirimkan event system.message.

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

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

Hasil dari GET /v1/sessions dipaginasi. Gunakan parameter kueri limit untuk mengontrol ukuran halaman. Setiap respons menyertakan kursor next_page; teruskan sebagai parameter page pada permintaan berikutnya untuk mengambil halaman selanjutnya. next_page bernilai null ketika tidak ada hasil lagi.

Untuk kembali satu halaman, teruskan prev_page sebagai parameter page. prev_page bernilai null ketika Anda berada di halaman pertama.

Kursor page bersifat opaque dan mengenkode order dari permintaan yang menghasilkannya. Parameter kueri order menetapkan arah pengurutan hasil, asc atau desc berdasarkan waktu pembuatan; default-nya adalah desc (terbaru lebih dulu). Menggunakan kembali kursor dengan order yang berbeda akan mengembalikan error 400; parameter kueri lainnya, termasuk filter dan limit, dapat berubah di antara permintaan yang dipaginasi. Untuk field paginasi yang digunakan bersama di seluruh endpoint daftar, lihat Paginasi.

# --format raw mengembalikan satu envelope halaman dengan kursor prev_page dan next_page
# miliknya; output default melakukan auto-paginasi dan hanya mengeluarkan sesi-sesinya.
cursors=$(ant beta:sessions list \
  --agent-id "$AGENT_ID" \
  --limit 1 \
  --format raw \
  --transform '{prev_page,next_page}')
printf '%s\n' "$cursors"

# Kirim kembali kursor next_page sebagai --page untuk mengambil halaman berikutnya.
NEXT_PAGE=$(jq -r '.next_page' <<< "$cursors")
ant beta:sessions list \
  --agent-id "$AGENT_ID" \
  --limit 1 \
  --page "$NEXT_PAGE" \
  --format raw \
  --transform '{prev_page,next_page}'
# Kirim prev_page dari respons itu sebagai --page untuk kembali dengan cara yang sama.



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 mengarsipkannya segera.

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 menghapusnya segera.

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"