AI Agent Troubleshooting, Error Codes & Operational FAQ
ለአይአይ ወኪል አፈጻጸም ውድቀቶች፣ የፍጥነት ገደብ እና የመሳሪያ ጥሪ ልዩነቶች አጠቃላይ የዲያግኖስቲክ መመሪያ እና የመፍትሄ ማትሪክስ።
1. Overview & Business Value#
ይህ የማጣቀሻ ሰነድ ለSmartERP ራሱን የቻለ የአይአይ ስብስብ የተለመዱ የስህተት ኮዶችን፣ የዲያግኖስቲክ ሂደቶችን እና የመፍትሄ እርምጃዎችን ይሸፍናል።


1. Diagnostic Error Matrix#
| Error Code | Error Description | Root Cause | Resolution Procedure |
|---|---|---|---|
ERR-AI-429 | Upstream Rate Limit Exceeded | ሁሉም የአቅራቢ ኤፒአይ ቁልፎች ኮታ ጨርሰዋል። | የቁልፍ ስብስብ ጤናን ያረጋግጡ፤ በAI Providers ውስጥ የብዙ ቁልፍ ሽክርክሪት ቅንብሮችን ያረጋግጡ። |
ERR-AI-401 | Unauthorized / Invalid Key | የሞዴል ኤፒአይ ቁልፍ ተሰርዟል ወይም ጊዜው አልፎበታል። | በቅንብሮች → Ashewa AI ውስጥ የኤፒአይ ምስክርነቶችን ያዘምኑ። |
ERR-AI-TOOL-01 | Tool Execution Exception | በመሳሪያ ጥሪ ወቅት የORM ገደብ ጥሰት ተከስቷል። | ለመሰረታዊ ሞዴል የተጠቃሚ የደህንነት ቡድን ፈቃዶችን ያረጋግጡ። |
ERR-AI-PARSE-02 | Output Schema Mismatch | ሞዴሉ ከJSON ቅርጸት ይልቅ ያልተዋቀረ ጽሑፍ መመለስ። | የሙቀት መለኪያውን ወደ 0.1 ዝቅ ያድርጉ እና እንደገና ይሞክሩ። |
ERR-AI-STG-LOCK | Staging Queue Concurrency Lock | ሁለት አጽዳቂዎች በአንድ ጊዜ እርምጃ ለመውሰድ እየሞከሩ ነው። | ለመቆለፊያ መለቀቅ 30 ሰከንድ ይጠብቁ ወይም በአስተዳዳሪ ኮንሶል በኩል በግድ ይልቀቁ። |
2. Frequently Asked Questions (FAQ)#
Can agents modify records without human approval?#
በግልጽ በተገለጹ የገንዘብ እና የአሰራር ገደቦች ውስጥ የሚሰሩ የደረጃ 3 እና ደረጃ 4 ወኪሎች ብቻ ግብይቶችን በራስ-ሰር መፈጸም ይችላሉ። ሁሉም የፋይናንስ ልጥፎች እና ከፍተኛ ተጽዕኖ ያላቸው ለውጦች የደረጃ 2 የሰው ይሁንታ (HITL) ማጽደቅ ያስፈልጋቸዋል።
How is data privacy maintained with cloud models?#
SmartERP ጥያቄዎችን ወደ ውጭ ሞዴል አቅራቢዎች ከመላኩ በፊት ሚስጥራዊ የግል መለያዎችን፣ የባንክ ሂሳብ ቁጥሮችን እና ደመወዞችን የሚሸፍን አብሮ የተሰራ የPII መሸፈኛ ፕሮክሲን ያካትታል።
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#
- ወደ SmartERP ስርዓት በ
https://smarterp.et/odooይግቡ። - ዋናውን የመተግበሪያ መቀየሪያ ይክፈቱ እና Ashewa AI የሚለውን ይምረጡ።
- ከዚህ የወኪል ስብስብ ጋር የሚዛመደውን የስራ ቦታ ይምረጡ።
Step 2: Executing Agent Actions#
- የወኪል ጥያቄዎችን እና የአፈጻጸም መለኪያዎችን ይገምግሙ።
- የታቀደውን ወይም በትዕዛዝ የሚከናወነውን የስራ ፍሰት እርምጃ ያስጀምሩ።
- በተፈጠረው የአሰራር ምዝግብ ማስታወሻ ውስጥ ውጤቱን ያረጋግጡ።
4. Advanced Configuration Points#
- የታቀዱ ክሮኖች:
muk_ai.ir_cron_agent_health_checkበየ30 ደቂቃው ይሰራል:: - የበርካታ ኩባንያዎች መነጠል: የበርካታ ኩባንያዎች የመዝገብ ህጎች የወኪሉ አውድ በኩባንያ 1 (
Ashewa Technology Solutions S.C.) ብቻ የተገደበ መሆኑን ያረጋግጣሉ።
5. Comprehensive Troubleshooting Matrix#
| Symptom / Error | Probable Root Cause | Resolution Action |
|---|---|---|
Agent unresponsive or timeout | የአውታረ መረብ መዘግየት ወይም የኤፒአይ መጨረሻ ነጥብ መቋረጥ። | በቅንብሮች → AI Providers ውስጥ የአቅራቢውን ግንኙነት ያረጋግጡ። |
Access Denied during agent execution | ተጠቃሚው የተመደበ የአሰራር ፈቃድ የለውም። | ተጠቃሚውን ለተሰየመው የአሰራር ቡድን ይመድቡ። |
መጨረሻ የተሻሻለው: 2026-11-15