Skip to main content

Cron та планувальник

intermediate 🤖 LLM-дружній 1 хв · 204 слів Оновлено: 2026-06-27 Українська

Планування регулярних викликів API — cron-завдання, що запускаються за розкладом, ідеально для періодичної синхронізації та нагадувань.

Читати цю статтю як: 📄 Простий текст ⚡ JSON 🤖 LLM-формат
Мова: English中文हिन्दीEspañolFrançaisالعربيةPortuguêsРусский日本語DeutschItaliano한국어NederlandsPolskiTürkçeSvenskaTiếng ViệtไทยBahasa IndonesiaУкраїнська

Cron та планувальник

Cron API дозволяє планувати регулярні HTTP-виклики до кінцевих точок Synapse (або зовнішніх HTTPS-кінцевих точок). Ідеально підходить для періодичної синхронізації, нагадувань та завдань з обслуговування.

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

POST /cron

Створити заплановане завдання.

curl -X POST https://synapse.schaefer.zone/cron \
  -H "Authorization: Bearer YOUR_MIND_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "schedule": "0 * * * *",
    "endpoint": "https://synapse.schaefer.zone/memory/recall",
    "method": "GET",
    "headers": {"Authorization": "Bearer YOUR_MIND_KEY"}
  }'

Відповідь:

{
  "id": "cron_001",
  "schedule": "0 * * * *",
  "endpoint": "https://synapse.schaefer.zone/memory/recall",
  "method": "GET",
  "enabled": true,
  "next_run": "2026-06-27T13:00:00Z",
  "created_at": "2026-06-27T..."
}

GET /cron

Список усіх запланованих завдань.

curl -H "Authorization: Bearer YOUR_MIND_KEY" \
     https://synapse.schaefer.zone/cron

DELETE /cron/:id

Видалити заплановане завдання.

curl -X DELETE -H "Authorization: Bearer YOUR_MIND_KEY" \
     https://synapse.schaefer.zone/cron/cron_001

PUT /cron/:id/toggle

Увімкнути або вимкнути завдання без видалення.

curl -X PUT -H "Authorization: Bearer YOUR_MIND_KEY" \
     https://synapse.schaefer.zone/cron/cron_001/toggle

Синтаксис розкладу

Стандартний cron (5 полів)

┌───── minute (0-59)
│ ┌───── hour (0-23)
│ │ ┌───── day of month (1-31)
│ │ │ ┌───── month (1-12)
│ │ │ │ ┌───── day of week (0-6, 0=Sunday)
│ │ │ │ │
* * * * *

Приклади:

Розклад Значення
0 * * * * Щогодини
*/15 * * * * Кожні 15 хвилин
0 9 * * 1-5 Будні о 9:00
0 0 * * 0 Кожної неділі опівночі
0 0 1 * * Першого числа кожного місяця опівночі

Цілочисельний інтервал (секунди)

Для простих інтервалів передайте ціле число:

{ "schedule": "300" }  // Кожні 5 хвилин

Обмеження кінцевих точок

Кінцеві точки мають бути URL-адресами `http://` або `https://`, що вказують на:

Це запобігає SSRF-атакам, коли скомпрометований mind міг би планувати запити до внутрішніх служб.

Типові шаблони

Щогодинне відкликання пам'яті (для LLM-агентів)

curl -X POST .../cron -d '{
  "schedule": "0 * * * *",
  "endpoint": "https://synapse.schaefer.zone/memory/recall",
  "method": "GET",
  "headers": {"Authorization": "Bearer YOUR_MIND_KEY"}
}'

Щоденне резервне копіювання

curl -X POST .../cron -d '{
  "schedule": "0 2 * * *",
  "endpoint": "https://synapse.schaefer.zone/memory/mind-export",
  "method": "GET",
  "headers": {"Authorization": "Bearer YOUR_MIND_KEY"}
}'

Періодичне опитування чату (кожні 5 хвилин)

curl -X POST .../cron -d '{
  "schedule": "300",
  "endpoint": "https://synapse.schaefer.zone/chat/poll",
  "method": "GET",
  "headers": {"Authorization": "Bearer YOUR_MIND_KEY"}
}'

Тригер щотижневого звіту

curl -X POST .../cron -d '{
  "schedule": "0 9 * * 1",
  "endpoint": "https://my-app.com/weekly-report",
  "method": "POST",
  "body": "{\"mind_id\": \"m_xyz789\"}",
  "headers": {"Content-Type": "application/json", "X-API-Key": "my-secret"}
}'

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

← Назад до Довідник з API