> ## Documentation Index
> Fetch the complete documentation index at: https://docs.befailproof.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# مهارة AgentEye CLI Agent Skill

> توثيق مهارة AgentEye CLI Agent Skill.

مهارة **AgentEye CLI** (`agenteye-cli`) هي *مهارة Agent* قابلة للتثبيت تعلّم وكيل الترميز — Claude Code و Codex والأدوات المتوافقة — كيفية تشغيل نشر AgentEye لديك من خلال [`agenteye` CLI](/ar/agenteye/cli) من طلبات باللغة الإنجليزية العادية: *"هل هناك أي شيء معطل اليوم؟"*، *"أعطِ CI مفتاحاً يمكنه فقط دفع الأحداث"*، *"اعترف بحادثة الإطلاق وأسندها إليّ"*.

**ليست** خدمة أو ملف ثنائي منفصل. إنها حزمة تعليمات صغيرة تعمل فوق CLI الذي قمت بتثبيته بالفعل: ينفذ الوكيل أوامر `agenteye --json …`، ويحلل JSON النظيف، ويجيبك بالنثر. كل شيء يمكنه فعله، يمكنك فعله بنفسك بكتابة نفس الأوامر.

***

## كيف يتعلق بواجهات AgentEye الأخرى

توفر AgentEye لك أربع طرق للوصول إلى نفس البيانات والتحكم. يكملان بعضهما البعض:

| الواجهة                                                           | ما هي                                | حيث تعمل                                    | استخدمها عندما                                 |
| ----------------------------------------------------------------- | ------------------------------------ | ------------------------------------------- | ---------------------------------------------- |
| **[CLI](/ar/agenteye/cli)**                                       | مرجع الأوامر والعلامات لـ `agenteye` | محطتك الطرفية                               | تريد تشغيل أو برمجة أمر معين                   |
| **[وصفات CLI](/ar/agenteye/cli-recipes)**                         | أنماط `jq`/خط أنابيب جاهزة للنسخ     | محطتك الطرفية / البرامج النصية              | تقوم بربط CLI بالأتمتة                         |
| **مهارة CLI** (هذا المستند)                                       | باب أمامي باللغة الطبيعية على CLI    | وكيل الترميز لديك، على محطة العمل الخاصة بك | تريد أن *تسأل فقط* واترك الوكيل يختار الأمر    |
| **[مساعد ذكاء اصطناعي داخل لوحة التحكم](/ar/agenteye/assistant)** | دردشة مضمنة في لوحة التحكم           | حاوية `agent` داخلية في مجموعتك             | تريد أسئلة وأجوبة داخل لوحة التحكم حول بياناتك |

### مقابل مساعد ذكاء اصطناعي داخل لوحة التحكم — تمييز مهم

هذه أداتان مختلفتان تماماً بنطاقات تأثير مختلفة جداً:

* **مساعد ذكاء اصطناعي داخل لوحة التحكم** ([assistant.md](/ar/agenteye/assistant)) هو دردشة مضمنة في لوحة التحكم، مدعومة بحاوية `agent` داخلية. وهو **للقراءة فقط مع التأليف المحمي بالموافقة**: يمكنه صياغة الاستعلامات المحفوظة ولوحات التحكم، لكن كل عملية كتابة تتوقف مقابل نقرة الموافقة الصريحة، ولا تحذف أبداً. يتم التحكم فيه بواسطة إذن `agent:use` وترى فقط البيانات الخاصة بالمنظمة التي تعرضها.
* **مهارة CLI** تعمل على *محطة العمل الخاصة بك* داخل *وكيل الترميز الخاص بك* وتشغل `agenteye` CLI كـ **أنت**. يمكنها تنفيذ **السطح الكامل للـ CLI، بما في ذلك التعديلات** — إنشاء/تدوير/تعطيل مفاتيح API، وتغيير إعدادات المنظمة، وحل الحوادث، وحذف الاستعلامات المحفوظة — مقيدة فقط بأذونات تسجيل دخول CLI الخاص بك. تعاملها بنفس الحذر الذي تتعامل به مع تشغيل تلك الأوامر يدوياً.

***

## المتطلبات الأساسية

1. **`agenteye` CLI مثبت** وعلى `PATH` (انظر [cli.md](/ar/agenteye/cli) — `pipx install agenteye`).
2. **عنوان URL لوحة التحكم الخاص بك** معين (`AGENTEYE_DASHBOARD_URL`، أو ينقل الوكيل `--base-url`).
3. **جلسة تسجيل دخول**: شغّل `agenteye login` بنفسك أولاً. المهارة **لا تستطيع** إكمال تسجيل دخول رمز لمرة واحدة عبر البريد الإلكتروني لك — ستخبرك بتشغيل `agenteye login` إذا كانت الجلسة مفقودة أو انتهت صلاحيتها (رمز خروج CLI `4`).

***

## تثبيت المهارة

Agent Skills هي مجلدات تحتوي على `SKILL.md` (بالإضافة إلى مراجع اختيارية). تقوم بتثبيت مهارة `agenteye-cli` بوضع مجلدها حيث يبحث وكيلك عن المهارات:

* **Claude Code** — انسخ مجلد `agenteye-cli/` إلى `~/.claude/skills/` (متاح في كل مشروع) أو إلى `<your-repo>/.claude/skills/` (مقصور على هذا المستودع). يكتشفها Claude Code تلقائياً؛ تحقق من قائمة `/skills`، أو اسأل سؤالاً يتطابق مع وصفها.
* **Codex (OpenAI)** — يقرأ Codex نفس `SKILL.md`. ملف `agents/openai.yaml` المضمن يعين `allow_implicit_invocation: true`، لذلك يختار Codex المهارة تلقائياً عندما تتطابق المهمة؛ وإلا فاستدعها صراحةً باسم `$agenteye-cli`.

يتم الحفاظ على المهارة جنباً إلى جنب مع `agenteye` CLI وتوزيعها كجزء من حزمة AgentEye الخاصة بك — إذا لم يكن لديك مجلد `agenteye-cli`، فاتصل بجهة اتصال AgentEye الخاصة بك. لا شيء عنها مقيد: فهي لا تحتاج إلى صورة Docker أو بيانات اعتماد، لأنها تقود فقط CLI العام `agenteye` مقابل لوحة التحكم الخاصة بك.

***

## الأمان — التعديلات لا تطلب موجه عندما ينفذ وكيل CLI

**اقرأ هذا قبل السماح لوكيل بإجراء تغييرات.**

يطلب `agenteye` CLI عادةً *"هل أنت متأكد؟"* قبل إجراء مدمر. **يتخطى ذلك الأكيد تلقائياً عندما لا يكون متصلاً بمحطة طرفية — وهو بالضبط كيف يقوم به وكيل ترميز — و `--json` يتخطاه أيضاً.** لذا فإن موجه الأمان **لن** ينطلق للوكيل.

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

* `keys create` / `update` / `disable` / `regenerate`
* `users create` / `update` / `disable` / `enable`
* `settings set`
* `alerts create` / `update` / `delete` / `test`
* أوامر الكتابة `incidents`: `ack` / `assign` / `resolve` / `open` / `comment-add` / `comment-delete` / `subscribe` / `unsubscribe`
* `query create` / `update` / `delete`
* `agent rename` / `delete`
* `orgs switch`

كل شيء تحت **Observe** (`events`, `sessions`, `evals`, `errors`, `list`, `whoami`, `orgs list/current/perms`) للقراءة فقط ولا يغيّر أي شيء.

لأن الوكيل يعمل بصفتك **أنت**، فيمكنه فقط فعل ما يُسمح به بواسطة تسجيل دخولك — يتم حل الأذونات **لكل منظمة** (انظر [api-keys.md](/ar/agenteye/api-keys)). أمر تفتقر الإذن له يرجع كود الخروج `5` مع الإذن الدقيق المذكور، حتى يتمكن الوكيل من إخبارك بالضبط ما تطلبه من مسؤول بدلاً من الفشل بغموض.

***

## ما يمكنك السؤال عنه

تعيّن المهارة القصد باللغة الطبيعية إلى أمر `agenteye` الصحيح، مكتشفة القيم الصحيحة أولاً (`list <kind>`, `whoami`) حتى لا تخمّن:

* *"هل هناك أي شيء معطل / حريق في آخر 24 ساعة؟"* → `errors --since 24h --aggregate`، ثم تحليل.
* *"لماذا فشلت جلسة `run-001`؟"* → `events --session-id run-001 --all` + `evals --session-id run-001`.
* *"كيف تتجه الجودة هذا الأسبوع؟"* → `evals --aggregate --since 7d`، ثم حفر في التشغيلات منخفضة الدرجات.
* *"أعطِ CI مفتاحاً يمكنه فقط دفع الأحداث."* → `keys create ci --add events:add` (تذكر الأمر، ثم تنشئه وتلتقط السر لمرة واحدة).
* *"من لديه وصول؟ اجعل Dana للقراءة فقط."* → `users list` → `users update dana@… --permission-set read-only` (بعد تأكيدك).
* *"اعترف بحادثة الإطلاق وأسندها إليّ."* → `incidents list --state firing` → `incidents ack <id>` / `incidents assign <id> you@…`.

للأوامر الدقيقة والعلامات وأشكال JSON وراء هذه، انظر [cli.md](/ar/agenteye/cli) و [cli-recipes.md](/ar/agenteye/cli-recipes).

***

## انظر أيضاً

* **[CLI](/ar/agenteye/cli)** — مرجع الأمر والعلم الكامل لـ `agenteye`.
* **[وصفات CLI للوكلاء](/ar/agenteye/cli-recipes)** — أنماط `jq` والتعامل مع رموز الخروج جاهزة للنسخ.
* **[مساعد ذكاء اصطناعي](/ar/agenteye/assistant)** — المساعد داخل لوحة التحكم (لا تخلطه مع هذه مهارة الطرفية).
* **[مفاتيح API](/ar/agenteye/api-keys)** — نموذج الأذونات لكل منظمة الذي يحد من ما يمكن للمهارة فعله.