Ir al contenido
Logotipo de mrdc.tech
mrdc.tech
Guatemalan based, for all the world

Manual de usuario · Inteligencia artificial en Odoo

Asistente de Inteligencia Artificial para Odoo 19

Cómo configurar y usar el módulo MRDC AI Base: agentes conectados a OpenAI, Google Gemini y Anthropic que consultan y modifican los datos de Odoo con herramientas, generan reportes y documentos, envían correos, ejecutan tareas programadas y misiones autónomas, aprenden de una base de conocimiento y se mantienen bajo gobernanza y presupuesto.

Plataforma: Odoo 19 · módulo mrdc_ai_base 19.0.2 Proveedores: OpenAI, Google Gemini, Anthropic, DeepSeek, xAI, Groq, Kimi, Perplexity, Ollama Autor: Rodrigo Contreras — mrdc.tech

1.Cómo usar este manual

Una guía completa para quien va a configurar el asistente, para quien lo va a usar a diario y para quien tiene que responder por lo que la inteligencia artificial hace dentro del ERP.

Este manual documenta el módulo MRDC AI Base (mrdc_ai_base), que integra modelos de lenguaje de OpenAI, Google, Anthropic y otros proveedores dentro de Odoo 19. No es un chat decorativo: el asistente tiene herramientas con las que lee y escribe datos reales de la base de datos, genera reportes y archivos, envía correos, programa trabajos recurrentes y ejecuta misiones largas de varios pasos. Por eso el manual le dedica el mismo espacio a lo que el asistente puede hacer que a cómo se limita, se aprueba y se mide lo que hace.

Está escrito para tres lectores distintos:

  • El administrador de Odoo, que instala el módulo, registra las claves de los proveedores, crea los agentes y define la gobernanza y los presupuestos (capítulos 3 a 9, 33 a 36).
  • El usuario de negocio —gerencia, ventas, contabilidad, compras—, que conversa con sus datos, pide reportes, crea registros desde el chat y recibe los correos automáticos (capítulos 10 a 20 y 26 a 31).
  • El responsable de mejorar al asistente, que cura las pistas de modelo, las recetas, la memoria y la base de conocimiento para que las respuestas sean exactas y baratas (capítulos 21 a 26 y 37 a 39).

Todas las capturas provienen de un ambiente de demostración real —la empresa ficticia Distribuidora El Quetzal, S.A., con ventas, compras, inventario, CRM y contabilidad de 2026— y todas las respuestas del asistente que aparecen son respuestas reales del modelo configurado (GPT-5.4 de OpenAI para el agente principal), obtenidas con las herramientas del módulo sobre esos datos. Los nombres técnicos de campos, herramientas y modelos aparecen en este formato.

Convención importante. En todo el manual, «el agente» es la configuración que define cómo responde la IA (modelo, instrucciones, capacidades, límites); «una herramienta» es una función concreta que el agente puede llamar dentro de Odoo (search_records, send_email, render_report…); «una tarea» es un trabajo que el agente ejecuta solo, según un horario o un evento; y «una misión» es un objetivo grande que el agente planifica y ejecuta paso a paso.

Qué encontrará en cada bloque

Puesta en marcha

Instalación, claves de proveedores, ajustes generales, modelos disponibles y la configuración de los agentes (capítulos 3 a 9).

Uso diario

El panel de chat, las consultas en lenguaje natural, reportes, documentos, registros, correos, navegación y la consulta rápida (capítulos 10 a 20).

Inteligencia curada

Pistas de modelo, recetas, memoria, autoaprendizaje, base de conocimiento y el Centro de hallazgos (capítulos 21 a 26).

Automatización

Tareas programadas, aprobaciones, tareas por evento, KPIs, el caso práctico del reporte semanal y las misiones (capítulos 27 a 33).

Control

Seguridad, costos, automatizaciones internas, resolución de problemas, buenas prácticas y la referencia de herramientas (capítulos 34 a 40).

2.Qué es MRDC AI Base y cómo funciona

Un modelo de lenguaje no sabe nada de su empresa. El módulo le presta ojos y manos dentro de Odoo —con permisos, límites y registro de todo lo que hace.

Un modelo de lenguaje (GPT, Gemini, Claude…) solo sabe conversar. Lo que convierte esa conversación en trabajo útil dentro del ERP es el ciclo de herramientas: el usuario pide algo, el modelo decide qué herramienta necesita, el módulo la ejecuta dentro de Odoo con los permisos del usuario que pregunta, le devuelve el resultado al modelo, y así hasta que el modelo tiene lo suficiente para responder. Una pregunta como «¿cuánto vendimos en julio y a quién?» termina en tres o cuatro llamadas: una para recuperar una receta validada de ventas por período, otra para agrupar pedidos por cliente, y la respuesta final con los números reales y la explicación de cómo se obtuvieron.

Puntos de entrada Panel de chat (systray) Chat de IA a pantalla completa Consulta rápida Tareas programadas · eventos Misiones (deep work) Agente de IA modelo principal · rápido · de respaldo prompt del sistema + contexto memoria · conocimiento · pistas · recetas capacidades · gobernanza · presupuesto ciclo de herramientas (hasta N iteraciones) Proveedores OpenAI · Google Gemini Anthropic · DeepSeek · xAI Groq · Kimi · Perplexity Ollama (local) clave por proveedor en Ajustes ejecuta como el usuario que pregunta Herramientas dentro de Odoo (41) Lectura: modelos, campos, búsqueda, agrupación, conteo, SQL de solo lectura, recetas, pistas, conocimiento, memoria Escritura: crear, actualizar, botones, métodos, acciones de servidor, imagen en registro, hallazgos Salida: reportes, gráficas, documentos, reportes oficiales PDF/XLSX, correo, notificaciones, tareas y misiones Base de datos de Odoo — con los permisos, reglas de registro y compañías del usuario todo queda registrado: mensajes, llamadas a herramientas, tokens, costo, acciones pendientes, ejecuciones
Figura 1. Arquitectura del asistente: los puntos de entrada conversan con un agente, que llama a un proveedor de IA y ejecuta herramientas dentro de Odoo como el usuario que pregunta. Nada sale de Odoo salvo el texto que se envía al proveedor del modelo.

Las piezas, en una frase cada una

PiezaQué esDónde se administra
AgenteLa personalidad y los permisos de la IA: modelo, prompt del sistema, estilo, capacidades habilitadas, modelos de respaldo, presupuesto y gobernanza. Vienen tres de fábrica: MRDC Assistant, Ask AI y Report Generator.MRDC AI → Configuración → Agentes de IA
HerramientaUna función concreta que el agente puede invocar: buscar registros, agrupar, crear, actualizar, generar un reporte, enviar un correo… Se habilitan por bloques con las casillas de capacidades del agente.Capacidades del agente (capítulo 7) y referencia (capítulo 40)
ConversaciónEl hilo entre un usuario y un agente, con sus mensajes, adjuntos, llamadas a herramientas, tokens, costo y retroalimentación.Panel de chat · MRDC AI → Historial
Tarea programadaUn trabajo que el agente ejecuta sin nadie delante: cada N horas/días/semanas/meses o cuando ocurre un evento sobre un modelo. Puede ejecutarse en modo autónomo o dejar sus escrituras y correos en una cola de aprobación.MRDC AI → Tareas programadas · Acciones pendientes
MisiónUn objetivo grande que el agente descompone en un plan de pasos, ejecuta paso a paso con reintentos y notas de trabajo, y cuyas escrituras pueden requerir aprobación.MRDC AI → Misiones
Pista de modeloConocimiento curado sobre un modelo de Odoo: qué campos importan, cuáles no están almacenados, qué trampas hay (IVA incluido, fechas en UTC…).Configuración → Pistas de modelo
RecetaUna consulta SQL u ORM parametrizada, probada y validada por una persona, que el agente prefiere sobre consultas improvisadas.Configuración → Recetas
MemoriaHechos duraderos por usuario, por agente o por conversación: preferencias, decisiones, mapeos. También la memoria y los KPIs de cada tarea.Configuración → Memorias · pestaña Memoria de la tarea
Nota aprendidaLecciones que el agente captura solo del día a día (trampas de datos, mapeos, criterios); nacen sin verificar y un administrador las acepta o las promueve a pista.Configuración → Notas aprendidas
Base de conocimientoTextos, adjuntos (PDF, Word, Excel) y registros de Odoo indexados con embeddings para que el agente cite políticas y procedimientos reales.MRDC AI → Base de conocimiento
HallazgoUna anomalía, riesgo u oportunidad que el agente detecta y registra con números, responsable y fecha límite.MRDC AI → Centro de hallazgos
Precio de modeloCosto por millón de tokens de entrada y salida de cada modelo; con él se calcula el costo de cada mensaje, ejecución y paso, y se vigilan los presupuestos.Configuración → Precios de modelos

El menú de la aplicación

Al instalar el módulo aparece la aplicación MRDC AI con los menús de la figura siguiente. El orden refleja el uso: lo conversacional primero (Chat de IA, Consulta rápida), después la automatización (Misiones, Tareas programadas, Acciones pendientes), el Historial, los dos repositorios de inteligencia (Centro de hallazgos, Base de conocimiento) y, al final, la Configuración.

Menú de la aplicación MRDC AI
Figura 2. La aplicación MRDC AI y su menú: Chat de IA, Consulta rápida, Misiones, Tareas programadas, Acciones pendientes, Historial, Centro de hallazgos, Base de conocimiento y Configuración.
Qué viaja hacia el proveedor de IA. Al proveedor solo se le envía texto: el prompt del sistema, el contexto (memoria, conocimiento, resumen de la conversación), el mensaje del usuario y los resultados de las herramientas que el modelo pidió (recortados a un máximo de caracteres). El proveedor nunca se conecta a la base de datos ni recibe credenciales de Odoo. Las herramientas se ejecutan en el servidor de Odoo con el usuario que conversa, así que la IA no puede ver ni modificar nada que ese usuario no pueda ver ni modificar.

Para seguir leyendo, crea tu cuenta

Quedan 38 capítulos más en este manual. Crea tu cuenta y solicita el acceso: lo aprobamos a mano, normalmente el mismo día.

Ver todos los manuales

Logotipo de mrdc.tech
mrdc.tech
Guatemalan based, for all the world

Manual del Asistente de Inteligencia Artificial para Odoo 19 — módulo MRDC AI Base.
Implementación, soporte y desarrollo a la medida sobre Odoo: facturación electrónica de Guatemala, El Salvador y Panamá, pasarelas de pago, aplicaciones móviles e integraciones con inteligencia artificial.

mrdc.tech · info@mrdc.tech · +502 4288 7385