# الأدوات المساعدة (الوقت، الحاسبة، عشوائي)
SUMMARY: نقاط نهاية الأدوات العامة — وقت الخادم، حاسبة آمنة، مولّد قيم عشوائية. لا تتطلب مصادقة.

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.

الأدوات المساعدة
نقاط النهاية  أدوات عامة — لا تتطلب مصادقة.
مفيدة لوكلاء LLM الذين يحتاجون وقتًا من جانب الخادم، أو حسابات آمنة، أو قيمًا
عشوائية.
GET /tools/time
الحصول على وقت الخادم الحالي، والمنطقة الزمنية، وإزاحة UTC.
[CODE BLOCK]
الاستجابة:
[CODE BLOCK]
حالة الاستخدام: وكلاء LLM الذين يحتاجون معرفة "كم الساعة الآن" للجدولة،
أو الطوابع الزمنية، أو حسابات التاريخ النسبية.
GET /tools/calc
حاسبة آمنة — حسابات حسابية فقط، دون . تدعم ، ، ، ،
، ، ، والأرقام.
[CODE BLOCK]
الاستجابة:
[CODE BLOCK]
> [!TIP]
> استخدم هذا بدلاً من محاولة إجراء الحسابات ذهنيًا أو عبر تحليل السلاسل.
> إنه آمن (لا يُمكن حقن كود) ودقيق.
المعاملات المدعومة
-  جمع
-  طرح
-  ضرب
-  قسمة
-  باقي القسمة
-   أقواس
- أرقام (صحيحة وعشرية)
أمثلة
[CODE BLOCK]
GET /tools/random
توليد قيم عشوائية.
[CODE BLOCK]
معاملات النوع
| النوع | المعاملات | المخرجات |
|------|-----------|--------|
|  | لا شيء | سلسلة UUID v4 |
|  | ،  (افتراضي 0-100) | عدد صحيح |
|  | ،  (افتراضي 0-100) | عدد عشري |
|  | ،  (نطاق الطول، افتراضي 8-16) | سلسلة hex |
|  | ،  (نطاق الطول، افتراضي 8-16) | سلسلة أبجدية |
حالات الاستخدام لوكلاء LLM
توليد معرّفات فريدة
[CODE BLOCK]
حساب النسب المئوية
[CODE BLOCK]
الحصول على الطابع الزمني الحالي
[CODE BLOCK]
توليد بيانات اختبار
[CODE BLOCK]
الخطوات التالية
- نظرة عامة على الـ API — جميع مجموعات نقاط النهاية
- الأخطاء ومعالجتها