{"title":"Công cụ tiện ích (thời gian, calc, random)","slug":"tools","category":"api","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.","audience":["human","llm"],"tags":["api","tools","utility","public"],"difficulty":"beginner","updated":"2026-06-27","word_count":298,"read_minutes":1,"llm_context":"No auth required for any /tools/* endpoint.\nGET /tools/time → { time, timezone, offset }\nGET /tools/calc?expr=(10+5)*3 → { result, expr } (safe, no eval, arithmetic only)\nGET /tools/random?type=uuid → { value, type } (types: uuid, int, float, hex, alpha)\nUse case: LLM agents that need current time, safe math, or random values.\n","lang":"vi","translated":true,"requested_lang":"vi","content_markdown":"\n# Công cụ tiện ích\n\nCác endpoint `/tools` là tiện ích công khai — không yêu cầu xác thực. Chúng hữu\ní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\nnhiên.\n\n## GET /tools/time\n\nLấy thời gian server hiện tại, múi giờ và độ lệch UTC.\n\n```bash\ncurl https://synapse.schaefer.zone/tools/time\n```\n\nPhản hồi:\n\n```json\n{\n \"time\": \"2026-06-27T14:30:00.000Z\",\n \"timezone\": \"Europe/Berlin\",\n \"offset\": 120\n}\n```\n\nTrường hợp sử dụng: LLM agent cần biết \"bây giờ là mấy giờ\" để lên lịch, timestamp\nhoặc tính ngày tương đối.\n\n## GET /tools/calc\n\nMáy tính an toàn — chỉ số học, không có `eval()`. Hỗ trợ `+`, `-`, `*`, `/`,\n`%`, `(`, `)` và số.\n\n```bash\ncurl \"https://synapse.schaefer.zone/tools/calc?expr=(10+5)*3\"\n```\n\nPhản hồi:\n\n```json\n{\n \"result\": 45,\n \"expr\": \"(10+5)*3\"\n}\n```\n\n> [!TIP]\n> Sử dụng endpoint này thay vì cố gắng tính toán trong đầu hoặc qua phân tích\n> chuỗi. Nó an toàn (không thể tiêm code) và chính xác.\n\n### Toán tử được hỗ trợ\n\n- `+` cộng\n- `-` trừ\n- `*` nhân\n- `/` chia\n- `%` modulo\n- `(` `)` dấu ngoặc\n- Số (số nguyên và số thập phân)\n\n### Ví dụ\n\n```bash\ncurl \".../tools/calc?expr=2+2\" # → 4\ncurl \".../tools/calc?expr=3.14*100\" # → 314\ncurl \".../tools/calc?expr=100%7\" # → 2\ncurl \".../tools/calc?expr=(2+3)*4-1\" # → 19\n```\n\n## GET /tools/random\n\nTạo giá trị ngẫu nhiên.\n\n```bash\n# UUID v4\ncurl \"https://synapse.schaefer.zone/tools/random?type=uuid\"\n# → { \"value\": \"a1b2c3d4-...\", \"type\": \"uuid\" }\n\n# Integer (default range 0-100)\ncurl \"https://synapse.schaefer.zone/tools/random?type=int&min=1&max=10\"\n# → { \"value\": 7, \"type\": \"int\" }\n\n# Float\ncurl \"https://synapse.schaefer.zone/tools/random?type=float&min=0&max=1\"\n# → { \"value\": 0.7234, \"type\": \"float\" }\n\n# Hex string\ncurl \"https://synapse.schaefer.zone/tools/random?type=hex&min=8&max=16\"\n# → { \"value\": \"a3f7b2c1\", \"type\": \"hex\" }\n\n# Alphabetic string\ncurl \"https://synapse.schaefer.zone/tools/random?type=alpha&min=8&max=12\"\n# → { \"value\": \"kQmzPwXn\", \"type\": \"alpha\" }\n```\n\n### Tham số loại\n\n| Loại | Tham số | Đầu ra |\n|------|-----------|--------|\n| `uuid` | không có | Chuỗi UUID v4 |\n| `int` | `min`, `max` (mặc định 0-100) | Số nguyên |\n| `float` | `min`, `max` (mặc định 0-100) | Số thực |\n| `hex` | `min`, `max` (phạm vi độ dài, mặc định 8-16) | Chuỗi hex |\n| `alpha` | `min`, `max` (phạm vi độ dài, mặc định 8-16) | Chuỗi chữ cái |\n\n## Trường hợp sử dụng cho LLM agent\n\n### Tạo ID duy nhất\n\n```bash\nID=$(curl -s .../tools/random?type=uuid | jq -r .value)\ncurl -X POST .../memory -d \"{\\\"key\\\": \\\"task_$ID\\\", ...}\"\n```\n\n### Tính phần trăm\n\n```bash\nTOTAL=142\nDONE=87\nPERCENT=$(curl -s \".../tools/calc?expr=($DONE*100)/$TOTAL\" | jq -r .result)\necho \"Progress: $PERCENT%\"\n```\n\n### Lấy timestamp hiện tại\n\n```bash\nNOW=$(curl -s .../tools/time | jq -r .time)\ncurl -X POST .../var -d \"{\\\"key\\\": \\\"last_run\\\", \\\"value\\\": \\\"$NOW\\\"}\"\n```\n\n### Tạo dữ liệu kiểm thử\n\n```bash\nfor i in {1..10}; do\n NAME=$(curl -s \".../tools/random?type=alpha&min=5&max=10\" | jq -r .value)\n curl -X POST .../memory -d \"{\\\"key\\\": \\\"test_$i\\\", \\\"content\\\": \\\"$NAME\\\"}\"\ndone\n```\n\n## Bước tiếp theo\n\n- [Tổng quan API](/docs/api/overview) — tất cả nhóm endpoint\n- [Lỗi & Xử lý lỗi](/docs/api/errors)\n","content_html":"

Công cụ tiện ích

\n

Các endpoint /tools là tiện ích công khai — không yêu cầu xác thực. Chúng hữu\ní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\nnhiên.

\n

GET /tools/time

\n

Lấy thời gian server hiện tại, múi giờ và độ lệch UTC.

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

Phản hồi:

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

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\nhoặc tính ngày tương đối.

\n

GET /tools/calc

\n

Máy tính an toàn — chỉ số học, không có eval(). Hỗ trợ +, -, *, /,\n%, (, ) và số.

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

Phản hồi:

\n
{\n  "result": 45,\n  "expr": "(10+5)*3"\n}
Sử dụng endpoint này thay vì cố gắng tính toán trong đầu hoặc qua phân tích\nchuỗi. Nó an toàn (không thể tiêm code) và chính xác.

Toán tử được hỗ trợ

\n\n

Ví dụ

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

GET /tools/random

\n

Tạo giá trị ngẫu nhiên.

\n
# UUID v4\ncurl "https://synapse.schaefer.zone/tools/random?type=uuid"\n# → { "value": "a1b2c3d4-...", "type": "uuid" }\n\n# Integer (default range 0-100)\ncurl "https://synapse.schaefer.zone/tools/random?type=int&min=1&max=10"\n# → { "value": 7, "type": "int" }\n\n# Float\ncurl "https://synapse.schaefer.zone/tools/random?type=float&min=0&max=1"\n# → { "value": 0.7234, "type": "float" }\n\n# Hex string\ncurl "https://synapse.schaefer.zone/tools/random?type=hex&min=8&max=16"\n# → { "value": "a3f7b2c1", "type": "hex" }\n\n# Alphabetic string\ncurl "https://synapse.schaefer.zone/tools/random?type=alpha&min=8&max=12"\n# → { "value": "kQmzPwXn", "type": "alpha" }

Tham số loại

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
LoạiTham sốĐầu ra
uuidkhông cóChuỗi UUID v4
intmin, max (mặc định 0-100)Số nguyên
floatmin, max (mặc định 0-100)Số thực
hexmin, max (phạm vi độ dài, mặc định 8-16)Chuỗi hex
alphamin, max (phạm vi độ dài, mặc định 8-16)Chuỗi chữ cái
\n

Trường hợp sử dụng cho LLM agent

\n

Tạo ID duy nhất

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

Tính phần trăm

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

Lấy timestamp hiện tại

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

Tạo dữ liệu kiểm thử

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

Bước tiếp theo

\n\n","urls":{"html":"/docs/api/tools","text":"/docs/api/tools?format=text","json":"/docs/api/tools?format=json","llm":"/docs/api/tools?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}