Fichiers · Documentation Ephemeral

Les fichiers sont des documents que l'agent peut lire pendant une exécution : instructions, données de référence ou exemples. Vous les importez une fois dans votre organisation et vous choisissez, pour chaque exécution ou workflow, lesquels monter et où.

Importer des fichiers

Importez des fichiers dans le tableau de bord, sous Fichiers, avec POST /v1/files ou avec ephemeral files upload. Chaque fichier reçoit un ID tel que file_9c41… et un nom. Le nom est un chemin relatif comme guides/refunds.md, de 240 caractères au maximum.

Importer de nouveau avec un nom déjà existant ajoute un nouveau fichier avec un nouvel ID. La liste des fichiers affiche l'import le plus récent pour chaque nom. Les anciens imports restent accessibles par leur ID jusqu'à ce que vous les supprimiez.

Donner des fichiers à une exécution

Listez les fichiers dans le tableau files de l'exécution. Chaque entrée monte un fichier au path de votre choix. Il y a trois façons de désigner le contenu :

Entrée	Monte
`{"file": "file_9c41…", "path": "refunds.md"}`	Exactement cet import.
`{"file": "guides/refunds.md"}`	L'import le plus récent portant ce nom, au moment de la création de l'exécution.
`{"path": "notes.md", "content": "…"}`	Du texte en ligne envoyé avec la requête. Rien n'est importé.

Pour les fichiers importés, path vaut par défaut le nom du fichier. Les fichiers en ligne doivent le définir. Les chemins doivent être relatifs et uniques au sein de l'exécution.

Fichiers dans une requête d'exécution

"files": [
  { "file": "guides/refunds.md", "path": "instructions/refunds.md" },
  { "file": "file_9c41d2a07be35f1e8a6c0d4b9e2f7a13" },
  { "path": "context.md", "content": "The customer is on the annual plan." }
]

Dans la microVM

Le worker reçoit les fichiers dans un répertoire en lecture seule et connaît le chemin de chacun. Il ne peut pas les modifier. Son répertoire de travail est un espace temporaire distinct. Tout ce qu'il y écrit disparaît lorsque la microVM est détruite : les fichiers ne sont donc jamais partagés entre les exécutions. Le résultat de l'exécution est sa sortie textuelle.

Une exécution lit le contenu des fichiers à sa sortie de la file d'attente. Si vous supprimez un fichier alors qu'une exécution qui l'utilise est encore en file d'attente, cette exécution échoue.

Limites

Limite	Valeur
Taille de fichier	1 Mio par fichier, importé ou en ligne
Fichiers par exécution	32
Total par exécution	4 Mio

Tout membre de l'organisation peut importer, renommer et supprimer des fichiers. Une définition d'exécution conserve le contenu des fichiers en ligne : placez donc les secrets dans une connexion plutôt que dans un fichier.

Consultez l'API des fichiers pour l'import, le téléchargement, le renommage et la suppression.