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

Integrate External LLM Providers and Vector RAG

የድብልቅ ክላውድ እና አካባቢያዊ AI አርክቴክቸር፣ የቬክተር RAG እውቀት ማካተት እና የሰነድ ክፋይ።

1. Overview & Business Value#

ይህ አጠቃላይ የአሰራር መመሪያ በ SmartERP ውስጥ ለIntegrate External LLM Providers and Vector RAG የሚያስፈልጉትን የስርዓት አርክቴክቸር፣ የንግድ የስራ ፍሰቶች፣ የማዋቀሪያ መለኪያዎች እና የአፈጻጸም እርምጃዎችን በዝርዝር ያብራራል።

የአርቴፊሻል ኢንተለጀንስ የሰው ቁጥጥር (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 ወኪል መለያን እና የጸዳቂውን ሰው መረጃ የሚያካትት ጥብቅ የኦዲት መዝገብ ያመነጫሉ።
  • የኦዲት ማረጋገጫ: የፈጣሪ መለያ፣ የጊዜ ማህተም እና የማይለወጥ የክለሳ ታሪክ በራስ-ሰር መመዝገብ።

Hybrid Cloud and On-Premise AI Architecture#

SmartERP ለተወሳሰበ ማመዛዘን የክላውድ LLMዎችን ሚስጥራዊ ለሆኑ የአሰራር ሂደቶች ከአካባቢያዊ ሞዴሎች ጋር የሚያጣምር ድብልቅ የማሰማሪያ ሞዴልን ይደግፋል።

Procedure: Setting Up Vector RAG Knowledge Ingestion#

  1. ወደ AI Workforce > Knowledge Base > Collections ይሂዱ።
  2. New Collection የሚለውን ጠቅ ያድርጉ፡ Ethiopian Statutory Tax Proclamations።
  3. የድርጅት የፒዲኤፍ ፖሊሲ መመሪያዎችን እና አዋጆችን ይጫኑ።
  4. SmartERP ሰነዶችን በ 50-ቶከን መደራረብ ወደ 500-ቶከን ክፍሎች ይከፍላል።
  5. መደበኛ የመክተቻ ሞዴሎችን በመጠቀም ኢምቤዲንግስ ይዘጋጃሉ እንዲሁም ወደ ቬክተር ማከማቻው ማውጫ ውስጥ ይገባሉ።
  6. አንድ ወኪል ጥያቄ ሲቀበል፣ የትርጉም ተመሳሳይነት ማዛመድ ትክክለኛውን የህግ አንቀጽ ወደ ማመዛዘኛ አውድ ውስጥ ያስገባል።

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