Tasks API

Tasks API 为 LLM Agent 提供结构化的方式来跟踪多步骤工作。任务归属于当前 Mind，并跨会话持久化，因此 Agent 可以从中断处继续工作。

端点

GET /mind/tasks

列出当前 Mind 中的所有任务。

# 全部任务
curl -H "Authorization: Bearer YOUR_MIND_KEY" \
     https://synapse.schaefer.zone/mind/tasks

# 按状态过滤
curl -H "Authorization: Bearer YOUR_MIND_KEY" \
     "https://synapse.schaefer.zone/mind/tasks?status=pending"

响应：

{
  "tasks": [
    {
      "id": "task_001",
      "title": "Deploy v1.5.0",
      "description": "Push to production after CI green",
      "priority": "high",
      "status": "in_progress",
      "due_at": "2026-06-28T...",
      "created_at": "2026-06-27T..."
    }
  ]
}

POST /mind/task

创建新任务。

curl -X POST https://synapse.schaefer.zone/mind/task \
  -H "Authorization: Bearer YOUR_MIND_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Update documentation",
    "description": "Add v1.5.0 changelog entries",
    "priority": "normal",
    "due_at": "2026-06-30T00:00:00Z"
  }'

GET /mind/task（查询参数）

通过 GET 创建任务（供只能使用 URL 的工具使用）。

curl -H "Authorization: Bearer YOUR_MIND_KEY" \
     "https://synapse.schaefer.zone/mind/task?title=Test+task&priority=high"

PUT /mind/task/:id

更新已有任务。

curl -X PUT https://synapse.schaefer.zone/mind/task/task_001 \
  -H "Authorization: Bearer YOUR_MIND_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "in_progress",
    "description": "Currently deploying, CI is green"
  }'

GET /mind/task/:id/complete

将任务标记为已完成。

curl -H "Authorization: Bearer YOUR_MIND_KEY" \
     https://synapse.schaefer.zone/mind/task/task_001/complete

GET /mind/task/:id/delete

永久删除任务。

curl -H "Authorization: Bearer YOUR_MIND_KEY" \
     https://synapse.schaefer.zone/mind/task/task_001/delete

优先级

• low — 不紧急
• normal — 默认
• high — 重要
• critical — 必须立即处理

状态

• pending — 已创建，未开始
• in_progress — 正在处理
• done — 已完成
• cancelled — 已放弃

模式：任务驱动工作流

# 会话开始时
tasks = list_tasks(status="in_progress")
if tasks:
    print(f"Resuming: {tasks[0].title}")

# 为多步骤工作做计划
for step in plan:
    task = create_task(title=step)

# 随进度更新
update_task(task.id, status="in_progress")
# ... 执行工作 ...
update_task(task.id, status="done")

下一步

• 任务驱动工作流
• Cron 与调度器