Scheduling Agents

Automate your business processes with intelligent agent scheduling. Set up agents to run on schedules, respond to events, or trigger based on external conditions. From simple daily tasks to complex multi-step workflows, mixus scheduling ensures your AI agents work when you need them.

Overview

Agent scheduling in mixus transforms one-time AI interactions into powerful automation workflows. Whether you need daily reports, periodic data analysis, or event-driven responses, the scheduling system provides flexible options to automate your processes while maintaining full control and monitoring.

How Agent Scheduling Works

The scheduling system operates through multiple trigger mechanisms:

Time-Based Scheduling: Run agents at specific times or intervals
Event-Driven Triggers: Activate agents based on external events or data changes
Conditional Logic: Execute agents when specific conditions are met
Workflow Orchestration: Chain multiple agents in complex sequences
Performance Monitoring: Track execution and optimize scheduling
Error Handling: Automatic retry and failure management

Agent scheduling workflow

Image placeholder - To be added

Scheduling Types

Time-Based Scheduling

Fixed Schedule

Run agents at predetermined times with precision:

Fixed Schedule Examples

{
  "daily_report": {
    "schedule_type": "fixed",
    "frequency": "daily",
    "time": "09:00",
    "timezone": "America/New_York",
    "description": "Generate daily performance report",
    "agent_config": {
      "agent_id": "daily_reporter",
      "parameters": {
        "report_date": "today",
        "include_charts": true,
        "recipients": ["management@company.com"]
      }
    }
  },
  "weekly_analysis": {
    "schedule_type": "fixed",
    "frequency": "weekly",
    "day_of_week": "monday",
    "time": "08:00",
    "timezone": "UTC",
    "description": "Weekly market analysis and insights",
    "agent_config": {
      "agent_id": "market_analyzer",
      "parameters": {
        "analysis_period": "last_week",
        "markets": ["technology", "healthcare", "finance"]
      }
    }
  },
  "monthly_summary": {
    "schedule_type": "fixed",
    "frequency": "monthly",
    "day_of_month": 1,
    "time": "07:00",
    "timezone": "UTC",
    "description": "Monthly business summary and metrics",
    "agent_config": {
      "agent_id": "business_summarizer",
      "parameters": {
        "period": "previous_month",
        "detailed": true
      }
    }
  }
}

Interval-Based Scheduling

Run agents at regular intervals for continuous monitoring:

Interval Scheduling Options

⏰ Interval-Based Schedules:

⚡ High Frequency (Real-time Monitoring):
├── 🔄 Every 5 minutes: System health checks
├── 🔄 Every 15 minutes: Price monitoring
├── 🔄 Every 30 minutes: Social media sentiment
└── 🔄 Every hour: Competitor analysis

📊 Medium Frequency (Regular Updates):
├── 🔄 Every 2 hours: News aggregation
├── 🔄 Every 4 hours: Inventory updates
├── 🔄 Every 6 hours: Customer feedback analysis
└── 🔄 Every 12 hours: Performance metrics

📅 Low Frequency (Periodic Reviews):
├── 🔄 Daily: Content curation
├── 🔄 Weekly: Trend analysis
├── 🔄 Monthly: Compliance checks
└── 🔄 Quarterly: Strategic insights

Flexible Scheduling

Dynamic scheduling based on business logic:

Flexible Schedule Configuration

{
  "business_hours_only": {
    "schedule_type": "flexible",
    "conditions": {
      "time_range": {
        "start": "09:00",
        "end": "17:00"
      },
      "days": ["monday", "tuesday", "wednesday", "thursday", "friday"],
      "exclude_holidays": true,
      "timezone": "America/New_York"
    },
    "frequency": "every_2_hours",
    "description": "Customer service monitoring during business hours"
  },
  "market_hours": {
    "schedule_type": "flexible",
    "conditions": {
      "market_open": true,
      "exclude_weekends": true,
      "special_conditions": {
        "earnings_season": "increase_frequency",
        "high_volatility": "enable_alerts"
      }
    },
    "frequency": "every_15_minutes",
    "description": "Trading signal analysis during market hours"
  }
}

Event-Driven Scheduling

External Event Triggers

Respond to events from connected services and systems:

Event Trigger Types

📡 External Event Triggers:

💬 Communication Events:
├── 📧 New email received (specific sender/subject)
├── 💬 Slack message mentions or keywords
├── 📞 Calendar meeting starting/ending
└── 📱 SMS or WhatsApp message received

📊 Business Events:
├── 💰 New sale or transaction completed
├── 👤 Customer support ticket created
├── 📈 KPI threshold crossed (up or down)
├── 🚨 System alert or error detected
└── 📦 Inventory level reached minimum

🌐 External Data Events:
├── 📰 News article matching keywords
├── 📈 Stock price movement beyond threshold
├── 🌡️ Weather condition changes
├── 📊 Market data updates
└── 🔔 Social media mentions or sentiment changes

Data Change Triggers

Activate agents when specific data conditions are met:

Data Trigger Configuration

{
  "sales_threshold_trigger": {
    "trigger_type": "data_change",
    "data_source": "crm_system",
    "conditions": {
      "metric": "daily_sales",
      "operator": "greater_than",
      "threshold": 10000,
      "time_window": "today"
    },
    "agent_action": {
      "agent_id": "celebration_notifier",
      "parameters": {
        "message_type": "achievement",
        "recipients": "sales_team"
      }
    }
  },
  "inventory_alert": {
    "trigger_type": "data_change",
    "data_source": "inventory_system",
    "conditions": {
      "any_product": {
        "stock_level": "less_than",
        "threshold": 10,
        "category": "high_priority"
      }
    },
    "agent_action": {
      "agent_id": "inventory_manager",
      "parameters": {
        "action": "reorder_analysis",
        "urgency": "high"
      }
    }
  }
}

File and Document Triggers

Respond to file uploads, changes, or document processing events:

File-Based Triggers

📁 File Event Triggers:

📤 Upload Events:
├── 📊 New spreadsheet uploaded → Data analysis agent
├── 📝 Contract document added → Legal review agent
├── 📷 Image uploaded → Content processing agent
└── 📄 Report submitted → Approval workflow agent

🔄 File Changes:
├── ✏️ Document edited → Version control agent
├── 🔒 File permissions changed → Security audit agent
├── 📁 Folder structure modified → Organization agent
└── 🗑️ File deleted → Backup verification agent

⚡ Processing Events:
├── ✅ OCR processing completed → Text analysis agent
├── 🔍 Document indexed → Search update agent
├── 🎯 Classification completed → Routing agent
└── 📊 Data extraction finished → Integration agent

Conditional and Advanced Scheduling

Multi-Condition Triggers

Complex logic combining multiple conditions:

Advanced Conditional Scheduling

{
  "complex_market_analysis": {
    "trigger_type": "multi_condition",
    "logic": "AND",
    "conditions": [
      {
        "type": "time",
        "market_hours": true,
        "day_of_week": ["monday", "tuesday", "wednesday", "thursday", "friday"]
      },
      {
        "type": "data",
        "source": "market_data",
        "metric": "volatility_index",
        "operator": "greater_than",
        "value": 20
      },
      {
        "type": "external_event",
        "source": "news_feed",
        "keyword_match": ["earnings", "acquisition", "merger"],
        "sentiment": "significant"
      }
    ],
    "agent_config": {
      "agent_id": "market_event_analyzer",
      "priority": "high",
      "parameters": {
        "analysis_depth": "comprehensive",
        "include_predictions": true
      }
    }
  }
}

Cascading Workflows

Chain multiple agents in sequence with conditional logic:

Workflow Orchestration Example

🔄 Quarterly Report Workflow:

1️⃣ Data Collection Agent (Day 1 of Quarter End)
├── 📊 Gather financial data from accounting system
├── 📈 Collect sales metrics from CRM
├── 👥 Retrieve HR data for headcount/productivity
└── ✅ Trigger next step when all data collected

2️⃣ Analysis Agent (Triggered by Step 1 Completion)
├── 📊 Perform financial analysis and calculations
├── 📈 Generate trend comparisons with previous quarters
├── 🎯 Identify key insights and recommendations
└── ✅ Trigger report generation when analysis complete

3️⃣ Report Generation Agent (Triggered by Step 2)
├── 📝 Create executive summary document
├── 📊 Generate charts and visualizations
├── 📧 Format for different stakeholder groups
└── ✅ Trigger distribution when report ready

4️⃣ Distribution Agent (Triggered by Step 3)
├── 📧 Send to board members and executives
├── 📱 Post summary to internal communication channels
├── 📁 Archive in document management system
└── 📊 Track delivery and engagement metrics

Schedule Management

Schedule Configuration

Visual Schedule Builder

Intuitive interface for creating complex schedules:

Schedule Builder Interface

🎛️ Visual Schedule Configuration:

📅 Calendar View:
├── 📊 Drag-and-drop schedule creation
├── 🔄 Visual repeat pattern selection
├── ⚠️ Conflict detection and resolution
├── 📈 Capacity planning and load balancing
└── 🎯 Timeline visualization with dependencies

⚙️ Advanced Options:
├── 🌍 Multi-timezone support and coordination
├── 🔄 Holiday and business day handling
├── 📊 Resource allocation and limits
├── 🚨 Error handling and retry policies
└── 📝 Custom notification and alerting rules

🧪 Testing and Simulation:
├── 🔍 Schedule dry-run and validation
├── 📊 Performance impact estimation
├── ⏰ Execution time prediction
└── 🎯 Optimization recommendations

Bulk Schedule Operations

Manage multiple schedules efficiently:

Bulk Schedule Management

{
  "bulk_operations": {
    "create_department_schedules": {
      "operation": "bulk_create",
      "template": "department_reporting_template",
      "departments": ["sales", "marketing", "engineering", "finance"],
      "customizations": {
        "sales": {
          "frequency": "daily",
          "time": "09:00",
          "reports": ["pipeline", "conversion", "forecast"]
        },
        "marketing": {
          "frequency": "weekly",
          "day": "monday",
          "time": "08:00",
          "reports": ["campaigns", "attribution", "leads"]
        }
      }
    },
    "seasonal_adjustments": {
      "operation": "bulk_modify",
      "filter": {
        "tags": ["reporting", "analysis"],
        "frequency": "daily"
      },
      "changes": {
        "holiday_period": {
          "reduce_frequency": true,
          "new_frequency": "weekly",
          "date_range": ["2024-12-20", "2024-01-05"]
        }
      }
    }
  }
}

Monitoring and Analytics

Execution Tracking

Comprehensive monitoring of scheduled agent runs:

Schedule Monitoring Dashboard

📊 Schedule Execution Monitoring:

🎯 Performance Metrics:
├── ✅ Success Rate: 98.7% (last 30 days)
├── ⏱️ Average Execution Time: 2.3 minutes
├── 🔄 On-Time Execution: 99.2%
├── 🚨 Failed Executions: 1.3% (12 of 924)
├── ⏰ Retry Success Rate: 89.1%
└── 📈 Resource Utilization: 67% average

📅 Schedule Health:
├── 🟢 Active Schedules: 45 running normally
├── ⚠️ Warning Schedules: 3 with minor issues
├── 🔴 Failed Schedules: 1 requires attention
├── ⏸️ Paused Schedules: 7 temporarily disabled
└── 📊 Total Executions Today: 127

🚨 Recent Alerts:
├── ⚠️ "Daily Sales Report" - 15 min delay (network issue)
├── 🔴 "Inventory Check" - Failed 3 times (authentication error)
├── 📊 "Market Analysis" - High resource usage detected
└── ✅ "Customer Feedback" - Resumed after temporary pause

Performance Optimization

Automatic optimization of schedule performance:

Performance Optimization Features

⚡ Automatic Performance Optimization:

🔄 Load Balancing:
├── 📊 Intelligent schedule distribution across time slots
├── 🎯 Avoid peak execution periods when possible
├── 📈 Dynamic capacity allocation based on complexity
└── ⚖️ Resource usage balancing across agent types

⏰ Timing Optimization:
├── 🧠 AI-powered optimal execution time suggestions
├── 📊 Historical performance pattern analysis
├── 🔄 Automatic adjustment for improved reliability
└── 🎯 Dependency-aware scheduling to minimize delays

🚨 Proactive Problem Detection:
├── 📈 Trend analysis for performance degradation
├── 🔍 Early warning system for potential failures
├── 🔄 Automatic retry strategy optimization
└── 📊 Resource bottleneck identification and resolution

Advanced Scheduling Features

Multi-Agent Orchestration

Parallel Execution

Run multiple agents simultaneously for efficiency:

Parallel Agent Execution

🔄 Parallel Execution Strategies:

⚡ Independent Parallel Tasks:
├── 📊 Data Collection: CRM, Marketing, Finance (simultaneous)
├── 🔍 Analysis Tasks: Multiple market segments (parallel)
├── 📧 Notifications: Different stakeholder groups (concurrent)
└── 🧹 Maintenance: System cleanup tasks (simultaneous)

🎯 Coordinated Parallel Workflows:
├── 📊 Phase 1: Data gathering agents (all start together)
├── ⏰ Phase 2: Wait for all Phase 1 completion
├── 📈 Phase 3: Analysis agents using combined data
└── 📝 Phase 4: Report generation with all insights

⚖️ Resource-Aware Execution:
├── 🧠 Dynamic parallelism based on system capacity
├── 📊 Priority-based resource allocation
├── 🔄 Automatic scaling and throttling
└── 🎯 SLA-aware execution prioritization

Sequential Dependencies

Manage complex workflows with dependencies:

Dependency Management Example

{
  "customer_lifecycle_workflow": {
    "workflow_type": "sequential_with_conditions",
    "stages": [
      {
        "stage": "lead_qualification",
        "agent": "lead_scorer",
        "success_criteria": {
          "score": "greater_than_70"
        },
        "on_success": "proceed_to_nurturing",
        "on_failure": "assign_to_manual_review"
      },
      {
        "stage": "lead_nurturing",
        "agent": "nurture_automation",
        "dependencies": ["lead_qualification"],
        "conditions": {
          "lead_score": "above_threshold",
          "engagement_level": "sufficient"
        },
        "duration": "7_days",
        "success_criteria": {
          "engagement_increase": "20_percent"
        }
      },
      {
        "stage": "sales_handoff",
        "agent": "sales_coordinator",
        "dependencies": ["lead_nurturing"],
        "conditions": {
          "nurtured_score": "sales_ready",
          "sales_team_capacity": "available"
        },
        "notifications": {
          "sales_rep": "immediate",
          "manager": "daily_summary"
        }
      }
    ]
  }
}

Intelligent Scheduling

AI-Powered Optimization

Machine learning-driven schedule optimization:

AI-Driven Schedule Intelligence

🧠 AI-Powered Schedule Optimization:

📊 Pattern Recognition:
├── 🎯 Optimal execution time prediction based on historical data
├── 📈 Resource demand forecasting for capacity planning
├── 🔄 Failure pattern analysis for proactive prevention
└── ⏰ Performance optimization recommendations

🎯 Adaptive Scheduling:
├── 🧠 Learning from execution success/failure patterns
├── 📊 Dynamic adjustment based on system performance
├── 🔄 Automatic rescheduling for optimal outcomes
└── 📈 Continuous improvement through feedback loops

🚨 Predictive Maintenance:
├── 🔍 Early detection of potential schedule conflicts
├── 📊 Resource exhaustion prediction and prevention
├── ⚡ Automatic failover and backup scheduling
└── 🔄 Proactive optimization before issues occur

Context-Aware Scheduling

Schedules that adapt to business context and external factors:

Context-Aware Configuration

{
  "context_aware_scheduling": {
    "market_analysis_agent": {
      "base_schedule": "every_4_hours_business_days",
      "context_adjustments": {
        "earnings_season": {
          "frequency": "every_hour",
          "priority": "high",
          "additional_data_sources": ["earnings_calendar", "analyst_reports"]
        },
        "market_volatility_high": {
          "frequency": "every_30_minutes",
          "enable_alerts": true,
          "expanded_analysis": true
        },
        "holiday_periods": {
          "frequency": "daily",
          "reduced_scope": true,
          "focus": "international_markets"
        }
      }
    },
    "customer_service_agent": {
      "base_schedule": "continuous_monitoring",
      "context_adjustments": {
        "high_ticket_volume": {
          "increase_capacity": "200_percent",
          "escalation_threshold": "lower",
          "additional_support": "enable"
        },
        "business_hours": {
          "response_time_target": "5_minutes",
          "quality_checks": "enabled"
        },
        "after_hours": {
          "response_time_target": "30_minutes",
          "escalation_only": "urgent_issues"
        }
      }
    }
  }
}

Best Practices

Effective Schedule Design

Start Simple, Scale Gradually

Progressive Scheduling Approach

📈 Schedule Development Strategy:
├── 1️⃣ Begin with basic time-based schedules
├── 2️⃣ Add event triggers for critical processes
├── 3️⃣ Introduce conditional logic for flexibility
├── 4️⃣ Implement multi-agent workflows
├── 5️⃣ Add AI optimization and learning
└── 6️⃣ Scale to organization-wide automation

2. **Design for Reliability**
   ```plaintext Reliability Best Practices
🛡️ Reliability Design Principles:
   ├── 🔄 Implement comprehensive error handling and retries
   ├── 📊 Set up monitoring and alerting for all schedules
   ├── 🔧 Design idempotent operations for safe retries
   ├── ⏰ Use appropriate timeouts and resource limits
   ├── 📝 Maintain detailed logs for troubleshooting
   └── 🧪 Test schedules thoroughly before production deployment

Optimize for Performance

Performance Optimization Guidelines

⚡ Performance Best Practices:
├── 📊 Balance load across time periods to avoid peaks
├── 🎯 Use parallel execution where dependencies allow
├── 📈 Monitor resource usage and optimize accordingly
├── 🔄 Implement intelligent caching for repeated operations
├── 📊 Regular performance reviews and optimization
└── 🧠 Leverage AI recommendations for schedule improvements

## Troubleshooting

### Common Scheduling Issues

#### Schedule Execution Failures
**Problem**: Scheduled agents fail to execute or complete successfully
**Solutions**:
- Check agent configuration and parameter validity
- Verify external service connectivity and authentication
- Review resource availability and system capacity
- Examine error logs for specific failure reasons
- Test agent execution manually to isolate issues

#### Timing and Synchronization Problems
**Problem**: Schedules execute at wrong times or out of sequence
**Solutions**:
- Verify timezone configurations across all systems
- Check for daylight saving time handling
- Review dependency chains and conditional logic
- Validate external trigger configurations
- Monitor system clock synchronization

#### Performance and Resource Issues
**Problem**: Scheduled agents consume excessive resources or run slowly
**Solutions**:
- Review and optimize agent complexity and resource usage
- Implement better load balancing across time periods
- Add resource limits and throttling mechanisms
- Scale infrastructure capacity if consistently overloaded
- Optimize data processing and external API calls

## Related Features

- [Agent Creation](/agents/creating) - Build agents for scheduled automation
- [Agent Running](/agents/running) - Manual agent execution and management
- [Integration Setup](/integrations/setup) - Connect external triggers and data sources

## What's Next?

Ready to automate your workflows with intelligent agent scheduling? Here are your next steps:

1. **[Create your first agent](/agents/creating)** for automated tasks
2. **[Set up external integrations](/integrations/setup)** for triggers and data
3. **[Review agent running guide](/agents/running)** to track performance
4. **[Explore workflow automation](/agents/collaboration)** for complex processes

---

*Need help with advanced scheduling scenarios? Contact our [support team](/support/contact) or check our [agent examples](/agents/examples).*

​Overview

​How Agent Scheduling Works

Agent scheduling workflow

​Scheduling Types

​Time-Based Scheduling

​Fixed Schedule

​Interval-Based Scheduling

​Flexible Scheduling

​Event-Driven Scheduling

​External Event Triggers

​Data Change Triggers

​File and Document Triggers

​Conditional and Advanced Scheduling

​Multi-Condition Triggers

​Cascading Workflows

​Schedule Management

​Schedule Configuration

​Visual Schedule Builder

​Bulk Schedule Operations

​Monitoring and Analytics

​Execution Tracking

​Performance Optimization

​Advanced Scheduling Features

​Multi-Agent Orchestration

​Parallel Execution

​Sequential Dependencies

​Intelligent Scheduling

​AI-Powered Optimization

​Context-Aware Scheduling

​Best Practices

​Effective Schedule Design