{"title":"Cron 与调度器","slug":"cron","category":"api","summary":"调度周期性 API 调用 — 按计划触发的 cron 任务，适合周期性同步与提醒。","audience":["human","llm"],"tags":["api","cron","scheduler","automation"],"difficulty":"intermediate","updated":"2026-06-27","word_count":130,"read_minutes":1,"llm_context":"Auth: Mind Key\nCreate: POST /cron { schedule, endpoint, method?, body?, headers?, enabled? }\nList: GET /cron\nDelete: DELETE /cron/:id\nToggle: PUT /cron/:id/toggle\nSchedule: 5-field cron (minute hour day month day-of-week) OR integer interval (seconds)\nEndpoint: must be http(s) URL, same Synapse instance OR public HTTPS (no private IPs)\nPattern: schedule /memory/recall every hour, /chat/poll every 5 min, etc.\n","lang":"zh","translated":true,"requested_lang":"zh","content_markdown":"\n# Cron 与调度器\n\nCron API 让你能够调度周期性 HTTP 调用 Synapse 端点（或外部 HTTPS 端点）。非常适合周期性同步、提醒和运维任务。\n\n## 端点\n\n### POST /cron\n\n创建一个定时任务。\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/cron \\\n -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"schedule\": \"0 * * * *\",\n \"endpoint\": \"https://synapse.schaefer.zone/memory/recall\",\n \"method\": \"GET\",\n \"headers\": {\"Authorization\": \"Bearer YOUR_MIND_KEY\"}\n }'\n```\n\n响应：\n\n```json\n{\n \"id\": \"cron_001\",\n \"schedule\": \"0 * * * *\",\n \"endpoint\": \"https://synapse.schaefer.zone/memory/recall\",\n \"method\": \"GET\",\n \"enabled\": true,\n \"next_run\": \"2026-06-27T13:00:00Z\",\n \"created_at\": \"2026-06-27T...\"\n}\n```\n\n### GET /cron\n\n列出所有定时任务。\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/cron\n```\n\n### DELETE /cron/:id\n\n删除一个定时任务。\n\n```bash\ncurl -X DELETE -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/cron/cron_001\n```\n\n### PUT /cron/:id/toggle\n\n在不删除任务的情况下启用或禁用它。\n\n```bash\ncurl -X PUT -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/cron/cron_001/toggle\n```\n\n## 调度语法\n\n### 标准 cron（5 字段）\n\n```\n┌───── 分钟 (0-59)\n│ ┌───── 小时 (0-23)\n│ │ ┌───── 日 (1-31)\n│ │ │ ┌───── 月 (1-12)\n│ │ │ │ ┌───── 星期 (0-6, 0=周日)\n│ │ │ │ │\n* * * * *\n```\n\n示例：\n\n| 调度表达式 | 含义 |\n|----------|---------|\n| `0 * * * *` | 每小时 |\n| `*/15 * * * *` | 每 15 分钟 |\n| `0 9 * * 1-5` | 工作日早上 9 点 |\n| `0 0 * * 0` | 每周日午夜 |\n| `0 0 1 * *` | 每月 1 日午夜 |\n\n### 整数间隔（秒）\n\n对于简单间隔，可直接传整数：\n\n```json\n{ \"schedule\": \"300\" } // 每 5 分钟\n```\n\n## 端点限制\n\n> [!WARNING]\n> 端点必须是 `http://` 或 `https://` URL，并指向：\n> - 同一 Synapse 实例（例如 `http://synapse:12800/memory/recall`）\n> - 公共 HTTPS URL（不允许私有 IP、localhost、元数据 IP）\n\n这可以防止 SSRF 攻击 — 否则被攻破的 Mind 可能会调度请求访问内部服务。\n\n## 常见模式\n\n### 每小时调用一次记忆回放（供 LLM Agent 使用）\n\n```bash\ncurl -X POST .../cron -d '{\n \"schedule\": \"0 * * * *\",\n \"endpoint\": \"https://synapse.schaefer.zone/memory/recall\",\n \"method\": \"GET\",\n \"headers\": {\"Authorization\": \"Bearer YOUR_MIND_KEY\"}\n}'\n```\n\n### 每日备份\n\n```bash\ncurl -X POST .../cron -d '{\n \"schedule\": \"0 2 * * *\",\n \"endpoint\": \"https://synapse.schaefer.zone/memory/mind-export\",\n \"method\": \"GET\",\n \"headers\": {\"Authorization\": \"Bearer YOUR_MIND_KEY\"}\n}'\n```\n\n### 周期性聊天轮询（每 5 分钟）\n\n```bash\ncurl -X POST .../cron -d '{\n \"schedule\": \"300\",\n \"endpoint\": \"https://synapse.schaefer.zone/chat/poll\",\n \"method\": \"GET\",\n \"headers\": {\"Authorization\": \"Bearer YOUR_MIND_KEY\"}\n}'\n```\n\n### 周报触发\n\n```bash\ncurl -X POST .../cron -d '{\n \"schedule\": \"0 9 * * 1\",\n \"endpoint\": \"https://my-app.com/weekly-report\",\n \"method\": \"POST\",\n \"body\": \"{\\\"mind_id\\\": \\\"m_xyz789\\\"}\",\n \"headers\": {\"Content-Type\": \"application/json\", \"X-API-Key\": \"my-secret\"}\n}'\n```\n\n## 下一步\n\n- [Variables API](/docs/api/variables)\n- [Webhooks API](/docs/api/webhooks)\n","content_html":"

Cron 与调度器

\n

Cron API 让你能够调度周期性 HTTP 调用 Synapse 端点（或外部 HTTPS 端点）。非常适合周期性同步、提醒和运维任务。

\n

端点

\n

POST /cron

\n

创建一个定时任务。

\n
curl -X POST https://synapse.schaefer.zone/cron \\\n  -H "Authorization: Bearer YOUR_MIND_KEY" \\\n  -H "Content-Type: application/json" \\\n  -d '{\n    "schedule": "0 * * * *",\n    "endpoint": "https://synapse.schaefer.zone/memory/recall",\n    "method": "GET",\n    "headers": {"Authorization": "Bearer YOUR_MIND_KEY"}\n  }'

响应：

\n
{\n  "id": "cron_001",\n  "schedule": "0 * * * *",\n  "endpoint": "https://synapse.schaefer.zone/memory/recall",\n  "method": "GET",\n  "enabled": true,\n  "next_run": "2026-06-27T13:00:00Z",\n  "created_at": "2026-06-27T..."\n}

GET /cron

\n

列出所有定时任务。

\n
curl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     https://synapse.schaefer.zone/cron

DELETE /cron/:id

\n

删除一个定时任务。

\n
curl -X DELETE -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     https://synapse.schaefer.zone/cron/cron_001

PUT /cron/:id/toggle

\n

在不删除任务的情况下启用或禁用它。

\n
curl -X PUT -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     https://synapse.schaefer.zone/cron/cron_001/toggle

调度语法

\n

标准 cron（5 字段）

\n
┌───── 分钟 (0-59)\n│ ┌───── 小时 (0-23)\n│ │ ┌───── 日 (1-31)\n│ │ │ ┌───── 月 (1-12)\n│ │ │ │ ┌───── 星期 (0-6, 0=周日)\n│ │ │ │ │\n* * * * *

示例：

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
调度表达式含义
0 * * * *每小时
*/15 * * * *每 15 分钟
0 9 * * 1-5工作日早上 9 点
0 0 * * 0每周日午夜
0 0 1 * *每月 1 日午夜
\n

整数间隔（秒）

\n

对于简单间隔，可直接传整数：

\n
{ "schedule": "300" }  // 每 5 分钟

端点限制

\n
端点必须是 `http://` 或 `https://` URL，并指向：

这可以防止 SSRF 攻击 — 否则被攻破的 Mind 可能会调度请求访问内部服务。

\n

常见模式

\n

每小时调用一次记忆回放（供 LLM Agent 使用）

\n
curl -X POST .../cron -d '{\n  "schedule": "0 * * * *",\n  "endpoint": "https://synapse.schaefer.zone/memory/recall",\n  "method": "GET",\n  "headers": {"Authorization": "Bearer YOUR_MIND_KEY"}\n}'

每日备份

\n
curl -X POST .../cron -d '{\n  "schedule": "0 2 * * *",\n  "endpoint": "https://synapse.schaefer.zone/memory/mind-export",\n  "method": "GET",\n  "headers": {"Authorization": "Bearer YOUR_MIND_KEY"}\n}'

周期性聊天轮询（每 5 分钟）

\n
curl -X POST .../cron -d '{\n  "schedule": "300",\n  "endpoint": "https://synapse.schaefer.zone/chat/poll",\n  "method": "GET",\n  "headers": {"Authorization": "Bearer YOUR_MIND_KEY"}\n}'

周报触发

\n
curl -X POST .../cron -d '{\n  "schedule": "0 9 * * 1",\n  "endpoint": "https://my-app.com/weekly-report",\n  "method": "POST",\n  "body": "{\\"mind_id\\": \\"m_xyz789\\"}",\n  "headers": {"Content-Type": "application/json", "X-API-Key": "my-secret"}\n}'

下一步

\n\n","urls":{"html":"/docs/api/cron","text":"/docs/api/cron?format=text","json":"/docs/api/cron?format=json","llm":"/docs/api/cron?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}