Shift Optimization & Automated Workforce Rostering Agent
Mathematical shift scheduling copilot balancing employee availability, labor law restrictions, and operational demand peaks.
1. Overview & Business Value#
The Shift Optimization Agent automates complex multi-shift rostering for 24/7 manufacturing plants, healthcare clinics, and retail stores.
1. Overview & Statutory Constraints#
The optimizer enforces Ethiopian Labour Proclamation No. 1156/2019 rules:
- Maximum 8 hours per normal working day (48 hours per week).
- Mandatory minimum 24 consecutive hours of weekly rest.
- Overtime limits (maximum 2 hours per day, 20 hours per month).
{screenshot:ai-shift-optimization-gantt}
2. Step-by-Step Execution Workflow#
- Open Planning → Rostering → AI Shift Generator.
- Specify the scheduling window (e.g., Next Month).
- Click Solve Shift Optimization. The constraint solver assigns qualified personnel to required shift slots.
- Review warnings (highlighted in red for overtime limit risks) and click Publish Schedule.
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#
- Log into your SmartERP instance at
https://smarterp.et/odoo. - Open the main App Switcher and select Ashewa AI.
- Select the operational workspace corresponding to this agent suite.
{screenshot:58-shift-optimization-and-rostering-agent-step1-navigation}
Step 2: Executing Agent Actions#
- Review agent prompts and execution parameters.
- Trigger the scheduled or on-demand workflow action.
- Validate output in the generated operational log.
{screenshot:58-shift-optimization-and-rostering-agent-step2-execution}
4. Advanced Configuration Points#
- Scheduled Crons:
muk_ai.ir_cron_agent_health_checkruns 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#
| Symptom / Error | Probable Root Cause | Resolution Action |
|---|---|---|
Agent unresponsive or timeout | Network latency or API endpoint outage. | Verify provider connection in Settings → AI Providers. |
Access Denied during agent execution | User lacks assigned operational permissions. | Assign user to the designated operational group. |
Last updated: 2026-10-30