Skip to main content

Tasks API

Керування завданнями для LLM-агентів — створення, список, оновлення, завершення, видалення завдань із пріоритетами.


Tasks API

Tasks API надає LLM-агентам структурований спосіб відстеження багатокрокової роботи. Завдання прив'язані до поточного mind-у та зберігаються між сесіями, тож агент може продовжити роботу з того місця, де зупинився.

Кінцеві точки

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-only інструментів).

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

Наступні кроки