Saltearse al contenido
Nappai Documentation

Storage Files

Storage Files trabaja con los archivos de tu almacenamiento de NappAI: lista los de una carpeta, trae un archivo (el archivo en sí, su texto o solo sus datos), guarda archivos nuevos, sustituye el contenido de uno existente, lo renombra, lo mueve, lo copia, lo elimina o crea un enlace para descargarlo.

Actúa sobre el almacenamiento de la persona que ejecuta el flujo, el mismo que ves en la página Almacenamiento, así que no necesita credencial. Lo que un flujo guarda aquí aparece al momento en esa página, y lo que tú subes allí lo puede usar el flujo.

Cuándo usarlo

  • Quieres guardar los adjuntos que llegan por correo o los informes que genera un flujo, sin depender de una nube externa.
  • Un agente de IA tiene que leer el texto de un documento que guardaste en tu almacenamiento.
  • Quieres pasar un archivo de tu almacenamiento a otro componente, por ejemplo para adjuntarlo a un correo o subirlo a OneDrive.
  • Necesitas enviar a alguien un enlace de descarga que caduque.

Cómo funciona

  • Las rutas. Una ruta sin sección, como informes/q3.pdf, está dentro de la sección Archivos (la carpeta files): equivale a files/informes/q3.pdf. Si dejas la carpeta vacía, se usa la propia sección Archivos. También funcionan las rutas completas de otras secciones, como pycode_data/ventas/datos.csv o <id-del-flujo>/notas.txt, que es lo que devuelve el selector. Ver Archivos.
  • Qué puede cambiar un flujo. Un flujo puede leer todo tu almacenamiento, pero solo puede cambiar la sección Archivos, las carpetas de archivos de cada flujo y los volúmenes de Python Code. Las bases de datos vectoriales, las bases SQLite, los modelos entrenados y las skills son de solo lectura para un flujo: puedes leerlos o copiarlos a otra sección, pero no modificarlos, moverlos ni eliminarlos. Tampoco se pueden mover ni eliminar las carpetas principales de cada sección.

Configuración

CampoQué hace
Operation (obligatorio)Lo que hace el componente. Ver Operaciones. Por defecto, List Files.
Selection ModeCómo indicas archivos y carpetas: By Selector (los eliges en tu almacenamiento) o By Path (escribes su ruta). Por defecto, By Selector.
Folder / Folder PathLa carpeta de tu almacenamiento, por ejemplo informes/2026. Vacía, se usa la sección Archivos. En List Files y Upload Files.
File / File PathEl archivo, por ejemplo informes/2026/ventas.xlsx. En Get File, Update File, Rename File, Move File, Copy File, Delete File y Create Download Link.
Destination Folder / Destination PathLa carpeta a la que va el archivo, por ejemplo archivo/2026. En Move File y Copy File.
File to SaveLos archivos que se guardan: conecta aquí la salida de otro componente que entregue archivos, como Gmail, Google Drive, OneDrive o un generador de documentos. En Upload Files y Update File.
Text or File URLSi no conectas nada: el texto que quieres guardar como archivo, o la dirección web de un archivo para guardarlo. En Upload Files y Update File.
File NameEl nombre del archivo guardado, con su extensión. Vacío, se mantiene el nombre original. Puede incluir subcarpetas, por ejemplo 2026/octubre/resumen.txt. Solo en Upload Files.
New NameEl nombre nuevo del archivo, con su extensión. Obligatorio en Rename File; en Move File y Copy File, vacío mantiene el nombre.
If the File ExistsQué hacer si ya hay un archivo con ese nombre en el destino: Keep both (el nuevo se guarda con un número, por ejemplo informe (1).pdf), Overwrite (sustituye al anterior) o Fail (el componente se detiene con un error). Por defecto, Keep both. En Upload Files, Move File y Copy File.
ContentQué entrega Get File: File (el archivo en sí, para pasarlo al siguiente componente, por ejemplo como adjunto de Gmail o para subirlo a OneDrive), Text (el texto que contiene, por ejemplo de un PDF o un Word) o Details only (solo su nombre, tamaño y fecha). Por defecto, File.
Include SubfoldersLista también los archivos de las subcarpetas. Desactivado por defecto. Solo en List Files.
File TypeQué archivos se listan: all, document, pdf, spreadsheet, presentation, image, audio, video, archive o code. Por defecto, all. Solo en List Files.
Max ResultsCuántos archivos se listan como máximo, entre 1 y 1000. Por defecto, 100. Solo en List Files.
Link Valid For (Hours)Cuántas horas funciona el enlace, entre 1 y 168 (una semana). Por defecto, 24. Solo en Create Download Link.

Con By Selector ves los campos Folder, File y Destination Folder; con By Path, Folder Path, File Path y Destination Path.

Operaciones

OperaciónQué hace
List FilesLista los archivos de una carpeta, con su nombre, ruta, tamaño, tipo y fecha de modificación.
Get FileTrae un archivo: el archivo en sí, su texto o solo sus datos, según Content. Para cargar el archivo o su texto, el archivo puede ocupar como mucho 50 MB; si es mayor, usa Create Download Link.
Upload FilesGuarda uno o varios archivos en la carpeta indicada.
Update FileSustituye el contenido de un archivo existente, manteniendo su nombre y su carpeta.
Rename FileCambia el nombre de un archivo sin moverlo.
Move FileMueve un archivo a otra carpeta y, si quieres, le cambia el nombre.
Copy FileCopia un archivo a otra carpeta. Sirve también para sacar una copia de una sección de solo lectura, como una base SQLite, a la sección Archivos.
Delete FileElimina un archivo. Las carpetas se eliminan con Storage Folders.
Create Download LinkCrea un enlace de descarga del archivo que caduca pasado el tiempo de Link Valid For (Hours).

Resultado

La salida Data devuelve un elemento por cada archivo listado, guardado o consultado, con su nombre (name), su ruta (path), su tamaño en bytes (size), su extensión, su tipo de archivo y su fecha de modificación (modified).

  • Get File con File entrega el archivo en sí, listo para el siguiente componente; con Text, añade el texto en text.
  • Move File y Copy File indican además la ruta de origen en source.
  • Delete File devuelve el nombre y la ruta del archivo eliminado.
  • Create Download Link devuelve el enlace (url), el nombre del archivo y la fecha en que caduca (expires_at).

Como herramienta de un agente

El componente se puede conectar a un Agente como herramienta, para que el agente decida cuándo listar, leer o guardar archivos. Ver Tool Mode. En ese caso:

  • Se usan siempre los campos de ruta (Folder Path, File Path, Destination Path), que escribe el agente.
  • Get File con File devuelve un enlace al archivo en lugar de su contenido, para no llenar la conversación con datos que el agente no puede leer. Si el agente necesita lo que dice el archivo, usa Text.
  • Para guardar, el agente escribe en Text or File URL el texto, la dirección web de un archivo o un archivo de la conversación.

Ejemplo

Una gestoría quiere guardar en su almacenamiento las facturas que recibe por correo, ordenadas por mes.

  1. Un componente de correo entrega los adjuntos de cada mensaje recibido.
  2. Añade Storage Files con la operación Upload Files.
  3. En Selection Mode elige By Path y escribe en Folder Path facturas/2026-10.
  4. Conecta los adjuntos a File to Save y deja If the File Exists en Keep both, para no perder dos facturas con el mismo nombre.
  5. Las facturas aparecen en la página Almacenamiento, dentro de Archivos, en facturas/2026-10.

Para enviar después una factura a un cliente, otro flujo usa Get File con Content en File y conecta su salida a los adjuntos de Gmail Message.

Buenas prácticas

  • Con Batch Mode el componente procesa una lista entera: por ejemplo, conecta el resultado de Storage Search y usa Get File con File Path en Mapped sobre path para traer cada archivo encontrado. Ver Batch Mode.
  • Usa Details only cuando solo necesites saber si un archivo existe, su tamaño o su fecha: no carga el archivo.
  • Para archivos de más de 50 MB, crea un enlace con Create Download Link en lugar de cargarlos en el flujo.
  • Delete File y Overwrite no piden confirmación. Si un agente usa el componente como herramienta, dale solo las operaciones que necesite.

Seguridad

  • Solo tu almacenamiento. El componente trabaja con el almacenamiento de quien ejecuta el flujo y no puede salir de él, con las mismas reglas que la página Almacenamiento.
  • Lo que usan otros componentes está protegido. Ni un flujo ni un agente pueden cambiar ni borrar bases de datos vectoriales, bases SQLite, modelos entrenados ni skills.
  • Archivos completos. Cada archivo se escribe aparte y aparece de una vez, así que ningún flujo lee un archivo a medio guardar.
  • Enlaces con caducidad. Cualquiera que tenga un enlace de Create Download Link puede descargar ese archivo, y solo ese, hasta que caduque. Envíalo solo a quien deba recibirlo y elige la duración más corta que te sirva.

Componentes relacionados