Agent Autonomy Tiers, Multi-Key Pooling, and Thought Signatures
የሂሳብ መሰረቶች፣ የ5-ደረጃ የራስ ገዝ ምደባ፣ ተለዋዋጭ የኤፒአይ ቁልፍ ማሰባሰብ እና የምስጢራዊ የሃሳብ ፊርማ ማረጋገጫ።
1. Overview & Business Value#
SmartERP የአይአይ ወኪል ባህሪን ጥብቅ ባለ አምስት ደረጃ የአሰራር የራስ ገዝ ማትሪክስ በመጠቀም ይደነግጋል፣ ይህም የትኞቹ ውሳኔዎች በራስ-ሰር ሊፈጸሙ እንደሚችሉ እና የትኞቹ ደግሞ ግልጽ የሆነ የሰው ይሁንታ እንደሚያስፈልጋቸው ሙሉ ግልጽነትን ያረጋግጣል።


1. Five-Tier Autonomy Classification Matrix#
| Tier | Autonomy Level | Permitted Actions | Required Human Intervention | Example Agents |
|---|---|---|---|---|
| Tier 1 | Passive Advisory | መፈለግ፣ ማጠቃለል፣ ረቂቅ ጽሑፍ ማመንጨት፣ ምስላዊ ትንታኔ | ለማንበብ ምንም አያስፈልግም፤ ሁኔታን መለወጥ አይችልም | Awaqi BI Query Copilot, Documentation Assistant |
| Tier 2 | Staged Draft | ረቂቅ መዝገቦችን መፍጠር (state='draft')፣ መስኮችን መሙላት | ለመቀጠል የግዴታ የሰው ግምገማ እና የአዝራር ጠቅታ ያስፈልጋል | Resume Screening Agent, Requisition Generator |
| Tier 3 | Conditional Auto | ዝቅተኛ ስጋት ያላቸውን መዝገቦች አስቀድሞ በተፈቀደ ገደብ መለጠፍ | ከድርጊት በኋላ ግምገማ፤ ባልተለመዱ ሁኔታዎች ላይ ፈጣን ማስጠንቀቂያ | Bank Reconciliation Assistant (under 5,000 ETB) |
| Tier 4 | Autonomous Exec | የዕለት ተዕለት የስራ ፍሰቶችን በጥብቅ ወሰኖች ውስጥ መፈጸም | ወቅታዊ የኋላ ታሪክ ኦዲት ምዝግብ ማስታወሻዎች | Shift Scheduler, Predictive Stock Replenishment |
| Tier 5 | Supervised Break-Glass | የአደጋ ጊዜ መለኪያ ማስተካከል፣ የስርዓት መልሶ ማግኛ ቅንጅት | ባለ ሁለት ፈቃድ የምስጢራዊ ቁልፍ ማረጋገጫ | System Recovery Orchestrator |
2. Multi-Key Pooling and 429 Failover Mechanics#
ከፍተኛ ፍሰት ያላቸው ወኪሎች በaddons/muk_ai/providers/google.py ውስጥ የተተገበረውን ተለዋዋጭ ባለአራት-ቁልፍ ዙር-ሮቢን ፑለር ይጠቀማሉ። የላይኛው የኤፒአይ መጨረሻ ነጥብ የHTTP 429 የፍጥነት ገደብ ስህተት ሲመልስ፣ ፑለሩ ቁልፉን ለ60 ሰከንድ ያገለለዋል እና ወዲያውኑ በቅደም ተከተል ቀጣዩን ጤናማ ቁልፍ በመጠቀም እንደገና ይሞክራል፡
$$\text{ActiveKey} = \text{Keys}[(\text{Counter} \bmod N)]$$
Request ──> [Key Selector] ──> Key A (200 OK) ──> Return Response
Key B (429 Rate Limit) ──> Cooldown 60s
└──> Failover ──> Key C (200 OK)
3. Cryptographic Thought Signatures#
ለውስብስብ ባለብዙ-ዙር አመክንዮ እና የመሳሪያ ጥሪ፣ የGemini 3.x እና Claude ወኪሎች ቆራጥ የሆኑ የምስጢራዊ አስተሳሰብ ፊርማዎችን (thoughtSignature) ያመነጫሉ። እነዚህ ፊርማዎች የመሳሪያ ጥሪዎች በተቀነባበረ የመለኪያ መርፌ ሳይሆን በቀጥታ በሞዴሉ ውስጣዊ የአመክንዮ ሰንሰለት መመረታቸውን ያረጋግጣሉ።
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