diff --git a/ai_oca_bridge_chatter/README.rst b/ai_oca_bridge_chatter/README.rst new file mode 100644 index 00000000..bdd2860f --- /dev/null +++ b/ai_oca_bridge_chatter/README.rst @@ -0,0 +1,105 @@ +.. image:: https://odoo-community.org/readme-banner-image + :target: https://odoo-community.org/get-involved?utm_source=readme + :alt: Odoo Community Association + +===================== +Ai Oca Bridge Chatter +===================== + +.. + !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! + !! This file is generated by oca-gen-addon-readme !! + !! changes will be overwritten. !! + !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! + !! source digest: sha256:57dc3cf709469bf2be35d088794b713d47b74b9aa9c9beb7f1f9f2cf088ee9d2 + !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! + +.. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png + :target: https://odoo-community.org/page/development-status + :alt: Beta +.. |badge2| image:: https://img.shields.io/badge/license-AGPL--3-blue.png + :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html + :alt: License: AGPL-3 +.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Fai-lightgray.png?logo=github + :target: https://github.com/OCA/ai/tree/19.0/ai_oca_bridge_chatter + :alt: OCA/ai +.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png + :target: https://translation.odoo-community.org/projects/ai-19-0/ai-19-0-ai_oca_bridge_chatter + :alt: Translate me on Weblate +.. |badge5| image:: https://img.shields.io/badge/runboat-Try%20me-875A7B.png + :target: https://runboat.odoo-community.org/builds?repo=OCA/ai&target_branch=19.0 + :alt: Try me on Runboat + +|badge1| |badge2| |badge3| |badge4| |badge5| + +This module allows usage of LLM chatbots inside Odoo. + +The logic of the chatbot should be defined in an external system like +n8n. + +**Table of contents** + +.. contents:: + :local: + +Configuration +============= + +On your external AI system create a workflow that will receive messages +and will return the call directly. + +Here you can see an `example <./static/description/Chat.json>`__ of +configuration in n8n. + +After that, create a bridge with usage type chatter and payload type +chatter. Then, create a user and assign the bridge to it. + +With this configuration, the user will answer automatically using the +external systema and will be online permanently. It can be used on +livechat without any issues. + +Bug Tracker +=========== + +Bugs are tracked on `GitHub Issues `_. +In case of trouble, please check there if your issue has already been reported. +If you spotted it first, help us to smash it by providing a detailed and welcomed +`feedback `_. + +Do not contact contributors directly about support or help with technical issues. + +Credits +======= + +Authors +------- + +* Dixmit + +Contributors +------------ + +- `Dixmit `__ + + - Enric Tobella + +- `Binhex `__ + + - Adria Hortoneda + +Maintainers +----------- + +This module is maintained by the OCA. + +.. image:: https://odoo-community.org/logo.png + :alt: Odoo Community Association + :target: https://odoo-community.org + +OCA, or the Odoo Community Association, is a nonprofit organization whose +mission is to support the collaborative development of Odoo features and +promote its widespread use. + +This module is part of the `OCA/ai `_ project on GitHub. + +You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute. diff --git a/ai_oca_bridge_chatter/__init__.py b/ai_oca_bridge_chatter/__init__.py new file mode 100644 index 00000000..0650744f --- /dev/null +++ b/ai_oca_bridge_chatter/__init__.py @@ -0,0 +1 @@ +from . import models diff --git a/ai_oca_bridge_chatter/__manifest__.py b/ai_oca_bridge_chatter/__manifest__.py new file mode 100644 index 00000000..33bbd74e --- /dev/null +++ b/ai_oca_bridge_chatter/__manifest__.py @@ -0,0 +1,19 @@ +# Copyright 202 Dixmit +# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl). + +{ + "name": "Ai Oca Bridge Chatter", + "summary": """Integrate a Bridge with a user that will use it on chatter""", + "version": "19.0.2.0.0", + "license": "AGPL-3", + "author": "Dixmit,Odoo Community Association (OCA)", + "website": "https://github.com/OCA/ai", + "depends": [ + "ai_oca_bridge", + ], + "data": [ + "views/res_users.xml", + "views/ai_bridge.xml", + ], + "demo": [], +} diff --git a/ai_oca_bridge_chatter/i18n/ai_oca_bridge_chatter.pot b/ai_oca_bridge_chatter/i18n/ai_oca_bridge_chatter.pot new file mode 100644 index 00000000..90e975d7 --- /dev/null +++ b/ai_oca_bridge_chatter/i18n/ai_oca_bridge_chatter.pot @@ -0,0 +1,84 @@ +# Translation of Odoo Server. +# This file contains the translation of the following modules: +# * ai_oca_bridge_chatter +# +msgid "" +msgstr "" +"Project-Id-Version: Odoo Server 18.0\n" +"Report-Msgid-Bugs-To: \n" +"Last-Translator: \n" +"Language-Team: \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: \n" +"Plural-Forms: \n" + +#. module: ai_oca_bridge_chatter +#: model:ir.model.fields,field_description:ai_oca_bridge_chatter.field_res_users__ai_bridge_id +msgid "AI Bridge" +msgstr "" + +#. module: ai_oca_bridge_chatter +#: model:ir.model,name:ai_oca_bridge_chatter.model_ai_bridge +msgid "Ai Bridge Configuration" +msgstr "" + +#. module: ai_oca_bridge_chatter +#: model:ir.model,name:ai_oca_bridge_chatter.model_ai_bridge_execution +msgid "Ai Execution" +msgstr "" + +#. module: ai_oca_bridge_chatter +#: model:ir.model.fields.selection,name:ai_oca_bridge_chatter.selection__ai_bridge__payload_type__chatter +#: model:ir.model.fields.selection,name:ai_oca_bridge_chatter.selection__ai_bridge__usage__chatter +msgid "Chatter" +msgstr "" + +#. module: ai_oca_bridge_chatter +#: model:ir.model.fields,field_description:ai_oca_bridge_chatter.field_ai_bridge_execution__chatter_user_id +msgid "Chatter User" +msgstr "" + +#. module: ai_oca_bridge_chatter +#: model:ir.model,name:ai_oca_bridge_chatter.model_res_partner +msgid "Contact" +msgstr "" + +#. module: ai_oca_bridge_chatter +#: model:ir.model.fields,help:ai_oca_bridge_chatter.field_ai_bridge__usage +msgid "" +"Defines how this bridge is used. If 'Thread', it will be used in the mail " +"thread context." +msgstr "" + +#. module: ai_oca_bridge_chatter +#: model:ir.model,name:ai_oca_bridge_chatter.model_discuss_channel +msgid "Discussion Channel" +msgstr "" + +#. module: ai_oca_bridge_chatter +#: model:ir.model.fields,field_description:ai_oca_bridge_chatter.field_ai_bridge__payload_type +msgid "Payload Type" +msgstr "" + +#. module: ai_oca_bridge_chatter +#. odoo-python +#: code:addons/ai_oca_bridge_chatter/models/ai_bridge_execution.py:0 +msgid "The message does not belong to any channel." +msgstr "" + +#. module: ai_oca_bridge_chatter +#. odoo-python +#: code:addons/ai_oca_bridge_chatter/models/ai_bridge.py:0 +msgid "The record must be a mail.message instance." +msgstr "" + +#. module: ai_oca_bridge_chatter +#: model:ir.model.fields,field_description:ai_oca_bridge_chatter.field_ai_bridge__usage +msgid "Usage" +msgstr "" + +#. module: ai_oca_bridge_chatter +#: model:ir.model,name:ai_oca_bridge_chatter.model_res_users +msgid "User" +msgstr "" diff --git a/ai_oca_bridge_chatter/i18n/es.po b/ai_oca_bridge_chatter/i18n/es.po new file mode 100644 index 00000000..9cec3c16 --- /dev/null +++ b/ai_oca_bridge_chatter/i18n/es.po @@ -0,0 +1,91 @@ +# Translation of Odoo Server. +# This file contains the translation of the following modules: +# * ai_oca_bridge_chatter +# +msgid "" +msgstr "" +"Project-Id-Version: Odoo Server 16.0\n" +"Report-Msgid-Bugs-To: \n" +"PO-Revision-Date: 2025-08-16 01:25+0000\n" +"Last-Translator: \"Leonardo J. Caballero G.\" \n" +"Language-Team: none\n" +"Language: es\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: \n" +"Plural-Forms: nplurals=2; plural=n != 1;\n" +"X-Generator: Weblate 5.10.4\n" + +#. module: ai_oca_bridge_chatter +#: model:ir.model.fields,field_description:ai_oca_bridge_chatter.field_res_users__ai_bridge_id +msgid "AI Bridge" +msgstr "Puente de IA" + +#. module: ai_oca_bridge_chatter +#: model:ir.model,name:ai_oca_bridge_chatter.model_ai_bridge +msgid "Ai Bridge Configuration" +msgstr "Configuración de puente de IA" + +#. module: ai_oca_bridge_chatter +#: model:ir.model,name:ai_oca_bridge_chatter.model_ai_bridge_execution +msgid "Ai Execution" +msgstr "Ejecución de IA" + +#. module: ai_oca_bridge_chatter +#: model:ir.model.fields.selection,name:ai_oca_bridge_chatter.selection__ai_bridge__payload_type__chatter +#: model:ir.model.fields.selection,name:ai_oca_bridge_chatter.selection__ai_bridge__usage__chatter +msgid "Chatter" +msgstr "Chatter" + +#. module: ai_oca_bridge_chatter +#: model:ir.model.fields,field_description:ai_oca_bridge_chatter.field_ai_bridge_execution__chatter_user_id +msgid "Chatter User" +msgstr "Usuario de Chatter" + +#. module: ai_oca_bridge_chatter +#: model:ir.model,name:ai_oca_bridge_chatter.model_res_partner +msgid "Contact" +msgstr "Contacto" + +#. module: ai_oca_bridge_chatter +#: model:ir.model.fields,help:ai_oca_bridge_chatter.field_ai_bridge__usage +msgid "" +"Defines how this bridge is used. If 'Thread', it will be used in the mail " +"thread context." +msgstr "" +"Define cómo se utiliza este puente. Si es 'Hilo', se usará en el contexto " +"del hilo de correo." + +#. module: ai_oca_bridge_chatter +#: model:ir.model,name:ai_oca_bridge_chatter.model_mail_channel +msgid "Discussion Channel" +msgstr "Canal de discusión" + +#. module: ai_oca_bridge_chatter +#: model:ir.model.fields,field_description:ai_oca_bridge_chatter.field_ai_bridge__payload_type +msgid "Payload Type" +msgstr "Tipo de carga útil" + +#. module: ai_oca_bridge_chatter +#. odoo-python +#: code:addons/ai_oca_bridge_chatter/models/ai_bridge_execution.py:0 +#, python-format +msgid "The message does not belong to any channel." +msgstr "El mensaje no pertenece a ningún canal." + +#. module: ai_oca_bridge_chatter +#. odoo-python +#: code:addons/ai_oca_bridge_chatter/models/ai_bridge.py:0 +#, python-format +msgid "The record must be a mail.message instance." +msgstr "El registro debe ser una instancia de mail.message." + +#. module: ai_oca_bridge_chatter +#: model:ir.model.fields,field_description:ai_oca_bridge_chatter.field_ai_bridge__usage +msgid "Usage" +msgstr "Uso" + +#. module: ai_oca_bridge_chatter +#: model:ir.model,name:ai_oca_bridge_chatter.model_res_users +msgid "User" +msgstr "Usuario" diff --git a/ai_oca_bridge_chatter/i18n/es_VE.po b/ai_oca_bridge_chatter/i18n/es_VE.po new file mode 100644 index 00000000..f40923ed --- /dev/null +++ b/ai_oca_bridge_chatter/i18n/es_VE.po @@ -0,0 +1,91 @@ +# Translation of Odoo Server. +# This file contains the translation of the following modules: +# * ai_oca_bridge_chatter +# +msgid "" +msgstr "" +"Project-Id-Version: Odoo Server 16.0\n" +"Report-Msgid-Bugs-To: \n" +"PO-Revision-Date: 2025-08-16 01:25+0000\n" +"Last-Translator: \"Leonardo J. Caballero G.\" \n" +"Language-Team: none\n" +"Language: es_VE\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: \n" +"Plural-Forms: nplurals=2; plural=n != 1;\n" +"X-Generator: Weblate 5.10.4\n" + +#. module: ai_oca_bridge_chatter +#: model:ir.model.fields,field_description:ai_oca_bridge_chatter.field_res_users__ai_bridge_id +msgid "AI Bridge" +msgstr "Puente de IA" + +#. module: ai_oca_bridge_chatter +#: model:ir.model,name:ai_oca_bridge_chatter.model_ai_bridge +msgid "Ai Bridge Configuration" +msgstr "Configuración de puente de IA" + +#. module: ai_oca_bridge_chatter +#: model:ir.model,name:ai_oca_bridge_chatter.model_ai_bridge_execution +msgid "Ai Execution" +msgstr "Ejecución de IA" + +#. module: ai_oca_bridge_chatter +#: model:ir.model.fields.selection,name:ai_oca_bridge_chatter.selection__ai_bridge__payload_type__chatter +#: model:ir.model.fields.selection,name:ai_oca_bridge_chatter.selection__ai_bridge__usage__chatter +msgid "Chatter" +msgstr "Chatter" + +#. module: ai_oca_bridge_chatter +#: model:ir.model.fields,field_description:ai_oca_bridge_chatter.field_ai_bridge_execution__chatter_user_id +msgid "Chatter User" +msgstr "Usuario de Chatter" + +#. module: ai_oca_bridge_chatter +#: model:ir.model,name:ai_oca_bridge_chatter.model_res_partner +msgid "Contact" +msgstr "Contacto" + +#. module: ai_oca_bridge_chatter +#: model:ir.model.fields,help:ai_oca_bridge_chatter.field_ai_bridge__usage +msgid "" +"Defines how this bridge is used. If 'Thread', it will be used in the mail " +"thread context." +msgstr "" +"Define cómo se utiliza este puente. Si es 'Hilo', se usará en el contexto " +"del hilo de correo." + +#. module: ai_oca_bridge_chatter +#: model:ir.model,name:ai_oca_bridge_chatter.model_mail_channel +msgid "Discussion Channel" +msgstr "Canal de discusión" + +#. module: ai_oca_bridge_chatter +#: model:ir.model.fields,field_description:ai_oca_bridge_chatter.field_ai_bridge__payload_type +msgid "Payload Type" +msgstr "Tipo de carga útil" + +#. module: ai_oca_bridge_chatter +#. odoo-python +#: code:addons/ai_oca_bridge_chatter/models/ai_bridge_execution.py:0 +#, python-format +msgid "The message does not belong to any channel." +msgstr "El mensaje no pertenece a ningún canal." + +#. module: ai_oca_bridge_chatter +#. odoo-python +#: code:addons/ai_oca_bridge_chatter/models/ai_bridge.py:0 +#, python-format +msgid "The record must be a mail.message instance." +msgstr "El registro debe ser una instancia de mail.message." + +#. module: ai_oca_bridge_chatter +#: model:ir.model.fields,field_description:ai_oca_bridge_chatter.field_ai_bridge__usage +msgid "Usage" +msgstr "Uso" + +#. module: ai_oca_bridge_chatter +#: model:ir.model,name:ai_oca_bridge_chatter.model_res_users +msgid "User" +msgstr "Usuario" diff --git a/ai_oca_bridge_chatter/i18n/it.po b/ai_oca_bridge_chatter/i18n/it.po new file mode 100644 index 00000000..10f4e592 --- /dev/null +++ b/ai_oca_bridge_chatter/i18n/it.po @@ -0,0 +1,91 @@ +# Translation of Odoo Server. +# This file contains the translation of the following modules: +# * ai_oca_bridge_chatter +# +msgid "" +msgstr "" +"Project-Id-Version: Odoo Server 16.0\n" +"Report-Msgid-Bugs-To: \n" +"PO-Revision-Date: 2025-07-29 09:25+0000\n" +"Last-Translator: mymage \n" +"Language-Team: none\n" +"Language: it\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: \n" +"Plural-Forms: nplurals=2; plural=n != 1;\n" +"X-Generator: Weblate 5.10.4\n" + +#. module: ai_oca_bridge_chatter +#: model:ir.model.fields,field_description:ai_oca_bridge_chatter.field_res_users__ai_bridge_id +msgid "AI Bridge" +msgstr "Collegamento IA" + +#. module: ai_oca_bridge_chatter +#: model:ir.model,name:ai_oca_bridge_chatter.model_ai_bridge +msgid "Ai Bridge Configuration" +msgstr "Configurazione collegamento IA" + +#. module: ai_oca_bridge_chatter +#: model:ir.model,name:ai_oca_bridge_chatter.model_ai_bridge_execution +msgid "Ai Execution" +msgstr "Esecuzione IA" + +#. module: ai_oca_bridge_chatter +#: model:ir.model.fields.selection,name:ai_oca_bridge_chatter.selection__ai_bridge__payload_type__chatter +#: model:ir.model.fields.selection,name:ai_oca_bridge_chatter.selection__ai_bridge__usage__chatter +msgid "Chatter" +msgstr "Elenco messaggi" + +#. module: ai_oca_bridge_chatter +#: model:ir.model.fields,field_description:ai_oca_bridge_chatter.field_ai_bridge_execution__chatter_user_id +msgid "Chatter User" +msgstr "Utente elenco messaggi" + +#. module: ai_oca_bridge_chatter +#: model:ir.model,name:ai_oca_bridge_chatter.model_res_partner +msgid "Contact" +msgstr "Contatto" + +#. module: ai_oca_bridge_chatter +#: model:ir.model.fields,help:ai_oca_bridge_chatter.field_ai_bridge__usage +msgid "" +"Defines how this bridge is used. If 'Thread', it will be used in the mail " +"thread context." +msgstr "" +"Definisce come viene usato questo collegamento. Se \"Discussione\", verrà " +"usato nel contesto della discussione e-mail." + +#. module: ai_oca_bridge_chatter +#: model:ir.model,name:ai_oca_bridge_chatter.model_mail_channel +msgid "Discussion Channel" +msgstr "Canale discussione" + +#. module: ai_oca_bridge_chatter +#: model:ir.model.fields,field_description:ai_oca_bridge_chatter.field_ai_bridge__payload_type +msgid "Payload Type" +msgstr "Tipo carico" + +#. module: ai_oca_bridge_chatter +#. odoo-python +#: code:addons/ai_oca_bridge_chatter/models/ai_bridge_execution.py:0 +#, python-format +msgid "The message does not belong to any channel." +msgstr "Questo messaggi non appartiene a nessun canale." + +#. module: ai_oca_bridge_chatter +#. odoo-python +#: code:addons/ai_oca_bridge_chatter/models/ai_bridge.py:0 +#, python-format +msgid "The record must be a mail.message instance." +msgstr "Il record deve essere una istanza mail.message." + +#. module: ai_oca_bridge_chatter +#: model:ir.model.fields,field_description:ai_oca_bridge_chatter.field_ai_bridge__usage +msgid "Usage" +msgstr "Uilizzo" + +#. module: ai_oca_bridge_chatter +#: model:ir.model,name:ai_oca_bridge_chatter.model_res_users +msgid "User" +msgstr "Utente" diff --git a/ai_oca_bridge_chatter/i18n/pt_BR.po b/ai_oca_bridge_chatter/i18n/pt_BR.po new file mode 100644 index 00000000..ef68a5fb --- /dev/null +++ b/ai_oca_bridge_chatter/i18n/pt_BR.po @@ -0,0 +1,87 @@ +# Translation of Odoo Server. +# This file contains the translation of the following modules: +# * ai_oca_bridge_chatter +# +msgid "" +msgstr "" +"Project-Id-Version: Odoo Server 16.0\n" +"Report-Msgid-Bugs-To: \n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"Language: pt_BR\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: \n" +"Plural-Forms: nplurals=2; plural=n > 1;\n" + +#. module: ai_oca_bridge_chatter +#: model:ir.model.fields,field_description:ai_oca_bridge_chatter.field_res_users__ai_bridge_id +msgid "AI Bridge" +msgstr "" + +#. module: ai_oca_bridge_chatter +#: model:ir.model,name:ai_oca_bridge_chatter.model_ai_bridge +msgid "Ai Bridge Configuration" +msgstr "" + +#. module: ai_oca_bridge_chatter +#: model:ir.model,name:ai_oca_bridge_chatter.model_ai_bridge_execution +msgid "Ai Execution" +msgstr "" + +#. module: ai_oca_bridge_chatter +#: model:ir.model.fields.selection,name:ai_oca_bridge_chatter.selection__ai_bridge__payload_type__chatter +#: model:ir.model.fields.selection,name:ai_oca_bridge_chatter.selection__ai_bridge__usage__chatter +msgid "Chatter" +msgstr "" + +#. module: ai_oca_bridge_chatter +#: model:ir.model.fields,field_description:ai_oca_bridge_chatter.field_ai_bridge_execution__chatter_user_id +msgid "Chatter User" +msgstr "" + +#. module: ai_oca_bridge_chatter +#: model:ir.model,name:ai_oca_bridge_chatter.model_res_partner +msgid "Contact" +msgstr "" + +#. module: ai_oca_bridge_chatter +#: model:ir.model.fields,help:ai_oca_bridge_chatter.field_ai_bridge__usage +msgid "" +"Defines how this bridge is used. If 'Thread', it will be used in the mail " +"thread context." +msgstr "" + +#. module: ai_oca_bridge_chatter +#: model:ir.model,name:ai_oca_bridge_chatter.model_mail_channel +msgid "Discussion Channel" +msgstr "" + +#. module: ai_oca_bridge_chatter +#: model:ir.model.fields,field_description:ai_oca_bridge_chatter.field_ai_bridge__payload_type +msgid "Payload Type" +msgstr "" + +#. module: ai_oca_bridge_chatter +#. odoo-python +#: code:addons/ai_oca_bridge_chatter/models/ai_bridge_execution.py:0 +#, python-format +msgid "The message does not belong to any channel." +msgstr "" + +#. module: ai_oca_bridge_chatter +#. odoo-python +#: code:addons/ai_oca_bridge_chatter/models/ai_bridge.py:0 +#, python-format +msgid "The record must be a mail.message instance." +msgstr "" + +#. module: ai_oca_bridge_chatter +#: model:ir.model.fields,field_description:ai_oca_bridge_chatter.field_ai_bridge__usage +msgid "Usage" +msgstr "" + +#. module: ai_oca_bridge_chatter +#: model:ir.model,name:ai_oca_bridge_chatter.model_res_users +msgid "User" +msgstr "" diff --git a/ai_oca_bridge_chatter/models/__init__.py b/ai_oca_bridge_chatter/models/__init__.py new file mode 100644 index 00000000..a6b8352c --- /dev/null +++ b/ai_oca_bridge_chatter/models/__init__.py @@ -0,0 +1,5 @@ +from . import ai_bridge +from . import ai_bridge_execution +from . import res_partner +from . import res_users +from . import mail_channel diff --git a/ai_oca_bridge_chatter/models/ai_bridge.py b/ai_oca_bridge_chatter/models/ai_bridge.py new file mode 100644 index 00000000..85e9fee4 --- /dev/null +++ b/ai_oca_bridge_chatter/models/ai_bridge.py @@ -0,0 +1,34 @@ +# Copyright 2025 Dixmit +# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl). + +from odoo import fields, models + + +class AiBridge(models.Model): + _inherit = "ai.bridge" + + usage = fields.Selection( + selection_add=[("chatter", "Chatter")], ondelete={"chatter": "set default"} + ) + payload_type = fields.Selection( + selection_add=[("chatter", "Chatter")], ondelete={"chatter": "set default"} + ) + + def _prepare_payload_chatter(self, record=None, **kwargs): + if not record: + record = self.env["mail.message"].search([], limit=1) + if record._name != "mail.message": + raise ValueError(self.env._("The record must be a mail.message instance.")) + return { + "message": { + "res_id": record.res_id, + "model": record.model, + "body": record.body, + "author_id": record.author_id.id, + "subject": record.subject, + "date": record.date.isoformat(), + "author_name": record.author_id.name, + "attachment_ids": record.attachment_ids.ids, + "parent_id": record.parent_id.id if record.parent_id else False, + } + } diff --git a/ai_oca_bridge_chatter/models/ai_bridge_execution.py b/ai_oca_bridge_chatter/models/ai_bridge_execution.py new file mode 100644 index 00000000..c09e1659 --- /dev/null +++ b/ai_oca_bridge_chatter/models/ai_bridge_execution.py @@ -0,0 +1,44 @@ +# Copyright 2025 Dixmit +# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl). + +from odoo import fields, models + + +class AiBridgeExecution(models.Model): + _inherit = "ai.bridge.execution" + + chatter_user_id = fields.Many2one("res.users", readonly=True) + + def _get_channel(self): + if self.ai_bridge_id.usage == "chatter": + # For chatter usage, we need to get the channel from the message + message = self.env["mail.message"].browse(self.res_id) + if message.model != "discuss.channel": + raise ValueError( + self.env._("The message does not belong to any channel.") + ) + return ( + self.env["discuss.channel"] + .browse(message.res_id) + .with_user(self.chatter_user_id.id) + ) + return super()._get_channel() + + def _process_response_message(self, response): + if self.ai_bridge_id.usage == "chatter": + recipient = ( + self.env["discuss.channel.member"] + .sudo() + .search( + [ + ("partner_id", "=", self.chatter_user_id.partner_id.id), + ("channel_id", "=", self._get_channel().id), + ], + limit=1, + ) + ) + recipient._notify_typing(is_typing=False) + response["author_id"] = self.chatter_user_id.partner_id.id + response["message_type"] = "comment" + + return super()._process_response_message(response) diff --git a/ai_oca_bridge_chatter/models/mail_channel.py b/ai_oca_bridge_chatter/models/mail_channel.py new file mode 100644 index 00000000..74324463 --- /dev/null +++ b/ai_oca_bridge_chatter/models/mail_channel.py @@ -0,0 +1,52 @@ +# Copyright 2025 Dixmit +# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl). + +from odoo import models + + +class MailChannel(models.Model): + _inherit = "discuss.channel" + + def message_post(self, **kwargs): + message = super().message_post(**kwargs) + if message.author_id.user_ids.ai_bridge_id: + # Don't answer AI agents + return message + channel_recipient_ids = self.sudo().channel_member_ids.filtered( + lambda recipient: recipient.partner_id != message.author_id + and recipient.partner_id.user_ids + and recipient.partner_id.user_ids.ai_bridge_id + and self._eligibile_for_ai(message, recipient) + ) + for recipient in channel_recipient_ids: + recipient._notify_typing(is_typing=True) + for user in recipient.partner_id.user_ids: + for bridge in user.ai_bridge_id: + execution = ( + self.env["ai.bridge.execution"] + .sudo() + .create( + { + "ai_bridge_id": bridge.id, + "model_id": self.sudo() + .env.ref("mail.model_mail_message") + .id, + "res_id": message.id, + "chatter_user_id": user.id, + } + ) + ) + execution._execute() + return message + + def _eligibile_for_ai(self, message, recipient): + if len(self.sudo().channel_member_ids) <= 2: + return True + if recipient.partner_id in message.partner_ids: + # If the recipient is already in the message partners, + # it was invoked by the user. + # This will make it work on general channels + return True + # TODO: add more checks to determine if the message is eligible + # for AI processing, like livechat messages. + return False diff --git a/ai_oca_bridge_chatter/models/res_partner.py b/ai_oca_bridge_chatter/models/res_partner.py new file mode 100644 index 00000000..555782b7 --- /dev/null +++ b/ai_oca_bridge_chatter/models/res_partner.py @@ -0,0 +1,21 @@ +# Copyright 2025 Dixmit +# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl). + +from odoo import models + + +class ResPartner(models.Model): + _inherit = "res.partner" + + def _compute_im_status(self): + """ + Override to set im_status to 'online' for partners + that have an associated user with an AI bridge. + It will be shown in general chatter as online. + """ + for record in self.filtered(lambda r: r.user_ids.ai_bridge_id): + record.im_status = "online" + to_process = self.filtered(lambda r: not r.user_ids.ai_bridge_id) + if not to_process: + return + return super(ResPartner, to_process)._compute_im_status() diff --git a/ai_oca_bridge_chatter/models/res_users.py b/ai_oca_bridge_chatter/models/res_users.py new file mode 100644 index 00000000..2d0ec57e --- /dev/null +++ b/ai_oca_bridge_chatter/models/res_users.py @@ -0,0 +1,25 @@ +# Copyright 2025 Dixmit +# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl). + +from odoo import fields, models + + +class ResUsers(models.Model): + _inherit = "res.users" + + ai_bridge_id = fields.Many2one( + "ai.bridge", string="AI Bridge", domain=[("usage", "=", "chatter")] + ) + + def _compute_im_status(self): + """ + Override to set im_status to 'online' for users + that have an associated user with an AI bridge. + Useful for Live chat + """ + for record in self.filtered(lambda r: r.ai_bridge_id): + record.im_status = "online" + to_process = self.filtered(lambda r: not r.ai_bridge_id) + if not to_process: + return + return super(ResUsers, to_process)._compute_im_status() diff --git a/ai_oca_bridge_chatter/pyproject.toml b/ai_oca_bridge_chatter/pyproject.toml new file mode 100644 index 00000000..4231d0cc --- /dev/null +++ b/ai_oca_bridge_chatter/pyproject.toml @@ -0,0 +1,3 @@ +[build-system] +requires = ["whool"] +build-backend = "whool.buildapi" diff --git a/ai_oca_bridge_chatter/readme/CONFIGURE.md b/ai_oca_bridge_chatter/readme/CONFIGURE.md new file mode 100644 index 00000000..887fcbce --- /dev/null +++ b/ai_oca_bridge_chatter/readme/CONFIGURE.md @@ -0,0 +1,9 @@ +On your external AI system create a workflow that will receive messages and will return the call directly. + +Here you can see an [example](./static/description/Chat.json) of configuration in n8n. + +After that, create a bridge with usage type chatter and payload type chatter. +Then, create a user and assign the bridge to it. + +With this configuration, the user will answer automatically using the external systema and will be online permanently. +It can be used on livechat without any issues. diff --git a/ai_oca_bridge_chatter/readme/CONTRIBUTORS.md b/ai_oca_bridge_chatter/readme/CONTRIBUTORS.md new file mode 100644 index 00000000..d8cf7aa5 --- /dev/null +++ b/ai_oca_bridge_chatter/readme/CONTRIBUTORS.md @@ -0,0 +1,7 @@ +- [Dixmit](https://www.dixmit.com) + + - Enric Tobella + +- [Binhex](https://www.binhex.cloud/) + + - Adria Hortoneda diff --git a/ai_oca_bridge_chatter/readme/DESCRIPTION.md b/ai_oca_bridge_chatter/readme/DESCRIPTION.md new file mode 100644 index 00000000..a2c79fa6 --- /dev/null +++ b/ai_oca_bridge_chatter/readme/DESCRIPTION.md @@ -0,0 +1,3 @@ +This module allows usage of LLM chatbots inside Odoo. + +The logic of the chatbot should be defined in an external system like n8n. diff --git a/ai_oca_bridge_chatter/static/description/Chat.json b/ai_oca_bridge_chatter/static/description/Chat.json new file mode 100644 index 00000000..ec3c94a5 --- /dev/null +++ b/ai_oca_bridge_chatter/static/description/Chat.json @@ -0,0 +1,185 @@ +{ + "name": "Chat", + "nodes": [ + { + "parameters": { + "httpMethod": "POST", + "path": "af33e75e-2cb4-4953-903c-4d7ce88aba7d", + "options": {} + }, + "type": "n8n-nodes-base.webhook", + "typeVersion": 2, + "position": [-540, -180], + "id": "604ad5d2-f45f-4f27-8040-392c5cde67de", + "name": "Webhook", + "webhookId": "af33e75e-2cb4-4953-903c-4d7ce88aba7d" + }, + { + "parameters": { + "method": "POST", + "url": "={{ $('Webhook').item.json.body._response_url }}", + "sendBody": true, + "bodyParameters": { + "parameters": [ + { + "name": "body", + "value": "={{ $json.data }}" + } + ] + }, + "options": {} + }, + "type": "n8n-nodes-base.httpRequest", + "typeVersion": 4.2, + "position": [320, -180], + "id": "196baea5-927e-49d7-b888-41a032255eb5", + "name": "HTTP Request", + "alwaysOutputData": false + }, + { + "parameters": { + "promptType": "define", + "text": "={{ $json.data }}", + "options": {} + }, + "type": "@n8n/n8n-nodes-langchain.agent", + "typeVersion": 2, + "position": [-200, -180], + "id": "92dff2e3-eede-4ba3-b494-ddbd3b33d009", + "name": "AI Agent" + }, + { + "parameters": { + "model": "gemma3:1b", + "options": {} + }, + "type": "@n8n/n8n-nodes-langchain.lmChatOllama", + "typeVersion": 1, + "position": [-200, -20], + "id": "4f3c84b0-217b-44dd-9798-f9f3bde0437c", + "name": "Ollama Chat Model", + "credentials": { + "ollamaApi": { + "id": "hjdwBXqKYq7uKQBz", + "name": "Ollama account" + } + } + }, + { + "parameters": { + "html": "={{ $json.body.message.body }}", + "options": {} + }, + "type": "n8n-nodes-base.markdown", + "typeVersion": 1, + "position": [-380, -180], + "id": "870d0777-4943-4f9d-a283-c31bb079f8b6", + "name": "Markdown" + }, + { + "parameters": { + "mode": "markdownToHtml", + "markdown": "={{ $json.output }}", + "options": {} + }, + "type": "n8n-nodes-base.markdown", + "typeVersion": 1, + "position": [160, -180], + "id": "3217e297-6508-47b2-bc67-52810c6512bd", + "name": "Markdown1" + }, + { + "parameters": { + "sessionIdType": "customKey", + "sessionKey": "={{ $json.body._odoo.db }}-{{ $json.body._odoo.db_hash }}-{{ $json.body.message.model }}-{{ $json.body.message.res_id }}" + }, + "type": "@n8n/n8n-nodes-langchain.memoryBufferWindow", + "typeVersion": 1.3, + "position": [-100, -20], + "id": "35174f6e-a121-4db5-be62-86db987bc294", + "name": "Simple Memory" + } + ], + "pinData": { + "Webhook": [] + }, + "connections": { + "Webhook": { + "main": [ + [ + { + "node": "Markdown", + "type": "main", + "index": 0 + } + ] + ] + }, + "Ollama Chat Model": { + "ai_languageModel": [ + [ + { + "node": "AI Agent", + "type": "ai_languageModel", + "index": 0 + } + ] + ] + }, + "AI Agent": { + "main": [ + [ + { + "node": "Markdown1", + "type": "main", + "index": 0 + } + ] + ] + }, + "Markdown": { + "main": [ + [ + { + "node": "AI Agent", + "type": "main", + "index": 0 + } + ] + ] + }, + "Markdown1": { + "main": [ + [ + { + "node": "HTTP Request", + "type": "main", + "index": 0 + } + ] + ] + }, + "Simple Memory": { + "ai_memory": [ + [ + { + "node": "AI Agent", + "type": "ai_memory", + "index": 0 + } + ] + ] + } + }, + "active": true, + "settings": { + "executionOrder": "v1" + }, + "versionId": "539a3987-4bb4-41e2-b37e-26c1d8896779", + "meta": { + "templateCredsSetupCompleted": true, + "instanceId": "853b8a3aa64a88c45a4d2dd4197c75abdf32fa4cca1ff05538d7e4592b457dcb" + }, + "id": "YP8qXDrWacI1QVyu", + "tags": [] +} diff --git a/ai_oca_bridge_chatter/static/description/icon.png b/ai_oca_bridge_chatter/static/description/icon.png new file mode 100644 index 00000000..3a0328b5 Binary files /dev/null and b/ai_oca_bridge_chatter/static/description/icon.png differ diff --git a/ai_oca_bridge_chatter/static/description/index.html b/ai_oca_bridge_chatter/static/description/index.html new file mode 100644 index 00000000..05e36281 --- /dev/null +++ b/ai_oca_bridge_chatter/static/description/index.html @@ -0,0 +1,451 @@ + + + + + +README.rst + + + +
+ + + +Odoo Community Association + +
+

Ai Oca Bridge Chatter

+ +

Beta License: AGPL-3 OCA/ai Translate me on Weblate Try me on Runboat

+

This module allows usage of LLM chatbots inside Odoo.

+

The logic of the chatbot should be defined in an external system like +n8n.

+

Table of contents

+ +
+

Configuration

+

On your external AI system create a workflow that will receive messages +and will return the call directly.

+

Here you can see an example of +configuration in n8n.

+

After that, create a bridge with usage type chatter and payload type +chatter. Then, create a user and assign the bridge to it.

+

With this configuration, the user will answer automatically using the +external systema and will be online permanently. It can be used on +livechat without any issues.

+
+
+

Bug Tracker

+

Bugs are tracked on GitHub Issues. +In case of trouble, please check there if your issue has already been reported. +If you spotted it first, help us to smash it by providing a detailed and welcomed +feedback.

+

Do not contact contributors directly about support or help with technical issues.

+
+
+

Credits

+
+

Authors

+
    +
  • Dixmit
    • +
+
+
+

Contributors

+ +
+
+

Maintainers

+

This module is maintained by the OCA.

+ +Odoo Community Association + +

OCA, or the Odoo Community Association, is a nonprofit organization whose +mission is to support the collaborative development of Odoo features and +promote its widespread use.

+

This module is part of the OCA/ai project on GitHub.

+

You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.

+
+
+
+
+ + diff --git a/ai_oca_bridge_chatter/tests/__init__.py b/ai_oca_bridge_chatter/tests/__init__.py new file mode 100644 index 00000000..cfd9f8d8 --- /dev/null +++ b/ai_oca_bridge_chatter/tests/__init__.py @@ -0,0 +1 @@ +from . import test_chatter diff --git a/ai_oca_bridge_chatter/tests/test_chatter.py b/ai_oca_bridge_chatter/tests/test_chatter.py new file mode 100644 index 00000000..67b4eda1 --- /dev/null +++ b/ai_oca_bridge_chatter/tests/test_chatter.py @@ -0,0 +1,184 @@ +# Copyright 2025 Dixmit +# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl). + +from unittest import mock + +from odoo.tests import common, new_test_user + + +class TestChatter(common.TransactionCase): + @classmethod + def setUpClass(cls): + super().setUpClass() + cls.env = cls.env(context=dict(cls.env.context, mail_create_nosubscribe=True)) + cls.bridge = cls.env["ai.bridge"].create( + { + "name": "Test Bridge", + "model_id": cls.env.ref("base.model_res_partner").id, + "url": "https://example.com/api", + "auth_type": "none", + "usage": "chatter", + "payload_type": "chatter", + "result_kind": "immediate", + # We will use the immediate result_kind to simplify the test + "result_type": "message", + } + ) + cls.ai_user = new_test_user( + cls.env, + login="test-chatter-user", + groups="base.group_user", + ) + cls.ai_user.write({"ai_bridge_id": cls.bridge.id}) + cls.user = new_test_user( + cls.env, + login="test-chatter-user-2", + groups="base.group_user", + ) + cls.chat = ( + cls.env["discuss.channel"] + .with_user(cls.user.id) + .create( + { + "name": "Test Channel", + "channel_type": "chat", + "channel_member_ids": [ + (0, 0, {"partner_id": cls.ai_user.partner_id.id}), + (0, 0, {"partner_id": cls.user.partner_id.id}), + ], + } + ) + ) + cls.channel = cls.env["discuss.channel"].create( + { + "name": "Main Channel", + "channel_type": "channel", + "channel_member_ids": [ + (0, 0, {"partner_id": cls.ai_user.partner_id.id}), + (0, 0, {"partner_id": cls.user.partner_id.id}), + (0, 0, {"partner_id": cls.env.user.partner_id.id}), + ], + } + ) + + def test_user_status(self): + self.assertEqual("online", self.ai_user.partner_id.im_status) + self.assertEqual("offline", self.user.partner_id.im_status) + self.assertEqual("online", self.ai_user.im_status) + self.assertEqual("offline", self.user.im_status) + + def test_chat(self): + """Answer is direct in this case""" + self.assertFalse( + self.env["mail.message"].search( + [("res_id", "=", self.chat.id), ("model", "=", "discuss.channel")] + ), + ) + with mock.patch("requests.post") as mock_post: + mock_post.return_value = mock.Mock( + status_code=200, json=lambda: {"body": "My message"} + ) + self.chat.with_user(self.user.id).message_post( + body="Test message", + ) + mock_post.assert_called_once() + self.assertEqual( + 2, + self.env["mail.message"].search_count( + [("res_id", "=", self.chat.id), ("model", "=", "discuss.channel")] + ), + ) + + def test_channel_not_called(self): + """No AI bridge should be called when the user is not callend in the channel""" + self.assertFalse( + self.env["mail.message"].search( + [("res_id", "=", self.channel.id), ("model", "=", "discuss.channel")] + ), + ) + with mock.patch("requests.post") as mock_post: + mock_post.return_value = mock.Mock( + status_code=200, json=lambda: {"body": "My message"} + ) + self.channel.with_user(self.user.id).message_post( + body="Test message", + ) + mock_post.assert_not_called() + self.assertEqual( + 1, + self.env["mail.message"].search_count( + [("res_id", "=", self.channel.id), ("model", "=", "discuss.channel")] + ), + ) + + def test_channel_called(self): + """Test that AI answers only if they are called in channels""" + self.assertFalse( + self.env["mail.message"].search( + [("res_id", "=", self.channel.id), ("model", "=", "discuss.channel")] + ), + ) + with mock.patch("requests.post") as mock_post: + mock_post.return_value = mock.Mock( + status_code=200, json=lambda: {"body": "My message"} + ) + self.channel.with_user(self.user.id).message_post( + body="Test message", + partner_ids=[self.ai_user.partner_id.id], + ) + mock_post.assert_called_once() + self.assertEqual( + 2, + self.env["mail.message"].search_count( + [("res_id", "=", self.channel.id), ("model", "=", "discuss.channel")] + ), + ) + + def test_channel_multiple_calls(self): + """Test that AI answers might be from multiple users + in the channel at the same time""" + self.assertFalse( + self.env["mail.message"].search( + [("res_id", "=", self.channel.id), ("model", "=", "discuss.channel")] + ), + ) + self.user.ai_bridge_id = self.bridge + with mock.patch("requests.post") as mock_post: + mock_post.return_value = mock.Mock( + status_code=200, json=lambda: {"body": "My message"} + ) + self.channel.message_post( + body="Test message", + partner_ids=[self.ai_user.partner_id.id, self.user.partner_id.id], + ) + mock_post.assert_called() + self.assertEqual( + 3, + self.env["mail.message"].search_count( + [("res_id", "=", self.channel.id), ("model", "=", "discuss.channel")] + ), + ) + + def test_chat_ai_no_answer(self): + """Test that AI does not answer to AI messages""" + self.assertFalse( + self.env["mail.message"].search( + [("res_id", "=", self.channel.id), ("model", "=", "discuss.channel")] + ), + ) + self.user.ai_bridge_id = self.bridge + with mock.patch("requests.post") as mock_post: + mock_post.return_value = mock.Mock( + status_code=200, json=lambda: {"body": "My message"} + ) + self.channel.with_user(self.user.id).message_post( + body="Test message", + partner_ids=[self.ai_user.partner_id.id], + ) + mock_post.assert_not_called() + self.assertEqual( + 1, + self.env["mail.message"].search_count( + [("res_id", "=", self.channel.id), ("model", "=", "discuss.channel")] + ), + ) diff --git a/ai_oca_bridge_chatter/views/ai_bridge.xml b/ai_oca_bridge_chatter/views/ai_bridge.xml new file mode 100644 index 00000000..f5600f58 --- /dev/null +++ b/ai_oca_bridge_chatter/views/ai_bridge.xml @@ -0,0 +1,13 @@ + + + + + diff --git a/ai_oca_bridge_chatter/views/res_users.xml b/ai_oca_bridge_chatter/views/res_users.xml new file mode 100644 index 00000000..4118a19d --- /dev/null +++ b/ai_oca_bridge_chatter/views/res_users.xml @@ -0,0 +1,14 @@ + + + + + res.users + + + + + + + +