# Công cụ tiện ích (thời gian, calc, random)
SUMMARY: Endpoint tiện ích công khai — thời gian server, máy tính an toàn, trình tạo giá trị ngẫu nhiên. Không yêu cầu xác thực.

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.

Công cụ tiện ích
Các endpoint  là tiện ích công khai — không yêu cầu xác thực. Chúng hữu
ích cho LLM agent cần thời gian phía server, toán học an toàn hoặc giá trị ngẫu
nhiên.
GET /tools/time
Lấy thời gian server hiện tại, múi giờ và độ lệch UTC.
[CODE BLOCK]
Phản hồi:
[CODE BLOCK]
Trường hợp sử dụng: LLM agent cần biết "bây giờ là mấy giờ" để lên lịch, timestamp
hoặc tính ngày tương đối.
GET /tools/calc
Máy tính an toàn — chỉ số học, không có . Hỗ trợ , , , ,
, ,  và số.
[CODE BLOCK]
Phản hồi:
[CODE BLOCK]
> [!TIP]
> Sử dụng endpoint này thay vì cố gắng tính toán trong đầu hoặc qua phân tích
> chuỗi. Nó an toàn (không thể tiêm code) và chính xác.
Toán tử được hỗ trợ
-  cộng
-  trừ
-  nhân
-  chia
-  modulo
-   dấu ngoặc
- Số (số nguyên và số thập phân)
Ví dụ
[CODE BLOCK]
GET /tools/random
Tạo giá trị ngẫu nhiên.
[CODE BLOCK]
Tham số loại
| Loại | Tham số | Đầu ra |
|------|-----------|--------|
|  | không có | Chuỗi UUID v4 |
|  | ,  (mặc định 0-100) | Số nguyên |
|  | ,  (mặc định 0-100) | Số thực |
|  | ,  (phạm vi độ dài, mặc định 8-16) | Chuỗi hex |
|  | ,  (phạm vi độ dài, mặc định 8-16) | Chuỗi chữ cái |
Trường hợp sử dụng cho LLM agent
Tạo ID duy nhất
[CODE BLOCK]
Tính phần trăm
[CODE BLOCK]
Lấy timestamp hiện tại
[CODE BLOCK]
Tạo dữ liệu kiểm thử
[CODE BLOCK]
Bước tiếp theo
- Tổng quan API — tất cả nhóm endpoint
- Lỗi & Xử lý lỗi