Integrate External LLM Providers and Vector RAG
የድብልቅ ክላውድ እና አካባቢያዊ AI አርክቴክቸር፣ የቬክተር RAG እውቀት ማካተት እና የሰነድ ክፋይ።
1. Overview & Business Value#
ይህ አጠቃላይ የአሰራር መመሪያ በ SmartERP ውስጥ ለIntegrate External LLM Providers and Vector RAG የሚያስፈልጉትን የስርዓት አርክቴክቸር፣ የንግድ የስራ ፍሰቶች፣ የማዋቀሪያ መለኪያዎች እና የአፈጻጸም እርምጃዎችን በዝርዝር ያብራራል።


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 ወኪል መለያን እና የጸዳቂውን ሰው መረጃ የሚያካትት ጥብቅ የኦዲት መዝገብ ያመነጫሉ።
- የኦዲት ማረጋገጫ: የፈጣሪ መለያ፣ የጊዜ ማህተም እና የማይለወጥ የክለሳ ታሪክ በራስ-ሰር መመዝገብ።
Hybrid Cloud and On-Premise AI Architecture#
SmartERP ለተወሳሰበ ማመዛዘን የክላውድ LLMዎችን ሚስጥራዊ ለሆኑ የአሰራር ሂደቶች ከአካባቢያዊ ሞዴሎች ጋር የሚያጣምር ድብልቅ የማሰማሪያ ሞዴልን ይደግፋል።
Procedure: Setting Up Vector RAG Knowledge Ingestion#
- ወደ AI Workforce > Knowledge Base > Collections ይሂዱ።
- New Collection የሚለውን ጠቅ ያድርጉ፡
Ethiopian Statutory Tax Proclamations። - የድርጅት የፒዲኤፍ ፖሊሲ መመሪያዎችን እና አዋጆችን ይጫኑ።
- SmartERP ሰነዶችን በ 50-ቶከን መደራረብ ወደ 500-ቶከን ክፍሎች ይከፍላል።
- መደበኛ የመክተቻ ሞዴሎችን በመጠቀም ኢምቤዲንግስ ይዘጋጃሉ እንዲሁም ወደ ቬክተር ማከማቻው ማውጫ ውስጥ ይገባሉ።
- አንድ ወኪል ጥያቄ ሲቀበል፣ የትርጉም ተመሳሳይነት ማዛመድ ትክክለኛውን የህግ አንቀጽ ወደ ማመዛዘኛ አውድ ውስጥ ያስገባል።
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