Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
2 changes: 1 addition & 1 deletion docs/admin/keys-and-permissions.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -54,7 +54,7 @@ Key secrets are shown when created or regenerated. Store them in a secret manage
| Events | `events:add`, `events:read` |
| Keys | `keys:create`, `keys:read`, `keys:disable`, `keys:regenerate`; `keys:update` is human-session only |
| Users | `users:create`, `users:read`, `users:update`, `users:delete` |
| Evaluations | `evaluations:read`, `evaluations:trigger` |
| Evaluations | `evaluations:read`, `evaluations:trigger`, `evaluations:run` |
| Dashboards | `dashboards:read`, `dashboards:write`, `dashboards:delete` |
| Queries | `queries:read`, `queries:write`, `queries:delete`, `queries:run` |
| Assistant | `agent:use` |
Expand Down
49 changes: 24 additions & 25 deletions docs/ar/admin/keys-and-permissions.mdx
Original file line number Diff line number Diff line change
@@ -1,30 +1,29 @@
---
---
title: "المفاتيح والأذونات"
description: "إنشاء مفاتيح API ذات نطاق محدد للآلات والأتمتة والمشغلين."
description: "أنشئ مفاتيح API محدودة النطاق للآلات والأتمتة والمشغلين."
icon: "key-round"
---

تنتمي مفاتيح API إلى منظمة وتحمل أذونات صريحة. استخدم مفاتيح منفصلة لإدراج العوامل وتسليم السياسات والمقيمين والأتمتة في CI والنصوص الإدارية.
تنتمي مفاتيح API إلى مؤسسة وتحمل أذونات صريحة. استخدم مفاتيح منفصلة لاستقبال الوكيل وتسليم السياسة والمقيّمون والأتمتة المستمرة والبرامج الإدارية.

## إنشاء وتدوير المفتاح
## إنشاء وتدوير مفتاح

<Tabs>
<Tab title="Dashboard">
1. انتقل إلى **AdministrationKeys**، وحدد **new key**، وأدخل اسم الحمل الكروي.
2. اختر مجموعة أذونات واضبط الأذونات الفردية فقط عندما تكون المجموعة المعرفة مسبقًا غير كافية.
3. أنشئ المفتاح وانسخ سره لمرة واحدة فورًا.
4. افتح المفتاح لاحقًا لتحديث المنح أو تعطيله أو إعادة إنشاء السر.
<Tab title="لوحة التحكم">
1. انتقل إلى **الإدارةالمفاتيح**، اختر **مفتاح جديد**، وأدخل اسم حمل العمل.
2. اختر مجموعة أذونات واضبط الأذونات الفردية فقط عندما تكون القائمة المحددة غير كافية.
3. أنشئ المفتاح وانسخ سره لمرة واحدة فوراً.
4. افتح المفتاح لاحقاً لتحديث الأذونات أو تعطيله أو إعادة تعيين السر.

درج الإنشاء هو المكان الذي تختار فيه أضيق المنح المطلوبة من قبل الحمل الكروي.
درج الإنشاء هو المكان الذي تختار فيه أضيق الأذونات المطلوبة من قبل حمل العمل.

![درج مفتاح API جديد يحتوي على مجموعات أذونات مسبقة الصنع والمنح الفردية.](/images/dashboard/key-create.png)
![درج مفتاح API جديد يعرض قوائم الأذونات المحددة والأذونات الفردية.](/images/dashboard/key-create.png)

بعد الإنشاء، تعرض صفحة المفاتيح البيانات الوصفية الثابتة وإجراءات الإدارة. لا يتم عرض السر لمرة واحدة مرة أخرى.
بعد الإنشاء، تعرض صفحة المفاتيح البيانات الوصفية الدائمة وإجراءات الإدارة. السر لمرة واحدة لن يتم عرضه مرة أخرى.

![صفحة مفاتيح API تعرض أذونات المفتاح ووقت الإنشاء وإجراءات إعادة الإنشاء والتعطيل.](/images/dashboard/api-keys.png)
![صفحة مفاتيح API تعرض أذونات المفتاح ووقت الإنشاء وإجراءات إعادة التعيين والتعطيل.](/images/dashboard/api-keys.png)

استخدم هذه القائمة لمراجعة المنح بانتظام وتعطيل المفاتيح التي لم تعد تتطابق مع حمل كروي نشط.
استخدم هذه القائمة لمراجعة الأذونات بانتظام وتعطيل المفاتيح التي لا تعود تعيّن إلى حمل عمل نشط.
</Tab>
<Tab title="CLI">
```bash
Expand All @@ -37,39 +36,39 @@ icon: "key-round"
fp keys disable production-agents
```

أعد توجيه أو احتفظ بإخراج الإنشاء/إعادة الإنشاء بأمان؛ يتم إرجاع السر مرة واحدة.
أعد توجيه أو التقط مخرجات الإنشاء/إعادة التعيين بشكل آمن؛ يتم إرجاع السر مرة واحدة فقط.
</Tab>
</Tabs>

الأذونان المطلوبان لآلة Failproof AI متصلة مستقلان:
الأذونتان المطلوبتان من قبل آلة Failproof AI المتصلة مستقلتان:

- `events:add` يرسل الأحداث وبيانات الجلسة.
- `policies:pull` يسترجع نشرات السياسة المعينة.

يتم عرض أسرار المفاتيح عند إنشاؤها أو إعادة إنشاؤها. قم بتخزينها في مدير السر وقم بتدويرها دون إعادة استخدام بيانات المشغل التفاعلية.
يتم عرض أسرار المفاتيح عند إنشاؤها أو إعادة تعيينها. قم بتخزينها في مدير الأسرار وأدرها دون إعادة استخدام بيانات اعتماد المشغل التفاعلية.

## فهرس الأذونات
## كتالوج الأذونات

| المنطقة | الأذونات |
| --- | --- |
| الأحداث | `events:add`, `events:read` |
| المفاتيح | `keys:create`, `keys:read`, `keys:disable`, `keys:regenerate`; `keys:update` للجلسات البشرية فقط |
| المفاتيح | `keys:create`, `keys:read`, `keys:disable`, `keys:regenerate`؛ `keys:update` للجلسات البشرية فقط |
| المستخدمون | `users:create`, `users:read`, `users:update`, `users:delete` |
| التقييمات | `evaluations:read`, `evaluations:trigger` |
| لوحات المعلومات | `dashboards:read`, `dashboards:write`, `dashboards:delete` |
| التقييمات | `evaluations:read`, `evaluations:trigger`, `evaluations:run` |
| لوحات التحكم | `dashboards:read`, `dashboards:write`, `dashboards:delete` |
| الاستعلامات | `queries:read`, `queries:write`, `queries:delete`, `queries:run` |
| المساعد | `agent:use` |
| الإعدادات | `settings:read`, `settings:write` |
| التنبيهات | `alerts:read`, `alerts:write` |
| المشاكل | `issues:read`, `issues:create`, `issues:close` |
| التدقيق | `audits:read`, `audits:write` |
| عمليات التدقيق | `audits:read`, `audits:write` |
| السياسات | `policies:read`, `policies:write`, `policies:pull` |
| الاستخدام | `usage:read` |

`orgs:admin` محجوز لمشغل المثيل ولا يمكن منحه لمفتاح منظمة أو عضو عادي. يتم قبول رموز `incidents:*` و `alerts:ack` المتقاعدة للتوافقية وتطبيع الأذونات `issues:*` الحالية.
`orgs:admin` محجوز لمشغل المثيل ولا يمكن منحه لمفتاح تنظيمي أو عضو عادي. يتم قبول الرموز المتقاعدة `incidents:*` و `alerts:ack` للتوافق وتطبيعها على أذونات `issues:*` الحالية.

مجموعات الأذونات المدمجة هي `read-only` و `standard` و `admin`. يضيف `standard` تشغيل التقييم وتنفيذ الاستعلامات والاستجابة للمشاكل واستخدام المساعد إلى أذونات القراءة. يؤدي إنشاء المفتاح إلى إزالة المنح التي تقتصر على البشر حتى عندما تحتوي مجموعة الأذونات عليها.
مجموعات الأذونات المدمجة هي `read-only` و `standard` و `admin`. يضيف `standard` تفعيل التقييم وتنفيذ الاستعلام والاستجابة للمشاكل واستخدام المساعد إلى أذونات القراءة. ينزع إنشاء المفتاح الأذونات الخاصة بالبشر فقط حتى عندما تحتوي مجموعة الأذونات عليها.

<Warning>
يمكن لمفاتيح النطاق على مستوى المثيل تحديد منظمة باستخدام رأس `X-AgentEye-Org`. قم بتعيينه بشكل صريح على النشرات متعددة المنظمات؛ قد يؤدي حذفه إلى تحديد المنظمة الافتراضية.
يمكن لمفاتيح النطاق الموسع اختيار منظمة من خلال رأس `X-AgentEye-Org`. اضبطه بصراحة في النشرات متعددة المنظمات؛ قد يؤدي الإغفال إلى تحديد المنظمة الافتراضية.
</Warning>
1 change: 0 additions & 1 deletion docs/ar/admin/overview.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,4 @@
---
---
title: "الإدارة"
description: "تشغيل الوصول والاستخدام والمنظمات والأمان دون دمجها في سير عمل الموثوقية."
icon: "settings-2"
Expand Down
1 change: 0 additions & 1 deletion docs/ar/admin/usage.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,4 @@
---
---
title: "الاستخدام"
description: "فحص استهلاك المنظمة والنافذة الفعالة للفواتير."
icon: "chart-no-axes-combined"
Expand Down
1 change: 0 additions & 1 deletion docs/ar/audits/agent-contracts.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,4 @@
---
---
title: "سياق الوكيل"
description: "أخبر المراجعات بما يجب أن يفعله كل وكيل، وما يجب أن ينتجه، وما يجب أن لا يفعله أبداً."
icon: "bot"
Expand Down
1 change: 0 additions & 1 deletion docs/ar/audits/alerts.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,4 @@
---
---
title: "التنبيهات"
description: "كتشف تكرار الحوادث وإعادة توجيهها إلى المستجيبين المناسبين."
icon: "bell-ring"
Expand Down
1 change: 0 additions & 1 deletion docs/ar/audits/cadence.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,4 @@
---
---
title: "تكرار المراجعة"
description: "حدد موعد تشغيل المراجعات المتكررة وكمية البيانات التي تراجعها."
icon: "calendar-clock"
Expand Down
1 change: 0 additions & 1 deletion docs/ar/audits/findings-and-issues.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,4 @@
---
---
title: "النتائج والمشاكل"
description: "تحويل أدلة التدقيق إلى عمل إعادة معالجة مملوك وقابل للتتبع."
icon: "clipboard-check"
Expand Down
1 change: 0 additions & 1 deletion docs/ar/audits/recipes.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,4 @@
---
---
title: "وصفات التدقيق"
description: "أهداف البداية للتحقيقات الشائعة لفشل الوكيل."
icon: "book-open-check"
Expand Down
1 change: 0 additions & 1 deletion docs/ar/audits/run.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,4 @@
---
---
title: "تشغيل ومراجعة التدقيق"
description: "قم بتشغيل التدقيق والتحقق من نطاقه وفحص النتائج الناتجة."
icon: "play"
Expand Down
55 changes: 55 additions & 0 deletions docs/ar/evaluations/deploy.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,55 @@
---
title: "نشر وإصدار تقييم"
description: "نشر نسخة ثابتة، اطلع على ما هو مباشر، انشر نسخ جديدة، استعد للإصدار السابق، وسجل الجلسات التي لديك بالفعل."
icon: "cloud-upload"
---

## نشره

حدد **نشر `<key>@<version>`** في أسفل صفحة التأليف. تصبح النسخة ثابتة بمجرد نشرها: من ذلك الحين فصاعداً، كل جلسة تنتهي وينطبق عليها الشرط يتم تسجيلها بها.

## اطلع على ما هو مباشر

**تحليل → تأليف التقييم** يسرد تعريفات المؤسسة المستضافة، التقييمات التي يقوم بها مُقيّم الإدارة. يعرض كل صف:

- اسمه ومفتاحه وإصداره ونوع النتيجة
- مجموع اختياره المصدر، الذي يميز الإصدارات المنشورة عن بعضها دون فتح الكود
- ما إذا كان **شرطياً** أو يعمل على **جميع الجلسات المكتملة** — الشرط هو ما يحصر التقييم على وكلاء أو بيئات معينة
- المهلة الزمنية والعلامات ووقت آخر تغيير له

![قائمة التعريفات المستضافة: اسم كل تقييم ومفتاحه وإصداره ونوع النتيجة والمجموع والمهلة الزمنية والنطاق، مع نسخة جديدة وتفعيل أو تعطيل.](/images/dashboard/eval-definitions.png)

ابحث في القائمة أو صفّيها حسب الحالة. التقييمات التي يسجلها عامل العمل الخاص بك لا تُدرج هنا؛ النتائج الخاصة بها تحمل علامة **عميل** على [صفحة التقييمات](/ar/sessions/evaluations)، والتقييمات المستضافة تحمل **إدارة**.

يمكن للمؤسسة أن تمتلك ما يصل إلى 100 تقييم مستضاف مختلف مفعل في المرة الواحدة.

## نشر نسخة جديدة

حدد **نسخة جديدة** على صف. تفتح صفحة التأليف مع كود تلك النسخة؛ غيّره واختبره ونشره. ينتقل المفتاح ونوع النتيجة ولا يمكن أن يتغيرا.

نشر خليفة يعطّل سابقه ويبقيه على القائمة. تحتفظ النتائج بالنسخة التي أنتجتها، لذا يوضح الرسم البياني بالضبط متى تولت المنطق الجديد.

## استعد للإصدار السابق

حدد **تعطيل** على النسخة الحالية و**تفعيل** على الإصدار الذي تريده مرة أخرى. لا يتم حذف أي شيء، وكل نتيجة تبقى كما هي.

## إيقاف التقييم

حدد **تعطيل**. بدون نسخة مفعلة، يتوقف عن العمل على الجلسات الجديدة. لإيقاف تقييم يقوم به عامل العمل الخاص بك، توقف عن تسجيله: أزله من العامل أو أوقف العامل.

## تسجيل الجلسات التي لديك بالفعل

التقييم يعمل للأمام: نسخة تُنشر الآن لا تسجل جلسة انتهت قبلها. لتسجيل السجل، افتح **تسجيل الجلسات التي لديك بالفعل** على صفحة تأليف التقييم، واختر نافذة تصل إلى 90 يوم وبشكل اختياري تقييم واحد فقط، وعد قبل أن تعمل. العدد هو بالضبط ما سيعمل، وكل زوج جلسة وتقييم فيه قابل للفواتير.

يملأ الفجوات فقط. جلسة لديها بالفعل نتيجة لذلك التقييم تحتفظ بها، والعمل على نفس النافذة مرتين لا يسجل شيئاً جديداً.

لتسجيل جلسة واحدة مرة أخرى — بعد إصلاح أو لجلسة لم تنته بنظافة — حدد **إعادة تقييم** على صفحتها. تُضاف النتيجة الجديدة إلى سجل الجلسة؛ تبقى الأولى.

## الأذونات

| الإذن | يتيح لك |
| --- | --- |
| `evaluations:read` | مشاهدة النتائج وفتح صفحة تأليف التقييم |
| `evaluations:trigger` | مشاهدة ونشر وإصدار وتفعيل وتعطيل التعريفات المستضافة؛ اختبارها؛ تسجيل السجل؛ إعادة تقييم جلسة |
| `events:read` | الاختبار على جلسات حقيقية وتأسيس المسودات في مفاتيح البيانات الخاصة بك، بالإضافة إلى `evaluations:trigger` |
| `evaluations:run` | تشغيل عامل المقيّم الخاص بك |
44 changes: 44 additions & 0 deletions docs/ar/evaluations/overview.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,44 @@
---
title: "تقييم الوكلاء"
description: "قيّم كل جلسة منتهية باستخدام التقييمات التي تحددها: فحوصات Python مستضافة، أو حكام LLM في العامل الخاص بك."
icon: "gauge"
---

يسجل التقييم جلسة وكيل منتهية. عند انتهاء جلسة، يتم تشغيل كل تقييم مفعّل ينطبق عليها وتسجيل ما وجدته، مع التفاصيل التي يمكنك قراءتها بجانب التتبع:

- **درجة** من 0 إلى 1، مع إمكانية تحديدها كناجحة أو فاشلة
- **مقياس**، مثل عدد، أو مدة، أو تكلفة، مع وحدتها
- **تأكيد**، إما أنه نجح أو لم ينجح

## نوعان من المقيّمين

| | Python مستضاف | العامل الخاص بك |
| --- | --- | --- |
| مكتوب | في لوحة التحكم، تحت **Analyze → eval authoring** | في Python، باستخدام [Evaluator SDK](/ar/reference/evaluator-sdk) |
| يعمل | على مقيّم Failproof AI المُدار، في بيئة معزولة | على البنية التحتية الخاصة بك |
| الأفضل لـ | الفحوصات الحتمية المستندة إلى الكود | حكام LLM، استدعاءات النماذج، الحزم، الأسرار، الوصول إلى الشبكة، المعالجة الثقيلة |

Python المستضاف متعمد الصغر: تعبير واحد، بدون استيرادات، بدون شبكة. أي شيء يتطلب نموذج — مثل حكم LLM يسجل ما إذا كانت الإجابة ذات صلة — يعمل في العامل الخاص بك بدلاً من ذلك. لا يحتاج أي من النوعين إلى اتصال واردة: يطالب العمال بالجلسات المنتهية ويقدمون النتائج عبر HTTPS الصادرة.

## كل منظمة تقيّم وكلاءها الخاصة

التقييمات تنتمي إلى المنظمة التي تحددها. تكتب كل منظمة في النسخة الخاصة بها — فحوصاتها الخاصة، وشروطها، وحدودها، وتسمياتها — وتصدر نسخًا وتنشرها دون التأثير على أي نسخة أخرى، وترى النتائج الخاصة بها فقط. صفّ تلك النتائج حسب الوكيل والبيئة والتقييم والوقت، أو اسأل المساعد عنها.

## من المسودة الأولى إلى الدرجات المباشرة

<Steps>
<Step title="اكتبها">
اشرح ما يجب قياسه واترك للمساعد صياغة مسودة، أو اكتبها بنفسك. انظر [كتابة التقييم](/ar/evaluations/write).
</Step>
<Step title="اختبرها">
قم بتشغيلها على جلسات حقيقية قبل إطلاقها مباشرة؛ لا يتم حفظ أي شيء. انظر [اختبار التقييم](/ar/evaluations/test).
</Step>
<Step title="نشرها ورقم نسختها">
انشر نسخة ثابتة، ونشر نسخًا جديدة مع تطورها، والعودة إلى نسخة سابقة. انظر [النشر والإصدار](/ar/evaluations/deploy).
</Step>
<Step title="اقرأ النتائج">
مثّل الدرجات بيانيًا على مدار الوقت، وقارن بين الوكلاء والبيئات، واسأل المساعد. انظر [قراءة نتائج التقييم](/ar/sessions/evaluations).
</Step>
</Steps>

التقييم يعمل للأمام: نسخة تم نشرها الآن تسجل الجلسات التي تنتهي من الآن فصاعدًا. لتسجيل الجلسات التي لديك بالفعل، [املأ الفجوات](/ar/evaluations/deploy#score-sessions-you-already-have).
Loading