Strumenti di utilità (time, calc, random)

beginner 🤖 Compatibile con LLM 1 min · 248 parole Aggiornato: 2026-06-27 Italiano

Endpoint di utilità pubblici — orario del server, calcolatrice sicura, generatore di valori casuali. Nessuna auth richiesta.

Leggi questo articolo come: 📄 Testo semplice ⚡ JSON 🤖 Formato LLM

Strumenti di utilità

Gli endpoint /tools sono utility pubbliche — nessuna autenticazione richiesta. Sono utili per agenti LLM che hanno bisogno di orario lato server, matematica sicura o valori casuali.

GET /tools/time

Ottiene l'orario corrente del server, il fuso orario e l'offset UTC.

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

Risposta:

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

Caso d'uso: agenti LLM che hanno bisogno di sapere "che ore sono adesso" per pianificazione, timestamp o calcoli di date relative.

GET /tools/calc

Calcolatrice sicura — solo aritmetica, nessun eval(). Supporta +, -, *, /, %, (, ) e numeri.

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

Risposta:

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

Lo usi al posto di cercare di fare calcoli a mente o tramite parsing di stringhe. È sicuro (nessuna injection di codice possibile) e accurato.

Operatori supportati

+ addizione
- sottrazione
* moltiplicazione
/ divisione
% modulo
( ) parentesi
Numeri (interi e decimali)

Esempi

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

Genera valori casuali.

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

Parametri per tipo

Tipo	Parametri	Output
`uuid`	nessuno	Stringa UUID v4
`int`	`min`, `max` (predefinito 0-100)	Intero
`float`	`min`, `max` (predefinito 0-100)	Float
`hex`	`min`, `max` (intervallo lunghezza, predefinito 8-16)	Stringa hex
`alpha`	`min`, `max` (intervallo lunghezza, predefinito 8-16)	Stringa alfabetica

Casi d'uso per agenti LLM

Genera ID univoci

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

Calcola percentuali

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

Ottieni timestamp corrente

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

Genera dati di test

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

Prossimi passi

Panoramica API — tutti i gruppi di endpoint
Errori e gestione degli errori