The Ashewa AI Bridge and ORM Tool Calling
የ Ashewa AI ድልድይ አርክቴክቸር፣ የ JSON Schema መሳሪያ ጥሪ ፕሮቶኮል እና የ ORM ደህንነት ጥበቃ።
1. Overview & Business Value#
ይህ አጠቃላይ የአሰራር መመሪያ በ SmartERP ውስጥ ለThe Ashewa AI Bridge and ORM Tool Calling የሚያስፈልጉትን የስርዓት አርክቴክቸር፣ የንግድ የስራ ፍሰቶች፣ የማዋቀሪያ መለኪያዎች እና የአፈጻጸም እርምጃዎችን በዝርዝር ያብራራል።


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 ወኪል መለያን እና የጸዳቂውን ሰው መረጃ የሚያካትት ጥብቅ የኦዲት መዝገብ ያመነጫሉ።
- የኦዲት ማረጋገጫ: የፈጣሪ መለያ፣ የጊዜ ማህተም እና የማይለወጥ የክለሳ ታሪክ በራስ-ሰር መመዝገብ።
Architecture of the Ashewa AI Bridge#
የ ashewa_ai_bridge ትላልቅ የቋንቋ ሞዴል ማመዛዘኛ ኤፒአይዎችን ከ SmartERP ነገር-ተዛማጅ ካርታ (ORM) አፈጻጸም ጋር የሚያገናኝ ዋናው የ Python ውህደት ንብርብር ነው።
Tool Calling Protocol#
SmartERP ከመደበኛ የ LLM ተግባር ጥሪ ስምምነቶች ጋር ተኳሃኝ የሆኑ ጥብቅ የ JSON Schema መሳሪያ ዝርዝሮችን ይጠቀማል፡
{
"name": "reconcile_bank_statement_line",
"description": "Matches a bank statement line to an open customer invoice or vendor bill.",
"parameters": {
"type": "object",
"properties": {
"statement_line_id": {"type": "integer", "description": "The ID of the account.bank.statement.line"},
"invoice_id": {"type": "integer", "description": "The ID of the matching account.move"},
"confidence": {"type": "number", "description": "Match confidence between 0.0 and 1.0"}
},
"required": ["statement_line_id", "invoice_id"]
}
}
Security Sandboxing and Privilege Escalation Prevention#
- የተጠቃሚ አውድ አፈጻጸም: የ AI መሳሪያዎች ጥብቅ በሆነ መልኩ የአስጀማሪውን ተጠቃሚ የደህንነት አውድ (
self.env) በመጠቀም ይፈጸማሉ፤ ይህም ሁሉንም የመዝገብ-ደረጃ ህጎች (ir.rule) እና የመዳረሻ መብቶችን (ir.model.access) ያከብራል። - ተነባቢ ብቻ ከሚቀይሩ መሳሪያዎች አንጻር: መሳሪያዎች ወደ አስተማማኝ ተነባቢ-ብቻ መጠይቆች (ወዲያውኑ የሚፈጸሙ) እና ውሂብ ወደሚቀይሩ አሰራሮች (ወደ
ashewa.ai.stagingየሚላኩ) ተከፍለዋል።
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