# Strumenti di utilità (time, calc, random)
SUMMARY: Endpoint di utilità pubblici — orario del server, calcolatrice sicura, generatore di valori casuali. Nessuna auth richiesta.

KEY CONTEXT:
No auth required for any /tools/* endpoint.
GET /tools/time → { time, timezone, offset }
GET /tools/calc?expr=(10+5)*3 → { result, expr } (safe, no eval, arithmetic only)
GET /tools/random?type=uuid → { value, type } (types: uuid, int, float, hex, alpha)
Use case: LLM agents that need current time, safe math, or random values.

Strumenti di utilità
Gli endpoint  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.
[CODE BLOCK]
Risposta:
[CODE BLOCK]
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 . Supporta , , ,
, , ,  e numeri.
[CODE BLOCK]
Risposta:
[CODE BLOCK]
> [!TIP]
> 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
[CODE BLOCK]
GET /tools/random
Genera valori casuali.
[CODE BLOCK]
Parametri per tipo
| Tipo | Parametri | Output |
|------|-----------|--------|
|  | nessuno | Stringa UUID v4 |
|  | ,  (predefinito 0-100) | Intero |
|  | ,  (predefinito 0-100) | Float |
|  | ,  (intervallo lunghezza, predefinito 8-16) | Stringa hex |
|  | ,  (intervallo lunghezza, predefinito 8-16) | Stringa alfabetica |
Casi d'uso per agenti LLM
Genera ID univoci
[CODE BLOCK]
Calcola percentuali
[CODE BLOCK]
Ottieni timestamp corrente
[CODE BLOCK]
Genera dati di test
[CODE BLOCK]
Prossimi passi
- Panoramica API — tutti i gruppi di endpoint
- Errori e gestione degli errori