XxlJobAgentScheduler

AgentScheduler implementation based on XXL-Job distributed task scheduling platform.

This scheduler integrates with XXL-Job to provide distributed scheduling capabilities for agents. Jobs are registered as JobHandlers in XXL-Job and can be managed through the XXL-Job admin console.

Key Features:

• Distributed scheduling across multiple executor instances

• Centralized management through XXL-Job admin console

• Support for cron expressions, fixed rate, and manual triggers

• Built-in monitoring and logging

• Fault tolerance and automatic failover

Prerequisites:

• XXL-Job admin server must be running and accessible

• XxlJobExecutor must be properly initialized and started

• Jobs must be configured in XXL-Job admin console with matching JobHandler names

Usage Example:

`// 1. Initialize XXL-Job executor (typically in Spring Boot configuration)
XxlJobExecutor executor = new XxlJobExecutor();
executor.setAdminAddresses("http://localhost:8080/xxl-job-admin");
executor.setAppname("agentscope-executor");
executor.setPort(9999);
executor.start();

// 2. Create scheduler
AgentScheduler scheduler = new XxlJobAgentScheduler(executor);

// 3. Create agent configuration
AgentConfig agentConfig = AgentConfig.builder()
.name("MyAgent")
.description("My scheduled agent")
.agentFactory(() -> ReActAgent.builder()
.name("MyAgent")
.model(model)
.toolkit(toolkit)
.build())
.build();

// 4. Schedule the agent
ScheduleConfig scheduleConfig = ScheduleConfig.builder().build();
ScheduleAgentTask task = scheduler.schedule(agentConfig, scheduleConfig);

// 5. Configure the job in XXL-Job admin console:
// - JobHandler: MyAgent (same as agent name)
// - Schedule type: CRON
// - Cron expression: 0 0 8 * * ?

// 6. The agent will be executed according to the schedule in XXL-Job
// Each execution will create a fresh Agent instance
`

Important Notes:

• The agent name from AgentConfig is used as the JobHandler name in XXL-Job

• Each execution creates a fresh Agent instance using the configured factory

• Schedule configuration (cron, fixedRate, fixedDelay) is managed in XXL-Job admin console

• This scheduler only registers the JobHandler; actual scheduling is controlled by XXL-Job

• Pause/resume operations are not directly supported; use XXL-Job admin console instead