Saltearse al contenido
Nappai Documentation

Storage Folders

Storage Folders organiza las carpetas de tu almacenamiento de NappAI: lista las que hay dentro de una carpeta, crea carpetas nuevas, las renombra, las mueve, las copia, las elimina o crea un enlace para descargar una carpeta entera como ZIP.

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.

Cuándo usarlo

  • Un flujo tiene que preparar una carpeta por cliente o por mes antes de guardar archivos en ella.
  • Quieres archivar al final de cada mes la carpeta de trabajo, moviéndola a otra.
  • Necesitas enviar a alguien todos los documentos de un proyecto en un único ZIP.
  • Quieres limpiar carpetas temporales que un flujo ya no necesita.

Cómo funciona

  • Las rutas. Una ruta sin sección, como clientes/acme, está dentro de la sección Archivos (la carpeta files): equivale a files/clientes/acme. 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, 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 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 Folders.
Selection ModeCómo indicas las carpetas: By Selector (las eliges en tu almacenamiento) o By Path (escribes su ruta). Por defecto, By Selector.
Folder / Folder PathLa carpeta con la que trabajas, por ejemplo informes/2026. En Create Folder, la carpeta dentro de la que se crea la nueva. Vacía, se usa la sección Archivos.
Folder NameEn Create Folder, el nombre de la carpeta nueva; puede tener varios niveles, por ejemplo 2026/octubre. En Rename Folder, el nombre nuevo (obligatorio). En Move Folder y Copy Folder, un nombre nuevo opcional; vacío, se mantiene.
Destination Folder / Destination PathLa carpeta dentro de la que va la carpeta, por ejemplo archivo. En Move Folder y Copy Folder.
Include SubfoldersLista también las carpetas que hay dentro de cada carpeta. Desactivado por defecto. Solo en List Folders.
Max ResultsCuántas carpetas se listan como máximo, entre 1 y 1000. Por defecto, 100. Solo en List Folders.
Delete Its ContentsElimina la carpeta aunque tenga archivos. Desactivado, solo se elimina si está vacía. Solo en Delete Folder.
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 y Destination Folder; con By Path, Folder Path y Destination Path.

Operaciones

OperaciónQué hace
List FoldersLista las carpetas que hay dentro de una carpeta, con su nombre, ruta, tamaño, número de archivos y fecha de modificación.
Create FolderCrea una carpeta, y las que falten por encima. Si ya existe, no hace nada y la devuelve.
Rename FolderCambia el nombre de una carpeta sin moverla.
Move FolderMueve una carpeta, con todo su contenido, dentro de otra.
Copy FolderCopia una carpeta, con todo su contenido, dentro de otra.
Delete FolderElimina una carpeta. Si tiene archivos, solo con Delete Its Contents activado.
Create Download LinkCrea un enlace para descargar la carpeta entera como ZIP, que caduca pasado el tiempo de Link Valid For (Hours).

Si en el destino ya hay algo con el mismo nombre, Move Folder y Copy Folder se detienen con un error en lugar de mezclar carpetas.

Resultado

La salida Data devuelve un elemento por cada carpeta, con su nombre (name), su ruta (path), su tamaño total en bytes (size), su número de archivos (files) y su fecha de modificación (modified).

  • Create Folder indica en created si la carpeta se ha creado o ya existía.
  • Move Folder y Copy Folder indican además la ruta de origen en source.
  • Delete Folder devuelve el nombre y la ruta de la carpeta eliminada.
  • Create Download Link devuelve el enlace (url), el nombre del ZIP y la fecha en que caduca (expires_at).

El componente también se puede conectar a un Agente como herramienta. Ver Tool Mode. En ese caso se usan siempre los campos de ruta (Folder Path y Destination Path), que escribe el agente.

Ejemplo

Un estudio de arquitectura entrega a cada cliente, al cerrar un proyecto, todos sus documentos.

  1. Un formulario de cierre entrega el nombre del proyecto.
  2. Añade Storage Folders con la operación Create Download Link.
  3. En Selection Mode elige By Path y escribe en Folder Path proyectos/ seguido del nombre del proyecto.
  4. Pon Link Valid For (Hours) en 72, para que el cliente tenga tres días.
  5. Conecta la salida Data a un componente de correo que envíe el enlace (url) al cliente.

Buenas prácticas

  • Con Batch Mode el componente procesa una lista entera: por ejemplo, crea una carpeta por cada fila de una hoja de cálculo con Folder Name en Mapped sobre el nombre del cliente. Ver Batch Mode.
  • Deja Delete Its Contents desactivado salvo que de verdad quieras borrar todo: así un error en la ruta no elimina una carpeta llena.
  • Para archivos sueltos usa Storage Files: este componente solo trabaja con carpetas.

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.
  • Enlaces con caducidad. Cualquiera que tenga un enlace de Create Download Link puede descargar esa carpeta, y solo esa, hasta que caduque. Envíalo solo a quien deba recibirlo.

Componentes relacionados