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

# Base de conocimiento

> Cómo entrenar tu chatbot con el contenido de tu empresa.

# Base de conocimiento

La base de conocimiento es el conjunto de información con la que entrenas a tu chatbot. Cuanto más completa y precisa sea, mejores respuestas dará el bot.

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/chatnorris/images/PLACEHOLDER-knowledge-base-lista.png" alt="TODO: captura de la lista de fuentes en la base de conocimiento" />
</Frame>

## Tipos de fuentes

Puedes agregar información de dos formas:

<CardGroup cols={2}>
  <Card title="URL" icon="link">
    Ingresa la dirección de una página web, blog, documentación o PDF en línea. ChatNorris extrae el contenido automáticamente.
  </Card>

  <Card title="Texto" icon="file-lines">
    Pega directamente cualquier texto: preguntas frecuentes, políticas, catálogos, descripciones de productos.
  </Card>
</CardGroup>

## Agregar una fuente

<Steps>
  <Step title="Ve a la base de conocimiento del chatbot">
    Desde **Chatbots**, entra al chatbot y haz clic en **Knowledge Base** (o en el menú lateral si ya estás en el chatbot).
  </Step>

  <Step title="Clic en + Agregar fuente">
    Aparece un formulario con las opciones de tipo.
  </Step>

  <Step title="Elige el tipo y completa los datos">
    **Si eliges URL:**

    * **Nombre** — un nombre descriptivo para identificar la fuente (ej. "Página de preguntas frecuentes").
    * **URL** — la dirección completa de la página (ej. `https://empresa.com/faq`).

    **Si eliges Texto:**

    * **Nombre** — un nombre descriptivo (ej. "Políticas de envío").
    * **Contenido** — pega el texto directamente.
  </Step>

  <Step title="Guarda y espera el procesamiento">
    Al guardar, la fuente pasa por los siguientes estados:

    | Estado         | Significado                                              |
    | -------------- | -------------------------------------------------------- |
    | **Pendiente**  | En cola para ser procesada                               |
    | **Procesando** | Se está extrayendo y procesando el contenido             |
    | **Listo**      | El contenido está indexado y disponible para el bot      |
    | **Error**      | Ocurrió un problema. Ver sección de problemas más abajo. |

    El proceso puede tardar entre 30 segundos y varios minutos según el tamaño del contenido.
  </Step>
</Steps>

## Re-procesar una fuente

Si actualizaste el contenido de una URL o quieres refrescar una fuente, usa el botón **Re-sincronizar** en la fila correspondiente. Esto vuelve a procesar el contenido desde cero.

<Tip>
  Si actualizas el contenido de tu sitio web frecuentemente, re-sincroniza las URLs correspondientes para que el bot tenga la información al día.
</Tip>

## Ver estadísticas de una fuente

Cada fuente muestra:

* **Caracteres indexados** — cuánto contenido fue procesado.
* **Chunks** — en cuántos fragmentos se dividió el contenido (el bot busca en estos fragmentos).
* **Última sincronización** — cuándo fue procesada por última vez.

## Buenas prácticas para entrenar tu chatbot

<AccordionGroup>
  <Accordion title="¿Qué contenido funciona mejor?">
    * Preguntas frecuentes (FAQ) — es el tipo de contenido más efectivo.
    * Páginas de productos o servicios con descripciones detalladas.
    * Políticas: devoluciones, envíos, términos de uso.
    * Guías de uso o manuales.
    * Catálogos de precios (en texto o tabla, no imágenes).
  </Accordion>

  <Accordion title="¿Qué contenido no funciona bien?">
    * Imágenes y videos — el bot no puede "ver" imágenes.
    * PDFs con texto escaneado (imágenes de texto) — no se extrae el contenido correctamente.
    * Contenido detrás de login o autenticación.
    * Páginas con mucho JavaScript dinámico (SPAs sin renderizado en servidor).
  </Accordion>

  <Accordion title="¿Cuántas fuentes puedo agregar?">
    El límite depende de los caracteres totales de tu plan (500K en plan gratuito, hasta 100M en planes superiores). Puedes agregar tantas fuentes como quepan dentro de ese límite.
  </Accordion>

  <Accordion title="Una fuente quedó en 'Error', ¿qué hago?">
    Las causas más comunes son:

    * La URL no es accesible públicamente.
    * La página requiere login.
    * El sitio bloquea los bots de crawling.

    En esos casos, copia el texto manualmente y agrégalo como fuente de tipo Texto.
  </Accordion>

  <Accordion title="¿Cada cuánto debo actualizar mi base de conocimiento?">
    Cada vez que cambie información relevante en tu negocio: nuevos precios, productos, políticas, horarios. Si agregas una URL, recuerda re-sincronizarla después de actualizar el contenido de la página.
  </Accordion>
</AccordionGroup>

<Warning>
  El bot solo responde con la información que tiene indexada. Si hay una pregunta frecuente que el bot no responde bien, lo más probable es que esa información no esté en la base de conocimiento o no esté formulada de forma clara.
</Warning>