מתכונים CLI לסוכנים

משוך נתוני session, event וערכת ערכים (והפעל הערכות מחדש) ישירות מסקריפט או סוכן קוד, עם JSON נקי ב-stdout שמופנה ישירות ל-jq. המתכונים האלה משנים נתונים של Failproof AI Observability למשהו שמשתמש בטרמינל או סוכן קוד AI (Claude Code, Cursor) יכול לשאול וליישם אוטומציה, ללא לחיצה דרך ה-dashboard. ההוראות למטה מוכנות להעתקה ישירה לממשק הפקודה של Failproof AI Observability (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 בסדר · 1 שגיאה בלתי צפויה · 2 ארגומנטים שגויים · 3 אי אפשר להגיע ל-dashboard · 4 לא מחובר או שתוקף פג · 5 הרשאה חסרה · 6 משאב לא נמצא.
גלה עם -h. כל פקודה מתעדת את המסננים שלה, פורמטי ערכים וצורת JSON.

התקנה חד פעמית

export AGENTEYE_DASHBOARD_URL=https://agenteye.example.com   # כדי שלא תחזור על --base-url
agenteye login --email you@example.com                       # הדבק את הקוד שנשלח בדוא"ל; תוקף ~24h

אמת אימות לפני ביצוע עבודה

whoami לעולם לא משגה בהפסדה או אימות שתוקפו פג; במקום זאת הוא מדווח logged_in:false, כך שסוכן יכול לבדוק את מצב האימות בבטחה. (זה עדיין יכול לצאת עם קוד שאינו אפס אם לא הוגדרה כתובת בסיסית או ה-dashboard אינו נגיש.)

if [ "$(agenteye --json whoami | jq -r .logged_in)" != "true" ]; then
  echo "Not authenticated. Run: agenteye login" >&2; exit 1
fi

מצא sessions שנכשלו או בעלי ניקוד נמוך

# sessions ב-24 שעות האחרונות שערכת הערכים שלהם היתה בשגיאה
agenteye --json sessions --since 24h --status error | jq -r '.sessions[].session_id'

# evaluations בניקוד <= 0.5 ב-helpfulness, לסוכן אחד
agenteye --json evals --agent-id checkout-bot --score helpfulness:..0.5 \
  | jq '.evaluations[] | {session_id, scores}'

סינון ניקוד חי ב-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 אחד מהסוף לסוף

אין פקודת session show יחידה. שלב את עקבות ה-event עם ערכת הערכים של ה-session:

# ערכת הערכים האחרונה של ה-session (סטטוס + ניקוד)
agenteye --json evals --session-id run-001 | jq '.evaluations[0] | {status, scores}'

# כל event בריצה (הגבר את --limit לסריקה מלאה)
agenteye --json events --session-id run-001 --all --limit 1000 | jq '.events[] | {ts, event_type}'

# רק הקריאות לכלים ב-session (--full נדרש כדי לקבל את ה-payload הגולמי)
agenteye --json events --full --session-id run-001 --event-type tool_use,tool_result --all \
  | jq '.events[].payload'

הערה: כברירת מחדל, events קורא feed מהיר וללא payload. כל event נושא summary המחושב בשרת בשורה אחת בתוספת דגלים כמו is_error וספירת token, אך payload חוזר כ-{}. כדי למשוך את ה-payload הגולמי, הוסף --full (או --fields payload). ה-feed המלא איטי בקנה מידה, אז שמור עליו מוגבל: זווג --full עם --session-id יחיד.

שלוף הכל (עמודים)

התוצאות הן חדשה-ראשית ומעמוד-ושרשור.

# היא אחת: משוך עד 500 שורות בעמודים של 200 שורה
agenteye --json events --session-id run-001 --limit 500 --all > events.json

# עמודים ידניים: הזן את next_cursor חזרה
page=$(agenteye --json events --limit 100)
cursor=$(echo "$page" | jq -r '.next_cursor // empty')
[ -n "$cursor" ] && agenteye --json events --limit 100 --cursor "$cursor"

הצמק את הפלט עם —fields

הגבל את המפתחות (גם בטבלה וב---json) כדי להפחית מה שסוכן חייב לקרוא.

agenteye --json sessions --since 7d --fields session_id,status,scores | jq -c '.sessions[]'
agenteye --json events --session-id run-001 --fields ts,event_type --all

שמות שדות לא ידוע נדחים (יציאה 2) עם הרשימה התקפה, דרך זולה לגלות שמות שדות.

גלה ערכי מסנן תקפים

agenteye --json list envs | jq -r '.values[]'           # ערכים לעבור --env
agenteye --json list tools | jq -r '.values[]'          # שמות כלים; גם agents, models, event_types, ...
agenteye --json list score_filters | jq -r '.values[]'  # KEY תקף עבור --score KEY:MIN..MAX

בחר את ה-org שלך (מרובה דיירים)

אם אתה שייך ליותר מ-org אחד, בחר את הדייר הפעיל בעת התחברות (זה נשמר):

agenteye login --org acme --email you@corp.com   # הגדר את הדייר באותו שלב כמו התחברות
agenteye --json orgs list | jq -r '.orgs[].org_slug'
agenteye --org globex --json sessions --since 24h   # בחזוק לפקודה אחת

התחברות מרובת-org ללא --org יוצאת עם קוד שאינו אפס ותדפיס את ה-orgs לבחירה.

הפקד מפתח API לעבור ה-SDK/collector

# הסוד מודפס פעם אחת, עם --json זה ה-.key field
key=$(agenteye --json keys create ci-bot --add events:read.add | jq -r '.key')
agenteye keys regenerate ci-bot --yes    # סובב; agenteye keys disable ci-bot --yes להשבת

הרץ שאילתה שמורה או ad-hoc

agenteye --json query run --sql "select count(*) from analytics.events" | jq '.rows'
agenteye --json query run errs --arg prod | jq '.rows'   # שאילתה שמורה + $1 מיקומי

בחן תקרית ללא אינטראקציה

id=$(agenteye --json incidents list --state firing | jq -r '.incidents[0].id')
agenteye incidents ack "$id"
agenteye incidents assign "$id" --assignee you@corp.com
agenteye incidents resolve "$id" --yes

הערה: Mutations מדלגות באופן אוטומטי על ההנחיה לאישור תחת --json או כאשר stdin אינו TTY, כך שסוכנים לעולם לא תלויים; העבור --yes/-y כדי לדלג עליו במפורש במקום אחר.

טיפול בקוד יציאה בסקריפט

out=$(agenteye --json sessions --since 1h) || code=$?
case "${code:-0}" in
  0) echo "$out" | jq '.sessions | length' ;;
  4) echo "Session expired - run 'agenteye login'." >&2 ;;
  5) echo "Missing permission (ask an admin for evaluations:read)." >&2 ;;
  3) echo "Dashboard unreachable - check the URL." >&2 ;;
  *) echo "Unexpected error (exit ${code})." >&2 ;;
esac

צורות פלט 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": [...]}`
create/update/delete (כל)	אובייקט המשאב, או `{"deleted": true, "id"}` למחיקות
כישלון (כל, עם `--json`)	`{"error": "...", "exit_code": <n>, "status"?: <http>, "hint"?: "..."}` ב-stdout

כל פריט event (events): id, session_id, agent_id, event_type, ts, payload, environment, summary, is_error, error_type, output_tokens, context_window, context_fill. שים לב ש-payload הוא {} אלא אם אתה מבקש את ה-feed המלא עם --full (או --fields payload).
כל פריט evaluation (evals): id, session_id, agent_id, environment, status, scores, reasoning, summary, error, attempt_count, duration_ms, completed_at, created_at.
כל פריט session (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, כך ששם תקף לאחד אולי יידחה על ידי השני.

שלבים הבאים

CLI: התקנה, אימות וההתייחסות המלאה לאפשרויות לכל פקודה.
CLI agent skill: אפס את המתכונים האלה כמו מיומנות שסוכן הקוד שלך יכול לטעון.
API keys: צור ותחום את המפתחות שעם ה-CLI, SDK והאספן מתאמתים.
Python SDK: שלח events ל-Failproof AI Observability כדי שיהיו נתונים כדי שהמתכונים האלה יכלו לשאול.

Overview

Features

SDK and CLI

Administration

מתכונים CLI לסוכנים

כללים זהב

התקנה חד פעמית

אמת אימות לפני ביצוע עבודה

מצא sessions שנכשלו או בעלי ניקוד נמוך

קרא session אחד מהסוף לסוף

שלוף הכל (עמודים)

הצמק את הפלט עם —fields

גלה ערכי מסנן תקפים

בחר את ה-org שלך (מרובה דיירים)

הפקד מפתח API לעבור ה-SDK/collector

הרץ שאילתה שמורה או ad-hoc

בחן תקרית ללא אינטראקציה

טיפול בקוד יציאה בסקריפט

צורות פלט JSON

שלבים הבאים

​כללים זהב

​התקנה חד פעמית

​אמת אימות לפני ביצוע עבודה

​מצא sessions שנכשלו או בעלי ניקוד נמוך

​קרא session אחד מהסוף לסוף

​שלוף הכל (עמודים)

​הצמק את הפלט עם —fields

​גלה ערכי מסנן תקפים

​בחר את ה-org שלך (מרובה דיירים)

​הפקד מפתח API לעבור ה-SDK/collector

​הרץ שאילתה שמורה או ad-hoc

​בחן תקרית ללא אינטראקציה

​טיפול בקוד יציאה בסקריפט

​צורות פלט JSON

​שלבים הבאים

כללים זהב

התקנה חד פעמית

אמת אימות לפני ביצוע עבודה

מצא sessions שנכשלו או בעלי ניקוד נמוך

קרא session אחד מהסוף לסוף

שלוף הכל (עמודים)

הצמק את הפלט עם —fields

גלה ערכי מסנן תקפים

בחר את ה-org שלך (מרובה דיירים)

הפקד מפתח API לעבור ה-SDK/collector

הרץ שאילתה שמורה או ad-hoc

בחן תקרית ללא אינטראקציה

טיפול בקוד יציאה בסקריפט

צורות פלט JSON

שלבים הבאים