Aggiungere file

Puoi fornire file al tuo agente caricandoli tramite la Files API e montandoli nella sandbox della sessione.



Caricare file

Per prima cosa, carica un file utilizzando la Files API:

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



Montare file in una sessione

Monta i file caricati nella sandbox aggiungendoli all'array resources durante la creazione di una sessione:

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

Viene creato un nuovo file_id che fa riferimento all'istanza del file nella sessione. Queste copie non vengono conteggiate nei tuoi limiti di archiviazione.



File multipli

Monta più file aggiungendo voci all'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"},
]

È supportato un massimo di 100 file per sessione.



Gestire file in una sessione in esecuzione

Puoi aggiungere o rimuovere file da una sessione dopo la creazione utilizzando l'API delle risorse della sessione. Ogni risorsa ha un id restituito quando viene aggiunta (o elencata), che utilizzi per le eliminazioni.

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

Elenca tutte le risorse di una sessione con resources.list. Per rimuovere un file, chiama resources.delete con l'ID della risorsa:

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)



Elencare e scaricare i file della sessione

Usa la Files API per elencare i file associati a una sessione e scaricarli.

# Elenca i file associati a una sessione
files = client.beta.files.list(
    scope_id="sesn_abc123",
    betas=["managed-agents-2026-04-01"],
)
for f in files:
    print(f.id, f.filename)

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



Tipi di file supportati

L'agente può lavorare con qualsiasi tipo di file, inclusi:

• Codice sorgente (.py, .js, .ts, .go, .rs e altri)
• File di dati (.csv, .json, .xml, .yaml)
• Documenti (.txt, .md)
• Archivi (.zip, .tar.gz) - l'agente può estrarli utilizzando bash
• File binari - l'agente può elaborarli con strumenti appropriati



Percorsi dei file

• I file vengono montati nel percorso esatto che specifichi
• Le directory padre vengono create automaticamente
• I percorsi devono essere assoluti (iniziare con /)