Agregar archivos

Puedes proporcionar archivos a tu agente cargándolos a través de la API de Archivos y montándolos en el contenedor de la sesión.

Cargando archivos

Primero, carga un archivo usando la API de Archivos:

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

Montando archivos en una sesión

Monta los archivos cargados en el contenedor agregándolos al array resources cuando crees una sesión:

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

Se creará un nuevo file_id que hace referencia a la instancia del archivo en la sesión. Estas copias no cuentan contra tus límites de almacenamiento.

Múltiples archivos

Monta múltiples archivos agregando entradas al 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"},
]

Se admite un máximo de 100 archivos por sesión.

Administrando archivos en una sesión en ejecución

Puedes agregar o eliminar archivos de una sesión después de su creación usando la API de recursos de sesión. Cada recurso tiene un id devuelto cuando se agrega (o se enumera), que usas para eliminaciones.

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

Enumera todos los recursos en una sesión con resources.list. Para eliminar un archivo, llama a resources.delete con el ID del recurso:

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)

Enumerando y descargando archivos de sesión

Usa la API de Archivos para enumerar archivos con alcance a una sesión y descargarlos.

# Enumera archivos asociados con una sesión
files = client.beta.files.list(
    scope_id="sesn_abc123",
    betas=["managed-agents-2026-04-01"],
)
for f in files:
    print(f.id, f.filename)

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

Tipos de archivo admitidos

El agente puede trabajar con cualquier tipo de archivo, incluyendo:

• Código fuente (.py, .js, .ts, .go, .rs, etc.)
• Archivos de datos (.csv, .json, .xml, .yaml)
• Documentos (.txt, .md)
• Archivos (.zip, .tar.gz) - el agente puede extraerlos usando bash
• Archivos binarios - el agente puede procesarlos con herramientas apropiadas

Rutas de archivo

• Los archivos se montan en la ruta exacta que especifiques
• Los directorios principales se crean automáticamente
• Las rutas deben ser absolutas (comenzando con /)