Dateien hinzufügen

Du kannst deinem Agenten Dateien bereitstellen, indem du sie über die Files API hochlädst und in der Sandbox der Session mountest.



Dateien hochladen

Lade zunächst eine Datei über die Files API hoch:

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



Dateien in einer Session mounten

Mounte hochgeladene Dateien in die Sandbox, indem du sie beim Erstellen einer Session zum resources-Array hinzufügst:

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

Es wird eine neue file_id erstellt, die auf die Instanz der Datei in der Session verweist. Diese Kopien werden nicht auf deine Speicherlimits angerechnet.



Mehrere Dateien

Mounte mehrere Dateien, indem du Einträge zum resources-Array hinzufügst:

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"},
]

Pro Session werden maximal 100 Dateien unterstützt.



Dateien in einer laufenden Session verwalten

Du kannst nach der Erstellung Dateien zu einer Session hinzufügen oder daraus entfernen, indem du die Session-Resources-API verwendest. Jede Ressource hat eine id, die beim Hinzufügen (oder Auflisten) zurückgegeben wird und die du zum Löschen verwendest.

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

Liste alle Ressourcen einer Session mit resources.list auf. Um eine Datei zu entfernen, rufe resources.delete mit der Ressourcen-ID auf:

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)



Session-Dateien auflisten und herunterladen

Verwende die Files API, um Dateien aufzulisten, die einer Session zugeordnet sind, und sie herunterzuladen.

# Liste die mit einer Sitzung verknüpften Dateien auf
files = client.beta.files.list(
    scope_id="sesn_abc123",
    betas=["managed-agents-2026-04-01"],
)
for f in files:
    print(f.id, f.filename)

# Lade eine Datei herunter
content = client.beta.files.download(files.data[0].id)
content.write_to_file("output.txt")



Unterstützte Dateitypen

Der Agent kann mit jedem Dateityp arbeiten, einschließlich:

• Quellcode (.py, .js, .ts, .go, .rs und andere)
• Datendateien (.csv, .json, .xml, .yaml)
• Dokumente (.txt, .md)
• Archive (.zip, .tar.gz) – der Agent kann diese mit Bash extrahieren
• Binärdateien – der Agent kann diese mit geeigneten Tools verarbeiten



Dateipfade

• Dateien werden genau an dem von dir angegebenen Pfad gemountet
• Übergeordnete Verzeichnisse werden automatisch erstellt
• Pfade sollten absolut sein (beginnend mit /)