Saltearse al contenido
Nappai Documentation

Google Drive Search

Google Drive Search es un componente sencillo que permite a los usuarios localizar archivos dentro de su cuenta de Google Drive. Solo necesitas indicar qué buscar y cómo, y el componente devuelve los resultados encontrados.

¿Cómo funciona?

El componente se conecta a la API de Google Drive. Cuando lo configuras, seleccionas una credencial previamente creada en Nappai (que contiene tu Client ID, Client Secret y el permiso de acceso a Drive). Al ejecutar el componente, se envía una solicitud a Google Drive con los parámetros que hayas definido (campo, operador y valor de búsqueda). La API devuelve una lista de archivos que coinciden, y el componente entrega esos datos como salida.

Entradas

  • Max Results: El número máximo de archivos que quieres que se devuelvan. Si lo dejas en blanco, se usarán los valores por defecto de la API.
  • Query Item: El campo de Google Drive que quieres consultar (por ejemplo, name, mimeType, modifiedTime, etc.). Este campo es obligatorio.
  • Query String: Una cadena de búsqueda que se pasa directamente a la API. Puedes escribirla manualmente. Es obligatorio junto con Search Value.
  • Search Value: El valor que buscas dentro del campo seleccionado en Query Item. También es obligatorio junto con Query String.
  • Valid Operator: El operador lógico que se aplica a la búsqueda (=, contains, >, <, etc.). Este campo es obligatorio.
  • Tool Name: Cuando conectes este componente como una herramienta para un agente, este es el nombre que aparecerá en la lista de herramientas disponibles.
  • Tool Description: Una descripción detallada de lo que hace la herramienta, para que el agente sepa cuándo usarla.
  • Tools arguments metadata: Metadatos que describen los argumentos que la herramienta acepta. Se usan cuando el componente se expone como una herramienta.

Nota sobre credenciales
Este componente necesita una credencial de tipo Google Drive.

  1. Ve a la sección de credenciales de Nappai y crea una nueva credencial de Google Drive, introduciendo tu Client ID, Client Secret y seleccionando el permiso de acceso a Drive.
  2. En el componente, selecciona esa credencial en el campo Credential (no aparece en la lista de entradas porque es un input especial).

Salidas

  • Data: Devuelve los archivos encontrados en formato de datos (search_data). Puedes usar esta salida para filtrar, mostrar o procesar los resultados en pasos posteriores.
  • Tool: Convierte la búsqueda en una herramienta (to_toolkit) que puede ser utilizada por agentes de IA dentro de Nappai.

Ejemplo de Uso

  1. Configura la credencial: Crea y selecciona la credencial de Google Drive.
  2. Añade el componente al flujo de trabajo.
  3. Define los parámetros:
    • Query Item: name
    • Valid Operator: contains
    • Search Value: Informe_Q1
    • Max Results: 10
  4. Ejecuta el flujo.
  5. Revisa la salida Data para ver la lista de archivos que contienen “Informe_Q1” en su nombre.

Componentes Relacionados

  • Google Drive List – Lista todos los archivos de una carpeta específica.
  • Google Drive Upload – Sube archivos nuevos a Google Drive.
  • Google Drive Delete – Elimina archivos seleccionados de Drive.

Consejos y Mejores Prácticas

  • Limita los resultados: Usa Max Results para evitar respuestas muy largas y mejorar el rendimiento.
  • Combina operadores: Si necesitas búsquedas más complejas, combina Query Item, Valid Operator y Search Value para filtrar por fecha, tipo de archivo, etc.
  • Revisa la cuota: La API de Google Drive tiene límites de uso; evita hacer demasiadas búsquedas en un corto período.
  • Guarda los resultados: Si vas a usar los datos en pasos posteriores, considera guardarlos en una tabla o variable para reutilizarlos sin volver a consultar Drive.

Consideraciones de Seguridad

  • Protege la credencial: Asegúrate de que solo usuarios autorizados tengan acceso a la credencial de Google Drive.
  • Revisa los permisos: La credencial debe tener solo los permisos necesarios (lectura de archivos) para minimizar riesgos.
  • Audita las búsquedas: Si tu flujo de trabajo es crítico, registra los parámetros de búsqueda y los resultados para auditoría y trazabilidad.