Aggiunta di file

Puoi fornire file al tuo agente caricandoli tramite l'API Files e montandoli nel contenitore della sessione.

Caricamento di file

Per prima cosa, carica un file utilizzando l'API Files:

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

Montaggio di file in una sessione

Monta i file caricati nel contenitore aggiungendoli all'array resources quando crei 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",
        },
    ],
)

Verrà creato un nuovo file_id che fa riferimento all'istanza del file nella sessione. Queste copie non contano rispetto ai 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.

Gestione dei 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 usi 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 in 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)

Elenco e download dei file della sessione

Utilizza l'API Files per elencare i file con ambito a una sessione e scaricarli.

# List files associated with a session
files = client.beta.files.list(
    scope_id="sesn_abc123",
    betas=["managed-agents-2026-04-01"],
)
for f in files:
    print(f.id, f.filename)

# Download a 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, ecc.)
• File di dati (.csv, .json, .xml, .yaml)
• Documenti (.txt, .md)
• Archivi (.zip, .tar.gz) - l'agente può estrarli usando bash
• File binari - l'agente può elaborarli con strumenti appropriati

Percorsi dei file

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