Skip to main content

Tasks API

LLM एजेंट्स के लिए कार्य प्रबंधन — प्राथमिकताओं के साथ कार्य बनाएँ, सूचीबद्ध करें, अपडेट करें, पूर्ण करें, हटाएँ।


Tasks API

Tasks API LLM एजेंट्स को बहु-चरणीय कार्य को ट्रैक करने का एक संरचित तरीका देता है। कार्य वर्तमान mind तक सीमित हैं और सत्रों में बने रहते हैं, इसलिए एजेंट जहाँ छोड़ा था वहाँ से काम फिर से शुरू कर सकता है।

एंडपॉइंट्स

GET /mind/tasks

वर्तमान mind के लिए सभी कार्यों की सूची बनाएँ।

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

प्रतिक्रिया:

{
  "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 — परित्यक्त

पैटर्न: कार्य-चालित वर्कफ़्लो

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

अगले कदम