Mulai sesi

Sesi adalah instans agen yang berjalan dalam lingkungan. Setiap sesi mereferensikan agen dan lingkungan (keduanya dibuat secara terpisah), dan mempertahankan riwayat percakapan di seluruh interaksi ganda.

Membuat sesi

Sesi memerlukan ID agent dan ID environment. Agen adalah sumber daya yang memiliki versi; melewatkan ID agent sebagai string memulai sesi dengan versi agen terbaru.

session = client.beta.sessions.create(
    agent=agent.id,
    environment_id=environment.id,
)

Untuk mengikat sesi ke versi agen tertentu, lewatkan objek. Ini memungkinkan Anda mengontrol dengan tepat versi mana yang berjalan dan melakukan peluncuran versi baru secara independen.

pinned_session = client.beta.sessions.create(
    agent={"type": "agent", "id": agent.id, "version": 1},
    environment_id=environment.id,
)

Autentikasi MCP melalui vault

Jika agen Anda menggunakan alat MCP yang memerlukan autentikasi, lewatkan vault_ids saat pembuatan sesi untuk mereferensikan vault yang berisi kredensial OAuth yang disimpan. Anthropic mengelola penyegaran token atas nama Anda. Lihat Autentikasi dengan vault untuk cara membuat vault dan mendaftarkan kredensial.

vault_session = client.beta.sessions.create(
    agent=agent.id,
    environment_id=environment.id,
    vault_ids=[vault.id],
)

Memulai sesi

Membuat sesi menyediakan lingkungan dan agen tetapi tidak memulai pekerjaan apa pun. Untuk mendelegasikan tugas, kirim peristiwa ke sesi menggunakan peristiwa pengguna. Sesi bertindak sebagai mesin keadaan yang melacak kemajuan sementara peristiwa mendorong eksekusi sebenarnya.

client.beta.sessions.events.send(
    session.id,
    events=[
        {
            "type": "user.message",
            "content": [
                {"type": "text", "text": "List the files in the working directory."}
            ],
        },
    ],
)

Lihat Peristiwa dan streaming untuk cara melakukan streaming respons agen dan menangani konfirmasi alat.

Status sesi

Sesi berkembang melalui status ini:

Operasi sesi lainnya

Mengambil sesi

retrieved = client.beta.sessions.retrieve(session.id)
print(f"Status: {retrieved.status}")

Daftar sesi

for session in client.beta.sessions.list():
    print(f"{session.id}: {session.status}")

Mengarsipkan sesi

Arsipkan sesi untuk mencegah peristiwa baru dikirim sambil mempertahankan riwayatnya:

client.beta.sessions.archive(session.id)

Menghapus sesi

Hapus sesi untuk menghapus secara permanen catatan, peristiwa, dan kontainer terkaitnya. Sesi running tidak dapat dihapus; kirim peristiwa interrupt jika Anda perlu menghapusnya segera.

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

client.beta.sessions.delete(session.id)