Search

⚠️ ADVERTENCIA DE DEPRECACIÓN

Este componente está deprecado y será eliminado en una versión futura de Nappai. Por favor, migra a los componentes alternativos recomendados.

El componente Search permite a los usuarios buscar dentro de todas las páginas y bases de datos que han sido compartidas con la integración de Notion configurada en Nappai. Es útil cuando necesitas localizar rápidamente información específica sin navegar manualmente por la estructura de Notion.

¿Cómo funciona?

El componente se conecta a la API de Notion usando el token de integración que has configurado previamente. Cuando envías una consulta, la API compara el texto de la consulta con los títulos de todas las páginas y bases de datos accesibles. Puedes limitar la búsqueda a solo páginas o solo bases de datos y ordenar los resultados en orden ascendente o descendente. El componente devuelve los resultados en dos formatos: un objeto de datos estructurado (Data) y una herramienta (Tool) que puede ser utilizada por otros componentes o flujos de trabajo.

Entradas

Campos de Entrada

• Filter Type: Selecciona si quieres buscar solo en páginas o solo en bases de datos.
• Search Query: Escribe el texto que quieres buscar en los títulos de las páginas y bases de datos.
• Sort Direction: Elige la dirección en la que se ordenarán los resultados (ascendente o descendente).

Nota: Antes de usar el componente, asegúrate de haber configurado una credencial de tipo Notion API en la sección de credenciales de Nappai y seleccionarla en el campo “Credential” del componente.

Salidas

• Data: Un objeto con la lista de páginas y bases de datos que coinciden con la búsqueda.
• Tool: Una herramienta que puede ser invocada por otros componentes para procesar o mostrar los resultados de manera más interactiva.

Ejemplo de Uso

1. Configura la credencial: Ve a Credenciales → Agregar credencial → selecciona Notion API y pega tu token de integración.
2. Añade el componente: Arrastra el componente Search al flujo de trabajo.
3. Configura las entradas:
   • Filter Type: Pages
   • Search Query: Monthly Report
   • Sort Direction: Ascending
4. Conecta la salida: Conecta la salida Data a un componente de visualización (por ejemplo, un cuadro de texto) para mostrar los resultados en el dashboard.

Componentes Relacionados

• NotionDirectoryLoader – Carga la estructura completa de carpetas y páginas de Notion.
• NotionCreatePage – Crea nuevas páginas en Notion a partir de datos generados.
• NotionUpdatePage – Actualiza el contenido de una página existente.

Consejos y Mejores Prácticas

• Limita la búsqueda: Si solo necesitas páginas, selecciona Pages en Filter Type para reducir la carga de la API.
• Usa consultas específicas: Cuanto más precisa sea la Search Query, más rápido obtendrás resultados relevantes.
• Ordena los resultados: Elige Ascending o Descending según la lógica de tu flujo de trabajo para facilitar la lectura.

Consideraciones de Seguridad

• Protege tu token: El token de integración de Notion debe mantenerse en secreto. No lo compartas en el código ni lo expongas públicamente.
• Revisa permisos: Asegúrate de que la integración de Notion tenga solo los permisos necesarios (lectura de páginas y bases de datos) para minimizar riesgos.