Saltearse al contenido
Nappai Documentation

Drive Search

Drive Search busca archivos en el Google Drive de la cuenta que conectes y te devuelve, de cada uno, su nombre, su tipo y el enlace para abrirlo. Puedes buscar por el nombre del archivo, por el texto que contiene, por la fecha de modificación, por quién lo comparte y por otros criterios de Google Drive.

Úsalo cuando un flujo o un agente necesita encontrar un documento antes de leerlo, enviarlo o compartir su enlace.

Cuándo usarlo

  • Encontrar el contrato de un cliente a partir de su nombre.
  • Listar los documentos modificados esta semana para preparar un resumen.
  • Buscar todas las hojas de cálculo de una carpeta compartida.
  • Dar a un agente la capacidad de buscar documentos en Drive cuando un usuario se lo pide.

Configuración

Necesitas una credencial Google Drive conectada a la cuenta de Google donde están los archivos. Consulta Credenciales.

CampoQué hace
Credential (obligatorio)La credencial Google Drive.
Query Item (obligatorio)El criterio de búsqueda. Los más habituales son name (nombre del archivo), fullText (texto que contiene), mimeType (tipo de archivo), modifiedTime (fecha de modificación), starred (destacados), sharedWithMe (compartidos contigo) y trashed (en la papelera). La lista incluye los demás criterios de Google Drive.
Valid Operator (obligatorio)Cómo se compara el criterio con el valor: contains (contiene), = (igual), != (distinto), <, <=, >, >= (para fechas), in o has. Con in, el valor se busca dentro del criterio: por ejemplo, el ID de una carpeta con parents encuentra los archivos de esa carpeta.
Search ValueEl valor que buscas, por ejemplo contrato o una fecha como 2026-01-01.
Query StringUna búsqueda escrita a mano, en el formato de búsqueda de Google Drive, por ejemplo name contains 'contrato' and trashed = false. Si la rellenas, se usa en lugar de los tres campos anteriores.
Max ResultsEl número máximo de archivos que devuelve. Por defecto, 10.

Tienes que rellenar Search Value o Query String; si los dos están vacíos, la búsqueda da un error.

Resultado

La salida Data devuelve un elemento por cada archivo encontrado, con:

  • title: el nombre del archivo.
  • url: el enlace para abrirlo. Los documentos, hojas de cálculo, presentaciones y dibujos de Google se abren directamente en su editor.
  • mime_type: el tipo de archivo.
  • id: el identificador del archivo en Google Drive, que piden otros componentes de Drive para trabajar con él.

El componente también puede usarse como herramienta de un agente con Tool Mode.

Ejemplo

Un despacho quiere que su asistente interno encuentre el contrato de un cliente y comparta el enlace.

  1. Añade Drive Search y elige la credencial Google Drive del despacho.
  2. En Query Item elige name y en Valid Operator, contains.
  3. Conecta a Search Value el nombre del cliente que escribe el usuario.
  4. Pon Max Results en 5.
  5. Conecta la salida Data al agente para que responda con el nombre y el enlace de cada contrato encontrado.

Componentes relacionados