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:
| Entrada | Monta |
|---|---|
{"file": "file_ | Exactamente esa subida. |
{"file": "guides/ | La última subida con ese nombre, en el momento en que se crea la ejecución. |
{"path": "notes. | 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.
"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ímite | Valor |
|---|---|
| Tamaño de archivo | 1 MiB por archivo, subido o en línea |
| Archivos por ejecución | 32 |
| Total por ejecución | 4 MiB |
Consulta la API de archivos para subir, descargar, renombrar y eliminar.