> ## 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 AgentEye CLI Agent Skill documentation.

**AgentEye CLI skill** (`agenteye-cli`) היא *Agent Skill* ניתנת להתקנה המלמדת סוכן קוד — Claude Code, Codex וכלים תואמים — להפעיל את הפריסה שלך של AgentEye דרך [`agenteye` CLI](/he/agenteye/cli) מבקשות ברגלית אנגלית: *"האם משהו שבור היום?"*, *"תן ל-CI מפתח שיכול רק לדחוף אירועים"*, *"אשר את האירוע הפורצ שורה וקצה לי"*.

זה **לא** שירות או בינארי נפרד. זה חבילת הוראות קטנה שרוכבת על ה-CLI שכבר התקנת: הסוכן משדר אל `agenteye --json …`, מחליץ את ה-JSON הנקי, ועונה לך בטקסט. כל מה שהוא יכול לעשות, אתה יכול לעשות בעצמך על ידי הקלדת אותן פקודות.

***

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

AgentEye נותן לך ארבע דרכים להגיע לאותם נתונים וקטגוריות. הם משלימים אחד את השני:

| ממשק                                                | מה זה                             | היכן זה פועל                  | השתמש בו כאשר                                       |
| --------------------------------------------------- | --------------------------------- | ----------------------------- | --------------------------------------------------- |
| **[CLI](/he/agenteye/cli)**                         | ההפניה לפקודה/דגל עבור `agenteye` | הטרמינל שלך                   | אתה רוצה להריץ או לכתוב סקריפט לפקודה ספציפית       |
| **[CLI recipes](/he/agenteye/cli-recipes)**         | דפוסי `jq`/pipeline להעתיק והדבק  | הטרמינל שלך / סקריפטים        | אתה מחבר את ה-CLI לאוטומציה                         |
| **CLI skill** (מסמך זה)                             | דלת קדמית בשפה טבעית ב-CLI        | סוכן הקוד שלך, בתחנה שלך      | אתה רוצה *פשוט לשאול* ולתן לסוכן לבחור את הפקודה    |
| **[עוזר AI בלוח המחוונים](/he/agenteye/assistant)** | צ'אט מובנה בלוח המחוונים          | מיכל `agent` פנימי בקלסטר שלך | אתה רוצה שאלות ותשובות בלוח המחוונים על הנתונים שלך |

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

אלה שני כלים שונים עם רדיוסי התפוצה שונים מאוד:

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

***

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

1. **ה-`agenteye` CLI מותקן** וב-`PATH` (ראה [cli.md](/he/agenteye/cli) — `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](/he/agenteye/api-keys)). פקודה שאתה חסר הרשאה עבורה מחזירה קוד יציאה `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](/he/agenteye/cli) ו-[cli-recipes.md](/he/agenteye/cli-recipes).

***

## ראה גם

* **[CLI](/he/agenteye/cli)** — הפניה פקודה ודגל מלאה עבור `agenteye`.
* **[CLI recipes לסוכנים](/he/agenteye/cli-recipes)** — דפוסי `jq` להעתיק והדבק וטיפול בקוד יציאה.
* **[עוזר AI](/he/agenteye/assistant)** — העוזר בלוח המחוונים (לא להתבלבל עם ה-skill הטרמינל הזה).
* **[API Keys](/he/agenteye/api-keys)** — מודל ההרשאות לכל ארגון השומר מה ה-skill יכול לעשות.