> ## Documentation Index
> Fetch the complete documentation index at: https://linkly.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Usar bibliotecas

> Organiza tus documentos en bibliotecas temáticas para búsquedas más precisas y una gestión del conocimiento más eficiente.

## Qué es una biblioteca

Una biblioteca es un contenedor con nombre en Linkly AI para organizar documentos. Puedes agrupar documentos del mismo tema en una biblioteca y filtrar las búsquedas por biblioteca para encontrar rápidamente lo que necesitas.

<CardGroup cols={2}>
  <Card title="Aislamiento temático" icon="layer-group" iconType="duotone">
    Mantén separados los "documentos de trabajo" y los "artículos de
    investigación" — las búsquedas no los mezclarán
  </Card>

  <Card title="Búsqueda precisa" icon="bullseye" iconType="duotone">
    Restringe el alcance de búsqueda a una biblioteca específica en el Launcher,
    MCP o CLI
  </Card>
</CardGroup>

**Las bibliotecas son una función avanzada opcional.** No crear bibliotecas no afecta la funcionalidad existente — la búsqueda global sigue siendo la experiencia predeterminada. Las bibliotecas son ideales para usuarios con muchos documentos que necesitan organización por categorías.

### Casos de uso

* **Investigadores**: Organiza artículos por tema en bibliotecas como `ml-papers`, `neuroscience`, etc.
* **Desarrolladores**: Separa documentación de proyectos, especificaciones de API y notas de reuniones
* **Colaboración en equipo**: Crea bibliotecas dedicadas por proyecto para que los asistentes de IA solo busquen en documentos relevantes vía MCP
* **Gestión personal del conocimiento**: Categoriza notas, extractos de libros y materiales de referencia

## Crear una biblioteca

<Steps>
  <Step title="Abrir la página de bibliotecas">
    Ve a **Configuración → Bibliotecas**. Verás la página de lista de bibliotecas (vacía en el primer uso).
  </Step>

  <Step title="Crear una nueva biblioteca">
    Haz clic en el botón **Nueva biblioteca** en la esquina superior derecha. En el diálogo, completa:

    * **Nombre** (obligatorio): Un identificador único para la biblioteca. Solo se permiten letras minúsculas, números y guiones (ej: `my-research`, `work-2024`)
    * **Descripción** (opcional): Una breve descripción del propósito de la biblioteca

    <Tip>
      El nombre usa formato slug y también se usa como parámetro de filtro al buscar. Mantenlo corto y fácil de recordar.
    </Tip>
  </Step>

  <Step title="Agregar carpetas">
    Después de la creación, entra a la página de detalles de la biblioteca y haz clic en el botón **Agregar carpeta** para seleccionar una carpeta desde el selector de archivos del sistema.

    Una biblioteca puede contener múltiples carpetas. Una vez agregada, Linkly AI escaneará e indexará automáticamente los documentos que contenga.
  </Step>
</Steps>

### Administrar bibliotecas

En la página de detalles de la biblioteca, puedes:

* **Editar**: Haz clic en el icono de lápiz para modificar el nombre o la descripción
* **Eliminar una carpeta**: Haz clic en el icono de eliminar junto a una carpeta para desvincularla de la biblioteca (los archivos reales no se eliminan)
* **Eliminar una biblioteca**: Haz clic en el icono de eliminar y confirma para eliminar toda la biblioteca. Los documentos indexados no se ven afectados y aún se pueden encontrar mediante la búsqueda global

## Búsqueda filtrada en el Launcher

El Launcher admite búsqueda filtrada por biblioteca activada con `@`:

<Steps>
  <Step title="Escribe @ para entrar en modo de selección">
    Escribe `@` en el cuadro de búsqueda del Launcher. La vista cambia a una
    lista de bibliotecas candidatas. Sigue escribiendo para filtrar por nombre.
  </Step>

  <Step title="Selecciona una biblioteca">
    Haz clic o presiona Enter para seleccionar una biblioteca. Aparece una
    insignia azul a la izquierda del cuadro de búsqueda (ej: `@my-research`),
    indicando que el alcance de búsqueda está restringido.
  </Step>

  <Step title="Ingresa tu consulta">
    Busca dentro del alcance restringido. Los resultados provienen solo de las
    carpetas incluidas en esa biblioteca.
  </Step>

  <Step title="Salir de la búsqueda filtrada">
    Presiona la tecla Retroceso cuando el cuadro de búsqueda esté vacío, o haz
    clic en el botón de retroceso a la izquierda para volver a la búsqueda
    global.
  </Step>
</Steps>

## Uso con asistentes de IA

Los asistentes de IA conectados a Linkly AI (como OpenClaw, Claude, Cursor, etc.) pueden buscar dentro de bibliotecas específicas. Simplemente indica el alcance de búsqueda en lenguaje natural:

<CardGroup cols={1}>
  <Card title="Búsqueda por biblioteca" icon="magnifying-glass" iconType="duotone" horizontal>
    "Busca en mi biblioteca ml-papers documentos sobre mecanismos de atención"
  </Card>

  <Card title="Listar bibliotecas" icon="list" iconType="duotone" horizontal>
    "Lista todas mis bibliotecas"
  </Card>

  <Card title="Filtrado combinado" icon="filter" iconType="duotone" horizontal>
    "Busca archivos PDF sobre transformers en mi biblioteca ml-papers"
  </Card>
</CardGroup>

El asistente de IA invocará automáticamente las herramientas MCP o CLI apropiadas para completar la búsqueda.

## Uso con el CLI

### Listar bibliotecas

```bash theme={null}
linkly list-libraries
```

### Búsqueda por biblioteca

```bash theme={null}
linkly search "attention mechanism" --library ml-papers
```

Combinado con filtrado por ruta:

```bash theme={null}
linkly search "transformer" --library ml-papers --path-glob "*.pdf"
```

<Tip>
  Las bibliotecas pronto admitirán push a la nube para acceso en línea las 24
  horas.
</Tip>

## Preguntas frecuentes

<AccordionGroup>
  <Accordion title="¿Se volverán a indexar las carpetas añadidas a una biblioteca?">
    No. Si los documentos de una carpeta ya han sido indexados a través de la gestión de carpetas, crear una biblioteca no activará una indexación duplicada. Las bibliotecas simplemente añaden una capa de agrupación lógica sobre los índices existentes.
  </Accordion>

  <Accordion title="¿La actualización a v0.3.0 activará una reindexación?">
    v0.3.0 incluye cambios en la estructura del índice de palabras clave, por lo que el índice se reconstruirá automáticamente tras la actualización. Este proceso solo implica ajustes en la estructura del índice, sin volver a analizar el contenido de los documentos, por lo que es mucho más rápido que una reindexación completa. Dependiendo del número de documentos, suele tardar entre unos minutos y unas horas.
  </Accordion>

  <Accordion title="¿Cuál es la relación entre bibliotecas y carpetas? ¿Cuándo debería usar bibliotecas?">
    Las carpetas añadidas a una biblioteca aparecen automáticamente en la lista de gestión de carpetas. Una biblioteca es esencialmente una agrupación lógica de carpetas y es una función opcional.

    **Añadir carpetas directamente** funciona para la mayoría de usuarios: las carpetas son globales y admiten búsqueda local y acceso remoto a través del túnel MCP.

    **Las bibliotecas** son útiles cuando necesitas aislar el alcance de búsqueda por tema, por ejemplo, separando documentos de "trabajo" y "académicos". Además, en el futuro las bibliotecas admitirán push a la nube e integración con herramientas externas específicas.

    Si no tienes necesidades específicas de categorización, puedes usar Linkly AI perfectamente sin crear ninguna biblioteca.
  </Accordion>
</AccordionGroup>