AI Workforce Troubleshooting, Architecture, and Tracing
የ AI Workforce ቴክኒካል አርክቴክቸር፣ የመሳሪያ ጊዜ ማብቂያ መላ ፍለጋ እና የ JSON መሳሪያ ጥሪ ጥገና።
1. Overview & Business Value#
ይህ አጠቃላይ የአሰራር መመሪያ በ SmartERP ውስጥ ለAI Workforce Troubleshooting, Architecture, and Tracing የሚያስፈልጉትን የስርዓት አርክቴክቸር፣ የንግድ የስራ ፍሰቶች፣ የማዋቀሪያ መለኪያዎች እና የአፈጻጸም እርምጃዎችን በዝርዝር ያብራራል።


2. Prerequisites & Security Access Groups#
- የሚያስፈልጉ ሞጁሎች:
ashewa_ai_workforce, ashewa_ai_bridge, smarterp_ai_agents - የደህንነት ቡድኖች:
AI Workforce Operator(ቴክኒካል መለያ፦ashewa_ai.group_ai_operator)AI Systems Administrator(ቴክኒካል መለያ፦ashewa_ai.group_ai_admin)Governance Officer(ቴክኒካል መለያ፦ashewa_ai.group_ai_governance)
- የማስተር ዳታ ጥገኝነቶች: ራሳቸውን ችለው የሚሰሩ የAI ወኪል መገለጫዎች፣ የ n8n የስራ ፍሰት ዌብሁኮች፣ የ LLM ሞዴል መለኪያዎች፣ የጥያቄ አስተዳደር ህጎች እና በሰው ቁጥጥር ስር ያሉ የማጽደቂያ ወረፋዎች።
3. Step-by-Step Configuration & Execution#
Step 1: Navigating to the Module Interface#
- ወደ SmartERP ስርዓት በ
https://smarterp.et/odooይግቡ። - የዋናውን App Switcher (ከላይ በስተግራ ጥግ ያለውን ፍርግርግ አዶ) ይክፈቱ።
- የ AI Workforce መተግበሪያ አዶን ይምረጡ።
- ከላይኛው የማውጫ አሞሌ ላይ AI Workforce → Copilots → Active Agents / Interaction History / Governance Queue የሚለውን ይክፈቱ።
Step 2: Creating and Parameterizing Records#
- ከላይ በስተግራ የቁጥጥር ፓነል ውስጥ ያለውን New የሚለውን አዝራር ጠቅ ያድርጉ።
- በመዝገብ ፎርሙ ውስጥ ያሉትን ግዴታ መስኮች ይሙሉ፡
- የወኪል ስም እና ሚና (ግዴታ): ልዩ የAI ሚና (የፋይናንስ ኦዲተር ኮፓይለት፣ SCM ኮፓይለት፣ ወዘተ)
- የታለመው የአሰራር ሞጁል (ግዴታ): የተዋሃደ የ SmartERP ሞጁል (ሂሳብ አያያዝ፣ የሰው ኃይል፣ ክምችት፣ ሽያጭ)
- የራስ ገዝነት ደረጃ (ግዴታ): ደረጃ 1 ረዳት፣ ደረጃ 2 ቁጥጥር የሚደረግበት፣ ደረጃ 3 ሙሉ በሙሉ ራሱን የቻለ
- የአስተዳደር በር (ግዴታ): የግዴታ የሰው ማረጋገጫ የሚያስፈልገው የእርምጃ ስጋት ምደባ
- እንደ አስፈላጊነቱ አማራጭ የአሰራር መለኪያዎችን እና አካባቢያዊ መለያዎችን ያዋቅሩ፡
- የአውድ ማሳጠሪያ ገደብ (አማራጭ): ታሪካዊ መልእክቶችን ከማሳጠር በፊት ያለው ከፍተኛ የ LLM ቶከን መስኮት
- ተለዋጭ የሞዴል መንገድ (አማራጭ): ዋናው አቅራቢ ምላሽ ካልሰጠ ሁለተኛ ደረጃ የ LLM አቅራቢ
- የዌብሁክ ማረጋገጫ ቶከን (አማራጭ): ለ n8n የስራ ፍሰት ጥሪ ደህንነቱ የተጠበቀ ሚስጥር
- መዝገቡን ለማስቀመጥ በመቆጣጠሪያ አሞሌው ውስጥ ያለውን Save አዶ ጠቅ ያድርጉ።
Step 3: Validating and Processing Transactions#
- የሁኔታ ሽግግሮች: የአሰራር ሁኔታ እድገትን ያከናውኑ (Prompt Ingestion → Reasoning Chain → Action Proposal → Human Gate Approved → Executed)።
- የመዝገብ እና የስርዓት ተፅዕኖ: ራሳቸውን ችለው በሚሰሩ ወኪሎች የሚፈጸሙ የፋይናንስ እና የክምችት ግብይቶች የAI ወኪል መለያን እና የጸዳቂውን ሰው መረጃ የሚያካትት ጥብቅ የኦዲት መዝገብ ያመነጫሉ።
- የኦዲት ማረጋገጫ: የፈጣሪ መለያ፣ የጊዜ ማህተም እና የማይለወጥ የክለሳ ታሪክ በራስ-ሰር መመዝገብ።
Technical Architecture Overview#
SmartERP AI Workforce የተገነባው በ muk_ai፣ muk_mcp እና ashewa_ai_bridge የሞጁል ስነ-ምህዳር ላይ ነው።
Issue 1: Tool Execution Times Out After 60 Seconds#
- ምክንያት: ውስብስብ የዳታቤዝ መጠይቅ ወይም ከባድ የሪፖርት ማመንጨት ከተመሳሳዩ የዌብሁክ ጊዜ ገደብ በላይ ሆኗል።
- መፍትሄ: መሳሪያውን በ n8n በኩል ላልተመሳሰለ አፈጻጸም ያዋቅሩት። ወኪሉ ወዲያውኑ የተግባር ትኬት መለያ ይቀበላል እንዲሁም በተመላሽ ጥሪ ማጠናቀቂያውን ይጠብቃል።
Issue 2: LLM Outputs Malformed JSON Tool Call#
- ምክንያት: ተለዋዋጭ የሞዴል ውጤት ያልተሸሹ የሕብረቁምፊ ቁምፊዎችን አምርቷል።
- መፍትሄ: የ
ashewa_ai_bridgeአውቶማቲክ የ JSON ጥገና ዘዴዎችን ያካትታል። መተንተን ሁለት ጊዜ ካልተሳካ ጥያቄው የሙቀት መጠኑ ወደ0.0በተዘጋጀ ከፍተኛ አቅም ወዳለው ሞዴል በራስ-ሰር ይመራል።
Issue 3: Staged Action Fails With Security Permission Error#
- ምክንያት: የተዘጋጀውን እርምጃ የሚያጸድቀው የሰው ስራ አስኪያጅ በታለመው ሞዴል ላይ አስፈላጊው የደህንነት ቡድን መብቶች የሉትም።
- መፍትሄ: ገምጋሚ ስራ አስኪያጆች በመደበኛ የ Odoo የደህንነት ቡድኖች ውስጥ ተገቢውን የመምሪያ የመጻፍ ፈቃድ እንዳላቸው ያረጋግጡ።
4. Advanced Configuration Points#
- አውቶማቲክ እርምጃዎች እና የታቀዱ ተግባራት (ክሮኖች):
AI Bridge: Heartbeat check for n8n orchestrator nodes(ashewa_ai.ir_cron_heartbeat): የጌትዌይ ግንኙነትን ለማረጋገጥ በየ 10 ደቂቃው ይሰራልAI Governance: Auto-archive cleared approval queue tickets(ashewa_ai.ir_cron_archive_audit): የአስተዳደር መዝገብ አፈጻጸምን ለመጠበቅ በየቀኑ እኩለ ሌሊት ይሰራል
- ብጁ የህትመት አብነቶች እና ሪፖርቶች:
- የAI ወኪል የአሰራር አፈጻጸም የኦዲት ዱካ
- የLLM ቶከን ፍጆታ እና የወጪ ድልድል ሰንጠረዥ
- በሰው ቁጥጥር ስር ያለ የውሳኔ እና የሽረት መዝገብ
- የወኪል የስራ ፍሰት ስህተት እና የመዘግየት ትንተና
- የበርካታ ኩባንያዎች ህጎች: በኩባንያ 1 (
Ashewa Technology Solutions S.C.) ስር የመዝገብ-ደረጃ የደህንነት መነጠል፣ በዋና እና በቅርንጫፍ ህጋዊ አካላት መካከል የሂሳብ መዝገብ መረጃ መፍሰስን ይከላከላል።
5. Comprehensive Troubleshooting Matrix#
| Error Symptom / Exception | Probable Root Cause | Corrective Action / Resolution |
|---|---|---|
Connection Refused: n8n webhook unreachable | የመጨረሻው ነጥብ URL ልክ ያልሆነ ነው፣ የኦርኬስትራተሩ አገልግሎት ከመስመር ውጭ ነው፣ ወይም የአውታረ መረብ ፋየርዎል አግዶታል። | የ n8n አገልግሎት ጤናን ያረጋግጡ እና በ AI Workforce ቅንብሮች ውስጥ የድልድይ URLን ያዘምኑ። |
Token Limit Exceeded: Context window exhausted | የጥያቄው አውድ ከተዋቀረው የሞዴል ከፍተኛ የቶከን ገደብ በላይ ሆኗል። | አውቶማቲክ የአውድ ማሳጠርን ያንቁ እና በወኪል ቅንብሮች ውስጥ የታሪካዊ መልእክቶችን ማቆያ ይቀንሱ። |
Governance Block: High-risk action requires human approval | ወኪሉ ከራስ ገዝነት ገደብ በላይ የፋይናንስ ምዝገባን ወይም የሰነድ ስረዛን ሞክሯል። | በ Human-in-the-Loop የአስተዳደር ወረፋ ውስጥ በመጠባበቅ ላይ ያለውን ግብይት ይገምግሙ እና ያጽድቁ። |
መጨረሻ የተሻሻለው: 2026-11-15