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

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 የሚያስፈልጉትን የስርዓት አርክቴክቸር፣ የንግድ የስራ ፍሰቶች፣ የማዋቀሪያ መለኪያዎች እና የአፈጻጸም እርምጃዎችን በዝርዝር ያብራራል።

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

የኤአይ ረዳቶች አጠቃቀም እና የቁጥጥር ዳሽቦርድ

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#

  1. ወደ SmartERP ስርዓት በ https://smarterp.et/odoo ይግቡ።
  2. የዋናውን App Switcher (ከላይ በስተግራ ጥግ ያለውን ፍርግርግ አዶ) ይክፈቱ።
  3. የ AI Workforce መተግበሪያ አዶን ይምረጡ።
  4. ከላይኛው የማውጫ አሞሌ ላይ AI Workforce → Copilots → Active Agents / Interaction History / Governance Queue የሚለውን ይክፈቱ።

Step 2: Creating and Parameterizing Records#

  1. ከላይ በስተግራ የቁጥጥር ፓነል ውስጥ ያለውን New የሚለውን አዝራር ጠቅ ያድርጉ።
  2. በመዝገብ ፎርሙ ውስጥ ያሉትን ግዴታ መስኮች ይሙሉ፡
    • የወኪል ስም እና ሚና (ግዴታ): ልዩ የAI ሚና (የፋይናንስ ኦዲተር ኮፓይለት፣ SCM ኮፓይለት፣ ወዘተ)
    • የታለመው የአሰራር ሞጁል (ግዴታ): የተዋሃደ የ SmartERP ሞጁል (ሂሳብ አያያዝ፣ የሰው ኃይል፣ ክምችት፣ ሽያጭ)
    • የራስ ገዝነት ደረጃ (ግዴታ): ደረጃ 1 ረዳት፣ ደረጃ 2 ቁጥጥር የሚደረግበት፣ ደረጃ 3 ሙሉ በሙሉ ራሱን የቻለ
    • የአስተዳደር በር (ግዴታ): የግዴታ የሰው ማረጋገጫ የሚያስፈልገው የእርምጃ ስጋት ምደባ
  3. እንደ አስፈላጊነቱ አማራጭ የአሰራር መለኪያዎችን እና አካባቢያዊ መለያዎችን ያዋቅሩ፡
    • የአውድ ማሳጠሪያ ገደብ (አማራጭ): ታሪካዊ መልእክቶችን ከማሳጠር በፊት ያለው ከፍተኛ የ LLM ቶከን መስኮት
    • ተለዋጭ የሞዴል መንገድ (አማራጭ): ዋናው አቅራቢ ምላሽ ካልሰጠ ሁለተኛ ደረጃ የ LLM አቅራቢ
    • የዌብሁክ ማረጋገጫ ቶከን (አማራጭ): ለ n8n የስራ ፍሰት ጥሪ ደህንነቱ የተጠበቀ ሚስጥር
  4. መዝገቡን ለማስቀመጥ በመቆጣጠሪያ አሞሌው ውስጥ ያለውን 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#

  1. የተጠቃሚ አውድ አፈጻጸም: የ AI መሳሪያዎች ጥብቅ በሆነ መልኩ የአስጀማሪውን ተጠቃሚ የደህንነት አውድ (self.env) በመጠቀም ይፈጸማሉ፤ ይህም ሁሉንም የመዝገብ-ደረጃ ህጎች (ir.rule) እና የመዳረሻ መብቶችን (ir.model.access) ያከብራል።
  2. ተነባቢ ብቻ ከሚቀይሩ መሳሪያዎች አንጻር: መሳሪያዎች ወደ አስተማማኝ ተነባቢ-ብቻ መጠይቆች (ወዲያውኑ የሚፈጸሙ) እና ውሂብ ወደሚቀይሩ አሰራሮች (ወደ 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 / ExceptionProbable Root CauseCorrective 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