דלג לתוכן הראשי
AgentEye CLI skill (agenteye-cli) היא Agent Skill ניתנת להתקנה המלמדת סוכן קוד — Claude Code, Codex וכלים תואמים — להפעיל את הפריסה שלך של AgentEye דרך agenteye CLI מבקשות ברגלית אנגלית: “האם משהו שבור היום?”, “תן ל-CI מפתח שיכול רק לדחוף אירועים”, “אשר את האירוע הפורצ שורה וקצה לי”. זה לא שירות או בינארי נפרד. זה חבילת הוראות קטנה שרוכבת על ה-CLI שכבר התקנת: הסוכן משדר אל agenteye --json …, מחליץ את ה-JSON הנקי, ועונה לך בטקסט. כל מה שהוא יכול לעשות, אתה יכול לעשות בעצמך על ידי הקלדת אותן פקודות.

​
כיצד זה קשור לממשקים האחרים של AgentEye

AgentEye נותן לך ארבע דרכים להגיע לאותם נתונים וקטגוריות. הם משלימים אחד את השני:
ממשקמה זההיכן זה פועלהשתמש בו כאשר
CLIההפניה לפקודה/דגל עבור agenteyeהטרמינל שלךאתה רוצה להריץ או לכתוב סקריפט לפקודה ספציפית
CLI recipesדפוסי jq/pipeline להעתיק והדבקהטרמינל שלך / סקריפטיםאתה מחבר את ה-CLI לאוטומציה
CLI skill (מסמך זה)דלת קדמית בשפה טבעית ב-CLIסוכן הקוד שלך, בתחנה שלךאתה רוצה פשוט לשאול ולתן לסוכן לבחור את הפקודה
עוזר AI בלוח המחווניםצ’אט מובנה בלוח המחווניםמיכל agent פנימי בקלסטר שלךאתה רוצה שאלות ותשובות בלוח המחוונים על הנתונים שלך

​
לעומת עוזר ה-AI בלוח המחוונים — הבחנה חשובה

אלה שני כלים שונים עם רדיוסי התפוצה שונים מאוד:
  • עוזר ה-AI בלוח המחוונים (assistant.md) הוא צ’אט מובנה בלוח המחוונים, תומך על ידי מיכל agent פנימי. זה קריאה בלבד בתוספת כתיבה מאושרת: זה יכול להשרטט שאילתות שמורות ולוחות מחוונים, אך כל כתיבה משהה לאישור נקודה מפורש שלך, והוא לעולם לא מוחק. זה מוגבל בהרשאה agent:use וזה רואה רק נתונים עבור הארגון שאתה צופה בו.
  • CLI skill פועל על תחנה שלך בתוך סוכן הקוד שלך ומנהל את agenteye CLI כ-אתה. זה יכול לבצע את המשטח המלא, כולל מוטציות — ליצור/לסובב/להשבית מפתחות API, לשנות הגדרות ארגון, לפתור אירועים, למחוק שאילתות שמורות — מוגבל רק בהרשאות של כניסת ה-CLI שלך. התייחס אליו בדיוק כמו שהיית מתייחס להפעלת אותן פקודות ביד.

​
דרישות מוקדמות

  1. ה-agenteye CLI מותקן וב-PATH (ראה cli.md — pipx install agenteye).
  2. כתובת URL של לוח המחוונים שלך מוגדרת (AGENTEYE_DASHBOARD_URL, או הסוכן מעביר --base-url).
  3. סשן מחובר: הרץ agenteye login בעצמך תחילה. ה-skill לא יכול להשלים עבורך את כניסת קוד חד-פעמי בדוא”ל — זה יגיד לך להריץ agenteye login אם הסשן חסר או פג (קוד יציאת CLI 4).

​
התקנת ה-Skill

Agent Skills הם תיקיות המכילות SKILL.md (בתוספת הפניות אופציונליות). אתה מתקין את ה-agenteye-cli skill על ידי הצבת התיקייה שלה היכן שהסוכן שלך מחפש skills:
  • 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 בוחר באופן אוטומטי את ה-skill כאשר המשימה תואמת; אחרת בקיע אותו במפורש כ-$agenteye-cli.
ה-skill נתחזק לצד ה-agenteye CLI והוא מופץ כחלק מחבילת AgentEye שלך — אם אין לך את תיקיית agenteye-cli, בקש מנציג AgentEye שלך. שום דבר בקשר אליו לא מוגבל: זה לא צריך תמונת Docker ושום אישור, כי זה רק מנהל את ה-ציבור agenteye CLI כנגד לוח המחוונים שלך.

​
בטיחות — מוטציות לא מהבהבות כאשר סוכן מריץ את ה-CLI

קרא את זה לפני שאתה מאפשר לסוכן לבצע שינויים. ה-agenteye CLI בדרך כלל שואל “אתה בטוח?” לפני פעולה הרסנית. זה דלג אוטומטי על אישור זה בכל פעם שזה לא מחובר לטרמינל — שזה בדיוק איך סוכן קוד מריץ אותו — ו---json דלג עליו גם. אז הודעת הבטיחות לא תורה עבור הסוכן. ה-skill כתוב לפיצוי: זה מוסר להצהיר את הפקודה המדויקת שהיא תריץ ולקבל את ה-OK המפורש שלך לפני כל שינוי מצב. שמור על משמעת זו — כאשר אתה מנהל את 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 עם ההרשאה המדויקת בשם, כך שהסוכן יכול להגיד לך בדיוק למה לשאול מנהל במקום להיכשל בעמימות.

​
מה אתה יכול לשאול אותו

ה-skill ממפה כוונה בשפה טבעית לפקודת 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 recipes לסוכנים — דפוסי jq להעתיק והדבק וטיפול בקוד יציאה.
  • עוזר AI — העוזר בלוח המחוונים (לא להתבלבל עם ה-skill הטרמינל הזה).
  • API Keys — מודל ההרשאות לכל ארגון השומר מה ה-skill יכול לעשות.