उपयोगिता टूल्स

/tools एंडपॉइंट्स सार्वजनिक उपयोगिताएँ हैं — किसी प्रमाणीकरण की आवश्यकता नहीं। ये उन LLM एजेंट्स के लिए उपयोगी हैं जिन्हें सर्वर-साइड समय, सुरक्षित गणित, या रैंडम मान चाहिए।

GET /tools/time

वर्तमान सर्वर समय, टाइमज़ोन, और UTC ऑफ़सेट प्राप्त करें।

curl https://synapse.schaefer.zone/tools/time

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

{
  "time": "2026-06-27T14:30:00.000Z",
  "timezone": "Europe/Berlin",
  "offset": 120
}

उपयोग का मामला: LLM एजेंट्स जिन्हें शेड्यूलिंग, टाइमस्टैम्प्स, या सापेक्ष तिथि गणना के लिए "अभी क्या समय है" जानना चाहिए।

GET /tools/calc

सुरक्षित कैलकुलेटर — केवल अंकगणित, कोई eval() नहीं। +, -, *, /, %, (, ), और संख्याओं का समर्थन करता है।

curl "https://synapse.schaefer.zone/tools/calc?expr=(10+5)*3"

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

{
  "result": 45,
  "expr": "(10+5)*3"
}

समर्थित ऑपरेटर

• + जोड़
• - घटाव
• * गुणन
• / भाग
• % मॉड्यूलो
• ( ) कोष्ठक
• संख्याएँ (पूर्णांक और दशमलव)

उदाहरण

curl ".../tools/calc?expr=2+2"          # → 4
curl ".../tools/calc?expr=3.14*100"     # → 314
curl ".../tools/calc?expr=100%7"        # → 2
curl ".../tools/calc?expr=(2+3)*4-1"    # → 19

GET /tools/random

रैंडम मान जनरेट करें।

# UUID v4
curl "https://synapse.schaefer.zone/tools/random?type=uuid"
# → { "value": "a1b2c3d4-...", "type": "uuid" }

# Integer (default range 0-100)
curl "https://synapse.schaefer.zone/tools/random?type=int&min=1&max=10"
# → { "value": 7, "type": "int" }

# Float
curl "https://synapse.schaefer.zone/tools/random?type=float&min=0&max=1"
# → { "value": 0.7234, "type": "float" }

# Hex string
curl "https://synapse.schaefer.zone/tools/random?type=hex&min=8&max=16"
# → { "value": "a3f7b2c1", "type": "hex" }

# Alphabetic string
curl "https://synapse.schaefer.zone/tools/random?type=alpha&min=8&max=12"
# → { "value": "kQmzPwXn", "type": "alpha" }

प्रकार पैरामीटर

LLM एजेंट्स के लिए उपयोग के मामले

अद्वितीय ID जनरेट करें

ID=$(curl -s .../tools/random?type=uuid | jq -r .value)
curl -X POST .../memory -d "{\"key\": \"task_$ID\", ...}"

प्रतिशत की गणना

TOTAL=142
DONE=87
PERCENT=$(curl -s ".../tools/calc?expr=($DONE*100)/$TOTAL" | jq -r .result)
echo "Progress: $PERCENT%"

वर्तमान टाइमस्टैम्प प्राप्त करें

NOW=$(curl -s .../tools/time | jq -r .time)
curl -X POST .../var -d "{\"key\": \"last_run\", \"value\": \"$NOW\"}"

परीक्षण डेटा जनरेट करें

for i in {1..10}; do
  NAME=$(curl -s ".../tools/random?type=alpha&min=5&max=10" | jq -r .value)
  curl -X POST .../memory -d "{\"key\": \"test_$i\", \"content\": \"$NAME\"}"
done

अगले कदम

• API Overview — सभी एंडपॉइंट समूह
• त्रुटियाँ और त्रुटि प्रबंधन