Conceptos

Archivos

Archivos de solo lectura montados en una ejecución.

Los archivos son documentos que el agente puede leer durante una ejecución, como instrucciones, datos de referencia o ejemplos. Los subes una vez a tu organización y eliges, en cada ejecución o flujo de trabajo, cuáles montar y dónde.

Subir archivos

Sube archivos en el panel, en Archivos, con POST /v1/files o con ephemeral files upload. Cada archivo recibe un ID como file_9c41… y un nombre. El nombre es una ruta relativa como guides/refunds.md, de hasta 240 caracteres.

Si subes de nuevo un archivo con un nombre que ya existe, se añade un archivo nuevo con un ID nuevo. La lista de archivos muestra la última subida de cada nombre. Las subidas anteriores siguen disponibles por ID hasta que las elimines.

Dar archivos a una ejecución

Indica los archivos en el array files de la ejecución. Cada entrada monta un archivo en la path que elijas. Hay tres formas de indicar el contenido:

EntradaMonta
{"file": "file_9c41…", "path": "refunds.md"}Exactamente esa subida.
{"file": "guides/refunds.md"}La última subida con ese nombre, en el momento en que se crea la ejecución.
{"path": "notes.md", "content": "…"}Texto en línea enviado con la solicitud. No se sube nada.

En los archivos subidos, path toma por defecto el nombre del archivo. Los archivos en línea deben indicarla. Las rutas deben ser relativas y únicas dentro de la ejecución.

Archivos en una solicitud de ejecución
"files": [
  { "file": "guides/refunds.md", "path": "instructions/refunds.md" },
  { "file": "file_9c41d2a07be35f1e8a6c0d4b9e2f7a13" },
  { "path": "context.md", "content": "The customer is on the annual plan." }
]

Dentro de la microVM

El worker recibe los archivos como un directorio de solo lectura y se le indica la ruta de cada uno. No puede modificarlos. Su directorio de trabajo es una zona temporal aparte. Todo lo que escribe allí desaparece cuando se destruye la microVM, así que los archivos nunca se comparten entre ejecuciones. El resultado de la ejecución es su salida de texto.

Una ejecución lee el contenido de los archivos cuando sale de la cola. Si eliminas un archivo mientras una ejecución que lo usa sigue en cola, esa ejecución falla.

Límites

LímiteValor
Tamaño de archivo1 MiB por archivo, subido o en línea
Archivos por ejecución32
Total por ejecución4 MiB
Cualquier miembro de la organización puede subir, renombrar y eliminar archivos. La definición de una ejecución conserva el contenido de los archivos en línea, así que guarda los secretos en una conexión en lugar de en un archivo.

Consulta la API de archivos para subir, descargar, renombrar y eliminar.

© 2026 EphemeralProducido por erni.works
esc

Nada coincide con “”.