Custom AI Model Architecture & Enterprise Integration
የSmartERP የተቀናጁ ብጁ የአይአይ ሞዴሎች፣ የሞዴል አገልግሎት መሠረተ ልማት እና የተዳቀሉ የደመና-ጫፍ ቶፖሎጂዎች ከፍተኛ ደረጃ አርክቴክቸር።


1. Overview & Technical Architecture#
SmartERP ለአፍሪካ የንግድ ስራዎች፣ ለኢትዮጵያ ህጋዊ ተገዢነት እና በግዕዝ ላይ ለተመሰረተ የብዙ ቋንቋዎች ሂደት ተብለው የተነደፉ ብጁ የድርጅት የአይአይ ሞዴሎችን ያካትታል።
ለኢትዮጵያ የሂሳብ አያያዝ አዋጆች (ለምሳሌ አዋጅ ቁጥር 979/2008) ወይም የንግድ ቃላት (ለምሳሌ ሞዴል 19 GRN፣ ሞዴል 20 SIV፣ የCPO የጨረታ ማስከበሪያ) የጎራ አውድ ከሌላቸው ከተለመዱ የህዝብ ሞዴሎች በተለየ፣ የSmartERP የተቀናጁ ሞዴሎች በተመረጡ የድርጅት የውሂብ ስብስቦች ላይ አስቀድመው የሰለጠኑ እና የተስተካከሉ ናቸው።
Note
Inference Engine vs. Training Pipeline Architecture: SmartERP's native module orchestrates runtime inference, prompt templating, PII sanitization, context window management, and model endpoint health monitoring (via vLLM, Ollama, or REST gateways). Parameter fine-tuning (LoRA / QLoRA) is executed via external offline data engineering pipelines (e.g., PyTorch / Hugging Face on high-performance GPU clusters) using curated datasets, with trained adapter weights subsequently loaded into the inference server.
flowchart LR
subgraph Enterprise ["SmartERP Monorepo Application"]
ORM["Odoo 19 ORM / Models"]
Chat["Floating AI Composer (.mk_voice)"]
Cron["Event Bus & Crons"]
end
subgraph Middleware ["Ashewa AI Bridge Layer"]
Proxy["PII Redaction & Security Gateway"]
Cache["Semantic Response Cache (Redis/PGVector)"]
Router["Dynamic Task Router"]
end
subgraph Inference ["Model Serving Infrastructure"]
Local["On-Premise Sovereign Model (vLLM / Ollama)"]
Cloud["Enterprise Gemini / Claude Endpoint"]
end
ORM --> Proxy
Chat --> Proxy
Cron --> Proxy
Proxy --> Cache
Cache --> Router
Router -->|Confidential / Sovereign| Local
Router -->|High-Reasoning Analytical| Cloud
2. Prerequisites & Infrastructure Requirements#
- የስራ ማስኬጃ አካባቢ (Runtime): Python 3.12+፣ PostgreSQL 16 ከ
pgvectorቅጥያ ጋር። - የደህንነት መዳረሻ ቡድን:
Ashewa AI / Administrator(የቴክኒክ መለያ፦muk_ai.group_ai_manager) - የሃርድዌር ዝርዝር: ቢያንስ 16 ጊባ የስርዓት RAM (ለሲፒዩ ኢንፈረንስ) ወይም NVIDIA ጂፒዩ ከ8+ ጊባ VRAM ጋር።
3. Step-by-Step Configuration & Verification#
Step 1: Navigating to Model Management#
- የSmartERP ስርዓትዎን በ
https://smarterp.et/odooይክፈቱ። - ወደ Settings → Technical → Ashewa AI → Model Registry ይሂዱ።
- ብጁ የሞዴል መገለጫውን ይምረጡ።
Step 2: Testing Endpoint Health & Response Verification#
- የRun Diagnostic Health Check አዝራሩን ጠቅ ያድርጉ።
- የቶከን ማመንጫ ፍጥነትን (ቶከን/ሰከንድ) እና የመዘግየት መለኪያዎችን ያረጋግጡ።
- በዲያግኖስቲክ ኮንሶል ውስጥ የናሙና ምላሹን ይገምግሙ።
4. Advanced Configuration Points#
- አውቶማቲክ ተግባራት:
muk_ai.ir_cron_model_health_monitorበየ15 ደቂቃው ይሰራል:: - የተከራይ ወሰኖች (Multi-Tenant): የብጁ ሞዴል ማስተካከያ አዳፕተሮች በእያንዳንዱ የተከራይ የውሂብ ጎታ በጥብቅ የተከፋፈሉ ናቸው።
5. Comprehensive Troubleshooting Matrix#
| Symptom / Error | Probable Root Cause | Resolution Action |
|---|---|---|
Connection refused: Model server unreachable | የኢንፈረንስ ዴሞን ቆሟል ወይም ወደቡ በፋየርዎል ታግዷል። | የሞዴል አገልግሎቱን እንደገና ያስጀምሩ (systemctl restart vllm) እና የፋየርዎል ደንቦችን ያረጋግጡ። |
Token limit exceeded on input prompt | የግብዓት አውድ የመስኮቱን መጠን አልፏል። | በሞዴል መገለጫ ቅንብሮች ውስጥ የአውድ ማሳጠርን ያንቁ። |