Fuentes de conocimiento

Las fuentes de conocimiento permiten al asistente responder a partir de su propio material: manuales, tarifas, páginas web, un registro y sus adjuntos. El texto se divide en fragmentos, un modelo de incrustación lo convierte en vectores y se almacena en PostgreSQL. Cuando alguien pregunta, se buscan los fragmentos más parecidos, la respuesta se redacta a partir de ellos y unas citas numeradas muestran de dónde procede cada dato.

Requisitos

  • Debe estar instalado el módulo AI Knowledge Sources (RAG).

  • El servidor PostgreSQL al que se conecta Odoo debe ofrecer la extensión pgvector (vector). La instalación del módulo ejecuta CREATE EXTENSION IF NOT EXISTS vector; si la extensión no está disponible en ese servidor, la instalación se detiene con un mensaje claro. Instale pgvector en el propio servidor de base de datos, no en el servidor de Odoo, y asegúrese de que el usuario de la base de datos pueda crear la extensión.

  • Con Docker, la extensión debe estar en la imagen del contenedor de la base de datos (por ejemplo una imagen de PostgreSQL con pgvector), no en el contenedor de Odoo. Si usa un servicio PostgreSQL gestionado, active pgvector allí.

  • Un modelo de incrustación de un proveedor que lo ofrezca (OpenAI, Google Gemini u OpenRouter). Elíjalo en IA ‣ Configuración ‣ Ajustes en Modelo de incrustación. Cambiarlo pone en cola todas las fuentes para reindexarlas, porque los vectores de modelos distintos nunca se comparan.

Añadir una fuente

Abra IA ‣ Conocimiento ‣ Fuentes y cree una fuente. Elija su Tipo:

  • Archivos: suba PDF, documentos ofimáticos, archivos OpenDocument o texto plano.

  • Página web: una dirección https://. Marque Rastrear para seguir los enlaces a otras páginas del mismo sitio, hasta Profundidad de rastreo saltos de enlace y Máximo de páginas páginas. El rastreador respeta el robots.txt del sitio (se identifica como eYssenAIBot), permanece en el mismo host, lee solo HTML estático (sin JavaScript) y nunca accede a direcciones de redes privadas.

  • Registro: cualquier registro de la base de datos; marque Incluir adjuntos para indexar también sus adjuntos. Se indexan los campos de texto almacenados, salvo los que el asistente nunca puede leer (contraseñas, tokens y similares).

  • Carpeta: agrupa otras fuentes en un árbol; coloque una fuente en una carpeta con el campo Carpeta. Reindexar una carpeta pone en cola todo lo que contiene.

Los artículos de Conocimiento, las carpetas de documentos y los archivos en almacenamiento en la nube se añaden como tipos de fuente adicionales mediante los puentes de Conocimiento y Documentos (véase IA en Conocimiento, Documentos y archivos en la nube).

Quién puede usar una fuente

  • Disponible para el asistente hace que la fuente se pueda consultar desde el asistente habitual. Un agente busca en cambio en sus propias fuentes, definidas en la pestaña Conocimiento del formulario del agente, más las globales cuando Usar también las fuentes globales está activado.

  • Grupos permitidos y la compañía restringen quién puede leer la fuente. Las carpetas restringen también todo lo que contienen.

  • Sea cual sea la fuente, cada persona solo recibe extractos de registros y adjuntos que podría abrir ella misma en Odoo, y solo de modelos que las reglas de acceso de IA permitan. Un registro privado o archivado nunca se cita.

Indexación

Una fuente nueva o modificada obtiene el estado Pendiente. Una acción programada (IA: indexar las fuentes de conocimiento, cada 10 minutos) procesa las fuentes pendientes. Indexar ahora procesa una de inmediato y Reindexar la vuelve a poner en cola. El estado pasa por Procesando hasta Indexada; si algo falla, el estado es Fallido y el error se muestra en el formulario. El botón Fragmentos muestra cuántos fragmentos se han almacenado.

El ajuste fino está en el bloque Fuentes de conocimiento de los ajustes de IA: Tamaño de fragmento (caracteres) y Solapamiento de fragmentos (caracteres) (1500 y 200 por defecto), Extractos por búsqueda (6), Dimensiones de la incrustación (0 significa el tamaño propio del modelo; los modelos text-embedding-3 de OpenAI pueden devolver vectores más cortos), Textos por petición de incrustación, Peticiones de incrustación por minuto (la indexación se pausa al alcanzarlo) y Máximo de páginas por rastreo. Las llamadas de incrustación se registran y se tarifican como cualquier otra llamada al modelo.

Uso: citas y solo fuentes

Cuando hay un modelo de incrustación configurado y al menos una fuente indexada dentro del alcance, el asistente puede buscar en las fuentes. Su respuesta cita los datos con referencias numeradas y unas etiquetas en las que se puede hacer clic bajo la respuesta muestran las fuentes: una página web abre su dirección, un archivo se descarga y un registro abre su formulario.

En las Opciones de la conversación del panel de IA aparece Responder solo con las fuentes cuando hay fuentes disponibles. Con esta opción activada, el asistente debe buscar en las fuentes y dice claramente que no encontró la respuesta cuando los extractos no la contienen.

Nota

El texto hallado en las fuentes se trata como material, no como instrucciones: una página web no puede ordenar nada al asistente.

Tareas similares

Con un modelo de incrustación configurado, los proyectos pueden encontrar tareas parecidas a la que está viendo. En el formulario del proyecto, en el bloque de IA, active Tareas similares activadas y, opcionalmente, defina el Umbral de similitud (de 0 a 1, 0,75 por defecto) y la Ventana de tiempo (días) (0 significa sin límite). El texto de la tarea (nombre, descripción y mensajes recientes) se incrusta en segundo plano cada 15 minutos.

El formulario de la tarea muestra entonces un botón inteligente Tareas similares con el recuento, por ejemplo «5, 2 cerradas». Abre las coincidencias ordenadas por similitud. Los recuentos se calculan al abrir el formulario. La clasificación y las indicaciones rápidas de tickets usan la misma función (véase IA para proyectos con SLA).

Límites

  • Los recuentos de tokens mostrados para los fragmentos son estimaciones (caracteres divididos por cuatro); la facturación usa los recuentos del propio proveedor en el registro de IA.

  • Los vectores de más de 2000 dimensiones se buscan de forma exacta (sin índice), lo que es más lento en colecciones grandes. Elija un tamaño de vector más corto si puede.

  • Las páginas web se leen como HTML estático; no se ve el contenido generado por JavaScript.

  • Cuando el acceso es muy selectivo en una colección muy grande, una búsqueda puede devolver menos extractos de los solicitados.