الانتقال إلى المحتوى الرئيسي
مهارة AgentEye CLI (agenteye-cli) هي مهارة Agent قابلة للتثبيت تعلّم وكيل الترميز — Claude Code و Codex والأدوات المتوافقة — كيفية تشغيل نشر AgentEye لديك من خلال agenteye CLI من طلبات باللغة الإنجليزية العادية: “هل هناك أي شيء معطل اليوم؟”، “أعطِ CI مفتاحاً يمكنه فقط دفع الأحداث”، “اعترف بحادثة الإطلاق وأسندها إليّ”. ليست خدمة أو ملف ثنائي منفصل. إنها حزمة تعليمات صغيرة تعمل فوق CLI الذي قمت بتثبيته بالفعل: ينفذ الوكيل أوامر agenteye --json …، ويحلل JSON النظيف، ويجيبك بالنثر. كل شيء يمكنه فعله، يمكنك فعله بنفسك بكتابة نفس الأوامر.

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

توفر AgentEye لك أربع طرق للوصول إلى نفس البيانات والتحكم. يكملان بعضهما البعض:
الواجهةما هيحيث تعملاستخدمها عندما
CLIمرجع الأوامر والعلامات لـ agenteyeمحطتك الطرفيةتريد تشغيل أو برمجة أمر معين
وصفات CLIأنماط jq/خط أنابيب جاهزة للنسخمحطتك الطرفية / البرامج النصيةتقوم بربط CLI بالأتمتة
مهارة CLI (هذا المستند)باب أمامي باللغة الطبيعية على CLIوكيل الترميز لديك، على محطة العمل الخاصة بكتريد أن تسأل فقط واترك الوكيل يختار الأمر
مساعد ذكاء اصطناعي داخل لوحة التحكمدردشة مضمنة في لوحة التحكمحاوية agent داخلية في مجموعتكتريد أسئلة وأجوبة داخل لوحة التحكم حول بياناتك

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

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

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

  1. agenteye CLI مثبت وعلى PATH (انظر cli.md — 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). أمر تفتقر الإذن له يرجع كود الخروج 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 و cli-recipes.md.

​
انظر أيضاً

  • CLI — مرجع الأمر والعلم الكامل لـ agenteye.
  • وصفات CLI للوكلاء — أنماط jq والتعامل مع رموز الخروج جاهزة للنسخ.
  • مساعد ذكاء اصطناعي — المساعد داخل لوحة التحكم (لا تخلطه مع هذه مهارة الطرفية).
  • مفاتيح API — نموذج الأذونات لكل منظمة الذي يحد من ما يمكن للمهارة فعله.