Ajout de fichiers

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

Téléchargement de fichiers

Tout d'abord, téléchargez un fichier en utilisant 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échargés dans le conteneur 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 sera créé qui référence l'instance du fichier dans la session. Ces copies ne comptent pas par rapport à 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 en utilisant l'API des ressources de session. Chaque ressource a 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 sur une session avec resources.list. Pour supprimer un fichier, appelez resources.delete avec l'ID de 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 limités à une session et les télécharger.

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

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, etc.)
• 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

• 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 /)