title: “מתכונים CLI לסוכנים” description: “תיעוד מתכונים CLI של AgentEye לסוכנים.”
משכו נתוני הפעלה, אירועים והערכה (והפעילו הערכה מחדש) ישירות מסקריפט או מסוכן קודינג, עם JSON נקי ב-stdout שמועבר ישירות ל-jq. המתכונים האלה הופכים את נתוני הנצפיות של AgentEye למשהו שמשתמש בטרמינל או סוכן קודינג AI (Claude Code, Cursor) יכול לשאול ולהפוך לאוטומציה, בלי ללחוץ דרך לוח הבקרה.
הדפוסים בהמשך מוכנים להעתקה ישירה ל-CLI של AgentEye (agenteye). להתקנה, אימות וההצעה המלאה ראו CLI; הריצו agenteye -h או agenteye <command> -h להשגת העזרה המובנית.
כללים ממוקדים
- אפשרויות גלובליות חייבות להופיע לפני הפקודה.
agenteye --json sessionsנכון;agenteye sessions --jsonלא. הגלובליים הם--json,--base-url,--org,--token,--insecure/--secure,--timeout,--quiet,--no-color. - העבירו
--jsonבכל פעם שאתם מנתחים פלט. נתונים עוברים ל-stdout כ-JSON; סטטוס אנושי ושגיאות עוברים ל-stderr, כדי ש-stdout יישאר נקי להעברה ל-jq. - הסתמכו על קוד היציאה, לא על טקסט stderr:
0בסדר ·2ארגומנטים שגויים ·3לא מוצא את לוח הבקרה ·4לא מחובר או פג תוקף ·5הרשאה חסרה. - גלו עם
-h. כל פקודה מתעדת את הסינונים שלה, פורמטי ערך ותצורת JSON.
התקנה חד-פעמית
אשרו אימות לפני ביצוע עבודה
whoami לעולם לא יחזור בשגיאה בהפעלה חסרה או פגה; הוא מדווח logged_in:false במקום זה, כך שסוכן יכול לבדוק את מצב האימות בבטחה. (עדיין יכול להחזור non-zero אם לא הוגדרה כתובת בסיס או לוח הבקרה לא זמין.)
מצאו הפעלות בעלות ניקוד נמוך או כשלון
evals, לא sessions. --score KEY:MIN..MAX חוזר וניתן לשילוב עם AND; כל גבול אופציונלי (..0.5 פירושו ≤ 0.5, 0.9.. פירושו ≥ 0.9). אתם יכולים להעביר עד 20 סינוני ניקוד לכל בקשה; יותר מזה מחזיר HTTP 400. sessions חולק את הסינונים --env, --status, --agent-id, --session-id וטווח זמן עם evals, אך אין לו --score.
קרא הפעלה אחת מקצה לקצה
אין פקודתsession show יחידה — שלבו את רצף האירוע עם ההערכה של ההפעלה:
משכו הכל (עימוד)
התוצאות הן החדשות ביותר תחילה ועומדות להעברה תור.הצרו את הפלט עם —fields
הגבלו את המפתחות (בטבלה וב---json) כדי להקטין את מה שסוכן חייב לקרוא.
2) עם הרשימה התקנה, דרך זולה להגדרת שמות שדות.
גלו ערכי סינון תקפים
בחרו את הארגון שלכם (ריבוי דיירים)
אם אתם שייכים ליותר מארגון אחד, בחרו בדיייר הפעיל בהתחברות (הוא נשמר):--org חוזרת non-zero והדפסה של הארגונים לבחירה.
יצור מפתח API ל-SDK/מאסף
הריצו שאילתה שמורה או ad-hoc
יהלם תקרית ללא אינטראקטיביות
מוטציות דלג-אוטומטי על הנקודת האישור שלהם תחת--jsonאו כאשר stdin אינו TTY, כדי שסוכנים לא תלויים; העברו--yes/-yלדלג עליה באופן מפורש במקומות אחרים.
טיפול בקוד יציאה בסקריפט
תצורות פלט JSON
| פקודה | stdout JSON (עם --json) |
|---|---|
whoami | {"logged_in": true, "id", "email", "is_instance_admin", "active_org", "permissions": [...], "memberships": [...]} או {"logged_in": false} |
orgs list | {"active_org", "orgs": [{"org_slug","org_name","permission_set","permissions"}]} |
events | {"events": [...], "next_cursor": <cursor or null>} |
evals | {"evaluations": [...], "next_cursor": <cursor or null>} |
sessions | {"sessions": [...], "next_cursor": <cursor or null>} |
errors | {"errors": [...], "next_cursor": <cursor or null>} |
list <kind> | {"kind", "values": [...]} |
keys list / keys create | {"keys": [...]} / {id, name, permissions, created_at, key} (key הוצג פעם אחת) |
query run | {columns: [{name,type}], rows: [[...]], truncated, elapsed_ms} |
users list / settings list | {"users": [...]} / {"settings": [...]} |
alerts list / incidents list | {"alerts": [...]} / {"incidents": [...]} |
| יצירה/עדכון/מחיקה (כל אחד) | אובייקט המשאב, או {"deleted": true, "id"} למחיקות |
כשל (כל אחד, עם --json) | {"error": "...", "exit_code": <n>, "status"?: <http>, "hint"?: "..."} ב-stdout |
- כל פריט אירוע (
events):id, session_id, agent_id, event_type, ts, payload, environment. - כל פריט הערכה (
evals):id, session_id, agent_id, environment, status, scores, reasoning, summary, error, attempt_count, duration_ms, completed_at, created_at. - כל פריט הפעלה (
sessions):session_id, agent_id, environment, status, scores, event_count, started_at, last_event_at, first_event_id, last_event_id, latest_evaluation.
--fields מקבלת בדיוק את שמות השדות של הפריט שלה — הסט שונה בין sessions ו-evals, כך ששם תקף לאחד עלול להידחות על ידי השני.
