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

Enterprise Prompt Governance, Token Budgets, and Rate Limits

የስርዓት ጥያቄዎችን ማስተዳደር፣ ተቋማዊ የምርት ስም ድምጽን ማስከበር፣ ወርሃዊ የቶከን ኮታዎችን ማዋቀር እና የሞዴል ግብዓቶችን መጠበቅ።

1. Overview & Business Value#

በድርጅት ክፍሎች ውስጥ 47 ራሳቸውን የቻሉ ወኪሎችን ማሰማራት ጥብቅ የጥያቄ አስተዳደር፣ ለእያንዳንዱ ክፍል የቶከን በጀት ገደቦች እና የኦዲት ማስከበርን ይጠይቃል።

የአርቴፊሻል ኢንተለጀንስ የሰው ቁጥጥር (HITL) የስራ ሂደት፤ የትዕዛዝ ትንተና፣ ማቆያ፣ የኃላፊ ማረጋገጫ እና የዳታቤዝ አፈፃፀም።
የSmartERP አርቴፊሻል ኢንተለጀንስ የሰው ቁጥጥር እና ደህንነት ማረጋገጫ ስርዓት።

የኤአይ ረዳቶች አጠቃቀም

1. Overview & Institutional Governance#

የSmartERP የጥያቄዎች መዝገብ (addons/muk_ai/models/prompt.py) በስሪት ቁጥጥር ስር ያሉ የስርዓት መመሪያዎችን ያከማቻል። የስርዓት ጥያቄዎች በተራ ተጠቃሚዎች ሊስተካከሉ አይችሉም። ሁሉም ማሻሻያዎች ከተሰየመ የAI አስተዳደር አስተዳዳሪ ፈቃድ ያስፈልጋቸዋል።

2. Prerequisites & Security Groups#

  • አስፈላጊ ሞጁሎች: muk_ai, smarterp_security
  • የደህንነት ቡድን: Ashewa AI / Manager (የቴክኒክ መለያ፦ muk_ai.group_ai_manager)
  • ጥገኝነቶች: ንቁ የአቅራቢ ውቅሮች እና የክፍል ወጪ ማዕከላት።

3. Step-by-Step Configuration & Execution#

Step 1: Navigating to Prompt Management#

  1. ወደ Settings → Technical → Ashewa AI → System Prompts ይሂዱ።
  2. ኢላማ የተደረገውን ወኪል ይምረጡ (ለምሳሌ Financial Audit Agent)።

Step 2: Parameterizing Token Budgets & Rate Limits#

  1. Maximum Context Tokens ይግለጹ (ለምሳሌ 8192)።
  2. Department Monthly Token Quota ያዘጋጁ (ለምሳሌ 5,000,000 tokens)።
  3. Hard Stop Action ይወስኑ፦ በBlock Execution ወይም በFallback to Flash Lite መካከል ይምረጡ።
  4. የሙቀት መለኪያዎችን ይግለጹ፡
    • ለፋይናንስ እና ህጋዊ ወኪሎች፦ temperature: 0.1 (ተጨባጭ)።
    • ለፈጠራ የግብይት ጸሐፊዎች፦ temperature: 0.7 (ገላጭ)።

Step 3: Enforcing PII Redaction Rules#

ጥያቄዎችን ወደ ውጭ ሞዴል መጨረሻ ነጥቦች ከመላክዎ በፊት የታክስ መለያ ቁጥሮችን (TIN)፣ የባንክ ሂሳብ ቁጥሮችን እና የግል ደመወዝ አሃዞችን ለመደበቅ የAutomatic PII Redactor ማብሪያ/ማጥፊያውን ያንቁ።

4. Advanced Configuration Points#

  • አውቶማቲክ ተግባራት (ክሮኖች):
    • Ashewa AI: Reset Monthly Department Quotas (muk_ai.ir_cron_reset_quotas፣ በእያንዳንዱ ወር 1ኛ ቀን)።
    • Ashewa AI: Audit Prompt Drift (muk_ai.ir_cron_audit_prompts፣ በየሳምንቱ)።
  • የበርካታ ኩባንያዎች መከፋፈል: ኮታዎች በኩባንያ መለያ (res.company) በጥብቅ የተከፋፈሉ ናቸው።

5. Comprehensive Troubleshooting Matrix#

Error SymptomRoot CauseCorrective Action
TokenQuotaExceededError: Monthly budget exhaustedክፍሉ የተመደበለትን የቶከን ድልድል አልፏል።በቅንብሮች → AI Budgets ውስጥ ወርሃዊ ኮታ ይጨምሩ ወይም አውቶማቲክ ወርሃዊ ዳግም ማስጀመርን ይጠብቁ።
PromptInjectionDetected: Prohibited keyword patternየተጠቃሚ ግብዓት የጥያቄ-መርፌ ጥበቃ ደንቦችን አስነስቷል።በashewa.ai.log ውስጥ የጥያቄ ሙከራን ይመርምሩ እና ተጠቃሚውን በግብዓት ተገዢነት ላይ ያስተምሩ።
ModelAuthenticationError: 401 Unauthorizedበአቅራቢው ስብስብ ውስጥ ልክ ያልሆነ ወይም የተሰረዘ የኤፒአይ ቁልፍ።ጊዜው ያለፈበትን ቁልፍ በቅንብሮች → AI Providers → Credentials ውስጥ ያሽከርክሩ።

2. Prerequisites & Security Access Groups#

  • አስፈላጊ ሞጁሎች: muk_ai, muk_mcp, smarterp_ai_suite
  • የደህንነት ቡድን: Ashewa AI / User (የቴክኒክ መለያ፦ muk_ai.group_ai_user)
  • የዋና ዳታ ጥገኝነቶች: የተዋቀሩ የአይአይ አቅራቢ ምስክርነቶች፣ ንቁ የስርዓት ጥያቄዎች እና የክፍል ወጪ ማዕከላት።

3. Step-by-Step UI Execution & Verification#

Step 1: Navigating to the Operational Interface#

  1. ወደ SmartERP ስርዓት በhttps://smarterp.et/odoo ይግቡ።
  2. ዋናውን የመተግበሪያ መቀየሪያ ይክፈቱ እና Ashewa AI የሚለውን ይምረጡ።
  3. ከዚህ የወኪል ስብስብ ጋር የሚዛመደውን የስራ ቦታ ይምረጡ።

Step 2: Executing Agent Actions#

  1. የወኪል ጥያቄዎችን እና የአፈጻጸም መለኪያዎችን ይገምግሙ።
  2. የታቀደውን ወይም በትዕዛዝ የሚከናወነውን የስራ ፍሰት እርምጃ ያስጀምሩ።
  3. በተፈጠረው የአሰራር ምዝግብ ማስታወሻ ውስጥ ውጤቱን ያረጋግጡ።

4. Advanced Configuration Points#

  • የታቀዱ ክሮኖች: muk_ai.ir_cron_agent_health_check በየ30 ደቂቃው ይሰራል::
  • የበርካታ ኩባንያዎች መነጠል: የበርካታ ኩባንያዎች የመዝገብ ህጎች የወኪሉ አውድ በኩባንያ 1 (Ashewa Technology Solutions S.C.) ብቻ የተገደበ መሆኑን ያረጋግጣሉ።

5. Comprehensive Troubleshooting Matrix#

Symptom / ErrorProbable Root CauseResolution Action
Agent unresponsive or timeoutየአውታረ መረብ መዘግየት ወይም የኤፒአይ መጨረሻ ነጥብ መቋረጥ።በቅንብሮች → AI Providers ውስጥ የአቅራቢውን ግንኙነት ያረጋግጡ።
Access Denied during agent executionተጠቃሚው የተመደበ የአሰራር ፈቃድ የለውም።ተጠቃሚውን ለተሰየመው የአሰራር ቡድን ይመድቡ።
መጨረሻ የተሻሻለው: 2026-11-15