Skip to main content

Tasks API

LLM ajanları için görev yönetimi — önceliklerle görev oluşturma, listeleme, güncelleme, tamamlama, silme.


Tasks API

Tasks API, LLM ajanlarına çok adımlı işleri izlemek için yapılandırılmış bir yol sağlar. Görevler mevcut mind'e bağlıdır ve oturumlar arasında kalıcıdır, böylece ajan kaldığı yerden devam edebilir.

Uç Noktalar

GET /mind/tasks

Mevcut mind için tüm görevleri listele.

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

Yanıt:

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

Yeni bir görev oluştur.

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 (sorgu parametreleri)

GET ile bir görev oluştur (yalnızca URL kullanan araçlar için).

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

PUT /mind/task/:id

Mevcut bir görevi güncelle.

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

Bir görevi tamamlandı olarak işaretle.

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

GET /mind/task/:id/delete

Bir görevi kalıcı olarak sil.

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

Öncelikler

  • low — acil değil
  • normal — varsayılan
  • high — önemli
  • critical — hemen yapılmalı

Durumlar

  • pending — oluşturuldu, başlanmadı
  • in_progress — şu anda üzerinde çalışılıyor
  • done — tamamlandı
  • cancelled — terk edildi

Desen: Görev Odaklı İş Akışı

# 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")

Sonraki Adımlar