Quick Start: Connecting and Invoking Custom AI Models
የአካባቢውን የኢንፈረንስ አገልጋይ ለማረጋገጥ፣ የOdoo አያያዥን ለማዋቀር እና የሞዴል ማመንጨትን ለመፈተሽ የ15 ደቂቃ መመሪያ።


1. Overview & Technical Architecture#
በSmartERP ዝርጋታዎ ውስጥ የተቀናጀውን ብጁ ሞዴል ያገናኙ እና ይፈትሹ።
Prerequisites#
- SmartERP instance running on Python 3.12+ and PostgreSQL 16.
- Model service running locally or on network server (e.g.,
http://localhost:11434orhttps://ai.smarterp.et/v1).
1. Verifying Local Model Health#
ተርሚናል ይክፈቱ እና curl በመጠቀም የሞዴል መጨረሻ ነጥብን ያረጋግጡ፡
curl -s http://localhost:11434/api/tags | jq .
smarterp-sovereign:latest በነቃ የሞዴሎች ዝርዝር ውስጥ መታየቱን ያረጋግጡ።
2. Configuring the SmartERP Model Connector#
- እንደ አስተዳዳሪ ወደ SmartERP ይግቡ።
- ወደ Settings → Technical → Ashewa AI → Model Endpoints ይሂዱ።
- New የሚለውን ጠቅ ያድርጉ እና የሚከተሉትን ይሙሉ፡
- Endpoint Name:
Local Sovereign AI Server - Provider Protocol:
Ollama / OpenAI-Compatible REST - Base URL:
http://localhost:11434/v1 - Model Identifier:
smarterp-sovereign:latest
- Endpoint Name:
- Test Endpoint Latency የሚለውን ጠቅ ያድርጉ። ከ350ሚሰ በታች በሆነ የመዘግየት ጊዜ የHTTP 200 ምላሽ መኖሩን ያረጋግጡ።
3. Testing Generation#
ተንሳፋፊውን የአይአይ አቀናባሪ ይክፈቱ፣ Local Sovereign AI Server የሚለውን ይምረጡ እና የሙከራ ጥያቄ ያስገቡ፡
"What are the mandatory tax deductions under Ethiopian Proclamation 979/2016?"
የተዋቀረ እና ህጋዊ መስፈርቶችን ያሟላ ምላሽ ያረጋግጡ።
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 | የግብዓት አውድ የመስኮቱን መጠን አልፏል። | በሞዴል መገለጫ ቅንብሮች ውስጥ የአውድ ማሳጠርን ያንቁ። |
መጨረሻ የተሻሻለው: 2026-11-15