Conecta Odoo con Hermes Agent vía XML-RPC
+ + +Imagina poder preguntarle a un asistente de IA cosas como "¿cuántos clientes tenemos en CRM?" o "crea una orden de venta para el cliente X" y que responda en tiempo real desde tu Odoo. Eso es exactamente lo que permite Hermes Agent conectado a Odoo vía XML-RPC, sin middleware, sin servidores MCP y sin pipelines de n8n. Solo tu agente y tu ERP hablando directamente.
+ +Esta es la primera y más simple de las tres formas de integrar Odoo con Hermes Agent —llamadas directas a la API XML-RPC. Es la ruta más rápida: un salto, un bloque de configuración, y una cosa menos que puede fallar. Para consultas simples, prototipos y demostraciones, es la elección correcta.
+ +Qué vas a construir
+Al final de esta guía tendrás un agente Hermes que puede consultar y manipular datos de tu Odoo en tiempo real usando XML-RPC.
+ +Prerrequisitos
+-
+
- Una instancia de Odoo (Community o Enterprise) con acceso de administrador +
- Hermes Agent instalado. Si aún no lo tienes, sigue la guía de instalación en derez.ai +
- Acceso a la terminal o interfaz de Hermes +
Paso 1 — Generar una clave API de Odoo
+Ve a Ajustes → Usuarios → Técnico en tu Odoo. Selecciona tu usuario y, en la pestaña Claves API, genera una nueva clave. Asígnale un nombre descriptivo como hermes-agent. Copia la clave generada: la necesitarás en el siguiente paso.
Paso 2 — Añadir la conexión a Hermes
+En tu archivo de configuración de Hermes, añade un bloque de conexión Odoo. La estructura básica incluye la URL de tu instancia, el nombre de la base de datos, el usuario y la clave API:
+url: "https://tu-instancia.odoo.com"
+db: "nombre-de-tu-base-de-datos"
+user: "tu@email.com"
+api_key: "tu-clave-api-generada"
+readonly: true
+ El parámetro readonly: true es recomendable si solo quieres realizar consultas. Para operaciones de escritura, cámbialo a false.
Paso 3 — Darle el prompt de conexión a tu agente
+Hermes Agent necesita un prompt que le indique cómo conectarse a tu Odoo. El prompt debe incluir las credenciales y el alcance de las operaciones permitidas. Puedes usar el prompt de ejemplo que encontrarás en la guía completa en derez.ai.
+ +Paso 4 — Iniciar Hermes y verificar
+Inicia Hermes Agent y haz tu primera consulta. Por ejemplo, pregúntale: "¿Cuántos clientes hay en CRM?". Si todo está configurado correctamente, tu agente responderá con el número de registros.
+> ¿Cuántos clientes tenemos en CRM?
+Total: 8 clientes en CRM
+
+ Qué puedes hacer ahora
+Una vez conectado, tu agente puede:
+-
+
- Consultar clientes, productos, pedidos y facturas +
- Crear y actualizar registros en cualquier modelo +
- Ejecutar búsquedas complejas con filtros en múltiples modelos +
- Automatizar tareas rutinarias desde una sola conversación +
Seguridad primero
+La conexión XML-RPC expone tu Odoo directamente al agente. Es importante usar claves API específicas para cada integración, activar readonly cuando sea posible, y limitar el acceso del agente a los modelos estrictamente necesarios.
+ +¿Por qué XML-RPC?
+La vía directa por XML-RPC es el camino más rápido: un salto, un bloque de configuración, una cosa menos que puede fallar. Sin servidores MCP que mantener, sin flujos de n8n que depurar. Para consultas simples, prototipos y experimentación, es la elección correcta. Para integraciones más complejas, puedes explorar los otros dos enfoques (MCP y n8n) en el blog de derez.ai.
+ +Este artículo está basado en la guía original de derez.ai.
+