Tasks API

Tasks API cung cấp cho LLM agent cách có cấu trúc để theo dõi công việc nhiều bước. Tác vụ được phạm vi hóa trong mind hiện tại và tồn tại qua các phiên, do đó agent có thể tiếp tục công việc từ nơi đã dừng.

Các endpoint

GET /mind/tasks

Liệt kê tất cả tác vụ cho mind hiện tại.

# All tasks
curl -H "Authorization: Bearer YOUR_MIND_KEY" \
     https://synapse.schaefer.zone/mind/tasks

# Filter by status
curl -H "Authorization: Bearer YOUR_MIND_KEY" \
     "https://synapse.schaefer.zone/mind/tasks?status=pending"

Phản hồi:

{
  "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

Tạo một tác vụ mới.

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 (query params)

Tạo tác vụ qua GET (cho công cụ chỉ dùng URL).

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

PUT /mind/task/:id

Cập nhật một tác vụ hiện có.

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

Đánh dấu một tác vụ là đã xong.

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

GET /mind/task/:id/delete

Xóa vĩnh viễn một tác vụ.

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

Mức ưu tiên

• low — không khẩn cấp
• normal — mặc định
• high — quan trọng
• critical — phải làm ngay lập tức

Trạng thái

• pending — đã tạo, chưa bắt đầu
• in_progress — đang được thực hiện
• done — đã hoàn thành
• cancelled — đã bỏ

Mẫu: Quy trình điều khiển bởi tác vụ

# At session start
tasks = list_tasks(status="in_progress")
if tasks:
    print(f"Resuming: {tasks[0].title}")

# Plan multi-step work
for step in plan:
    task = create_task(title=step)

# Update as you progress
update_task(task.id, status="in_progress")
# ... do work ...
update_task(task.id, status="done")

Bước tiếp theo

• Quy trình điều khiển bởi tác vụ
• Cron & Scheduler