OdooWiki OCA HUB

AI OCA Bridge

ai_oca_bridge folder_open OCA/ai open_in_new
AI Licencia: AGPL-3

Este módulo se utiliza para crear un puente entre Odoo y otros sistemas de IA como n8n.

Traducción automática al español (DeepSeek) de la descripción original de OCA, que está en inglés.

auto_awesome Qué hace este módulo

Generado por IA a partir del código · Odoo 18.0

Conecta Odoo a sistemas de IA externos (como n8n) configurando puentes que envían datos de registros y reciben respuestas. Los usuarios pueden activar un puente desde el chatter, o hacer que se ejecute automáticamente cuando se crean, actualizan o eliminan registros.

Este módulo permite a los administradores definir "puentes de IA": conexiones a un servicio de IA externo. Cada puente tiene una URL, un método de autenticación (ninguno, usuario/contraseña básico o token) y una elección de qué datos enviar.

  • Payload: o bien ningún payload o el registro seleccionado, limitado a los campos elegidos, con un filtro opcional.
  • Gestión del resultado: nada, publicar un mensaje en el chatter u abrir una acción devuelta por el sistema de IA.
  • Momento de ejecución: inmediato o asíncrono, donde Odoo proporciona al sistema de IA una URL de callback y espera hasta un tiempo de espera máximo.

Los puentes pueden activarse manualmente desde un botón de rayo en el chatter de cualquier registro que tenga puentes configurados para él. También pueden ejecutarse automáticamente al crear, actualizar o eliminar un registro, según el uso elegido. La eliminación se prepara antes de que el registro desaparezca para que los datos aún puedan enviarse.

Cada llamada se registra como una ejecución con su payload, respuesta, estado y cualquier error, visible en el menú AI Bridge (restringido a administradores del sistema). El acceso puede limitarse a grupos de usuarios específicos, y una regla multiempresa mantiene los puentes y las ejecuciones dentro de las empresas permitidas.

Depende de

mail

Menús que añade

AI Bridge
Modelos y campos (5)
  • base · amplía un modelo existente
  • ai.bridge · modelo nuevourl (URL), name, model (Model Name), usage, active, domain (Filter), user_id, model_id (Model), sequence, auth_type (Authentication Type), field_ids, group_ids, auth_token, company_id, description, result_kind, result_type, payload_type, async_timeout, auth_password, auth_username, execution_ids, model_required, sample_payload, execution_count
  • mail.thread · amplía un modelo existenteai_bridge_info
  • ai.bridge.thread · modelo nuevo
  • ai.bridge.execution · modelo nuevoname, error, state, res_id, result, payload, model_id, company_id, payload_txt, ai_bridge_id, expiration_date

Texto generado por IA (DeepSeek) al leer el código de la versión 18.0 en GitHub; puede contener errores, así que verifícalo en el código antes de decidir. Ver el código en GitHub

Disponibilidad por versión

Revisado: 2026-11-03
Confirmado (verificado en repositorio y rama) Estimado (sin verificar) Sin información

Estado de confirmación: 3 confirmadas, 6 sin información de 9 versiones.

terminal Instalación y uso

Documentación de OCA · Odoo 18.0

Como administrador, accede a AI Bridge\AI Bridge.

Crea un nuevo bridge. Define el nombre, el modelo, la url y la configuración.

Para mejorar la vista de la configuración de la IA, utiliza grupos y dominio para establecer mejores filtros.

Configuración de la carga útil

En el sistema externo, recibirás una carga útil POST. Los datos incluidos serán los siguientes:

General

  • _odoo: Datos estándar para identificar la base de datos de Odoo
  • _model: Modelo del objeto relacionado
  • _id: Id del objeto relacionado
  • _response_url: Url a la que llamar con la respuesta en caso de llamadas asíncronas

Carga útil del registro

Añade un nuevo elemento llamado record con todos los campos.

Llamadas asíncronas y síncronas

El nuevo sistema permite llamadas asíncronas y síncronas. Las llamadas asíncronas tienen sentido cuando la tarea a procesar no necesita ser inmediata. Por ejemplo, revisar una factura y dejar un comentario con el resultado. Lo mismo ocurriría con un mensaje de chat. Esperamos que el sistema deje tiempo a la IA para responder y que el usuario de Odoo pueda hacer otras cosas.

Mientras tanto, las llamadas síncronas congelarán el sistema de Odoo y esperarán una respuesta. Esto tiene sentido cuando esperamos algún tipo de retroalimentación por parte del usuario de Odoo. Tiene sentido, cuando abrimos una acción por ejemplo.

En la llamada síncrona, el resultado se procesa cuando el sistema de IA responde en el webhook. Por otro lado, se procesará automáticamente en la llamada síncrona.

Procesamiento del resultado

Con las respuestas del sistema esperamos hacer algo al respecto. Tenemos las siguientes opciones:

Sin procesamiento

En este caso, el resultado no hará nada

Publicar un mensaje

Publicaremos un mensaje en el hilo original del sistema. El hilo se calcula mediante una función, por lo que se puede sobrescribir en módulos futuros. Espera los argumentos de palabra clave de la función message_post.

Acción

Espera lanzar una acción en la interfaz de usuario. Solo tiene sentido en llamadas síncronas.

Espera un elemento action con los siguientes parámetros:

  • action: xmlid de la acción
  • context: Contexto a pasar a la acción (no requerido)
  • res_id: Id del recurso (no requerido)

Utilice el widget del rayo en el chatter para ejecutar las diferentes opciones de IA.

Las opciones se filtrarán según la configuración.

Traducción automática al español (DeepSeek) de la documentación original de OCA; los comandos y el código no se traducen. Sin información verificada en OCA: Instalación.

info

Datos importados de GitHub: esta ficha refleja la última revisión del catálogo, no una consulta en directo. Verifica siempre en la documentación del módulo y en staging antes de instalar en producción.