Skip to main content
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 任务”句柄。
每次任务触发时,调度器会”现造”一个新的 Agent 实例并执行,避免状态串台。

Quartz 模式(单机/集群)

添加依赖

用法

支持运行时管控:

XXL-Job 模式(分布式)

添加依赖

用法

之后,调度策略(CRON、并发、路由)在 XXL-Job 控制台配置,Agent 名 DailyReportAgent 会作为 JobHandler 显示。

工具绑定

绑定 Toolkit 时使用 RuntimeAgentConfig(过渡 API,未来可能调整):

选型建议

  • 本地或小集群、不想引入外部调度服务 → Quartz
  • 需要可视化控制台、跨节点路由、任务日志 → XXL-Job
  • 想接其他调度框架 → 自己实现 AgentScheduler 接口