AgentScheduler

Core interface for scheduling agents to run at specified times or intervals.

This interface defines the fundamental operations for scheduling agents, including registering tasks with various scheduling configurations (cron expressions, fixed rates, fixed delays), managing task lifecycle (pause, resume, cancel), and querying scheduled agents.

Implementations can be based on different scheduling frameworks such as:

• Spring TaskScheduler - Lightweight implementation for simple scenarios

• Quartz Scheduler - Enterprise-grade implementation with persistence and clustering

• External schedulers - Integration with distributed scheduling systems (XXL-Job, etc.)

Design Principles:

• Task-centric - Returns ScheduleAgentTask for task lifecycle management

• Framework agnostic - Core interface can be implemented with any scheduling backend

• Extensible - Support for custom scheduling strategies through configuration

• Stateful - Track task execution history, metrics, and current status

Usage Example:

`AgentScheduler scheduler = new XxlJobAgentScheduler(executor);

// Create agent configuration
AgentConfig agentConfig = AgentConfig.builder()
.name("MyAgent")
.model(model)
.toolkit(toolkit)
.sysPrompt("You are a helpful assistant")
.build();

// Create schedule configuration
ScheduleConfig scheduleConfig = ScheduleConfig.builder()
.cron("0 0 8 * * ?")
.build();

// Schedule the agent and get a task handle
ScheduleAgentTask task = scheduler.schedule(agentConfig, scheduleConfig);

// Control the task
task.run(); // Manual execution
task.cancel(); // Cancel scheduling

// Or cancel through scheduler
scheduler.cancel(task.getName());
`