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

# Agregar Conocimiento

> Enseñale a tu agente sobre tu negocio subiendo documentos, links y conectando fuentes de datos

Tu agente necesita información para responder preguntas específicas sobre tu negocio. Esta guía te muestra cómo alimentarlo con documentos, páginas web, y otras fuentes de datos.

## ¿Qué son los Datastores?

Un **Datastore** (base de conocimiento) es donde guardás toda la información que tu agente puede consultar. Pensalo como la memoria y el conocimiento del agente.

<Info>
  Podés tener múltiples datastores y conectarlos a uno o varios agentes. Por ejemplo: un datastore de "Productos", otro de "Políticas" y otro de "Preguntas Frecuentes".
</Info>

## Crear un Datastore

<Steps>
  <Step title="Ir a Datastores">
    Desde el menú principal, click en **"Datastores"** o **"Conocimiento"**
  </Step>

  <Step title="Crear Nuevo">
    Click en **"+ Crear Datastore"**
  </Step>

  <Step title="Configurar">
    Completa los datos básicos:

    * **Nombre**: Ej. "Productos", "FAQ", "Documentación Técnica"
    * **Descripción**: Para qué sirve este datastore
    * **Visibilidad**: Privado (solo tus agentes) o Público
  </Step>

  <Step title="Elegir Vector Store">
    Horneross usa **Qdrant** por defecto (recomendado). No necesitás cambiar nada.
  </Step>
</Steps>

## Tipos de Fuentes

Podés agregar información de múltiples formas:

<CardGroup cols={2}>
  <Card title="Archivos" icon="file">
    PDFs, Word, Excel, PowerPoint, archivos de texto
  </Card>

  <Card title="Páginas Web" icon="globe">
    URLs de tu sitio web, blog o documentación online
  </Card>

  <Card title="Texto Directo" icon="keyboard">
    Copiar y pegar información
  </Card>

  <Card title="APIs" icon="code">
    Conectar sistemas externos (plan Pro)
  </Card>
</CardGroup>

## Subir Archivos

### Formatos Soportados

<Tabs>
  <Tab title="Documentos">
    * **PDF** (.pdf) - Recomendado
    * **Word** (.doc, .docx)
    * **Excel** (.xls, .xlsx)
    * **PowerPoint** (.ppt, .pptx)
    * **Texto plano** (.txt)
    * **Markdown** (.md)
  </Tab>

  <Tab title="Páginas Web">
    * **URLs individuales**
    * **Sitemap XML** (para múltiples páginas)
    * **Contenido HTML**
  </Tab>

  <Tab title="Otros">
    * **CSV** (.csv) - Para datos tabulares
    * **JSON** (.json) - Para datos estructurados
    * **Imágenes con texto** (OCR limitado)
  </Tab>
</Tabs>

### Cómo Subir Archivos

1. Dentro de tu datastore, click en **"+ Agregar Fuente"**
2. Seleccioná **"Archivo"**
3. Arrastrá y soltá o click para seleccionar archivos
4. Esperá que se procese

<Warning>
  **Límites de tamaño:**

  * Plan Free: hasta 10 MB por archivo
  * Plan Starter: hasta 50 MB por archivo
  * Plan Pro: hasta 100 MB por archivo

  Si tenés archivos más grandes, dividílos en partes más chicas.
</Warning>

### Tips para Mejores Resultados

<AccordionGroup>
  <Accordion title="PDFs con Texto Real" icon="file-pdf">
    Asegurate que el PDF tenga **texto seleccionable**, no solo imágenes de texto. Si escaneaste un documento, usá OCR primero.

    **Cómo verificar:** Intentá seleccionar texto en el PDF. Si podés, está bien.
  </Accordion>

  <Accordion title="Organización Clara" icon="folder-tree">
    Dividí documentos grandes en secciones temáticas:

    * ✅ "Productos\_Categoria\_A.pdf"
    * ✅ "Productos\_Categoria\_B.pdf"
    * ❌ "TodosLosProductos.pdf" (100 páginas)

    Documentos más chicos = búsquedas más precisas.
  </Accordion>

  <Accordion title="Formato Consistente" icon="align-left">
    Usá títulos, subtítulos y listas. Evitá bloques de texto sin estructura.

    **Bueno:**

    ```
    # Política de Devoluciones

    ## Plazo
    - Tenés 30 días desde la compra

    ## Requisitos
    - Producto sin usar
    - Etiquetas originales
    ```

    **Malo:**

    ```
    Aceptamos devoluciones dentro de los 30 días de la compra
    el producto debe estar sin usar y con las etiquetas originales...
    ```
  </Accordion>

  <Accordion title="Actualización Regular" icon="arrows-rotate">
    Eliminá información desactualizada. Si cambian precios o políticas, actualizá los documentos.
  </Accordion>
</AccordionGroup>

## Agregar Páginas Web

Perfecto para documentación online, blogs, o páginas de productos.

### Método 1: URL Individual

1. Click en **"+ Agregar Fuente"**
2. Seleccioná **"Web Page"**
3. Pegá la URL completa
4. Click en **"Procesar"**

**Ejemplo:**

```
https://www.minegocio.com/productos/zapatillas-running
```

### Método 2: Sitemap (Múltiples Páginas)

Si querés indexar todo tu sitio web:

1. Seleccioná **"Sitemap"**
2. Pegá la URL del sitemap: `https://tudominio.com/sitemap.xml`
3. Horneross automáticamente procesa todas las URLs

<Tip>
  La mayoría de los sitios web tienen un sitemap en `/sitemap.xml` o `/sitemap_index.xml`
</Tip>

### Método 3: Scraping Profundo

Para sitios sin sitemap:

1. Ingresá la URL base: `https://www.tudominio.com`
2. Definí profundidad máxima (ej: 3 niveles)
3. Horneross rastrea y indexa automáticamente

<Warning>
  El scraping puede tardar varios minutos en sitios grandes. Te notificamos cuando termina.
</Warning>

## Agregar Texto Manualmente

Ideal para información breve o datos que no están en documentos.

1. Click en **"+ Agregar Fuente"**
2. Seleccioná **"Texto"**
3. Pegá o escribí el contenido
4. Dale un nombre descriptivo
5. Guardá

**Ejemplo de uso:**

```markdown theme={null}
# Horarios de Atención

Lunes a Viernes: 9:00 - 18:00
Sábados: 10:00 - 14:00
Domingos: Cerrado

Feriados: Consultar calendario especial

# Información de Contacto

Teléfono: +54 11 1234-5678
Email: contacto@minegocio.com
Dirección: Av. Corrientes 1234, CABA
```

## Conectar a un Agente

Una vez que tenés tu datastore con información:

<Steps>
  <Step title="Ir a tu Agente">
    Abrí la configuración del agente
  </Step>

  <Step title="Sección Datastores">
    Andá a **"Datastores Conectados"** o **"Conocimiento"**
  </Step>

  <Step title="Conectar">
    Click en **"Conectar Datastore"** y elegí el que creaste
  </Step>

  <Step title="Configurar Búsqueda">
    Ajustá parámetros de búsqueda (opcional):

    * **Top K**: Cuántos resultados buscar (default: 5)
    * **Similarity Threshold**: Qué tan similar debe ser (default: 0.7)
  </Step>
</Steps>

<Info>
  Un agente puede tener **múltiples datastores** conectados. Horneross busca en todos automáticamente.
</Info>

## Configuración Avanzada

### Parámetros de Búsqueda

<ResponseField name="topK" type="number" default="5">
  Cuántos fragmentos de texto buscar por consulta.

  * **3-5**: Para información concisa
  * **5-10**: Para respuestas más completas
  * **10+**: Para análisis profundos (usa más tokens)
</ResponseField>

<ResponseField name="similarityThreshold" type="number" default="0.7">
  Qué tan relacionado debe estar el texto con la pregunta (0 a 1):

  * **0.5-0.6**: Búsqueda amplia, más resultados
  * **0.7-0.8**: Balanceado (recomendado)
  * **0.9-1.0**: Solo resultados muy precisos
</ResponseField>

<ResponseField name="includeMetadata" type="boolean" default="true">
  Incluir información sobre la fuente en las respuestas (nombre del archivo, página, etc.)
</ResponseField>

### Chunking (División de Texto)

Horneross automáticamente divide documentos largos en fragmentos pequeños para búsquedas eficientes.

**Configuración predeterminada:**

* Tamaño de chunk: 1000 caracteres
* Overlap: 200 caracteres

Generalmente no necesitás cambiar esto, pero podés ajustarlo en configuración avanzada.

## Monitoreo y Mantenimiento

### Ver Qué Está Indexado

1. Abrí tu datastore
2. Andá a **"Fuentes"**
3. Ves todas las fuentes y su estado:
   * ✅ Procesado
   * ⏳ Procesando
   * ❌ Error

### Actualizar Información

<Tabs>
  <Tab title="Reemplazar Archivo">
    1. Eliminá el archivo viejo
    2. Subí el nuevo con el mismo nombre
    3. Espera que procese
  </Tab>

  <Tab title="Actualizar Web">
    1. Click en la fuente web
    2. Click en **"Re-indexar"**
    3. Horneross vuelve a procesar la página
  </Tab>

  <Tab title="Sync Automático">
    Configurá auto-sync para que Horneross revise cambios cada X horas:

    * Cada 6 horas
    * Cada 24 horas
    * Cada semana
  </Tab>
</Tabs>

### Eliminar Fuentes

<Warning>
  Eliminar una fuente es **permanente** y afecta inmediatamente a todos los agentes conectados.
</Warning>

1. Seleccioná la fuente
2. Click en **"Eliminar"**
3. Confirmá

El agente dejará de tener acceso a esa información.

## Buenas Prácticas

<CardGroup cols={2}>
  <Card title="Documenta Todo" icon="book">
    Mientras más información, mejor. Incluí:

    * Preguntas frecuentes
    * Políticas (devoluciones, envíos, privacidad)
    * Catálogo de productos/servicios
    * Horarios, ubicaciones, contacto
  </Card>

  <Card title="Mantené Actualizado" icon="clock-rotate-left">
    Revisá y actualizá contenido regularmente:

    * Precios
    * Disponibilidad
    * Políticas
    * Información de contacto
  </Card>

  <Card title="Organizá por Tema" icon="layer-group">
    Creá datastores separados por categoría:

    * Productos
    * Soporte Técnico
    * Ventas y Precios
    * Empresa
  </Card>

  <Card title="Probá las Fuentes" icon="vial">
    Después de subir información:

    1. Preguntale al agente algo de ese documento
    2. Verificá que responda correctamente
    3. Ajustá si es necesario
  </Card>
</CardGroup>

## Solución de Problemas

<AccordionGroup>
  <Accordion title="El agente no encuentra información" icon="triangle-exclamation">
    **Posibles causas:**

    * El documento no se procesó correctamente
    * La pregunta usa palabras diferentes a las del documento
    * Similarity threshold muy alto

    **Soluciones:**

    * Verificá que el documento esté "Procesado"
    * Bajá el similarity threshold a 0.6
    * Reformulá la información con más variedad de palabras
  </Accordion>

  <Accordion title="Archivo no se procesa" icon="file-exclamation">
    **Posibles causas:**

    * Archivo muy grande
    * PDF escaneado sin OCR
    * Archivo corrupto

    **Soluciones:**

    * Dividí el archivo en partes más chicas
    * Usá herramientas de OCR si es necesario
    * Intentá convertir a otro formato
  </Accordion>

  <Accordion title="Respuestas con información vieja" icon="clock">
    El agente está usando información desactualizada.

    **Solución:**

    * Eliminá el documento viejo del datastore
    * Subí la versión actualizada
    * O usa "Re-indexar" para páginas web
  </Accordion>

  <Accordion title="Respuestas incorrectas" icon="circle-xmark">
    El agente responde algo que no está en tus documentos.

    **Solución:**

    * Revisá las instrucciones del agente
    * Agregá instrucción: "Solo respondé basándote en la documentación. Si no sabés, decí que no tenés esa información."
    * Bajá la temperatura del modelo
  </Accordion>
</AccordionGroup>

## Próximos Pasos

<CardGroup cols={2}>
  <Card title="Probar el Agente" icon="vial">
    Probá tu agente con preguntas reales
  </Card>

  <Card title="Conectar Integraciones" icon="plug">
    Integrá WhatsApp, web, Instagram
  </Card>

  <Card title="Ver Analíticas" icon="chart-line">
    Monitoreá qué preguntas hace la gente
  </Card>

  <Card title="Optimizar" icon="gauge-high">
    Mejorá respuestas basándote en conversaciones reales
  </Card>
</CardGroup>

<Card title="¿Necesitás ayuda?" icon="headset" href="/support/contact">
  Nuestro equipo puede ayudarte a estructurar y subir tu documentación
</Card>