$ 30.00
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
Discuss (mail)
|
| Lines of code | 466 |
| Technical Name |
ai_chatbot_llama |
| License | OPL-1 |
| Website | https://linkedin.com/in/okky-permana-sihipo |
| Versions | 18.0 19.0 |
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
Discuss (mail)
|
| Lines of code | 466 |
| Technical Name |
ai_chatbot_llama |
| License | OPL-1 |
| Website | https://linkedin.com/in/okky-permana-sihipo |
| Versions | 18.0 19.0 |
Buku Panduan Teknis: AI OdooBot Chatbot
Membongkar arsitektur penyadapan chat OdooBot, kompilasi metadata konteks, mesin inferensi hybrid, evaluasi kode sandboxed AST, dan unit testing ringan.
Penyadapan Pesan
Bagaimana OdooBot mewarisi modul mail.bot untuk mendeteksi direct message dan ping, menyaring command, dan mengirim teks bersih ke LLM.
Sandboxing AST
Mempelajari cara asisten memvalidasi pohon sintaksis (Abstract Syntax Tree) Python untuk memblokir import berbahaya dan fungsi built-in terlarang.
Inference Hybrid
Mengulas deteksi otomatis jalur file GGUF lokal versus remote endpoint API (Ollama) lengkap dengan penanganan drive letter sistem Windows.
ð¬ Hubungi Kami & Layanan Training
Hubungi kami untuk informasi atau menjadwalkan training
Bab 01 Penyadapan Jalur Pesan OdooBot (mail.bot)
Modul chatbot ini memperluas fungsionalitas OdooBot default dengan mewarisi model abstrak mail.bot. Backend mendeteksi jika OdooBot diajak berkomunikasi secara langsung (DM) atau di-ping di dalam saluran diskusi (Discuss):
def _get_answer(self, record, body, values, command=False): # Memeriksa status keaktifan AI ai_enabled = self.env["ir.config_parameter"].sudo().get_param("ai_chatbot_llama.ai_odoobot_enabled", "disabled") if ai_enabled != "enabled": return super()._get_answer(record, body, values, command) odoobot_partner = self.env.ref("base.partner_root") is_dm = record.channel_type == "chat" and odoobot_partner in record.channel_member_ids.partner_id is_pinged = odoobot_partner.id in values.get("partner_ids", []) # Lewatkan AI jika berupa command (/), canned response (:), atau tour if command or body.startswith("/") or body.startswith(":") or _("start the tour") in body.lower(): return super()._get_answer(record, body, values, command)
Bab 02 Sesi & Histori Percakapan (Context Packing)
Agar AI memiliki memori kontekstual terhadap diskusi yang sedang berlangsung, modul mengumpulkan metadata pengguna aktif beserta maksimal 5 pesan terakhir dalam thread diskusi tersebut:
def _get_session_context(self, record, current_message): return { "user_name": self.env.user.name, "user_login": self.env.user.login, "company_name": self.env.company.name, "today": str(date.today()), "history": self._get_chat_history(record, current_message, limit=5) } def _get_chat_history(self, record, current_message, limit=5): # Mengambil comment murni, menyaring tag HTML, dan memformat history messages = record.message_ids.filtered(lambda m: m.message_type == "comment" and m.body) history_lines = [] for msg in reversed(messages[1:limit + 1]): clean_body = re.sub(r"", "", msg.body or "").strip() history_lines.append(f"{msg.author_id.name}: {clean_body}") return "\n".join(history_lines)
Bab 03 Mesin Inferensi Hybrid & Deteksi Endpoint
LLaMA Engine dapat dikonfigurasi menggunakan file biner GGUF lokal maupun remote HTTP API (seperti Ollama). Modul secara dinamis mendeteksi jenis masukan URL, termasuk meloloskan Windows drive letters yang sering salah dideteksi sebagai protokol:
def _is_url(self, path): # Regex memeriksa apakah string mengandung port localhost atau skema HTTP if re.match(r"^[a-zA-Z]:\\", path): # Meloloskan Windows drive letter (misal C:\models) return False if "localhost:" in path or "127.0.0.1:" in path: return True return path.startswith(("http://", "https://"))
Bab 04 Keamanan Eksekusi: AST Sandbox & Proteksi Model
Untuk mengeksekusi script kalkulasi atau ORM buatan LLM, modul mengurai source code ke bentuk Abstract Syntax Tree (AST) untuk memastikan ketiadaan statement berbahaya:
| Area Keamanan | Tindakan Pencegahan AST | Bahaya yang Dihindari |
|---|---|---|
| Statement Impor | Memblokir class node ast.Import dan ast.ImportFrom. |
Injeksi file sistem / pemanggilan compiler eksternal. |
| Fungsi Built-in | Memblokir list keyword: eval, exec, open, getattr, __import__. |
Membaca file rahasia OS atau memodifikasi atribut database. |
| Dunder Attributes | Memblokir semua variabel atau atribut yang diawali/diakhiri __. |
Membongkar class runtime internal (python sandbox escape). |
| Database Blacklist | Memblokir direct ORM query ke res.users, ir.config_parameter, dsb. |
Eksploitasi data credential user / config admin. |
tree = ast.parse(code) for node in ast.walk(tree): if isinstance(node, (ast.Import, ast.ImportFrom)): raise ValueError("AST Security Violation: Python import statements are strictly prohibited.") if isinstance(node, ast.Attribute): if node.attr.startswith("__") or node.attr.endswith("__"): raise ValueError("AST Security Violation: Double underscore attribute access is blocked.")
Bab 05 Parser Format Markdown Ringan
Odoo Discuss memerlukan markup HTML bersih. Teks dari LLM diformat secara instan menggunakan regex untuk membersihkan XSS dan menyusun tata letak bold, italic, dan inline code:
# Mengubah format markdown menjadi tag HTML Odoo escaped_text = html.escape(text) # Proteksi XSS injection escaped_text = re.sub(r"\*\*([^*]+)\*\*", r"\1", escaped_text) escaped_text = re.sub(r"\*([^*]+)\*", r"\1", escaped_text) escaped_text = re.sub(r"`([^`]+)`", r'<code style="...">\1</code>', escaped_text)
Bab 06 Automated Testing & Sandbox Mocking
Pengujian unit test dilakukan secara terisolasi tanpa memakan resource GPU/CPU berat menggunakan mocking (penyamaran API):
conda run -n odoo-18 python odoo-bin -c odoo-apps.conf -d odoo_18ce_apps --test-enable --test-tags=ai_chatbot_llama --stop-after-init
Odoo Proprietary License v1.0 This software and associated files (the "Software") may only be used (executed, modified, executed after modifications) if you have purchased a valid license from the authors, typically via Odoo Apps, or if you have received a written agreement from the authors of the Software (see the COPYRIGHT file). You may develop Odoo modules that use the Software as a library (typically by depending on it, importing it and using its resources), but without copying any source code or material from the Software. You may distribute those modules under the license of your choice, provided that this license is compatible with the terms of the Odoo Proprietary License (For example: LGPL, MIT, or proprietary licenses similar to this one). It is forbidden to publish, distribute, sublicense, or sell copies of the Software or modified copies of the Software. The above copyright notice and this permission notice must be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Please log in to comment on this module