# Narzędzia pomocnicze (czas, kalkulator, losowość)
SUMMARY: Publiczne endpointy narzędziowe — czas serwera, bezpieczny kalkulator, generator wartości losowych. Bez autoryzacji.

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.

Narzędzia pomocnicze
Endpointy  to publiczne narzędzia — nie wymagają autoryzacji. Są
przydatne dla agentów LLM, które potrzebują czasu po stronie serwera,
bezpiecznych obliczeń matematycznych lub wartości losowych.
GET /tools/time
Zwraca aktualny czas serwera, strefę czasową i przesunięcie UTC.
[CODE BLOCK]
Odpowiedź:
[CODE BLOCK]
Przypadek użycia: agenty LLM, które muszą wiedzieć „która jest teraz godzina" do
planowania, znaczników czasu lub obliczeń dat względnych.
GET /tools/calc
Bezpieczny kalkulator — wyłącznie arytmetyka, bez . Obsługuje , ,
, , , ,  oraz liczby.
[CODE BLOCK]
Odpowiedź:
[CODE BLOCK]
> [!TIP]
> Należy używać tego zamiast liczenia w pamięci lub parsowania ciągów. Jest
> bezpieczne (bez możliwości wstrzykiwania kodu) i dokładne.
Obsługiwane operatory
-  dodawanie
-  odejmowanie
-  mnożenie
-  dzielenie
-  modulo
-   nawiasy
- Liczby (całkowite i dziesiętne)
Przykłady
[CODE BLOCK]
GET /tools/random
Generuje wartości losowe.
[CODE BLOCK]
Parametry typu
| Typ | Parametry | Wynik |
|------|-----------|--------|
|  | brak | Ciąg UUID v4 |
|  | ,  (domyślnie 0-100) | Liczba całkowita |
|  | ,  (domyślnie 0-100) | Liczba zmiennoprzecinkowa |
|  | ,  (zakres długości, domyślnie 8-16) | Ciąg szesnastkowy |
|  | ,  (zakres długości, domyślnie 8-16) | Ciąg alfabetyczny |
Przypadki użycia dla agentów LLM
Generowanie unikalnych ID
[CODE BLOCK]
Obliczanie procentów
[CODE BLOCK]
Pobieranie aktualnego znacznika czasu
[CODE BLOCK]
Generowanie danych testowych
[CODE BLOCK]
Następne kroki
- Przegląd API — wszystkie grupy endpointów
- Błędy i ich obsługa