የSmartERP መመሪያ የAshewa Technology Solutions መድረክ

Secure API Key Vault, Quota Management, and Rotation

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

የn8n አውቶሜሽን እና የSmartERP አርቴፊሻል ኢንተለጀንስ ድልድይ ስነ-ህንፃ ዲያግራም።
የSmartERP እና n8n የስራ ፍሰት አውቶሜሽን ስነ-ህንፃ።

የኤአይ ሞዴሎች ማሰልጠኛ እና መቆጣጠሪያ

1. Overview & Technical Architecture#

ለውጭ የደመና አቅራቢዎች የኤፒአይ ቁልፎች በእረፍት ጊዜ እና በማስታወሻ ውስጥ በAES-256 ምስጠራ ይቀመጣሉ።

1. Key Vault Operations#

  1. ወደ Settings → Technical → Parameters → System Parameters ይሂዱ።
  2. የተመሰጠሩ ቁልፎች በቅድመ ቅጥያ muk_ai.secret.* ምልክት ይደረግባቸዋል።
  3. ቁልፎች በፍጹም በግልጽ ጽሑፍ አይመዘገቡም ወይም በደንበኛ ወገን 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#

  1. የSmartERP ስርዓትዎን በhttps://smarterp.et/odoo ይክፈቱ።
  2. ወደ Settings → Technical → Ashewa AI → Model Registry ይሂዱ።
  3. ብጁ የሞዴል መገለጫውን ይምረጡ።

Step 2: Testing Endpoint Health & Response Verification#

  1. የRun Diagnostic Health Check አዝራሩን ጠቅ ያድርጉ።
  2. የቶከን ማመንጫ ፍጥነትን (ቶከን/ሰከንድ) እና የመዘግየት መለኪያዎችን ያረጋግጡ።
  3. በዲያግኖስቲክ ኮንሶል ውስጥ የናሙና ምላሹን ይገምግሙ።

4. Advanced Configuration Points#

  • አውቶማቲክ ተግባራት: muk_ai.ir_cron_model_health_monitor በየ15 ደቂቃው ይሰራል::
  • የተከራይ ወሰኖች (Multi-Tenant): የብጁ ሞዴል ማስተካከያ አዳፕተሮች በእያንዳንዱ የተከራይ የውሂብ ጎታ በጥብቅ የተከፋፈሉ ናቸው።

5. Comprehensive Troubleshooting Matrix#

Symptom / ErrorProbable Root CauseResolution Action
Connection refused: Model server unreachableየኢንፈረንስ ዴሞን ቆሟል ወይም ወደቡ በፋየርዎል ታግዷል።የሞዴል አገልግሎቱን እንደገና ያስጀምሩ (systemctl restart vllm) እና የፋየርዎል ደንቦችን ያረጋግጡ።
Token limit exceeded on input promptየግብዓት አውድ የመስኮቱን መጠን አልፏል።በሞዴል መገለጫ ቅንብሮች ውስጥ የአውድ ማሳጠርን ያንቁ።
መጨረሻ የተሻሻለው: 2026-11-15