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.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": "/data.csv",
        },
    ],
)

Dengan mount_path di atas, agen membaca file di /mnt/session/uploads/data.csv (lihat Jalur file).

Sebuah file_id baru dibuat yang mereferensikan instans 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": "/data.csv"},
    {"type": "file", "file_id": "file_def456", "mount_path": "/config.json"},
    {"type": "file", "file_id": "file_ghi789", "mount_path": "/src/main.py"},
]

Maksimum 500 file didukung per sesi.



Mengelola file pada sesi yang sedang berjalan

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

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

Daftar semua sumber daya pada sesi dengan resources.list. Untuk menghapus file, panggil resources.delete dengan ID sumber daya:

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)



Mendaftar dan mengunduh file sesi

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

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

# Mengunduh 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



Jalur file

• Jalur yang Anda tentukan berakar di bawah direktori uploads sesi: mount_path berupa /data.csv menempatkan file di /mnt/session/uploads/data.csv dalam sandbox
• Jika Anda menghilangkan mount_path, file ditempatkan di /mnt/session/uploads/<file_id>
• Direktori induk dibuat secara otomatis
• Jalur harus absolut (dimulai dengan /)