Activating Your First Enterprise Agent in 15 Minutes

1. Overview & Business Value#

Follow this step-by-step tutorial to activate the unified Ashewa AI Suite and verify autonomous agent operations.

Prerequisites & Access Requirements#

• Active SmartERP Enterprise instance on Odoo 19 Community base.
• User assigned to the Administration / Settings group (base.group_system).
• Valid API credentials for Google Gemini Standard or Anthropic Claude.

1. Installing the Unified Ashewa AI Module#

1. Navigate to Apps from the main app switcher.
2. Clear the default Apps filter and search for Ashewa AI.
3. Locate the card titled Ashewa AI (muk_ai) and click Activate.
4. The system automatically installs dependent packages (muk_mcp, muk_ai_skills, smarterp_ai_bridge).

{screenshot:ai-quickstart-apps-install}

2. Configuring API Key Pools#

1. Open Settings → Ashewa AI → AI Providers.
2. Select Google Gemini Provider.
3. Under the API Keys Configuration tab, enter your primary and secondary API keys separated by commas.
4. Set the default conversational model to gemini-3.5-flash and click Save.
5. Click the Test Connection & Quota button to confirm operational status.

{screenshot:ai-quickstart-provider-config}

3. Initiating an Agent Conversation#

1. Click the floating robot icon in the bottom-right corner or the systray AI icon.

2. Select the General Enterprise Assistant or press the microphone icon (.mk_voice) to speak in Amharic or English:

   "Show me total unposted vendor bills for October 2026."

3. The agent invokes the account_invoice_search tool, aggregates the data, and returns formatted markdown with links directly to the ledger records.

{screenshot:ai-quickstart-chat-interaction}

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:30-quick-start-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:30-quick-start-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#