Saltearse al contenido
Nappai Documentation

Storage Search

Storage Search busca archivos en tu almacenamiento de NappAI y devuelve los que cumplen todos los filtros que indiques: una parte del nombre o un patrón, el tipo de archivo, un periodo de fechas de modificación y un tamaño mínimo o máximo.

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. Solo lee: nunca cambia nada.

Cuándo usarlo

  • Un agente de IA tiene que encontrar el contrato o la factura de un cliente sin saber en qué carpeta está.
  • Quieres procesar cada mañana los PDF que se guardaron el día anterior.
  • Necesitas localizar los archivos más grandes para hacer limpieza.
  • Quieres todas las hojas de cálculo de una carpeta y sus subcarpetas.

Cómo funciona

  • Dónde busca. Por defecto, en la sección Archivos (la carpeta files) y en todas sus subcarpetas. Una ruta sin sección, como informes, está dentro de esa sección; también puedes buscar en otras, por ejemplo en pycode_data/ventas. Ver Archivos.
  • El nombre. Escribe una parte del nombre (factura encuentra Factura-0042.pdf) o un patrón con * y ? (factura-2026-*.pdf). No distingue mayúsculas de minúsculas.
  • Los filtros se suman. Un archivo aparece solo si cumple todos los que rellenes; los que dejes vacíos no filtran.

Configuración

CampoQué hace
Selection ModeCómo indicas la carpeta: By Selector (la eliges en tu almacenamiento) o By Path (escribes su ruta). Por defecto, By Selector.
Search In / Search In PathLa carpeta en la que se busca, por ejemplo informes. Vacía, se busca en la sección Archivos. Con By Selector ves Search In; con By Path, Search In Path.
NameUna parte del nombre del archivo o un patrón como factura-*.pdf. Vacío, vale cualquier nombre.
File TypeQué archivos se buscan: all, document, pdf, spreadsheet, presentation, image, audio, video, archive o code. Por defecto, all.
Modified AfterSolo archivos modificados ese día o después, con el formato AAAA-MM-DD, por ejemplo 2026-10-01.
Modified BeforeSolo archivos modificados ese día o antes, por ejemplo 2026-10-31. Incluye el día entero.
Include SubfoldersBusca también dentro de las subcarpetas. Activado por defecto.
Max ResultsCuántos archivos se devuelven como máximo, entre 1 y 1000. Por defecto, 100.

Opciones avanzadas

CampoQué hace
Minimum Size (MB)Solo archivos de al menos este tamaño, en MB. 0 es sin mínimo. Por defecto, 0.
Maximum Size (MB)Solo archivos de como mucho este tamaño, en MB. 0 es sin máximo. Por defecto, 0.

En las fechas también puedes indicar una hora, por ejemplo 2026-10-01T14:30; si no indicas zona horaria, se toma la hora UTC.

Resultado

La salida Data devuelve un elemento por cada archivo encontrado, 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). Si no encuentra nada, devuelve una lista vacía.

Conecta el resultado a Storage Files con Batch Mode para leer, mover o compartir cada archivo encontrado, o a un agente para que lo resuma.

El componente también se puede conectar a un Agente como herramienta, para que el agente busque archivos cuando lo necesite. Ver Tool Mode. En ese caso se usa siempre Search In Path, que escribe el agente junto con los filtros.

Ejemplo

Una empresa quiere enviar cada lunes a su contable las facturas en PDF de la semana anterior.

  1. Programa el flujo para que se ejecute los lunes. Ver Programador.
  2. Añade Storage Search con Search In Path en facturas, File Type en pdf y en Modified After y Modified Before las fechas del lunes y el domingo anteriores.
  3. Conecta su salida a Storage Files con Get File, Batch Mode activado y File Path en Mapped sobre path.
  4. Conecta los archivos a los adjuntos de Gmail Message.

Buenas prácticas

  • Empieza por la carpeta más concreta que puedas: la búsqueda es más rápida y los resultados, más precisos.
  • Si esperas muchos resultados, ajusta Max Results: la búsqueda se detiene al llegar al máximo.
  • Desactiva Include Subfolders cuando solo te interesen los archivos de esa carpeta.

Seguridad

  • Solo tu almacenamiento. El componente busca en el almacenamiento de quien ejecuta el flujo y no puede salir de él.
  • Solo lectura. Buscar no cambia, mueve ni borra nada, así que es seguro dárselo a un agente como herramienta.

Componentes relacionados