Ajouter des fichiers

Vous pouvez fournir des fichiers à votre agent en les téléversant via l'API Files et en les montant dans le sandbox de la session.

Téléverser des fichiers

Commencez par téléverser un fichier à l'aide de l'API Files :

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

Monter des fichiers dans une session

Montez les fichiers téléversés dans le sandbox en les ajoutant au tableau resources lors de la création d'une session :

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

Avec le mount_path précédent, l'agent lit le fichier à l'emplacement /mnt/session/uploads/data.csv (voir Chemins de fichiers).

Un nouveau file_id est créé, qui référence l'instance du fichier dans la session. Ces copies ne sont pas comptabilisées dans vos limites de stockage.

Fichiers multiples

Montez plusieurs fichiers en ajoutant des entrées au tableau resources :

resources = [
    {"type": "file", "file_id": "file_abc123", "mount_path": "/data.csv"},
    {"type": "file", "file_id": "file_def456", "mount_path": "/config.json"},
    {"type": "file", "file_id": "file_ghi789", "mount_path": "/src/main.py"},
]

Un maximum de 500 fichiers est pris en charge par session.

Gérer les fichiers d'une session en cours d'exécution

Vous pouvez ajouter ou supprimer des fichiers d'une session après sa création à l'aide de l'API des ressources de session. Chaque ressource possède un id renvoyé lors de son ajout (ou de son listage), que vous utilisez pour les suppressions.

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

Listez toutes les ressources d'une session avec resources.list. Pour supprimer un fichier, appelez resources.delete avec l'ID de la ressource :

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)

Lister et télécharger les fichiers d'une session

Utilisez l'API Files pour lister les fichiers rattachés à une session et les télécharger. Les fichiers que l'agent écrit dans /mnt/session/outputs/ apparaissent dans la liste peu après que l'agent a fini de les écrire, parfois quelques secondes après que la session est devenue inactive. Si un fichier de sortie attendu est manquant, relancez le listage après un court délai ; une fois qu'il apparaît dans la liste, son téléversement est terminé.

Le filtrage par scope_id nécessite l'en-tête bêta managed-agents-2026-04-01 ; les exemples de listage utilisent donc l'espace de noms de fichiers beta et transmettent explicitement cet en-tête.

# Lister les fichiers associés à une session
files = client.beta.files.list(
    scope_id="sesn_abc123",
    betas=["managed-agents-2026-04-01"],
)
for file in files:
    print(file.id, file.filename)

# Télécharger un fichier
content = client.files.download(files.data[0].id)
content.write_to_file("output.txt")

Types de fichiers pris en charge

L'agent peut travailler avec n'importe quel type de fichier, notamment :

• Code source (.py, .js, .ts, .go, .rs, et autres)
• Fichiers de données (.csv, .json, .xml, .yaml)
• Documents (.txt, .md)
• Archives (.zip, .tar.gz) - l'agent peut les extraire à l'aide de bash
• Fichiers binaires - l'agent peut les traiter avec les outils appropriés

Chemins de fichiers

• Le chemin que vous spécifiez est ancré sous le répertoire uploads de la session : un mount_path de /data.csv place le fichier à l'emplacement /mnt/session/uploads/data.csv dans le sandbox
• Si vous omettez mount_path, le fichier est placé à l'emplacement /mnt/session/uploads/<file_id>
• Les répertoires parents sont créés automatiquement
• Les chemins doivent être absolus (commençant par /)
• Les fichiers que l'agent écrit dans /mnt/session/outputs/ deviennent disponibles via l'API Files, rattachés à la session ; voir Lister et télécharger les fichiers d'une session