Cli skill

​

title: “כישורון CLI Observability של Failproof AI” description: “שאל את סוכן הקוד שלך “האם משהו שבור היום?” והנח לו לענות מנתוני Failproof AI Observability השידוריים שלך, ללא צורך לשנן פקודות.”

​

איך זה קשור לממשקים אחרים של Failproof AI Observability

​

לעומת עוזר ה-AI בתוך הלוח: הבחנה חשובה

• עוזר ה-AI בתוך הלוח (AI assistant) הוא צ’אט משובץ בלוח המחוונים, בגיבוי שירות הסוכן. זה קריאה בלבד בתוספת כתיבה שאושרה: הוא יכול לטיוטה שאלות שמורות ולוחות, אך כל כתיבה עוצרת לאישור ההקלקה המפורש שלך, והוא לעולם לא מוחק. זה נשער על ידי ההרשאה agent:use ורק אי פעם רואה נתונים עבור הארגון שאתה צופה בו.
• כישורון CLI רץ על תחנת העבודה שלך בתוך סוכן הקוד שלך ומנהל את agenteye CLI כ-אתה. הוא יכול לבצע את המשטח המלא של ה-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 סוגי שגיאה בבחינה האחרונה. הגדול ביותר הוא TimeoutError
        (18 עוקבים, כולם ב-checkout-agent), ואחריו RateLimited (5).
        רוצה את ההפעלות הנכשלות עבור TimeoutError?

אתה   ▸ תן ל-CI מפתח שיכול רק לדחוף אירועים.

סוכן ▸ זה יוצר מפתח API. אני אריץ:
          agenteye keys create ci --add events:add
        בסדר להמשיך?

אתה   ▸ כן

סוכן ▸ בוצע. מפתח "ci" נוצר עם events:add בלבד.
        הסוד מוצג רק פעם אחת, כך שאחסן אותו עכשיו. אני לא יכול להדפיס מחדש.

• “האם משהו שבור / נכשל בבחינה האחרונה?” → 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 recipes for agents: דוגמות jq להעתקה-הדבקה וטיפול בקוד יציאה.
• כישורון סוכן Evaluator: הכישורון אחות, לבניית ה-evaluator שאותו ניקוד agenteye evals קורא.
• כישורון סוכן Python SDK: הכישורון אחות, להכשרת סוכן כך שהוא פולט את הטלמטריה שקוראת agenteye.
• עוזר AI: העוזר בתוך הלוח (לא להתבלבל עם כישורון הטרמינל הזה).
• API keys: מודל ההרשאה לכל ארגון שמגביל מה הכישורון יכול לעשות.