47+ Autonomous AI Agent Fleet & Orchestration Architecture

1. Overview & Business Value#

The SmartERP Autonomous AI Fleet consists of 47 purpose-built cognitive agents distributed across operational domains including Finance, Human Resources, Supply Chain, Commercial Sales, and Executive Strategy.

Unlike generic chatbot overlays, each SmartERP agent is bound to native Open Source Community Association (OCA) and Ashewa enterprise ORM models, enforcing role-based permissions, transactional idempotency, and strict auditability.

flowchart TD
    subgraph Ingress ["Multi-Channel Interaction Layer"]
        UI["OWL Floating & Systray Chat (.mk_voice)"]
        Cron["Automated Crons & Event Triggers"]
        Webhook["n8n Webhook Ingress Engine"]
    end

    subgraph Core ["Orchestration & Governance Plane"]
        Router["Model Router & Multi-Key Pooler"]
        HITL["Human-in-the-Loop Approval Queue (ashewa.ai.staging)"]
        Audit["Immutable Audit Log (ashewa.ai.log)"]
    end

    subgraph Models ["Tiered Model Backends"]
        Claude["Anthropic Claude Sonnet 4.6 (8 High-Reasoning Agents)"]
        GeminiF["Google Gemini 3.5 Flash (22 Analytical Agents)"]
        GeminiL["Google Gemini 3.5 Flash Lite (17 Operational Agents)"]
    end

    subgraph Execution ["SmartERP ORM Execution Plane"]
        Tools["MCP Server & Odoo Tool Registry (muk_mcp)"]
        ORM["Native Models (account, hr, purchase, sale, stock)"]
    end

    UI --> Router
    Cron --> Router
    Webhook --> Router
    Router --> Claude
    Router --> GeminiF
    Router --> GeminiL
    Claude --> Tools
    GeminiF --> Tools
    GeminiL --> Tools
    Tools --> HITL
    HITL --> ORM
    Tools --> Audit

Architectural Tenets#

• Statutory Anchoring: Native integration with Ethiopian proclamations (Proclamation 979/2016 for taxation, Proclamation 1156/2019 for labor laws, and Proclamation 715/2011 for POESSA pension).
• Dual-Engine Model Tiering: Critical compliance and treasury workflows run on Anthropic Claude Sonnet 4.6 with cryptographic thought signatures. Operational workflows execute on 4-key pooled Google Gemini 3.5 Flash.
• Fail-Safe Autonomy: Agents proposing financial disbursements, journal postings, or inventory write-offs must pass through mandatory Maker-Checker Human-in-the-Loop staging queues.

2. Prerequisites & Security Access Groups#

• Required Modules: muk_ai, muk_mcp, smarterp_ai_suite
• Security Group: Ashewa AI / User (Technical ID: muk_ai.group_ai_user)
• Master Data Dependencies: Configured AI provider credentials, active system prompts, and departmental cost centers.

3. Step-by-Step UI Execution & Verification#

Step 1: Navigating to the Operational Interface#

1. Log into your SmartERP instance at https://smarterp.et/odoo.
2. Open the main App Switcher and select Ashewa AI.
3. Select the operational workspace corresponding to this agent suite.

{screenshot:10-overview-step1-navigation}

Step 2: Executing Agent Actions#

1. Review agent prompts and execution parameters.
2. Trigger the scheduled or on-demand workflow action.
3. Validate output in the generated operational log.

{screenshot:10-overview-step2-execution}

4. Advanced Configuration Points#

• Scheduled Crons: muk_ai.ir_cron_agent_health_check runs every 30 minutes.
• Multi-Company Isolation: Multi-company record rules ensure agent context is isolated to Company 1 (Ashewa Technology Solutions S.C.).

5. Comprehensive Troubleshooting Matrix#