failproofai 1.0.1-beta.0 → 1.0.1

package/.next/standalone/docs-old/ar/agenteye/alerts.mdx

@@ -0,0 +1,63 @@
+---
+title: "التنبيهات"
+description: "اكتشف اللحظة التي يتجاوز فيها شيء ما حدك، على القناة التي يراقبها فريقك بالفعل، بدلاً من سماعها من العميل."
+---
+
+
+اكتشف اللحظة التي يتجاوز فيها شيء ما حدك، على القناة التي يراقبها فريقك بالفعل، بدلاً من سماعها من العميل. عيّن قاعدة مرة واحدة و Failproof AI Observability تفحصها وفقاً لجدول زمني، ثم ترسل إليك تنبيهاً عبر البريد الإلكتروني أو Slack أو webhook أو مباشرة في لوحة التحكم.
+
+![صفحة التنبيهات: شبكة من بطاقات قواعد التنبيهات، تعرض كل منها محفزها ونافذة التقييم والقنوات وشارة الخطورة (معلومات أو تحذير أو حرج)](/agenteye/images/alerts.png)
+*كل قاعدة تنبيه في نظرة واحدة: ما الذي تراقبه وعدد المرات والقنوات ومستوى الإلحاح.*
+
+## اعرف عن المشاكل قبل مستخدميك
+
+توقف عن تحديث لوحة التحكم على أمل اكتشاف انحدار. استخدم تنبيهاً كلما كانت هناك إشارة تريد أن تسمع عنها حتى لو لم يكن أحد يراقب، واجعلها تصل إلى حيث أنت بالفعل:
+
+- **البريد الإلكتروني**، لمن يجب أن يعرف.
+- **Slack**، رسالة غنية بزر ينقلك مباشرة إلى الحادثة.
+- **Webhook**، POST JSON لـ PagerDuty أو Opsgenie أو نقطة نهاية خاصة بك، مع توقيع اختياري حتى يتمكن المستقبل من الوثوق به.
+- **داخل لوحة التحكم**، هادئة بالتصميم، عندما تكون تضبط قاعدة ولا تريد إزعاج أحد حتى الآن.
+
+قم بإرفاق أي مزيج لقاعدة واحدة، وشدتها (معلومات أو تحذير أو حرج) تنتقل معها حتى تبدو الحالات الملحة ملحة.
+
+## بناء القاعدة في نموذج، وليس JSON
+
+تصف ما معنى أن يكون الشيء "معطلاً" في نموذج، و Failproof AI Observability تكتب القاعدة الأساسية لك. مواصفات JSON ليست سوى ما ينتجه هذا النموذج تحت الغطاء، حتى تتمكن من قراءتها لفهم قاعدة لكن نادراً ما تكتبها.
+
+![نموذج التنبيه الجديد: الاسم والوصف وزر التفعيل واختيار المحفز يعرض عتبة المقياس والـ SQL المخصص ودرجة التقييم والتقييم المركب والشروط لكل حدث](/agenteye/images/alert-new.png)
+*اختر محفزاً والنموذج يعدّل الحقول المناسبة؛ الحفظ يكتب القاعدة.*
+
+المسار السعيد سريع: سمِّه، اختر **محفز** (ما يجب مراقبته)، عيّن **العتبة والنافذة** (مدى السوء وعلى مدى كم من الوقت)، أرفق قناة واحدة على الأقل، ثم **احفظ** و**اختبر** لإرسال إخطار تركيبي وتأكيد أن كل وجهة متصلة. تحت الغطاء ينتج عن هذا مواصفات صغيرة مثل:
+
+```json
+{ "metric": "p95_latency_ms", "op": ">", "value": 5000, "window_secs": 900 }
+```
+
+لا تقتصر على نوع إشارة واحد. اختر المحفز الذي يطابق طريقة تفكيرك حول الخلل:
+
+| المحفز | ينطلق عندما |
+|---|---|
+| **عتبة المقياس** | يتجاوز مقياس محدد مسبقاً (معدل الخطأ أو كمون p95 أو p99 أو عدد الأحداث أو الأخطاء أو إنفاق الرموز) حدك على مدى نافذة |
+| **SQL مخصص** | الاستعلام المخصص للقراءة فقط يعيد صفاً أو قيمة يحسبها تتجاوز عتبة |
+| **درجة التقييم** | متوسط درجة المقيّم (مثل الهلوسة) يتجاوز عتبة |
+| **التقييم المركب** | عدة فحوصات درجات تجتمع مع أي أو الكل أو على الأقل منطق N، لاكتشاف انحدار يظهر فقط عبر الدرجات |
+| **لكل حدث** | يصل حدث واحد مطابق: وكيل محدد أو نوع خطأ محدد أو جزء رسالة |
+
+تحدق بالفعل في خلل على [صفحة الأخطاء](/ar/agenteye/error-tracking)؟ كل صف هناك به زر **+ تنبيه** يفتح نفس النموذج معبأ مسبقاً لاكتشاف هذا الخلل بالضبط مرة أخرى، حتى الحادثة التي قمت بفحصها للتو تصبح الحادثة التي ستنبهك في المرة القادمة.
+
+**حيث تجده:** التنبيهات موجودة في `/<org-slug>/alerts`. إنشاء وتحرير وحذف واختبار القواعد يتطلب `alerts:write`؛ `alerts:read` كافٍ للمراقبة. منتقي المستقبل يسرد أعضاء منظمتك حسب الاسم، حتى تتمكن من إنذار شخص ما دون مغادرة النموذج.
+
+## أنبهني فقط عندما يكون حقيقياً
+
+قياس خاطئ واحد يجب ألا يوقظك. **M من N** مرشح الضوضاء يتحكم في عدد الفحوصات القليلة الأخيرة التي يجب أن تفشل قبل أن ينطلق التنبيه فعلاً. عيّنه على **3 من 5** والقاعدة تنطلق فقط بعد أن تخترق ثلاثة من آخر خمس فحوصات، حتى تتوقف الإشارة المتذبذبة عن استدعاء الذئب؛ اتركه على الافتراضي **1 من 1** لينطلق عند أول انتهاك. تختار أيضاً عدد مرات تشغيل القاعدة، من إعدادات مسبقة بـ 1 دقيقة أو 5 دقائق أو 15 دقيقة أو ساعة واحدة، مطابقة لمدى سرعة حركة الإشارة الفعلية.
+
+## ما يحدث عندما ينطلق تنبيه
+
+يفتح انتهاك **حادثة** وينبه قنواتك مرة واحدة. من هناك يعترف فريقك بها ويعين مالكاً ويناقشها ويحلها، كل ذلك ضد سجل نظيف ومنسوب. لهذا سير العمل في الفحص منزل خاص به: انظر [الحوادث](/ar/agenteye/incidents).
+
+## ذات صلة
+
+- [الحوادث](/ar/agenteye/incidents): تتبع تنبيه منطلق من مفتوح إلى معترف به إلى محلول.
+- [تتبع الأخطاء](/ar/agenteye/error-tracking): تجميع إخفاقات الوكيل وترقية واحد إلى تنبيه بنقرة واحدة.
+- [لوحات التحكم](/ar/agenteye/dashboards): راقب اللوحات المشتركة التي تأتي منها العتبات التي تنبه عليها.
+- [CLI والوكلاء](/ar/agenteye/cli-and-agents): أنشئ تنبيهات وأقرّ الحوادث من محطتك الطرفية أو أدخلها في CI.

package/.next/standalone/docs-old/ar/agenteye/api-keys.mdx

@@ -0,0 +1,279 @@
+---
+title: "مفاتيح API"
+description: "تتحكم مفاتيح API بمن وما يمكنه الوصول إلى خادم Failproof AI Observability، بحيث يمكن لأداة جمع البيانات إرسال الأحداث دون الحصول على صلاحيات القراءة أو الإدارة."
+---
+
+تتحكم مفاتيح API بمن وما يمكنه الوصول إلى خادم Failproof AI Observability، بحيث يمكن لأداة جمع البيانات إرسال الأحداث دون الحصول على صلاحيات القراءة أو الإدارة. يحمل كل مفتاح واحداً أو أكثر من الصلاحيات، وكل صلاحية تتحكم في مسارات خادم محددة؛ فأنت تمنح فقط ما تحتاجه المهمة. تنشئ معظم عمليات النشر ثلاثة أنواع من المفاتيح فقط.
+
+## المفاتيح الثلاثة التي تحتاجها معظم عمليات النشر
+
+| المفتاح | الصلاحيات | من يستخدمه |
+|---|---|---|
+| مفتاح جامع البيانات | `events:add` | `agenteye-collector` على كل جهاز وكيل، لإرسال الأحداث. |
+| مفتاح قراءة لوحة التحكم | `events:read`, `keys:read` | عامل تشغيل أو تكامل يقرأ فقط يستعلم عن البيانات دون تغييرها. |
+| مفتاح إدارة التمهيد | جميع الصلاحيات | عامل التشغيل الذي يبدأ المثيل أولاً (ولوحة التحكم). يتم تغذيته من متغير البيئة `ADMIN_KEY`. راجع [مفتاح إدارة التمهيد](#bootstrap-admin-key). |
+
+ابدأ هنا. استخدم قائمة الصلاحيات الكاملة أدناه فقط عندما تحتاج إلى مفتاح مخصص أقل نطاقاً. راجع أيضاً [تخطيط المفتاح الموصى به](#recommended-key-layout) و[إنشاء المفاتيح](#creating-keys).
+
+---
+
+## الصلاحيات
+
+يفرض الخادم قائمة ثابتة من الصلاحيات؛ تتحكم كل واحدة في مسارات HTTP محددة. يحمل **مفتاح الإدارة** جميعها؛ يحمل المفتاح ذو النطاق المحدد المجموعة الفرعية التي تمنحها عند الإنشاء. يتم رفض سلاسل الصلاحيات غير المعروفة عند إنشاء مفتاح.
+
+> **ملاحظة:** صلاحيتان صحيحتان مخصصتان للعاملين البشريين/لوحة التحكم فقط ولا يمكن منحهما لمفتاح API: `orgs:admin` (إدارة المثيل، وهي حصرية للعاملين) و`keys:update`. يتم رفض الطلب إلى `POST /keys` أو `PATCH /keys/:id` الذي يحاول منح أي منهما برمز HTTP 422. راجع صف `keys:update` أدناه لمعرفة السبب في أن مفتاح الحامل قد ينشئ مفاتيح لكن لا يمكنه تعديلها.
+
+### بث الأحداث والاستعلام عنها
+
+| الصلاحية | مسارات HTTP | ما تسمح به |
+|---|---|---|
+| `events:add` | `POST /events` | بث دفعات من الأحداث من جامع البيانات. الصلاحية الوحيدة التي يحتاجها جامع البيانات. |
+| `events:read` | `GET /events`, `GET /events/latency_aggregate`, `GET /events/environments`, `GET /events/models`, `GET /sessions/:session_id/export` | الاستعلام عن الأحداث، وإدراج البيئات المعروفة، وإدراج معرفات النموذج المرئية في البيانات (تستخدمها عرض النماذج ومرشحات النموذج)، وحساب إجمالي الكمون الذي يقوي خريطة الحرارة / نطاق النسب المئوية، وتصدير جلسة عمل كـ JSONL. تكون نقاط نهاية facet شريط التصفية المشترك `GET /events/environments` و`GET /events/agent_ids` قابلة للوصول **باستخدام** `events:read` **أو** `evaluations:read`، بحيث تعيد صفحة الجلسات (المحدودة `evaluations:read`) استخدام نفس facet لكل منظمة. `GET /events/models` ليست واحدة منها: تتطلب `events:read`، لذا فإن المبدأ الذي يحتفظ بـ `evaluations:read` فقط يحصل على 403 منها. |
+
+### الجلسات والتقييمات
+
+| الصلاحية | مسارات HTTP | ما تسمح به |
+|---|---|---|
+| `evaluations:read` | `GET /sessions`, `GET /evaluations`, `GET /evaluations/aggregate`, `GET /evaluations/environments`, `GET /evaluation-jobs` | إدراج الجلسات، وقراءة نتائج التقييم، وصحة التقييم المجمعة التي تستخدمها لوحات التحكم، وحالة قائمة انتظار عمل التقييم. |
+| `evaluations:trigger` | `POST /sessions/:session_id/re-evaluate` | إعادة تقييم يدوية لجلسة منتهية. |
+
+### لوحات التحكم
+
+| الصلاحية | مسارات HTTP | ما تسمح به |
+|---|---|---|
+| `dashboards:read` | `GET /dashboards`, `GET /dashboards/:id`, `GET /dashboards/:id/tiles` | إدراج لوحات التحكم، وتحميل واحدة، وقراءة بلاطاتها. |
+| `dashboards:write` | `POST /dashboards`, `PUT /dashboards/:id`, `POST /dashboards/:id/tiles`, `PUT /dashboards/:id/tiles/:tile_id`, `DELETE /dashboards/:id/tiles/:tile_id`, `PUT /dashboards/:id/tiles/layout` | إنشاء وتعديل لوحات التحكم، وإضافة / تعديل / إزالة البلاطات، وإعادة ترتيب شبكة البلاطات. |
+| `dashboards:delete` | `DELETE /dashboards/:id` | حذف لوحة تحكم بالكامل (حذف على مستوى البلاطة موجود تحت `dashboards:write`). |
+
+### الاستعلامات المحفوظة (محرر SQL)
+
+| الصلاحية | مسارات HTTP | ما تسمح به |
+|---|---|---|
+| `queries:read` | `GET /queries`, `GET /queries/:id`, `GET /queries/schema` | إدراج الاستعلامات المحفوظة، وتحميل واحد، وفحص المخطط المقروء فقط الذي يستهدفه محرر الاستعلام. |
+| `queries:write` | `POST /queries`, `PUT /queries/:id` | إنشاء وتعديل الاستعلامات المحفوظة. لا يزال SQL يتم توجيهه من خلال نفس الدور المقروء فقط والتحقق من SQL المحمي كما هو الحال في استدعاء `queries:run`. |
+| `queries:delete` | `DELETE /queries/:id` | حذف استعلام محفوظ. |
+| `queries:run` | `POST /queries/run` | تنفيذ استعلامات SQL محفوظة أو مرتجلة ضد الدور المقروء فقط الذي يستخدمه محرر الاستعلام. |
+
+### مساعد ذكي
+
+| الصلاحية | مسارات HTTP | ما تسمح به |
+|---|---|---|
+| `agent:use` | `GET /agent/conversations`, `POST /agent/conversations`, `GET /agent/conversations/:id`, `PATCH /agent/conversations/:id`, `DELETE /agent/conversations/:id`, `PUT /agent/conversations/:id/messages` | التحدث إلى المساعد الذكي وإدارة محادثاتك الخاصة (الخاصة). مطلوب على **المستخدم** لرؤية لوحة المساعد؛ مفتاح المساعد نفسه هو `dashboard-assistant` ويتم تغذيته بشكل منفصل (انظر أدناه). |
+
+### مفاتيح API
+
+| الصلاحية | مسارات HTTP | ما تسمح به |
+|---|---|---|
+| `keys:create` | `POST /keys` | إنشاء مفتاح API جديد محدد النطاق. لا يمنح **تعديل صلاحيات مفتاح موجود (هذا هو `keys:update`). |
+| `keys:read` | `GET /keys` | إدراج المفاتيح الموجودة. لا يتم إرجاع الأسرار من قبل هذا الجانب. |
+| `keys:update` | `PATCH /keys/:id` | تعديل صلاحيات مفتاح موجود. صلاحية **حصرية للعاملين البشريين/لوحة التحكم**؛ لا يمكن تعيينها لمفتاح API (قد يقوم مفتاح الحامل بإنشاء مفاتيح لكن لا يمكنه تعديلها). |
+| `keys:disable` | `POST /keys/:id/disable` | إلغاء مفتاح. لا يمكن تعطيل المفاتيح المحمية (`admin`, `dashboard-assistant`); قم بتدويرها عبر متغير البيئة + إعادة تشغيل. |
+| `keys:regenerate` | `POST /keys/:id/regenerate` | تدوير سر المفتاح. لا يمكن إعادة إنشاء المفاتيح المحمية من خلال هذا الجانب. |
+
+### مستخدمو لوحة التحكم
+
+| الصلاحية | مسارات HTTP | ما تسمح به |
+|---|---|---|
+| `users:create` | `POST /users`, `GET /users/defaults` | دعوة مستخدم لوحة تحكم جديد (إصدار رمز بريد + رمز لمرة واحدة (OTP) تسجيل دخول) وقراءة مجموعة الصلاحيات الافتراضية المكونة بلوحة التحكم المستخدمة لتمرير نموذج الدعوة. |
+| `users:read` | `GET /users`, `GET /users/:id` | إدراج المستخدمين وتحميل سجل مستخدم واحد. |
+| `users:update` | `PUT /users/:id` | تعديل صلاحيات المستخدم. تُرسل التحديثات رسالة بريد تغيير الصلاحيات للمستخدم المتأثر وتصبح سارية عند طلبهم التالي؛ لا يلزم إعادة تسجيل الدخول. |
+| `users:delete` | `DELETE /users/:id`, `POST /users/:id/enable` | تعطيل مستخدم (إلغاء جلساته على الفور) وإعادة تفعيل مستخدم تم تعطيله سابقاً. |
+
+تدعم هذه الصلاحيات صفحة لوحة التحكم **المستخدمون**، حيث يتم عرض النطاقات الممنوحة لكل عضو كرقائق:
+
+![صفحة المستخدمون: بطاقة لكل مستخدم لوحة تحكم مع بريده الإلكتروني والصلاحيات الممنوحة والتحكم في التعديل/التعطيل](/agenteye/images/users.png)
+
+### الإعدادات التشغيلية
+
+| الصلاحية | مسارات HTTP | ما تسمح به |
+|---|---|---|
+| `settings:read` | `GET /settings`, `GET /settings/schema`, `GET /settings/model-context-windows`, `GET /settings/model-context-windows/resolve` | عرض الإعدادات التشغيلية المدارة بلوحة التحكم وبيانات التعريف الخاصة بها؛ إدراج تجاوزات نافذة السياق حسب النموذج؛ وحل النافذة الفعالة للنموذج. |
+| `settings:write` | `PUT /settings/:key`, `PUT /settings/model-context-windows`, `DELETE /settings/model-context-windows` | تعديل الإعدادات التشغيلية وإضافة أو تغيير أو إزالة تجاوزات نافذة السياق حسب النموذج. تؤثر التغييرات على الأحداث الجديدة دون إعادة تشغيل الخادم. |
+
+![صفحة الإعدادات: إعدادات تشغيلية مدارة بلوحة التحكم مثل عمليات تسجيل الدخول المسموحة وأعمار الجلسات / OTP، قابلة للتعديل دون إعادة تشغيل](/agenteye/images/settings.png)
+
+### التنبيهات والحوادث
+
+| الصلاحية | مسارات HTTP | ما تسمح به |
+|---|---|---|
+| `alerts:read` | `GET /alerts`, `GET /alerts/:id` | عرض تعريفات التنبيهات المكونة. |
+| `alerts:write` | `POST /alerts`, `PUT /alerts/:id`, `DELETE /alerts/:id`, `POST /alerts/:id/test` | إنشاء وتعديل وحذف وتشغيل تنبيهات تجريبية. |
+| `incidents:read` | `GET /alerts/incidents`, `GET /alerts/incidents/:iid`, `GET /alerts/incidents/:iid/comments`, `GET /alerts/incidents/:iid/subscribers` | عرض الحوادث وأثر الفحص الخاص بها. |
+| `incidents:write` | `POST /alerts/:id/incidents` | فتح حادثة يدوية ضد تنبيه موجود. |
+| `incidents:ack` | `POST /alerts/incidents/:iid/ack`, `POST /alerts/incidents/:iid/assign`, `POST /alerts/incidents/:iid/resolve`, `POST /alerts/incidents/:iid/comments`, `POST /alerts/incidents/:iid/subscribe`, `POST /alerts/incidents/:iid/unsubscribe` | الإقرار بالحوادث وتعيينها وحلها والتعليق عليها. |
+
+### التدقيقات
+
+| الصلاحية | مسارات HTTP | ما تسمح به |
+|---|---|---|
+| `audits:read` | `GET /audits`, `GET /audits/:id`, `GET /audits/:id/runs`, `GET /audits/findings`, `GET /audits/findings/:fid` | عرض تعريفات التدقيق وسجل التشغيل والنتائج. |
+| `audits:write` | `POST /audits`, `PUT /audits/:id`, `DELETE /audits/:id`, `POST /audits/:id/run`, `POST /audits/findings/:fid/status` | إنشاء وتعديل وحذف وتشغيل التدقيقات؛ فحص النتائج (إقرار / كتم صوت / رفض / حل / إعادة فتح / تعيين). |
+
+> **ملاحظة:** لإعطاء مفتاح سطح التدقيق، امنح `audits:*` بشكل صريح. راجع [ملاحظات الترقية والتوافق للخلف](#upgrade-and-backward-compatibility-notes) لمعرفة كيف تمت ترقية المستفيدين الموجودين عند شحن التدقيقات.
+
+> نقطة نهاية منتقي المستقبل `GET /alerts/recipients` (التي تسرد رسائل بريد الأعضاء التي يمكن لمحرر التنبيهات إخطارهم) قابلة للوصول من قبل صاحب **إما** `alerts:read` **أو** `alerts:write`، لذا يمكن لمحررات التنبيهات ملء المنتقي دون منح `users:read`.
+
+> مشاهد لوحة التحكم يحتاج **كل من** `dashboards:read` (لتحميل العروض المحفوظة) و`evaluations:read` (يتم حساب مقاييس الصحة من بيانات التقييم). امنح `dashboards:write` للسماح للمستخدم بإنشاء أو تعديل لوحات التحكم، و`dashboards:delete` لإزالتها.
+
+> `/health` و`/auth/*` (طلب OTP، التحقق من OTP، فحص الجلسة، تسجيل الخروج) غير معاثة بالتصميم؛ إنها تدفق تسجيل الدخول واختبار الحيوية. `GET /access-granters` يتطلب مفتاحاً صحيحاً لكن لا توجد صلاحية محددة، بحيث يمكن لأي مستخدم مسجل دخول أن يرى الإداريين الذين يجب الاتصال بهم بخصوص تغييرات الوصول.
+
+---
+
+## مجموعات الصلاحيات
+
+تتيح لك مجموعات الصلاحيات تطبيق دور محدد اسم بدلاً من انتقاء رموز فردية يدوياً في كل مرة. بدلاً من تحديد عشرات الصلاحيات واحدة تلو الأخرى لكل مستخدم جديد لوحة تحكم أو مفتاح API، تختار مجموعة، ويحمل كل شخص معين لها منحة متسقة وقابلة للمراجعة. يؤدي تعديل مجموعة مخصصة إلى إعادة تطبيق المنحة الجديدة على كل مستخدم معين لها بالفعل، بحيث يكون تغيير الدور تعديلاً واحداً بدلاً من مسح عبر كل عضو.
+
+يتم تغذية كل منظمة بثلاث مجموعات مدمجة:
+
+| المجموعة | الصلاحيات | المقصود ل |
+|---|---|---|
+| `read-only` | `events:read`, `keys:read`, `users:read`, `evaluations:read`, `dashboards:read`, `queries:read`, `settings:read`, `alerts:read`, `audits:read`, `incidents:read` | وصول العرض فقط عبر كل سطح تشغيلي. |
+| `standard` | كل شيء في `read-only`، بالإضافة إلى `evaluations:trigger`, `queries:run`, `incidents:ack`, `agent:use` | قراءة فقط بالإضافة إلى إجراءات في الوقت المناسب اليومية: تشغيل الاستعلامات وإعادة تقييم الجلسات والإقرار بالحوادث واستخدام المساعد الذكي. |
+| `admin` | كل صلاحية قابلة للتعيين | التحكم الكامل بالمنظمة. |
+
+المجموعات المدمجة الثلاث **غير قابلة للتغيير**؛ أسماؤها تعني دائماً نفس الشيء، لذا فإن `read-only` و`standard` و`admin` آمنة للرجوع إليها في السياسة والتمهيد. يمكن لعامل التشغيل إنشاء **مجموعات مخصصة** إضافية لنمذجة أدوار محددة لمنظمتك (على سبيل المثال، دور "مؤلف لوحة التحكم" أو دور "جامع البيانات فقط").
+
+يتم عرض المجموعات في لوحة التحكم وإدارتها عبر API في `GET /permission-sets` (الإدراج، المحدود بـ `users:read`) و`POST /permission-sets` / `PUT /permission-sets/:name` / `DELETE /permission-sets/:name` (إنشاء وتعديل وحذف مجموعة مخصصة، المحدودة بـ `settings:write`). يتم رفض حذف أو تعديل مجموعة مدمجة.
+
+عضوية المجموعة هي ما يدعم ميزتين أخريين:
+
+- **`DEFAULT_USER_PERMISSIONS`** (المنحة المحددة مسبقاً عندما يفتح المسؤول **+ مستخدم جديد**) تقتصر على مجموعة `standard`.
+- **الحد `--set`** على `agenteye-orgctl` (إدارة أعضاء المشغل) يبدأ عضواً من مجموعة محددة، والتي يمكنك بعد ذلك ضبطها بدقة باستخدام `--add` / `--remove`.
+
+> **ملاحظة:** عندما تتضمن مجموعة صلاحية غير قابلة لتعيين المفاتيح (على سبيل المثال مجموعة مخصصة تحمل `keys:update`)، يسقط تغذية مفتاح من تلك المجموعة الرموز غير القابلة للتعيين؛ سيتم رفض الخادم المفتاح برمز HTTP 422. مستخدمو لوحة التحكم ليسوا خاضعين لهذا القيد.
+
+---
+
+## مفتاح إدارة التمهيد
+
+مفتاح الإدارة هو بيانات اعتماد جذر واحدة تسمح لعامل التشغيل بإحضار الوصول من لا شيء: باستخدامه يمكنك صك كل مفتاح محدود النطاق آخر، ودعوة أول مستخدمي لوحة تحكم، وتكوين المثيل قبل وجود أي مفتاح آخر. إنه المفتاح الوحيد الذي لا تقوم بإنشاؤه من خلال مفاتيح API؛ يتم توفيره من البيئة بحيث يكون الخادم قابلاً للوصول عند بدء التشغيل الأول.
+
+اضبط متغير البيئة `ADMIN_KEY` على الخادم. في كل بدء تشغيل، يقوم الخادم بـ upsert هذه القيمة كمفتاح إدارة مع جميع الصلاحيات.
+
+للتدوير: غيّر `ADMIN_KEY` إلى سر جديد وأعد تشغيل الخادم.
+
+---
+
+## نطاق المنظمة
+
+**يتم إنشاء المنظمات وإدارتها خارج النطاق من قبل عامل التشغيل، وليس من خلال API المفاتيح هذا.** دورة حياة المنظمة والعضو (إنشاء / إعادة تسمية / حذف / تنظيف منظمة؛ إضافة / تحديث / إزالة عضو) يتم بـ **`agenteye-orgctl`** CLI؛ لا توجد واجهة HTTP API أو زر لوحة تحكم لذلك. ما لم يتغير: **يتم سك مفاتيح API لكل منظمة في لوحة التحكم (أو عبر API المفاتيح هذا)** من قبل أعضاء المنظمة.
+
+في نشر متعدد المنظمات، يملك كل مفتاح ينشئه عضو المنظمة (من خلال API المفاتيح هذا أو صفحة لوحة التحكم **المفاتيح**) **منظمة واحدة** ولا يمكنه أبداً قراءة أو كتابة بيانات تلك المنظمة فقط؛ يتم وضع الختم على المنظمة على المفتاح عند الإنشاء وتطبيقه على كل طلب. الاستثناء الوحيد هو المفاتيح الاستهلاكية الاثنان: مفتاح `admin` (المحدثة من `ADMIN_KEY`) ومفتاح `dashboard-assistant` (المحدثة من `AGENT_API_KEY`) هما **نطاق المثيل** (لا يحملان أي منظمة). تتحقق لوحة التحكم مع مفتاح `admin` بحيث يمكنها توكيل الطلبات لكل منظمة نيابة عن الأعضاء المسجلين. لا تحتاج عمليات النشر للتأجير الواحد إلى التفكير في هذا؛ جميع المفاتيح تابعة للمنظمة المدمجة `default`.
+
+---
+
+## إنشاء المفاتيح
+
+استخدم مفتاح الإدارة (أو أي مفتاح به صلاحية `keys:create`) لإنشاء مفاتيح محدودة النطاق إضافية.
+
+### مفتاح جامع البيانات (البث فقط)
+
+```bash
+curl -s -X POST http://your-server/keys \
+  -H "Authorization: Bearer $ADMIN_KEY" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "name": "prod-collector",
+    "key": "your-collector-secret",
+    "permissions": ["events:add"]
+  }'
+```
+
+### مفتاح لوحة التحكم (قراءة فقط)
+
+```bash
+curl -s -X POST http://your-server/keys \
+  -H "Authorization: Bearer $ADMIN_KEY" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "name": "dashboard",
+    "key": "your-dashboard-secret",
+    "permissions": ["events:read", "keys:read"]
+  }'
+```
+
+عند إنشاء مفتاح عبر HTTP API، تقدم قيمة `key` بنفسك؛ اختر سراً قوياً وخزّنه بأمان. (لوحة التحكم تعمل بالطريقة الأخرى: فهي تنتج سراً قوياً لك وتعرضه مرة واحدة عند الإنشاء؛ انظر [إدارة المفاتيح في لوحة التحكم](#key-management-in-the-dashboard).) يؤكد الرد أنه تم إنشاء المفتاح:
+
+```json
+{
+  "id": "550e8400-e29b-41d4-a716-446655440000",
+  "name": "prod-collector",
+  "permissions": ["events:add"],
+  "created_at": "2026-04-01T12:00:00Z"
+}
+```
+
+---
+
+## إدراج المفاتيح
+
+```bash
+curl -s http://your-server/keys \
+  -H "Authorization: Bearer $ADMIN_KEY"
+```
+
+لا يتم إرجاع أسرار المفاتيح في استجابات الإدراج، فقط المعرفات والأسماء والصلاحيات.
+
+---
+
+## تعطيل مفتاح
+
+يؤدي التعطيل إلى إلغاء الوصول على الفور دون حذف سجل المفتاح.
+
+```bash
+curl -s -X POST http://your-server/keys/<id>/disable \
+  -H "Authorization: Bearer $ADMIN_KEY"
+```
+
+---
+
+## إعادة إنشاء مفتاح
+
+ينتج سراً جديداً لمفتاح موجود. يتم إلغاء السر القديم على الفور.
+
+```bash
+curl -s -X POST http://your-server/keys/<id>/regenerate \
+  -H "Authorization: Bearer $ADMIN_KEY"
+```
+
+تتضمن الاستجابة السر الجديد بنص عادي، **معروض مرة واحدة فقط**.
+
+---
+
+## إدارة المفاتيح في لوحة التحكم
+
+توفر صفحة **المفاتيح** في لوحة التحكم واجهة مستخدم لجميع العمليات المذكورة أعلاه. تحتاج مفتاح به صلاحية `keys:read` لعرض القائمة، و`keys:create` / `keys:update` / `keys:disable` / `keys:regenerate` لإجراءات الإنشاء / التعديل / التعطيل / إعادة الإنشاء على التوالي. يختلف تعديل صلاحيات المفتاح (`keys:update`) عن إنشاء واحد (`keys:create`)، بحيث يمكنك منح عامل تشغيل القدرة على سك مفاتيح دون القدرة على إعادة تحديد نطاق الموجودة، أو العكس. يغطي مفتاح الإدارة كل هذه.
+
+عند إنشاء مفتاح من لوحة التحكم لا تقدم السر؛ تنتج لوحة التحكم سراً قوياً لك وتعرضه **مرة واحدة** عند الإنشاء. انسخه فوراً وخزّنه بأمان؛ لا يتم عرضه أبداً مرة أخرى، تماماً كما هو الحال مع إعادة الإنشاء. لا يزال بإمكانك انتقاء صلاحيات المفتاح مباشرة، أو تغذيتها من مجموعة صلاحيات (انظر أدناه).
+
+![صفحة مفاتيح API: بطاقة لكل مفتاح توضح اسمه والصلاحيات الممنوحة ووقت الإنشاء، مع إجراءات إعادة الإنشاء والتعطيل؛ يتم وضع علامة على المفاتيح المحمية مثل `admin`](/agenteye/images/api-keys.png)
+
+---
+
+## تخطيط المفتاح الموصى به
+
+| المفتاح | الصلاحيات | يستخدمه |
+|---|---|---|
+| `admin` (التمهيد عبر متغير بيئة `ADMIN_KEY`) | الكل | العمليات / الإعداد، ولوحة التحكم (المصادقة باستخدام `ADMIN_KEY`، توكيل طلبات المستخدم مع فحوصات الصلاحية) |
+| مفتاح جامع البيانات لكل مضيف | `events:add` | جامع البيانات على كل جهاز وكيل |
+| `dashboard-assistant` (التمهيد عبر متغير بيئة `AGENT_API_KEY`) | `events:read`, `evaluations:read`, `dashboards:read`, `dashboards:write`, `queries:read`, `queries:write`, `queries:run` | المساعد الذكي، المحدثة تلقائياً، **محمي**؛ لا يمكن تعديله من خلال API |
+| مفتاح قياس مساعد (اختياري) | `events:add` | قياس ذاتي للمساعد الذكي، إن تم تفعيله |
+
+> **ملاحظة:** يتم **تغذية مفتاح المساعد تلقائياً** من قبل الخادم من متغير بيئة `AGENT_API_KEY` (نفس السر الذي يقدمه الوكيل باسم `AGENTEYE_API_KEY`); لا يوجد خطوة سك مفاتيح يدويّة ولا مفتاح إدارة متورط. تم إصلاح صلاحياته في كود المصدر بحيث لا يمكن توسيع النطاق من خلال سوء التكوين: قراءة عبر الأحداث / التقييمات / لوحات التحكم، بالإضافة إلى dashboards-write و queries-read / write / run لتدفق الإنشاء من قبل استخدام "اطلب من AI كتابة استعلام". لا يزال كل SQL يمر عبر نفس الدور المقروء فقط والمسار SQL المحمي كما هو الحال مع الاستعلام المكتوب من قبل المستخدم، لذا فإن هذا يوسع سطح الإنشاء، وليس سطح البيانات؛ تبقى العمليات المدمّرة (`queries:delete`, `dashboards:delete`) عن قصد بعيداً عن مفتاح المساعد. مثل مفتاح `admin`، فهو **محمي**: لا يمكن تعطيله أو إعادة إنشاؤه من خلال API المفاتيح، فقط تدويره بتغيير `AGENT_API_KEY` وإعادة تشغيل. مستخدمو لوحة التحكم **بالإضافة إلى** يحتاجون إلى صلاحية `agent:use` لرؤية واستخدام المساعد. إذا قمت بتفعيل قياس ذاتي، امنح المساعد مفتاحاً منفصلاً `events:add` فقط.
+
+---
+
+## ملاحظات الترقية والتوافق للخلف
+
+أنت بحاجة فقط إلى هذه إذا كنت ترقي مثيلاً موجوداً؛ يمكن لعمليات النشر الجديدة تخطيها.
+
+> عند شحن التدقيقات، تمت توسيع المستفيدين الموجودين على طول نفس أشكال الأدوار مثل التنبيهات: اكتسب كل مستخدم ومجموعة صلاحيات تحمل `alerts:read` على `audits:read`، واكتسب كل صاحب `alerts:write` على `audits:write`. **لم يتم توسيع** مفاتيح API الموجودة. امنح `audits:*` لمفتاح بشكل صريح إذا كان يحتاج إلى سطح التدقيق.
+
+> يتم تحليل مانحات الرموز الموروثة لـ `alerts:ack` كـ `incidents:ack` بحيث يحتفظ في الوقت المناسب بالوصول دون إعادة صك. لم يعد الرمز قابلاً للتعيين من محرر مستخدمي لوحة التحكم؛ تقدم المصفوفة `incidents:ack` بدلاً من ذلك.
+
+---
+
+## الخطوات التالية
+
+- [Python SDK](/ar/agenteye/python-sdk): كيفية مصادقة كود الوكيل عند إرسال الأحداث.
+- [الأمان](/ar/agenteye/security): كيف يعمل تسجيل الدخول والتحكم في الوصول وعزل البيانات لكل منظمة.

package/.next/standalone/docs-old/ar/agenteye/assistant.mdx

@@ -0,0 +1,62 @@
+---
+title: "مساعد ذكاء اصطناعي"
+description: "اطرح سؤالاً على بيانات وكيلك بلغة إنجليزية عادية واحصل على إجابة مرتبطة مباشرة بالأدلة."
+---
+
+اطرح سؤالاً على بيانات وكيلك بلغة إنجليزية عادية واحصل على إجابة مرتبطة مباشرة بالأدلة. لا حاجة لكتابة SQL، ولا حاجة للحفر في لوحات المعلومات — مساعد **Failproof AI Observability** هو أسرع طريقة لأي شخص في فريقك للحصول على إجابات حول وكلائك.
+
+![مساعد Failproof AI Observability يجيب على سؤال بلغة إنجليزية عادية داخل لوحة المعلومات، يعرض جدول نشاط الوكيل المباشر، وتفصيل استخدام النموذج لكل وكيل، والخلاصات المكتوبة، مع عرض الاستعلامات التي أجراها بشكل مدمج](/agenteye/images/assistant.png)
+*اطرح السؤال بلغة إنجليزية عادية واحصل على إجابة مبنية من بياناتك الخاصة. هنا يقسم أي الوكلاء الأكثر انشغالاً وأي نماذج يستخدمونها، ويعرض الاستعلامات التي أجراها حتى تتمكن من التحقق من كل رقم.*
+
+لا شيء لتعلمه. افتح الدردشة، اكتب ما تريد معرفته، واتبع الروابط التي يعطيها لك:
+
+```
+You:  which sessions errored today?
+AI:   5 sessions errored today, newest first. Each one is linked:
+      • checkout-agent   14:02   tool timeout
+      • billing-agent    11:47   unhandled error
+      • ...and 3 more
+
+You:  summarize this session          (asked while viewing a run)
+AI:   This run took 12 steps across 3 tools and failed near the end when a
+      payment tool returned an error. It scored low on your "resolved" eval.
+      Links: the session, the failing event, and that evaluation.
+```
+
+## فقط اسأل، وانتقل مباشرة إلى الدليل
+
+تتوقف عن التخمين وتتوقف عن كتابة الاستعلامات. اسأل "كيف تتجه الجودة في الإنتاج هذا الأسبوع؟" أو "ما الجلسات التي حدثت فيها أخطاء اليوم؟" أو "لخص هذه الجلسة"، وتحصل على إجابة مباشرة في ثوان بدلاً من بناء استعلام وقراءته بنفسك.
+
+تأتي كل إجابة مع إثباتاتها. يربط المساعد الجلسات الدقيقة والاستعلامات المحفوظة ولوحات المعلومات التي استخدمها للوصول إلى الإجابة، حتى تتمكن من النقر والتحقق بدلاً من الثقة بكلامه. كما أنه **يدرك الصفحة**: اسأل عن "هذه الجلسة" وأنت تشاهد واحدة وهو يعرف بالفعل أي عملية تقصد. أعد فتح أي محادثة سابقة لاحقاً من محول السجل والتقط من حيث توقفت.
+
+## حول إجابة جيدة إلى استعلام محفوظ أو لوحة معلومات
+
+عندما تستحق إجابة الاحتفاظ بها، اطلب من المساعد حفظها. يصيغ SQL لاستعلام محفوظ، أو يجمع لوحة معلومات من تلك الاستعلامات، ثم يعرض لك بطاقة **Approve / Reject**. لا شيء يُكتب حتى تنقر على Approve، لذا تحصل على سرعة "فقط اسأل" مع الكلمة الأخيرة دائماً لك.
+
+في صفحة **Queries** يذهب خطوة أبعد ويصبح مؤلف SQL: صف الاستعلام الذي تريده ("عرض معدل الخطأ حسب الوكيل لآخر 7 أيام") وسيحول SQL مباشرة إلى المحرر، فاتحاً عرض diff حتى تتمكن من **Accept** أو **Reject** التغيير قبل أن يتم تطبيقه.
+
+![صفحة Observability Queries ومحررها SQL](/agenteye/images/query-lab.png)
+*صفحة Queries: هذا المحرر هو المكان الذي يحول فيه المساعد مسودة استعلام للقراءة فقط بالنسبة لك لقبولها أو رفضها.*
+
+كتابة SQL بالسؤال هنا يستخدم إذن `queries:run`، وهو نفس الإذن خلف زر **Run** في المحرر. الدردشة في أي مكان آخر تحتاج `agent:use`.
+
+## آمن للعطاء لكامل الفريق
+
+يمكنك فتح المساعد للجميع دون القلق بشأن ما قد يلمسه:
+
+- **يقرأ فقط ما يمكنك رؤيته بالفعل.** الإجابات مقيدة بأذوناتك القراءة الخاصة، لذا لا تتسع سطح البيانات أبداً.
+- **كل كتابة تنتظر لك.** الاستعلامات المحفوظة ولوحات المعلومات يتم إنشاؤها فقط بعد نقرك Approve الصريح، ولا توجد إعدادات تطفئ هذه البوابة.
+- **لا يمكنه حذف أي شيء.** لا يتم الكشف عن أداة حذف والمساعد لا يحتفظ بإذن حذف. عمليات الحذف تبقى في يديك، في لوحة المعلومات.
+- **يبقى داخل مؤسستك.** المساعد يرى فقط المؤسسة التي تشاهدها حالياً.
+- **أسئلتك تبقى لك.** الطلبات والإجابات تعيش في قاعدة بيانات Observability الخاصة بك؛ تسجيل تحليلات المنتج فقط بيانات وصفية الاستخدام، أبداً نص الطلب الخاص بك.
+
+## مكان البحث عنها
+
+يركب المساعد على الحافة اليمنى لكل صفحة تحت مؤسستك (`/<org-slug>/...`). انقر على السكة، أو اضغط على `⌘J` / `Ctrl+J`، لتوسيع لوحة الدردشة الكاملة، واسحب حافتها لتغيير الحجم؛ سيتم تذكر عرضك عند إعادة التحميل. تحتاج إلى إذن **`agent:use`** لاستخدامها، وإلا ستكون السكة رمادية. إذا لم يتم تشغيلها بعد لنشرك (فهي تحتاج اتصال LLM)، ستشاهد سكة خافتة بدلاً من دردشة عاملة.
+
+## ذات صلة
+
+- [CLI والوكلاء](/ar/agenteye/cli-and-agents)
+- [الاستعلامات](/ar/agenteye/queries)
+- [لوحات المعلومات](/ar/agenteye/dashboards)
+- [مجموعة التقييم](/ar/agenteye/evaluation-suite)

package/.next/standalone/docs-old/ar/agenteye/audits.mdx

@@ -0,0 +1,55 @@
+---
+---
+title: "التدقيق: محلل الموثوقية التلقائي الخاص بك"
+description: "Failproof AI Observability يبحث عن الأعطال التي لم تكتب قاعدة لها ويسلمك قائمة مهام مرتبة ومدعومة بالأدلة حول ما يجب إصلاحه بالضبط."
+---
+
+
+يبحث Failproof AI Observability عن الأعطال التي لم تكتب قاعدة لها ويسلمك قائمة مهام مرتبة ومدعومة بالأدلة حول ما يجب إصلاحه بالضبط. إنه مثل وجود محلل يمر عبر السجلات الخاصة بك كل ليلة، ثم يترك القائمة المختصرة على مكتبك في الصباح.
+
+<div style={{ position: "relative", width: "100%", paddingBottom: "56.25%", height: 0, overflow: "hidden", borderRadius: "12px", margin: "1.5rem 0" }}>
+  <iframe src="https://www.youtube.com/embed/C5nHKGQIqZQ?autoplay=1&mute=1&loop=1&playlist=C5nHKGQIqZQ&rel=0&playsinline=1" title="Watch: Automatically find where your agent is failing (2 min)" allow="autoplay; encrypted-media; picture-in-picture; fullscreen" allowFullScreen style={{ position: "absolute", top: 0, left: 0, width: "100%", height: "100%", border: 0 }}></iframe>
+</div>
+
+*جولة مدتها دقيقتان: من تشغيل مجدول إلى إصلاح يمكنك العمل عليه.*
+
+![صفحة التدقيق: وظائف متكررة تفحص جلساتك بحثاً عن أنماط الفشل، كل منها مع جدول زمني وحساسية](/agenteye/images/audits.png)
+*كل تدقيق هو وظيفة متكررة تستكشف جلساتك وتكتب توصيات مرتبة ومدعومة بالأدلة.*
+
+## توقف عن التخمين بشأن ما يجب إصلاحه بعد ذلك
+
+تمسك التنبيهات بالمشاكل التي تعرفها بالفعل أنك تراقبها. التدقيق يمسك بتلك التي لا تعرفها. في جدول زمني تحدده، يقرأ التدقيق عبر جميع جلسات الوكيل الخاصة بك ويبحث عن الأنماط التي تستحق الإصلاح، حتى تتمكن من قضاء وقتك في التصرف بناءً على النتائج بدلاً من التمرير عبر السجلات على أمل اكتشافها بنفسك.
+
+يستهدف التشغيل الواحد أنماط الفشل التي تكسر الوكلاء فعلاً في الإنتاج:
+
+- **مجموعات الأخطاء**: نفس الفشل يتكرر تحت سبب جذري مشترك.
+- **الانجراف مقابل الأساس**: السلوك ينزلق بهدوء بعيداً عن نطاق معروف جيد.
+- **فشل الهدف في النصوص**: التشغيل الذي انتهى تقنياً لكن لم يؤدِ المهمة أبداً.
+- **سوء استخدام الأداة**: الأداة الخاطئة أو الحجج السيئة أو الحلقات التي تحرق الاستدعاءات.
+- **المقايضات بين الجودة والتكلفة**: حيث تدفع أكثر من اللازم للمخرجات التي يمكنك الحصول عليها بأرخص.
+- **فجوات التغطية**: السلوك الذي لا يراقبه أي تقييم أو تنبيه.
+
+تقرر مدى صعوبة البحث باستخدام إعداد **الحساسية** الفردي (منخفض أو متوسط أو مرتفع)، حتى يتمكن الوكيل في بيئة الاختبار الضوضائية والوكيل المقيد في الإنتاج من أن يتم ضبط كل منهما إلى الإشارة التي تريدها.
+
+## كل توصية تأتي مع الإيصالات
+
+لا تضطر أبداً إلى تقبل النتيجة بحسن نية. كل توصية تستشهد بالجلسات الدقيقة التي جاءت منها و SQL التي أظهرتها، حتى تتمكن من فتح الدليل والتأكد من المشكلة بنقرة واحدة بدلاً من عكس هندسة مطالبة.
+
+عندما تتعلق النتيجة بأوراق اعتماد مسربة، تذهب خطوة أبعد وتربط أحداث الفرد التي طابقتها. انقر فوق واحد وستهبط على تلك اللحظة بالذات في الجلسة، محددة بالفعل، وليس أعلى نص طويل للتمرير خلاله. يسمي الرابط الحدث؛ لا ينسخ أبداً السر المكتشف إلى النتيجة، لذا فإن قراءة النتيجة لا تحدث في مكان ثانٍ حيث يتم كتابة بيانات اعتمادك. إذا لم يعد الحدث موجوداً لأن الجلسة مرت نافذة الاحتفاظ بك، تقول الصفحة ذلك بوضوح بدلاً من تركك تتساءل عما إذا كنت قد نقرت الشيء الخطأ.
+
+هذا أيضاً ما يحافظ على صدق التدقيق. يتحقق الخادم من أن كل جلسة مذكورة موجودة بالفعل **ويتجاهل أي توصية لا تصمد أدلتها**، لذا فإن التدقيق يحقق ولكن لا يخترع أبداً. ما يصل إلى قائمتك حقيقي وقابل للتكرار ومرتب حسب أهميته، مع أكبر الأرباح في الأعلى.
+
+## حول الإصلاح إلى درع حماية
+
+إصلاح مشكلة هو فقط نصف الفوز. النصف الآخر هو التأكد من أنه لا يمكنه العودة بهدوء. كل نتيجة تحمل **اختصار بنقرة واحدة يصيغ تنبيه تكرار**، مملوء مسبقاً بحافز بداية معقول يمكنك ضبطه. أغلق النتيجة، وسلح التنبيه، والمرة القادمة التي يظهر فيها هذا النمط ستتلقى إخطار بدلاً من اكتشافه مرة أخرى في تدقيق مستقبلي.
+
+## أين تجده
+
+يعيش التدقيق في لوحة التحكم في **`/<org-slug>/audits`** (الشريط الجانبي إلى *تحليل* إلى *التدقيق*). عرض التشغيل والنتائج يحتاج **`audits:read`**؛ إنشاء وتحرير وفرز التدقيق يحتاج **`audits:write`**. عين نطاق التدقيق والوتيرة، ثم اضغط **تشغيل الآن** عندما تريد النتائج على الفور بدلاً من انتظار الممر المجدول التالي.
+
+## ذات صلة
+
+- [التنبيهات](/ar/agenteye/alerts): احصل على إخطار في اللحظة التي يتم فيها تجاوز حد تعرفه بالفعل.
+- [التقييمات](/ar/agenteye/evaluations): سجل كل عملية تشغيل حتى تظهر انحدارات الجودة من تلقاء نفسها.
+- [تتبع الأخطاء](/ar/agenteye/error-tracking): جمّع واتبع الأخطاء التي يرميها الوكلاء الخاصون بك.
+- [الحوادث](/ar/agenteye/incidents): تتبع المشكلة التي يكتشفها التدقيق حتى إصلاحها.

package/.next/standalone/docs-old/ar/agenteye/cli-and-agents.mdx

@@ -0,0 +1,81 @@
+---
+---
+title: "واجهة سطر الأوامر"
+description: "نشر Failproof AI Observability بالكامل، أمر واحد فقط."
+---
+
+
+نشر Failproof AI Observability بالكامل، أمر واحد فقط. تحقق من بيئة الإنتاج، أنشئ مفتاح API، أو أقرّ حادثة دون مغادرة جهازك الطرفي، ثم قم بإجراء أي من ذلك في خط أنابيب CI، أو اترك لوكيل الترميز القيام به بلغة إنجليزية عادية.
+
+```bash
+pipx install agenteye
+agenteye login --email you@example.com      # a 6-digit code lands in your inbox
+agenteye --json sessions --since 24h         # every agent run from the last day, newest first
+```
+
+*واجهة سطر الأوامر `agenteye` تتواصل مع لوحة التحكم. إنها أداة مختلفة عن مجمّع البيانات، الذي يرسل الأحداث إلى الخادم.*
+
+## نشرك بالكامل، أمر واحد فقط
+
+توقف عن القفز بين علامات التبويب للإجابة على سؤال سريع. واجهة سطر الأوامر `agenteye` تقرأ بيانات نظامك وتدير مؤسستك من ملف تنفيذي واحد، لذا فإن الفحص الذي كان يعني النقر عبر لوحة التحكم يصبح سطر واحد يمكنك إعادة تشغيله أو إنشاء اختصار له أو لصقه في دليل التشغيل. تحصل على أربع واجهات:
+
+- **اقرأ بيانات نظامك:** `sessions` و `events` و `evals` و `errors`، مصفاة حسب الوقت والوكيل والبيئة.
+- **أدر مؤسستك:** `keys` و `users` و `settings` و `alerts` و `incidents`.
+- **قم بتشغيل التحليلات:** SQL المحفوظ بالإضافة إلى مشغل `query` مخصص على بيانات الأحداث لديك.
+- **اسأل المساعد:** `agent ask` يصل إلى نفس محلل القراءة فقط الذي تتحدث معه في لوحة التحكم.
+
+ثبّته مرة واحدة باستخدام `pipx`، وسجّل الدخول برمز 6 أرقام يُرسل بالبريد الإلكتروني، وأنت جاهز. تستمر الجلسة حوالي يوم واحد؛ أعد تشغيل `agenteye login` عند انتهاء صلاحيتها. استخدمه للتحقق من الإنتاج أو توفير مفتاح أو فرز حادثة نشطة، كل ذلك دون فتح متصفح:
+
+```bash
+agenteye errors --since 24h --aggregate      # what is breaking, grouped by error type
+agenteye incidents list --state firing       # what is on fire right now
+agenteye keys create ci --add events:add     # a key that can only push events, secret shown once
+```
+
+عادة واحدة يجب معرفتها: الخيارات العامة مثل `--json` تأتي قبل الأمر. `agenteye --json sessions` صحيح؛ `agenteye sessions --json` غير صحيح.
+
+## قم بكتابة نص، ادمجه في CI
+
+كل أمر يقبل `--json`، وهذا يغير كل شيء. JSON نظيف يذهب إلى stdout بينما حالة النظام والتحذيرات تذهب إلى stderr، لذا فإن التقاط `--json` ينبوب مباشرة إلى `jq` بدون سطر شاذ لإزالته. هذا هو ما يجعل واجهة سطر الأوامر جيدة بنفس القدر لك في المحث ولوكيل ترميز يحلل النتيجة:
+
+```bash
+agenteye --json sessions --since 24h --status error | jq -r '.sessions[].session_id'
+```
+
+إنها مبنية للعمل دون إشراف. تخطي المطالبات الأكيدة تلقائياً عندما لا يكون هناك محطة نصية مرفقة، لذا لا شيء يتعطل في خط الأنابيب، وكل أمر يعيد رمز خروج ذي معنى: `0` نجاح، `4` لم تقم بتسجيل الدخول، `5` تفتقد صلاحية (الرسالة تسميها، على سبيل المثال `alerts:write`)، `3` لوحة التحكم غير قابلة للوصول. يمكن للنص أن يتفرع على `4` لإعادة المصادقة أو على `5` لإخبارك بالضبط بما يجب أن تطلبه من مسؤول، بدلاً من الفشل العمياني.
+
+## اترك وكيل ترميز يتحكم به باللغة الإنجليزية العادية
+
+الأفضل من ذلك، لا يجب أن تتذكر أي من هذه الأعلام على الإطلاق. **مهارة واجهة سطر الأوامر** عبارة عن مجلد مهارة وكيل صغير يُسمى `agenteye-cli` يعلم وكيل ترميز مثل Claude Code أو Codex كيفية تشغيل واجهة سطر الأوامر من طلبات باللغة الإنجليزية البسيطة. اسأل "هل هناك أي شيء معطل اليوم؟" والوكيل يختار الأمر، ويقوم بتشغيله باسمك، ويجيب بشكل نثري.
+
+بالنسبة إلى Claude Code، اسحب مجلد `agenteye-cli` إلى `~/.claude/skills/` وسيتم اكتشافه تلقائياً. يوفر Failproof AI Observability المجلد؛ لا يوجد شيء إضافي للتثبيت، لأنه يقود فقط واجهة سطر الأوامر التي ثبتها بالفعل. قم بتسجيل الدخول بنفسك أولاً: المهارة لا يمكنها إكمال تسجيل الدخول برمز البريد الإلكتروني من أجلك.
+
+نظراً لأن الوكيل يقوم بتشغيل واجهة سطر الأوامر باسمك، فيمكنه القيام بكل شيء تسمح به عملية تسجيل الدخول الخاصة بك، القراءة والكتابة على حد سواء: إنشاء مفاتيح، تغيير الإعدادات، حل الحوادث. لا تظهر مطالبة "هل أنت متأكد؟" في واجهة سطر الأوامر لوكيل، لذا تمت كتابة المهارة لتوضيح الأمر الدقيق والانتظار لموافقتك قبل أي تغيير. أنت خطوة التأكيد.
+
+```text
+you    Why did session run-001 fail?
+
+agent  Running: agenteye --json events --session-id run-001 --all
+       The checkout-agent hit a TimeoutError on its third tool call.
+```
+
+البيانات المقروءة تبقى فورية، وكل كتابة تتوقف من أجلك:
+
+```text
+you    Give CI a key that can only push events.
+
+agent  This creates an API key. I'll run:
+         agenteye keys create ci --add events:add
+       OK to proceed?
+
+you    yes
+
+agent  Done. Key "ci" created with events:add only. The secret is shown once, so store it now.
+```
+
+## ذات صلة
+
+- [مرجع واجهة سطر الأوامر](/ar/agenteye/cli): كل أمر وعلم وشكل JSON.
+- [وصفات واجهة سطر الأوامر للوكلاء](/ar/agenteye/cli-recipes): أنماط `jq` التي يمكنك نسخها بسهولة ومعالجة رموز الخروج.
+- [مهارة وكيل واجهة سطر الأوامر](/ar/agenteye/cli-skill): ثبّت وقم بتشغيل مهارة `agenteye-cli`.
+- [مساعد ذكاء اصطناعي](/ar/agenteye/assistant): محلل لوحة التحكم الذي يتحدث معه `agent ask`.