Dateien hinzufügen

Sie können Dateien für Ihren Agent bereitstellen, indem Sie sie über die Files API hochladen und in den Container der Sitzung mounten.

Dateien hochladen

Laden Sie zunächst eine Datei mit der Files API hoch:

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

Dateien in einer Sitzung mounten

Mounten Sie hochgeladene Dateien in den Container, indem Sie sie beim Erstellen einer Sitzung zum Array resources hinzufügen:

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

Eine neue file_id wird erstellt, die auf die Instanz der Datei in der Sitzung verweist. Diese Kopien werden nicht auf Ihre Speicherlimits angerechnet.

Mehrere Dateien

Mounten Sie mehrere Dateien, indem Sie Einträge zum Array resources hinzufügen:

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 Sitzung werden maximal 100 Dateien unterstützt.

Verwalten von Dateien in einer laufenden Sitzung

Sie können Dateien einer Sitzung nach der Erstellung über die Sitzungsressourcen-API hinzufügen oder entfernen. Jede Ressource hat eine id, die beim Hinzufügen (oder Auflisten) zurückgegeben wird und die Sie zum Löschen verwenden.

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

Listen Sie alle Ressourcen in einer Sitzung mit resources.list auf. Um eine Datei zu entfernen, rufen Sie 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)

Sitzungsdateien auflisten und herunterladen

Verwenden Sie die Files API, um Dateien aufzulisten, die auf eine Sitzung beschränkt sind, und um sie herunterzuladen.

# 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")

Unterstützte Dateitypen

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

• Quellcode (.py, .js, .ts, .go, .rs, usw.)
• 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 entsprechenden Tools verarbeiten

Dateipfade

• Dateien werden unter dem genauen Pfad gemountet, den Sie angeben
• Übergeordnete Verzeichnisse werden automatisch erstellt
• Pfade sollten absolut sein (beginnend mit /)