Saltearse al contenido
Nappai Documentation

Search

El componente Search te permite buscar archivos en tu cuenta de Microsoft OneDrive directamente desde el dashboard de Nappai. Puedes filtrar por tipo de archivo, autor, fecha, tamaño y mucho más, y elegir entre tres formas de búsqueda: rápida, semántica o avanzada.

¿Cómo funciona?

El componente se conecta a la API de Microsoft OneDrive a través de la credencial que hayas configurado previamente en Nappai. Cuando envías una consulta, el componente construye una petición a la API, aplica los filtros seleccionados y devuelve los resultados en un formato estructurado que puedes usar en otros componentes o en un agente de IA.

Operaciones

Este componente ofrece varias operaciones que puedes seleccionar según lo que necesites hacer. Solo puedes usar una operación a la vez:

  • Quick Search: Busca archivos rápidamente usando una consulta simple y devuelve los resultados más relevantes.
  • Semantic Search: Utiliza la inteligencia semántica para encontrar archivos que coincidan con el significado de tu consulta, no solo con palabras clave.
  • Advanced Search: Permite combinar múltiples filtros (fecha, autor, extensión, tamaño, etc.) para obtener resultados muy específicos.

Para usar el componente, primero selecciona la operación que necesitas en el campo Operation (Operación).

Entradas

Modo de Mapeo (Mapping Mode)

Este componente cuenta con un modo especial llamado “Mapping Mode” (Modo de Mapeo). Cuando activas este modo mediante el interruptor, se habilita una entrada adicional llamada Mapping Data y cada campo de entrada te ofrece tres formas diferentes de proporcionar datos:

  • Fixed (Fijo): Escribes el valor directamente en el campo.
  • Mapped (Mapeado): Conectas la salida de otro componente para usar su resultado como valor.
  • Javascript: Escribes código Javascript para calcular el valor dinámicamente.

Esta flexibilidad te permite crear flujos de trabajo más dinámicos y conectados.

Campos de Entrada

Los siguientes campos están disponibles para configurar este componente. Cada campo puede estar visible en diferentes operaciones:

  • Date From: Fecha de inicio para filtrar los archivos (YYYY-MM-DD).
    • Visible en: Advanced Search
  • Date To: Fecha de fin para filtrar los archivos (YYYY-MM-DD).
    • Visible en: Advanced Search
  • Operation: Tipo de búsqueda a realizar.
    • Visible en: Quick Search, Semantic Search, Advanced Search
  • Author Filter: Filtra por autor o creador del archivo.
    • Visible en: Advanced Search
  • File Context: Contexto para mejorar los resultados semánticos.
    • Visible en: Semantic Search
  • File Extensions: Lista separada por comas de extensiones de archivo (ej. pdf,docx,xlsx).
    • Visible en: Quick Search, Advanced Search
  • Mapping Mode: Habilita el modo de mapeo para procesar múltiples registros en lote.
    • Visible en: Quick Search, Semantic Search, Advanced Search
  • Max Results: Número máximo de resultados a devolver.
    • Visible en: Quick Search, Semantic Search, Advanced Search
  • Search Query: Consulta de búsqueda o descripción en lenguaje natural.
    • Visible en: Quick Search, Semantic Search, Advanced Search
  • Size Filter: Filtra archivos por tamaño.
    • Visible en: Semantic Search
  • Time Filter: Filtra archivos por hora de modificación.
    • Visible en: Semantic Search
  • Top Score: Umbral de puntuación superior para los resultados (0‑10, menor es mejor).
    • Visible en: Quick Search, Semantic Search, Advanced Search
  • Tool Name: Nombre del instrumento que se usará cuando el componente esté conectado como herramienta.
    • Visible en: Quick Search, Semantic Search, Advanced Search
  • Tool Description: Descripción detallada de lo que hace esta herramienta.
    • Visible en: Quick Search, Semantic Search, Advanced Search
  • Tools arguments metadata: Define los metadatos de los argumentos de la herramienta.
    • Visible en: Quick Search, Semantic Search, Advanced Search

Nota importante: Antes de usar el componente, debes configurar una credencial de tipo Microsoft One Drive en la sección de credenciales de Nappai y luego seleccionarla en el campo Credential del componente. La credencial requiere los datos de tu aplicación Azure: Client ID, Client Secret, Tenant ID y el acceso a OneDrive.

Salidas

  • Search Results: Devuelve los archivos encontrados en formato Data. Puedes usar estos datos en otros componentes o pasarles a un agente de IA.
  • Tool: Devuelve una herramienta (Tool) que puede ser utilizada por un agente para ejecutar la búsqueda directamente.

Ejemplo de Uso

  1. Configuración inicial

    • En la sección de credenciales, crea una nueva credencial llamada OneDriveCred con tu Client ID, Client Secret, Tenant ID y selecciona el acceso a OneDrive.
    • En el componente Search, selecciona OneDriveCred en el campo Credential.

  2. Búsqueda rápida

    • Selecciona la operación Quick Search.
    • En Search Query escribe: report 2024.
    • Deja Max Results en 10.
    • Haz clic en Run.
    • Los resultados aparecerán en la salida Search Results y podrás conectarlos a un componente de visualización o a un agente.

  3. Búsqueda avanzada

    • Cambia la operación a Advanced Search.
    • En Date From escribe 2024-01-01 y en Date To escribe 2024-12-31.
    • En File Extensions escribe pdf,docx.
    • En Author Filter escribe Juan Pérez.
    • Ejecuta la búsqueda.
    • Los resultados filtrados aparecerán en Search Results.

Plantillas

(Esta sección se omite porque no hay plantillas que utilicen este componente.)

Componentes Relacionados

  • OneDriveSearchComponentBase – Base que define la lógica común de búsqueda en OneDrive.
  • OneDriveGraphAPI – Conexión directa a la API de Microsoft Graph para operaciones de OneDrive.

Consejos y Mejores Prácticas

  • Usa filtros específicos: Cuanto más precisos sean los filtros (fecha, extensión, autor), más rápido y relevante será el resultado.
  • Aprovecha el Modo de Mapeo: Si necesitas buscar en varios archivos a la vez, activa el modo de mapeo y conecta la salida de un componente de lista de archivos.
  • Limita el número de resultados: Establece un valor razonable en Max Results para evitar sobrecargar la interfaz y mejorar el rendimiento.
  • Revisa la puntuación: En búsquedas semánticas, ajusta Top Score para filtrar resultados menos relevantes.

Consideraciones de Seguridad

  • Protege tus credenciales: No compartas la credencial de OneDrive en archivos públicos ni la incluyas en el código fuente.
  • Control de acceso: Asegúrate de que solo los usuarios autorizados tengan acceso a la credencial y al componente.
  • Revisa los permisos: La credencial debe tener permisos mínimos necesarios (lectura de archivos) para cumplir con el principio de menor privilegio.