调度指南¶

┌─────────────────────┐
│   CronScheduler     │  后台定时循环（1 秒间隔）
│   (Tick Loop)       │  任务选择与执行编排
└──────────┬──────────┘
           │
           ▼
┌─────────────────────┐
│   SqliteJobStore    │  持久化任务存储
│   (Job Storage)     │  事务支持、状态管理
└──────────┬──────────┘
           │
           ▼
┌─────────────────────┐
│DefaultAgentScheduler│  智能体执行运行时
│ (Execution Engine)  │  AgentContext 生命周期管理
└─────────────────────┘

schedule {
  name: "daily-report"
  agent: "reporter-agent"
  cron: "0 0 9 * * *"

  session_mode: "ephemeral_with_summary"
  delivery: ["stdout", "log_file"]

  policy {
    require_approval: false
    max_runtime: "5m"
  }
}

┌─────────────── 秒 (0-59)
│ ┌───────────── 分钟 (0-59)
│ │ ┌─────────── 小时 (0-23)
│ │ │ ┌───────── 月份中的日期 (1-31)
│ │ │ │ ┌─────── 月份 (1-12)
│ │ │ │ │ ┌───── 星期几 (0-6, 星期日 = 0)
│ │ │ │ │ │
* * * * * *

# 每天上午 9 点
cron: "0 0 9 * * *"

# 每周一下午 6 点
cron: "0 0 18 * * 1"

# 每 15 分钟
cron: "0 */15 * * * *"

# 每月第一天午夜
cron: "0 0 0 1 * *"

schedule {
  name: "deployment-check"
  agent: "health-checker"
  at: "2026-02-15T14:30:00Z"  # ISO 8601 时间戳

  delivery: ["webhook"]
  webhook_url: "https://ops.example.com/hooks/deployment"
}

schedule {
  name: "system-monitor"
  agent: "heartbeat-agent"
  cron: "0 */5 * * * *"  # 每 5 分钟唤醒一次

  heartbeat: {
    enabled: true
    context_mode: "ephemeral_with_summary"
    max_iterations: 100  # 安全限制
  }
}

agent heartbeat_monitor {
  model: "claude-sonnet-4.5"
  system_prompt: """
  You are a system monitoring agent. On each heartbeat:
  1. Check system metrics (CPU, memory, disk)
  2. Review recent error logs
  3. If issues detected, take action:
     - Restart services if safe
     - Alert ops team via Slack
     - Log incident details
  4. Summarize findings
  5. Return 'sleep' when done
  """
}

schedule {
  name: "heartbeat-monitor"
  agent: "heartbeat_monitor"
  cron: "0 */10 * * * *"  # 每 10 分钟

  heartbeat: {
    enabled: true
    context_mode: "ephemeral_with_summary"
    max_iterations: 50
  }

  delivery: ["log_file", "slack"]
  slack_channel: "#ops-alerts"
}

schedule {
  name: "data-pipeline"
  agent: "etl-agent"
  cron: "0 0 2 * * *"

  # 每次运行使用全新上下文，包含前次运行的摘要
  session_mode: "ephemeral_with_summary"
}

schedule {
  name: "backup"
  agent: "backup-agent"
  cron: "0 0 3 * * *"
  delivery: ["log_file"]
}

schedule {
  name: "security-scan"
  agent: "scanner"
  cron: "0 0 1 * * *"

  delivery: ["log_file", "slack", "email"]

  slack_channel: "#security"
  email_recipients: ["ops@example.com", "security@example.com"]
}

schedule {
  name: "metrics-report"
  agent: "metrics-agent"
  cron: "0 */30 * * * *"

  delivery: ["webhook"]
  webhook_url: "https://metrics.example.com/ingest"
  webhook_headers: {
    "Authorization": "Bearer ${METRICS_API_KEY}"
    "Content-Type": "application/json"
  }
}

schedule {
  name: "production-deploy"
  agent: "deploy-agent"
  cron: "0 0 0 * * 0"  # 周日午夜

  policy {
    # 执行前需要人工审批
    require_approval: true

    # 强制终止前的最大运行时间
    max_runtime: "30m"

    # 要求具备特定能力
    require_capabilities: ["deployment", "production_write"]

    # 时间窗口限制（UTC）
    allowed_hours: {
      start: "00:00"
      end: "04:00"
    }

    # 环境限制
    allowed_environments: ["staging", "production"]

    # 需要 AgentPin 验证
    require_agent_pin: true
  }
}

schedule {
  name: "data-sync"
  agent: "sync-agent"
  cron: "0 */5 * * * *"

  max_concurrent: 2  # 最多允许 2 个并发运行
}

schedule {
  name: "flaky-job"
  agent: "unreliable-agent"
  cron: "0 0 * * * *"

  max_retries: 3  # 3 次失败后移入死信队列
}

schedule {
  name: "secure-task"
  agent: "trusted-agent"
  cron: "0 0 * * * *"

  agent_pin_jwt: "${AGENT_PIN_JWT}"  # 来自 agentpin-cli 的 ES256 JWT

  policy {
    require_agent_pin: true
  }
}

# 总运行次数
symbiont_cron_runs_total{job_name="daily-report",status="succeeded"} 450

# 失败运行次数
symbiont_cron_runs_total{job_name="daily-report",status="failed"} 5

# 执行时间直方图
symbiont_cron_execution_duration_seconds{job_name="daily-report"} 1.234

# 运行中任务计数
symbiont_cron_in_flight_jobs 3

# 死信队列任务
symbiont_cron_dead_letter_total{job_name="flaky-job"} 2