Docs

Base de conocimiento (RAG)

Utiliza Helmcode Chat con tu propia documentación. Una base de conocimiento es una fuente RAG privada, a nivel de organización — tu equipo sube ficheros (o sincroniza un repositorio Git) una sola vez, y cualquiera puede añadirla a un chat para obtener respuestas basadas en ese contenido.

1. Crea una base de conocimiento

Ve a knowledgeNew base, ponle un nombre y una descripción opcional, y pulsa Create.

Modal de creación de una nueva base de conocimiento

2. Añade documentos

Abre tu nueva base y arrastra ficheros al área de subida, o pulsa Browse. Formatos soportados: PDF, TXT o MD, hasta 25 MiB cada uno. También puedes pulsar New page para escribir un documento directamente desde el dashboard en lugar de subir un fichero.

Cada documento muestra su estado de indexado — espera a que pase a Ready antes de consultarlo.

Base de conocimiento con un documento subido en estado Ready

3. Úsala en el chat

En el chat, abre el selector de base de conocimiento junto al selector de modelo (por defecto está en No knowledge base) y elige la que acabas de crear. A partir de ahí, cada mensaje que envíes se responde usando esa base como contexto, con citas hacia el documento de origen.

Selector de base de conocimiento en el chat

Respuesta del chat basada en la base de conocimiento seleccionada

4. Sincroniza desde GitHub o GitLab

En lugar de subir ficheros a mano, puedes apuntar una base de conocimiento a un repositorio Git de documentos markdown y mantenerla sincronizada automáticamente.

Base de conocimiento sincronizada desde GitHub, con acceso a los ajustes de Integrations

Crea un personal access token

Crea un PAT con permisos de lectura sobre los repositorios que quieras sincronizar — consulta la guía de GitHub para crear un personal access token (classic). GitLab funciona igual, con un token de acceso de proyecto o de grupo.

Conecta el proveedor

Desde knowledge, abre los ajustes (icono del engranaje) → Integrations:

  • Elige un Provider: GitHub o GitLab.
  • Base URL — déjalo en blanco para el SaaS público (github.com / gitlab.com); indícalo solo si usas una instancia self-hosted de GitHub Enterprise o GitLab.
  • Pega tu personal access token y pulsa Connect. Se guarda cifrado y no vuelve a mostrarse.

Conectar un repositorio: proveedor GitHub, Base URL y personal access token

Añade una fuente de repositorio

Una vez conectado, añade el repositorio a sincronizar como owner/repo (por ejemplo helmcode/docs), con una rama opcional (por defecto main) y una ruta opcional para acotarlo a un subdirectorio, y pulsa Add source. Elige una frecuencia de Sync (por ejemplo, cada hora) o lanza Sync now para una sincronización inmediata.

Añadir una fuente de repositorio tras conectar GitHub

Aparecerá en la lista una nueva base de conocimiento con el nombre del repositorio, con todos los ficheros markdown encontrados en él.

Documentos extraídos automáticamente desde el repositorio de GitHub

Las bases de conocimiento sincronizadas desde Git son de solo lectura desde la página Knowledge — no puedes subir ni borrar documentos individuales ahí. Gestiona la fuente (rama, ruta, frecuencia de sincronización, desconexión) desde Integrations.

Así de sencillo, cualquiera en la organización puede consultar la documentación interna de la empresa — de forma rápida, segura y usando los mismos modelos abiertos que ya tienes disponibles en tu plan.