Menambahkan file

Anda dapat menyediakan file untuk agen Anda dengan mengunggahnya melalui Files API dan memasangnya di sandbox sesi.



Mengunggah file

Pertama, unggah file menggunakan Files API:

file = client.beta.files.upload(file=Path("data.csv"))
print(f"File ID: {file.id}")



Memasang file dalam sesi

Pasang file yang telah diunggah ke dalam sandbox dengan menambahkannya ke array resources saat membuat sesi:

session = client.beta.sessions.create(
    agent=agent.id,
    environment_id=environment.id,
    resources=[
        {
            "type": "file",
            "file_id": file.id,
            "mount_path": "/workspace/data.csv",
        },
    ],
)

Sebuah file_id baru dibuat yang mereferensikan instance file dalam sesi tersebut. Salinan ini tidak dihitung terhadap batas penyimpanan Anda.



Beberapa file

Pasang beberapa file dengan menambahkan entri ke array resources:

resources = [
    {"type": "file", "file_id": "file_abc123", "mount_path": "/workspace/data.csv"},
    {"type": "file", "file_id": "file_def456", "mount_path": "/workspace/config.json"},
    {"type": "file", "file_id": "file_ghi789", "mount_path": "/workspace/src/main.py"},
]

Maksimum 100 file didukung per sesi.



Mengelola file pada sesi yang sedang berjalan

Anda dapat menambahkan atau menghapus file dari sesi setelah pembuatan menggunakan API resources sesi. Setiap resource memiliki id yang dikembalikan saat ditambahkan (atau didaftarkan), yang Anda gunakan untuk penghapusan.

resource = client.beta.sessions.resources.add(
    session.id,
    type="file",
    file_id=file.id,
)
print(resource.id)  # "sesrsc_01ABC..."

Daftarkan semua resource pada sesi dengan resources.list. Untuk menghapus file, panggil resources.delete dengan ID resource:

listed = client.beta.sessions.resources.list(session.id)
for entry in listed.data:
    print(entry.id, entry.type)

client.beta.sessions.resources.delete(resource.id, session_id=session.id)



Mendaftarkan dan mengunduh file sesi

Gunakan Files API untuk mendaftarkan file yang tercakup dalam sesi dan mengunduhnya.

# Daftar file yang terkait dengan sebuah sesi
files = client.beta.files.list(
    scope_id="sesn_abc123",
    betas=["managed-agents-2026-04-01"],
)
for f in files:
    print(f.id, f.filename)

# Unduh sebuah file
content = client.beta.files.download(files.data[0].id)
content.write_to_file("output.txt")



Tipe file yang didukung

Agen dapat bekerja dengan tipe file apa pun, termasuk:

• Kode sumber (.py, .js, .ts, .go, .rs, dan lainnya)
• File data (.csv, .json, .xml, .yaml)
• Dokumen (.txt, .md)
• Arsip (.zip, .tar.gz) - agen dapat mengekstraknya menggunakan bash
• File biner - agen dapat memprosesnya dengan alat yang sesuai



Path file

• File dipasang pada path persis yang Anda tentukan
• Direktori induk dibuat secara otomatis
• Path harus absolut (dimulai dengan /)