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 berkembang melalui status-status berikut. Lihat Memulai sesi untuk siklus hidup sesi.



Memperbarui konfigurasi agen

Anda dapat memperbarui agent.tools dan agent.mcp_servers sebuah 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.

Hanya tools dan mcp_servers agen yang dapat berubah setelah sesi dibuat. Untuk menjalankan sesi dengan nilai model, system, atau skills yang berbeda dari milik agen, gunakan penggantian konfigurasi agen saat Anda membuat sesi. Bidang system yang dikonfigurasi pada agen bersifat tetap selama masa hidup sesi. Pada model yang mendukungnya, Anda masih dapat menambahkan panduan tingkat sistem di tengah sesi dengan mengirimkan event system.message.

Semantik dari pembaruan tools atau mcp_servers adalah penggantian penuh: array yang diberikan adalah nilai baru. Untuk mempertahankan entri yang sudah ada, lakukan GET pada sesi, modifikasi array-nya, dan 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"



Mendaftar 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 lagi hasil.

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

Kursor page bersifat opak dan mengodekan order dari permintaan yang menghasilkannya. Parameter kueri order menetapkan arah pengurutan hasil, asc atau desc berdasarkan waktu pembuatan; nilai default 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 bidang paginasi yang digunakan bersama di seluruh endpoint daftar, lihat Paginasi.

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

# Teruskan kursor next_page kembali 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}'
# Teruskan prev_page dari respons itu sebagai --page untuk kembali dengan cara yang sama.



Mengarsipkan sesi

Arsipkan sesi untuk mencegah event baru dikirim sambil 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 menghilangkan secara permanen catatan, event, dan sandbox yang terkait dengannya. Sesi dengan status running tidak dapat dihapus; kirim event interupsi jika Anda perlu menghapusnya segera.

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

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