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 de la session.



Téléversement de fichiers

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

file = client.beta.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": "/workspace/data.csv",
        },
    ],
)

Un nouveau file_id est créé et 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": "/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"},
]

Un maximum de 100 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 à 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)



Listage et téléchargement des 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 f in files:
    print(f.id, f.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 à l'aide de bash
• Fichiers binaires - l'agent peut les traiter avec les outils appropriés



Chemins de fichiers

• Les fichiers sont montés au chemin exact que vous spécifiez
• Les répertoires parents sont créés automatiquement
• Les chemins doivent être absolus (commençant par /)