Base de Conocimiento

Introducción a Knowledge Base

Las organizaciones se esfuerzan por gestionar y aprovechar grandes cantidades de datos e información. Ya sea para el intercambio de conocimiento interno, materiales de capacitación, soporte al cliente o alimentar modelos de IA, tener un repositorio centralizado de datos es esencial. Aquí es donde entra en juego una knowledge base (KB).

Una knowledge base es un repositorio estructurado que permite a las organizaciones almacenar, gestionar y recuperar información de manera eficiente. Típicamente incluye documentos, FAQs, guías, procedimientos operativos estándar y más. Estos documentos están curados para asegurar accesibilidad, confiabilidad y relevancia contextual. Una knowledge base bien mantenida ayuda a reducir consultas repetitivas, apoya la incorporación y empodera a los usuarios con acceso instantáneo a contenido crítico.

Por ejemplo, un agente de soporte podría consultar la knowledge base para resolver un problema del cliente más rápidamente, mientras que un chatbot entrenado en el mismo repositorio puede proporcionar respuestas instantáneas a los usuarios finales. En el contexto de QuickML, esta knowledge base cumple un propósito aún más poderoso: enriquece los modelos de IA, haciendo que las respuestas de la máquina sean más inteligentes, contextuales y precisas.

El rol de Knowledge Base en QuickML

En QuickML, la knowledge base no es solo un sistema de almacenamiento de documentos; es una capa fundamental que interactúa directamente con las capacidades de IA. Una vez que se cargan los documentos, se indexan de manera inteligente y se aprovechan como fuentes de datos contextuales. Esto se vuelve especialmente crucial para funciones como Retrieval-Augmented Generation (RAG), donde los modelos de IA acceden a la knowledge base para recuperar y entregar respuestas precisas y ricas en contexto en respuesta a las consultas del usuario.

Al permitir que los documentos sean referenciados por modelos de ML dinámicamente, QuickML asegura que las respuestas generadas a través de APIs o interfaces de chat sean contextualmente relevantes, factualmente precisas y fundamentadas en conocimiento organizacional en tiempo real. Esta fusión de datos e IA transforma documentos pasivos en entradas activas y vivas para sistemas inteligentes de toma de decisiones.

Accediendo a la Knowledge Base

En QuickML, puedes acceder a la pestaña Knowledge Base directamente desde el panel de navegación izquierdo bajo la sección GENERATIVE AI, junto a las opciones de LLM Serving y RAG, destacando su relevancia estratégica en el desarrollo de pipelines de IA.

Cargando documentos a la Knowledge Base

Para poblar tu knowledge base, QuickML proporciona tres métodos de carga distintos. Cada método ofrece flexibilidad basada en la fuente de tu documento.

Cargar un archivo (desde el escritorio local)

Este es el método más directo y se utiliza para cargar documentos directamente desde tu computadora.

Campos requeridos

• Name: Un título para el documento.
• Document file: Arrastra y suelta o selecciona un archivo (.pdf, .docx, .txt; máx. 500 KB por archivo).

Ideal para: Cargas de documentos estáticos de una sola vez como políticas de RRHH, SOPs o documentos técnicos.

Zoho WorkDrive

Esta opción te permite importar documentos alojados en Zoho WorkDrive a través de URLs. Incluye opciones de sincronización dinámica para mantener los documentos actualizados.

Campos requeridos

• Name: El título del documento en la knowledge base.
• Link: Un enlace directo de WorkDrive al documento. (pdf, .docx, .txt; máx. 500 KB por archivo).
• Sync frequency: Elige con qué frecuencia el sistema debe obtener actualizaciones (ej., None, Hourly, Daily, Weekly o Custom Frequency).

Ideal para: Documentos vivos como especificaciones de diseño, manuales de incorporación o páginas wiki internas que se actualizan regularmente.

Zoho Learn

Usa esto para extraer documentación de tu hub de Zoho Learn. Es útil si tu organización ya utiliza Zoho Learn para documentación de capacitación o políticas.

Campos requeridos

• Name: Un nombre personalizado para referencia interna.
• Link: Una URL directa al artículo o manual.
• Import option: Elige si “Import an article using the article link” o “Import from a manual”. Sync frequency: Elige con qué frecuencia el sistema debe obtener actualizaciones (ej., None, Hourly, Daily, Weekly o Custom Frequency).

Nota importante sobre los enlaces de documentos de Zoho Learn:

1. Debes ser parte de un hub de Zoho Learn para usar esta opción. Si no, no podrás cargar los documentos usando este método.

2. Al compartir o cargar enlaces de documentos en Zoho Learn, no copies la URL directamente de la barra de direcciones, ya que puede incluir elementos de ruta adicionales (como /team/ o nombres de proyectos específicos) que pueden hacer que el enlace no funcione para otros.

Formatos de enlace correctos vs. incorrectos:

OCR Article

Funciona: https://learn.zoho.com/portal/zohocorp/manual/image/article/ocr-wiki

No funciona: https://learn.zoho.com/portal/zohocorp/team/crmzia-ml-dl/manual/image/article/ocr-wiki

Para cargar documentos a la Knowledge Base

1. Inicia sesión en tu cuenta de QuickML.
2. Bajo la sección Generative AI, selecciona la pestaña Knowledge Base.
3. Haz clic en Upload Document.
4. Elige el método de carga de documentos deseado:
   • Elige Upload a file para cargar un documento directamente desde tu computadora local.
   • Elige Zoho Workdrive para cargar un documento almacenado en tu Zoho Workdrive.
   • Elige Zoho Learn para importar un artículo o un manual desde tu espacio de trabajo de Zoho Learn.

5. Los documentos cargados aparecerán en el repositorio de la knowledge base.

Gestionando documentos cargados

Una vez que tus documentos están cargados, QuickML proporciona una interfaz limpia de estilo tarjeta para interactuar con cada documento a través de ciertas acciones en la knowledge base.

Acciones de documentos disponibles

• Delete: Eliminar permanentemente el documento del repositorio de la knowledge base.

• Copy Document ID: Útil para referenciar el documento en tus APIs o dentro de pipelines de RAG.

• Vista previa de meta descripción: Al pasar el cursor debajo del título del documento, puedes ver las primeras líneas del contenido del documento como la meta descripción.

Explorando las opciones de RAG API

En la esquina superior derecha, notarás el botón Rag API. Esta opción es para usuarios técnicos o desarrolladores que buscan integrar el sistema RAG en sus aplicaciones usando documentos de la knowledge base.

Al configurar una llamada de RAG API, se pueden establecer varios parámetros.

OAuth Scope

Esto define el nivel específico de acceso que el token de API (access token) otorgará. En este caso, el scope es: QuickML.deployment.READ. Esto otorga acceso de solo lectura al despliegue de QuickML, que incluye consultar documentos de la knowledge base usando la función de RAG (Retrieval-Augmented Generation).

Authentication

La autenticación asegura que solo usuarios autorizados puedan realizar llamadas de API. Esta RAG API utiliza OAuth, un framework de autorización seguro que permite a las aplicaciones obtener acceso limitado a cuentas de usuario.

HTTP method

El método HTTP utilizado para esta llamada de API es: POST. Este método se utiliza porque la API no solo está recuperando datos estáticos; está enviando entrada (consulta y documentos) al servidor para recibir una respuesta generada basada en razonamiento dinámico.

Endpoint URL

La Endpoint URL especifica la ubicación exacta del servicio de RAG API al cual tu aplicación enviará la solicitud POST.

Headers

Los headers son metadatos enviados junto con la solicitud. Ayudan a autenticar y enrutar la solicitud correctamente.

Request body

El request body contiene la carga real enviada a la API. En este caso, la consulta del usuario y qué documentos buscar.

Mejores prácticas para el uso efectivo de la Knowledge Base

Para maximizar el valor de la pestaña de Knowledge Base:

1. Asegúrate de que los documentos estén formateados de manera limpia con encabezados, viñetas y estructura legible.
2. Revisa y actualiza regularmente los documentos para mantener la relevancia.
3. Siempre copia y almacena el Document ID de forma segura cuando planees usarlo con APIs.