Secure API Key Vault, Quota Management, and Rotation
በPostgreSQL ውስጥ የተመሰጠሩ የኤፒአይ ምስክርነቶችን ማስተዳደር፣ የምስጢር ማሽከርከር የስራ መመሪያዎች እና የክፍል ወጪ ድልድል።


1. Overview & Technical Architecture#
ለውጭ የደመና አቅራቢዎች የኤፒአይ ቁልፎች በእረፍት ጊዜ እና በማስታወሻ ውስጥ በAES-256 ምስጠራ ይቀመጣሉ።
1. Key Vault Operations#
- ወደ Settings → Technical → Parameters → System Parameters ይሂዱ።
- የተመሰጠሩ ቁልፎች በቅድመ ቅጥያ
muk_ai.secret.*ምልክት ይደረግባቸዋል። - ቁልፎች በፍጹም በግልጽ ጽሑፍ አይመዘገቡም ወይም በደንበኛ ወገን HTML DOM ዛፎች ውስጥ አይታዩም።
2. Automated Key Rotation Runbook#
በየ90 ቀኑ የደህንነት ክሮን (muk_ai.ir_cron_rotate_api_keys) ዋናውን ቁልፍ ከማስወጣቱ በፊት አዲስ ቁልፎችን ወደ ሁለተኛው የመጠባበቂያ ማስገቢያ እንዲያስገቡ አስተዳዳሪዎችን ያሳስባል።
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