跳到主要内容

使用 Cron 自动化任何任务

每日简报机器人教程 涵盖了基础知识。本指南更进一步——介绍五个可应用于您自身工作流的真实世界自动化模式。

如需完整功能参考,请参阅 计划任务(Cron)

关键概念

Cron 任务在全新的代理会话中运行,不会保留您当前聊天的记忆。提示必须是完全自包含的——包含代理所需的一切信息。


模式 1:网站变更监控器

监控指定 URL 的变更,并仅在内容发生变化时收到通知。

script 参数是此模式的关键。每次执行前都会运行一段 Python 脚本,其标准输出将作为代理的上下文。脚本负责机械性工作(获取网页内容、对比差异);代理则负责推理判断(此变更是否值得关注?)。

创建监控脚本:

mkdir -p ~/.hermes/scripts
~/.hermes/scripts/watch-site.py
import hashlib, json, os, urllib.request

URL = "https://example.com/pricing"
STATE_FILE = os.path.expanduser("~/.hermes/scripts/.watch-site-state.json")

# Fetch current content
req = urllib.request.Request(URL, headers={"User-Agent": "Hermes-Monitor/1.0"})
content = urllib.request.urlopen(req, timeout=30).read().decode()
current_hash = hashlib.sha256(content.encode()).hexdigest()

# Load previous state
prev_hash = None
if os.path.exists(STATE_FILE):
with open(STATE_FILE) as f:
prev_hash = json.load(f).get("hash")

# Save current state
with open(STATE_FILE, "w") as f:
json.dump({"hash": current_hash, "url": URL}, f)

# Output for the agent
if prev_hash and prev_hash != current_hash:
print(f"CHANGE DETECTED on {URL}")
print(f"Previous hash: {prev_hash}")
print(f"Current hash: {current_hash}")
print(f"\nCurrent content (first 2000 chars):\n{content[:2000]}")
else:
print("NO_CHANGE")

设置 Cron 任务:

/cron add "every 1h" "If the script output says CHANGE DETECTED, summarize what changed on the page and why it might matter. If it says NO_CHANGE, respond with just [SILENT]." --script ~/.hermes/scripts/watch-site.py --name "Pricing monitor" --deliver telegram
[SILENT] 技巧

当代理的最终响应包含 [SILENT] 时,将抑制通知发送。这意味着只有真正发生变更时才会收到提醒——在无变化时段不会产生通知噪音。


模式 2:每周报告

从多个信息源汇总数据,生成格式化的摘要报告。该任务每周运行一次,并发送至您的主频道。

/cron add "0 9 * * 1" "Generate a weekly report covering:

1. Search the web for the top 5 AI news stories from the past week
2. Search GitHub for trending repositories in the 'machine-learning' topic
3. Check Hacker News for the most discussed AI/ML posts

Format as a clean summary with sections for each source. Include links.
Keep it under 500 words — highlight only what matters." --name "Weekly AI digest" --deliver telegram

通过 CLI 执行:

hermes cron create "0 9 * * 1" \
"Generate a weekly report covering the top AI news, trending ML GitHub repos, and most-discussed HN posts. Format with sections, include links, keep under 500 words." \
--name "Weekly AI digest" \
--deliver telegram

0 9 * * 1 是标准的 Cron 表达式:每周一上午 9:00。


模式 3:GitHub 仓库监视器

监视仓库中是否有新问题、拉取请求或发布版本。

/cron add "every 6h" "Check the GitHub repository NousResearch/hermes-agent for:
- New issues opened in the last 6 hours
- New PRs opened or merged in the last 6 hours
- Any new releases

Use the terminal to run gh commands:
gh issue list --repo NousResearch/hermes-agent --state open --json number,title,author,createdAt --limit 10
gh pr list --repo NousResearch/hermes-agent --state all --json number,title,author,createdAt,mergedAt --limit 10

Filter to only items from the last 6 hours. If nothing new, respond with [SILENT].
Otherwise, provide a concise summary of the activity." --name "Repo watcher" --deliver discord
完全自包含的提示

请注意提示中如何明确包含 gh 命令。Cron 代理没有记忆前次运行或您的偏好的能力——必须完整写出所有指令。


模式 4:数据收集流水线

定期抓取数据,保存到文件,并随时间检测趋势。该模式结合脚本(用于收集)与代理(用于分析)。

~/.hermes/scripts/collect-prices.py
import json, os, urllib.request
from datetime import datetime

DATA_DIR = os.path.expanduser("~/.hermes/data/prices")
os.makedirs(DATA_DIR, exist_ok=True)

# Fetch current data (example: crypto prices)
url = "https://api.coingecko.com/api/v3/simple/price?ids=bitcoin,ethereum&vs_currencies=usd"
data = json.loads(urllib.request.urlopen(url, timeout=30).read())

# Append to history file
entry = {"timestamp": datetime.now().isoformat(), "prices": data}
history_file = os.path.join(DATA_DIR, "history.jsonl")
with open(history_file, "a") as f:
f.write(json.dumps(entry) + "\n")

# Load recent history for analysis
lines = open(history_file).readlines()
recent = [json.loads(l) for l in lines[-24:]] # Last 24 data points

# Output for the agent
print(f"Current: BTC=${data['bitcoin']['usd']}, ETH=${data['ethereum']['usd']}")
print(f"Data points collected: {len(lines)} total, showing last {len(recent)}")
print(f"\nRecent history:")
for r in recent[-6:]:
print(f" {r['timestamp']}: BTC=${r['prices']['bitcoin']['usd']}, ETH=${r['prices']['ethereum']['usd']}")
/cron add "every 1h" "Analyze the price data from the script output. Report:
1. Current prices
2. Trend direction over the last 6 data points (up/down/flat)
3. Any notable movements (>5% change)

If prices are flat and nothing notable, respond with [SILENT].
If there's a significant move, explain what happened." \
--script ~/.hermes/scripts/collect-prices.py \
--name "Price tracker" \
--deliver telegram

脚本负责机械性数据收集;代理则添加推理分析层。


模式 5:多技能工作流

将多个技能串联起来,完成复杂的计划任务。技能在提示执行前按顺序加载。

# Use the arxiv skill to find papers, then the obsidian skill to save notes
/cron add "0 8 * * *" "Search arXiv for the 3 most interesting papers on 'language model reasoning' from the past day. For each paper, create an Obsidian note with the title, authors, abstract summary, and key contribution." \
--skill arxiv \
--skill obsidian \
--name "Paper digest"

通过工具直接执行:

cronjob(
action="create",
skills=["arxiv", "obsidian"],
prompt="Search arXiv for papers on 'language model reasoning' from the past day. Save the top 3 as Obsidian notes.",
schedule="0 8 * * *",
name="Paper digest",
deliver="local"
)

技能按顺序加载——首先是 arxiv(教会代理如何搜索论文),然后是 obsidian(教会代理如何撰写笔记)。提示将它们串联起来。


管理您的任务

# List all active jobs
/cron list

# Trigger a job immediately (for testing)
/cron run <job_id>

# Pause a job without deleting it
/cron pause <job_id>

# Edit a running job's schedule or prompt
/cron edit <job_id> --schedule "every 4h"
/cron edit <job_id> --prompt "Updated task description"

# Add or remove skills from an existing job
/cron edit <job_id> --skill arxiv --skill obsidian
/cron edit <job_id> --clear-skills

# Remove a job permanently
/cron remove <job_id>

交付目标

--deliver 标志控制结果的发送位置:

目标示例使用场景
origin--deliver origin创建任务的原始聊天(默认)
local--deliver local仅保存到本地文件
telegram--deliver telegram您的 Telegram 主频道
discord--deliver discord您的 Discord 主频道
slack--deliver slack您的 Slack 主频道
特定聊天--deliver telegram:-1001234567890指定的 Telegram 群组
线程--deliver telegram:-1001234567890:17585指定的 Telegram 主题线程

技巧

使提示完全自包含。 Cron 任务中的代理没有记忆您对话的能力。请在提示中直接包含 URL、仓库名称、格式偏好和交付指令。

广泛使用 [SILENT] 对于监控类任务,始终包含类似“若无变化,请回复 [SILENT]”的指令。这可防止通知噪音。

使用脚本进行数据收集。 script 参数允许 Python 脚本处理繁琐部分(HTTP 请求、文件 I/O、状态追踪)。代理仅看到脚本的标准输出,并基于此进行推理。相比让代理自行执行获取操作,这种方式更经济且更可靠。

使用 /cron run 测试。 在等待计划触发前,可使用 /cron run <job_id> 立即执行任务,验证输出是否正确。

调度表达式。 人类可读格式如 every 2h30mdaily at 9am 均支持,同时兼容标准 Cron 表达式如 0 9 * * *


如需完整的 Cron 参考——包含所有参数、边缘情况和内部机制——请参阅 计划任务(Cron)