agentscope-extensions-scheduler 让 Agent 可以按调度器配置周期性执行——比如”每天 8 点跑一次日报 Agent”、“每 5 秒做一次健康巡检”。模块抽出统一的 AgentScheduler 接口,提供两个实现:
底层 SPI 在
agentscope-extensions-scheduler-common,可以自己实现接入其他调度框架。
共享概念
AgentConfig(或RuntimeAgentConfig):定义 Agent 怎么”造”出来——名字、模型配置、system prompt、工具集等。ScheduleConfig:定义调度策略——CRON、固定速率、最大并发等。AgentScheduler:核心接口,schedule(...)/pause(...)/resume(...)/cancel(...)/shutdown()。ScheduleAgentTask:一次注册返回的”被调度的 Agent 任务”句柄。
Quartz 模式(单机/集群)
添加依赖
用法
XXL-Job 模式(分布式)
添加依赖
用法
DailyReportAgent 会作为 JobHandler 显示。
工具绑定
绑定 Toolkit 时使用RuntimeAgentConfig(过渡 API,未来可能调整):
选型建议
- 本地或小集群、不想引入外部调度服务 → Quartz
- 需要可视化控制台、跨节点路由、任务日志 → XXL-Job
- 想接其他调度框架 → 自己实现
AgentScheduler接口