Ajout de fichiers

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



Téléversement de fichiers

Tout d'abord, téléversez un fichier en utilisant l'API Files :

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



Montage de 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 à /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.



Gestion des fichiers sur une session en cours d'exécution

Vous pouvez ajouter ou supprimer des fichiers d'une session après sa création en utilisant l'API de ressources de session. Chaque ressource possède un id renvoyé lorsqu'elle est ajoutée (ou listée), 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 de session

Utilisez l'API Files pour lister les fichiers associés à une session et les télécharger.

# 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.beta.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 en utilisant bash
• Fichiers binaires - l'agent peut les traiter avec les outils appropriés



Chemins de fichiers

• Le chemin que vous spécifiez est enraciné sous le répertoire uploads de la session : un mount_path de /data.csv place le fichier à /mnt/session/uploads/data.csv dans le sandbox
• Si vous omettez mount_path, le fichier est placé à /mnt/session/uploads/<file_id>
• Les répertoires parents sont créés automatiquement
• Les chemins doivent être absolus (commençant par /)