Skip to main content

Cron और Scheduler

आवर्ती API कॉल शेड्यूल करें — शेड्यूल पर चलने वाले cron कार्य, आवर्ती सिंक और रिमाइंडर के लिए आदर्श।


Cron और Scheduler

Cron API आपको Synapse एंडपॉइंट्स (या बाहरी HTTPS एंडपॉइंट्स) पर आवर्ती HTTP कॉल शेड्यूल करने की सुविधा देता है। आवर्ती सिंक, रिमाइंडर और रखरखाव कार्यों के लिए आदर्श।

एंडपॉइंट्स

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 बजे
0 0 * * 0 हर रविवार आधी रात को
0 0 1 * * हर महीने की पहली तारीख आधी रात को

पूर्णांक अंतराल (सेकंड)

सरल अंतरालों के लिए, पूर्णांक पास करें:

{ "schedule": "300" }  // Every 5 minutes

एंडपॉइंट प्रतिबंध

एंडपॉइंट्स `http://` या `https://` URL होने चाहिए जो निम्न पर संकेत करते हों:

यह 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"}
}'

आवर्ती चैट poll (हर 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"}
}'

अगले कदम