Cli skill

​

title: “مهارة عامل Failproof AI Observability CLI” description: “اسأل وكيل الترميز الخاص بك “هل حدث عطل ما اليوم؟” ودعه يجيب من بيانات Failproof AI Observability المباشرة، بدون الحاجة لحفظ أوامر.”

​

كيف يرتبط بواجهات Failproof AI Observability الأخرى

​

مقابل مساعد AI في لوحة المعلومات: تمييز مهم

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

​

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

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

​

حيث تحصل عليها

​

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

# Claude Code، هذا المشروع فقط
npx skills add FailproofAI/skills --skill agenteye-cli -a claude-code

# كل مشروع (التثبيت في ~/.claude/skills/)
npx skills add FailproofAI/skills --skill agenteye-cli -a claude-code -g --copy

# Codex بدلاً من ذلك
npx skills add FailproofAI/skills --skill agenteye-cli -a codex

npx skills list -a claude-code      # ما هو مثبت
npx skills update agenteye-cli      # اسحب أحدث إصدار
npx skills remove 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.

​

الأمان: التغييرات لا تطلب موافقة عندما يشغل الوكيل CLI

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

• 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

​

ما الذي يمكنك أن تسأله

أنت   ▸ هل حدث عطل ما في اليوم الأخير؟

وكيل ▸ تشغيل: agenteye --json errors --since 24h --aggregate
       3 أنواع أخطاء في آخر 24 ساعة. الأكبر هو TimeoutError
       (18 نقرة، جميعها على checkout-agent)، ثم RateLimited (5).
       تريد الجلسات الفاشلة لـ TimeoutError؟

أنت   ▸ أعط CI مفتاح يمكنه فقط دفع الأحداث.

وكيل ▸ هذا ينشئ مفتاح API. سأشغل:
       agenteye keys create ci --add events:add
       OK للمتابعة؟

أنت   ▸ نعم

وكيل ▸ تم. تم إنشاء المفتاح "ci" مع events:add فقط.
       يتم عرض السر مرة واحدة فقط، لذا قم بتخزينه الآن. لا يمكنني إعادة طباعته.

• “هل حدث عطل / فشل في آخر 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@….

​

الخطوات التالية

• CLI: مرجع أمر وخيار كامل لـ agenteye.
• وصفات CLI للوكلاء: أنماط jq جاهزة للنسخ ومعالجة رموز الخروج.
• مهارة وكيل المقيّم: المهارة الشقيقة، لبناء المقيّم الذي تقرأه agenteye evals.
• مهارة وكيل Python SDK: المهارة الشقيقة، لتجهيز وكيل حتى يصدر البيانات التي يقرأها agenteye.
• مساعد AI: مساعد لوحة المعلومات (لا تخلطها مع مهارة المحطة الطرفية هذه).
• مفاتيح API: نموذج الأذونات لكل منظمة الذي يحدد ما يمكن للمهارة القيام به.