Failproof Cloud CLI - Failproof AI

השתמש ב-fp לבדיקת טלמטריית Cloud, ניהול כפיית Cloud (מדיניות, פריסות צי, החלטות guardrail), וניהול ביקורות, ממצאים, בעיות, התראות, מפתחות, משתמשים, שאילתות והגדרות. השתמש ב-failproofai עבור hooks מקומיים, מדיניות, capture וההרשמה של מכונות. התקן את Cloud CLI המשוחרר ככלי מבודד:

uv tool install fp-cloud-cli
fp version

כניסה

fp login
fp whoami

תחביר

fp [GLOBAL_OPTIONS] COMMAND [SUBCOMMAND] [ARGUMENTS] [OPTIONS]

אפשרויות גלובליות חייבות להיות לפני הפקודה:

fp --json sessions --since 24h

הרץ fp COMMAND --help או fp COMMAND SUBCOMMAND --help לעזרה בטרמינל.

פקודות CLI

אימות

Command	Purpose	Options
`fp login`	כניסה עם קוד חד-זמני שנשלח דוא”ל וביחור ארגון.	`--email`, `-e`; `--org`; `--force`
`fp logout`	שחרור והסרה של ההפעלה המשתמש השמורה.	—
`fp whoami`	הצגת הזהות הנוכחית, מצב אימות, ארגון והרשאות.	—
`fp version`	הצגת גרסת CLI המותקנת.	—
`fp help`	הצגת עזרה לפקודה בדרגה העליונה.	—

fp login --email you@example.com --org reliability-team
fp whoami

Events

fp events [OPTIONS]

רשימת אירועי agent בודדים. ההזנה הקלה ברירת המחדל אינה כוללת payload גולם; השתמש ב---full רק לחקירה מוגבלת.

Option	Description
`--limit`, `-n <n>`	מרבי שורות כוללות. ברירת מחדל: `50`.
`--since <window>`	`all`, `15m`, `1h`, `6h`, `24h`, או `7d`.
`--from <timestamp>` / `--to <timestamp>`	טווח ISO 8601 UTC; דורס את `--since`.
`--env <value>`	מסנן סביבה; חזור או הפרד בפסיקים.
`--event-type <value>`	מסנן סוג אירוע; חזור או הפרד בפסיקים.
`--agent-id <value>`	מסנן agent; חזור או הפרד בפסיקים.
`--session-id <value>`	מסנן session; חזור או הפרד בפסיקים.
`--search <text>`	חיפוש טקסט payload; חוזר, כל מונח תואם.
`--order asc\|desc`	סדר זמן. ברירת מחדל: החדש ביותר תחילה.
`--all`	עימוד אוטומטי עד `--limit`.
`--cursor <token>`	חידוש מ-cursor אטום.
`--page-size <n>`	שורות לבקשה עם `--all`; מרבי `200`.
`--full`	כלול payload גולם דרך נקודת הקצה של אירוע כבדה יותר.
`--fields <csv>`	החזר רק שדות נבחרים; בקשת `payload` מאפשרת מצב מלא.

fp events --session-id <session-id> --order asc --all --limit 10000
fp --json events --full --session-id <session-id> --all --limit 10000

--all פוגן עד --limit, שברירת המחדל היא 50 — אז --all לבדו מעצור ב-50 שורות. כאשר הוא מעצור מוקדם התגובה נושאת next_cursor לחידוש מעמדה; "next_cursor": null פירושו שההזנה באמת הייתה מחוקה.

Sessions

fp sessions [OPTIONS]

Option	Description
`--limit`, `-n <n>`	מרבי שורות כוללות. ברירת מחדל: `50`.
`--since <window>`	`all`, `15m`, `1h`, `6h`, `24h`, או `7d`.
`--from <timestamp>` / `--to <timestamp>`	טווח ISO 8601 UTC; דורס את `--since`.
`--env <value>`	מסנן סביבה; חזור או הפרד בפסיקים.
`--status <value>`	`done`, `error`, או `timeout`; חזור או הפרד בפסיקים.
`--agent-id <value>`	התאמת sessions הכוללות כל agent נבחר.
`--session-id <value>`	מסנן session; חזור או הפרד בפסיקים.
`--all`	עימוד אוטומטי עד `--limit`.
`--cursor <token>`	חידוש מ-cursor אטום.
`--page-size <n>`	שורות לבקשה עם `--all`; מרבי `200`.
`--fields <csv>`	החזר רק שדות נבחרים.
`--full-ids`	אל תקצר session IDs בפלט טרמינל.
`--agents`	הרחב רשימת agent עבור sessions מרובי-agent.

Evaluations

fp evals [OPTIONS]

Option	Description
`--aggregate`	הצגת סכומים וסטטיסטיקות לכל ניקוד במקום הערכות בודדות.
`--limit`, `-n <n>`	מרבי שורות רשימה. ברירת מחדל: `50`.
`--since`, `--from`, `--to`	בחירת טווח הזמן.
`--env`, `--status`, `--agent-id`, `--session-id`	הצמצום לערך מדויק אחד לכל מסנן.
`--score KEY:MIN..MAX`	טווח ניקוד; חוזר וכל הטווחים חייבים להתאים.
`--all`, `--cursor`, `--page-size`	שליטה בעימוד רשימה.
`--fields <csv>`	החזר רק שדות נבחרים.
`--full-ids`	הצגת session IDs שלמים.
`--scores-full`	הצגת כל ניקוד בפלט טרמינל.

Errors

fp errors [OPTIONS]

Option	Description
`--aggregate`	סיכום שגיאות תואמות במקום רישום שורות.
`--limit`, `-n <n>`	מרבי שורות רשימה. ברירת מחדל: `50`.
`--since`, `--from`, `--to`	בחירת טווח הזמן.
`--env`, `--error-type`, `--event-type`, `--agent-id`, `--session-id`	הצמצום של אוכלוסיית השגיאות.
`--search <text>`	חיפוש טקסט payload; חוזר.
`--order asc\|desc`	סדר זמן.
`--all`, `--cursor`, `--page-size`	שליטה בעימוד רשימה.
`--fields <csv>`	החזר רק שדות נבחרים.
`--full-ids`	הצגת session IDs שלמים.

שימוש וערכי מסננים

Command	Purpose
`fp usage`	הצגת שימוש לחלון המדידה הנוכחי.
`fp list envs`	רשימת סביבות שנצפו.
`fp list agents`	רשימת agent IDs שנצפו.
`fp list event_types`	רשימת סוגי אירוע.
`fp list score_filters`	רשימת מפתחות ניקוד הערכה.
`fp list models`	רשימת שמות מודלים.
`fp list hooks`	רשימת שמות hook.
`fp list tools`	רשימת שמות כלים.
`fp list error_types`	רשימת סוגי שגיאה.

Organizations

Command	Purpose
`fp orgs list`	רשימת ארגונים נגישים.
`fp orgs switch [SLUG]`	שמירת ארגון פעיל; מהות כשהוא מושמט.
`fp orgs current`	הצגת הארגון הפעיל.
`fp orgs perms`	הצגת ההרשאות שלך בארגון הפעיל.

API keys

Command	Purpose	Options
`fp keys list`	רשימת מפתחות ארגון.	`--show-id`; `--fields <csv>`
`fp keys show NAME`	הצגת מפתח אחד והנחות שלו.	—
`fp keys create NAME`	יצירת מפתח וחשיפת הסוד שלו פעם אחת.	`--permission-set`; `--add`; `--remove`
`fp keys update NAME`	החלפת קבוצת ההרשאות או התאמת הנחות.	`--permission-set`; `--add`; `--remove`; `--yes`, `-y`
`fp keys regenerate NAME`	סיבוב הסוד וחשיפת התחליף פעם אחת.	`--yes`, `-y`
`fp keys disable NAME`	שחרור קבוע של מפתח.	`--yes`, `-y`

token הרשאות משתמשים ב-resource:action, כגון events:add. חזור על --add, הפרד בפסיקים token, או השתמש בפעולות מנוקדות כגון events:read.add.

Queries

Command	Purpose	Options
`fp query list`	רשימת שאילתות שמורות.	`--show-id`; `--fields <csv>`
`fp query show NAME`	הצגת שאילתה אחת.	—
`fp query create NAME`	שמירת שאילתה.	`--sql <text\|@file>`; `--description`
`fp query update NAME`	עדכון או שינוי שם של שאילתה.	`--name`; `--sql`; `--description`; `--yes`, `-y`
`fp query delete NAME`	מחיקת שאילתה שמורה.	`--yes`, `-y`
`fp query run [NAME]`	הרצת שאילתה שמורה או SQL ad-hoc.	`--sql`; `--limit`; `--all`; `--arg`, `--param`
`fp query schema [TABLE]`	רשימת טבלאות שניתן לשאול או בדיקה של טבלה אחת.	—

Users

Command	Purpose	Options
`fp users list`	רשימת חברי ארגון.	`--active-only`; `--show-id`
`fp users show EMAIL`	הצגת חברי ונחות שלו.	—
`fp users create EMAIL`	הוספת חברי.	`--permission-set`; `--add`; `--remove`
`fp users update EMAIL`	שינוי נחות של חברי.	`--permission-set`; `--add`; `--remove`; `--yes`, `-y`
`fp users disable EMAIL`	השבתת כניסה.	`--yes`, `-y`
`fp users enable EMAIL`	הפעלה מחדש של כניסה.	`--yes`, `-y`

Settings

Command	Purpose	Options
`fp settings list`	רשימת הגדרות ארגון וערכים נוכחיים.	—
`fp settings schema`	הצגת ערכים מקובלים ותיאורים.	—
`fp settings set KEY`	שינוי הגדרה קיימת.	בדיוק אחד מ-`--value`, `--json-value`, `--file`; אופציונלי `--yes`, `-y`

Alerts

Command	Purpose	Options
`fp alerts list`	רשימת כללי התראה.	`--show-id`
`fp alerts show NAME`	הצגת התראה אחת.	—
`fp alerts create NAME`	יצירת התראה.	`--file`; `--description`; `--severity`; `--trigger-kind`; `--trigger-spec`; `--channels`; `--eval-interval-secs`; `--min-breaches`; `--eval-window`
`fp alerts update NAME`	עדכון או שינוי שם של התראה.	אפשרויות יצירה בתוספת `--name`; `--yes`, `-y`
`fp alerts delete NAME`	מחיקת התראה.	`--yes`, `-y`
`fp alerts test NAME`	שלח הודעה בדיקה.	`--channels`; `--yes`, `-y`

חומרות התראה הן info, warning, ו-critical. סוגי trigger הם metric_threshold, custom_sql, evaluation_score, eval_compound, ו-per_event. מרווחי הערכה חייבים להיות בין 30 ל-86,400 שניות.

Audits

Command	Purpose	Options
`fp audits list`	רשימת ביקורות.	`--enabled-only`; `--show-id`
`fp audits show NAME`	הצגת הגדרת ביקורת אחת ומצב.	—
`fp audits create NAME`	יצירת ביקורת וערבוב הריצה הראשונה שלה מיד.	ראה אפשרויות יצירה.
`fp audits edit NAME`	החלפת הגדרות ביקורת תוך שמירה על ערכים לא מוגדרים.	אפשרויות הגדרת יצירה; `--name`; `--yes`, `-y`
`fp audits delete NAME`	מחיקת ביקורת, ממצאים שלו והיסטוריית ריצה.	`--yes`, `-y`
`fp audits run NAME`	ערבוב ריצה ידנית.	—
`fp audits runs NAME`	רשימת היסטוריית ריצה.	`--limit`, `-n`; `--show-id`
`fp audits context-show NAME`	הצגת מצב ההיקף וה-URL Reference fetch.	—
`fp audits context-set NAME`	שינוי התיאור או Reference URLs.	`--text`; `--text-file`; `--url`; `--clear-urls`
`fp audits context-refresh NAME`	הזנת Reference URLs מחדש.	—
`fp audits findings`	רשימת ממצאים.	`--audit`; `--run-id`; `--status`; `--limit`, `-n`; `--offset`; `--show-id`
`fp audits finding FINDING_ID`	הצגת ממצא אחד והראיה שלו.	—
`fp audits ack FINDING_ID`	הכרה בממצא.	`--reason`
`fp audits mute FINDING_ID`	ספיגת תבנית חוזרת.	`--reason`; `--yes`, `-y`
`fp audits dismiss FINDING_ID`	סימון תבנית לא מעשית וספיגתה.	`--reason`; `--yes`, `-y`
`fp audits resolve FINDING_ID`	סימון ממצא תיקון ללא ספיגה עתידית.	`--yes`, `-y`
`fp audits reopen FINDING_ID`	החזרת ממצא לתור החי וניקוי הספיגה.	—
`fp audits assign FINDING_ID`	הגדרת בעל ממצא.	דרוש `--to <email>`

Audit create options

fp audits create checkout-reliability \
  --description "Find checkout failures that agents do not recover from" \
  --scope '{"environments":["production"],"agent_ids":["checkout-agent"]}' \
  --schedule-interval-secs 86400 \
  --window-mode since_last \
  --sensitivity medium \
  --text-file ./checkout-audit-brief.txt \
  --url https://runbooks.example.com/checkout

Option	Description
`--file <path>`	בסיס ההגדרה על JSON, או השתמש ב-`-` עבור stdin. דגלים מפורשים דורסים ערכי קובץ.
`--description <text>`	מדינת שאלת כישלון או מטרה.
`--enabled` / `--disabled`	תחילת תזמון מופעל או כבוי. ברירת מחדל: מופעל.
`--schedule-interval-secs <n>`	`3600`–`604800`. ברירת מחדל: `86400`.
`--schedule-anchor <timestamp>`	שלב UTC קבוע בצורה ISO 8601. ברירת מחדל: 09:00 UTC הבא.
`--window-mode since_last\|fixed`	המשך לאחר החלון שנותח לאחרונה או בדיקה חוזרת של חלון מתגלגל. ברירת מחדל: `since_last`.
`--lookback-window-secs <n>`	`3600`–`7776000`. ברירת מחדל: `604800`.
`--scope '<json>'`	סנן לפי `environments`, `agent_ids`, או שדות scope נתמכים אחרים.
`--ignore-error-type <type>`	הסרת סוגי שגיאה; חזור או הפרד בפסיקים.
`--llm` / `--no-llm`	הפעלה או השבתה של ניתוח agentic. ברירת מחדל: מופעל.
`--top-k <n>`	שמור `1`–`500` ממצאים. ברירת מחדל: `50`.
`--sensitivity low\|medium\|high`	הגדרת רגישות דיווח. ברירת מחדל: `medium`.
`--channels '<json>'`	מערך ערוץ התראה.
`--text <brief>`	תיאור מובנה, מרבי 8,192 תווים.
`--text-file <path>`	קרא את התיאור מקובץ; הדדיות בלעדית עם `--text`.
`--url <https-url>`	הוספת reference ציבורי HTTPS; חזור עד חמש פעמים.

כלול הקשר במהלך יצירה כאשר הריצה הראשונה זקוקה לה. יצירה מחייבת את ההגדרה וההקשר ביחד לפני תחילת הריצה בתור.

fp audits run אסינכרוני. סקור fp audits runs NAME עד שהריצה האחרונה מצליחה או נכשלת לפני קריאת הממצאים שלה.

Issues

Command	Purpose	Options
`fp issues list`	רשימת בעיות.	`--state`; `--alert-id`; `--limit`, `-n`; `--show-id`
`fp issues count`	ספירת בעיות פתוחות או מדינות בעיות נבחרות.	`--state`
`fp issues show INCIDENT_ID`	הצגת פרטי בעיה, הערות, מנויים ופעילות.	—
`fp issues open`	פתיחת בעיה ידנית או קשורה להתראה.	דרוש `--summary`; אופציונלי `--title`, `--alert-id`, `--severity`
`fp issues ack INCIDENT_ID`	הכרה בבעיה.	—
`fp issues assign INCIDENT_ID`	החלפת מוקצים; הוציא את האפשרות לנקות אותם.	חוזר `--assignee`
`fp issues resolve INCIDENT_ID`	פתרון בעיה.	`--yes`, `-y`
`fp issues comment-list INCIDENT_ID`	רשימת הערות.	—
`fp issues comment-add INCIDENT_ID`	הוסף הערה.	בדיוק אחד מ-`--body`, `--file`
`fp issues comment-delete INCIDENT_ID COMMENT_ID`	מחיקת הערה.	`--yes`, `-y`
`fp issues subscribers INCIDENT_ID`	רשימת מנויים.	—
`fp issues subscribe INCIDENT_ID`	הרשמה לעצמך או למפעיל אחר.	`--email`
`fp issues unsubscribe INCIDENT_ID`	הסרת הרשמה.	`--email`

מצבי בעיה תקפים הם firing, acknowledged, ו-resolved. חומרות בעיה עצמאיות הן info, warning, ו-critical.

Cloud assistant

Command	Purpose	Options
`fp agent health`	בדיקת זמינות assistant והגדרה.	—
`fp agent models`	רשימת מודלים assistant זמינים.	—
`fp agent chats`	רשימת צ’אטים שמורים.	—
`fp agent ask [MESSAGE]`	התחלה או המשך של צ’אט; קריאת stdin כאשר ההודעה הוא מושמט.	`--chat`; `--model`; `--page-context`
`fp agent show CHAT_ID`	הצגת שיחה שמורה.	—
`fp agent rename CHAT_ID`	שינוי שם של שיחה.	דרוש `--title`
`fp agent delete CHAT_ID`	מחיקת שיחה.	`--yes`, `-y`

Policies

גרסות מדיניות מנוהלות ב-Cloud. Session-only — כל פקודה כאן יוצא 2 תחת מפתח API, לפני כל בקשה, כי אלה הן routes כתיבה root-only בכוונה לא קיים ב-/v1.

Command	Purpose	Options
`fp policies list`	רשימת גרסות מדיניות.	`--json`
`fp policies show POLICY_ID`	הצגת מדיניות אחת, עם המקור שלה.	—
`fp policies publish NAME PATH`	הנפקת גרסה מ-`.mjs` מקומי.	`--description`; `--no-verify`
`fp policies enable POLICY_ID`	הוסף אותה בחזרה לכל פריסה שהוא הוסר ממנה, הנפקת דור חדש בכל אחד.	`--yes`, `-y`
`fp policies disable POLICY_ID`	הסר אותה מכל פריסה שנושאת אותה, הנפקת דור חדש בכל אחד.	`--yes`, `-y`
`fp policies delete POLICY_ID`	מחיקת גרסת מדיניות.	`--yes`, `-y`
`fp policies test PATH`	הרצת מדיניות מקומית מול הקשר סינתטי. חל כל מסנן `match` של המדיניות, אז אחד שלא מכסה את האירוע/הכלי הנתון מדווח `skipped` ולא הרץ.	`--event`; `--tool`; `--command`; `--file`; `--expect`
`fp policies compose PROMPT`	טיוטת מדיניות עם ה-assistant. צורך `policies:write`.	—

Fleet

אילו מכונות מריצות אילו מדיניות. Session-only, אותו סיבה כמו לעיל.

Command	Purpose	Options
`fp fleet list`	רשימת מכונות רשומות ודור פריסה שלהן.	—
`fp fleet show MACHINE_ID`	מערך מדיניות שמכונה מריצה כרגע.	—
`fp fleet deploy MACHINE_ID`	החלפת כל מערך מדיניות של מכונה. הדפס את התוכנית ושאל רק בטרמינל אינטראקטיבי ללא `--json`.	`--add`; `--remove`; `--set`; `--create`; `--yes`, `-y`
`fp fleet diff MACHINE_ID`	השוואת מכונה לפריסה אחרת.	—
`fp fleet history MACHINE_ID`	פריסות קודמות למכונה.	—
`fp fleet rollback MACHINE_ID GENERATION`	הנחת דור קודם מערך מדיניות, כדור חדש.	`--yes`, `-y`
`fp fleet rename MACHINE_ID`	תן שם קריא למכונה.	דרוש `--name`

Guardrails

מה כפיית ממש עשתה. Session-only, אותו סיבה כמו לעיל.

Command	Purpose	Options
`fp guardrails summary`	כיסוי, חסומות/מוערכות סכומות, ניצוץ deny, וטבלת per-policy.	`--since` (`1h`, `6h`, `24h`, `7d`); `--machine`
`fp guardrails timeline`	החלטות מכניות על החלון, סיכמו על כל מקור מדיניות.	`--since` (`1h`, `6h`, `24h`, `7d`); `--machine`

דגלים גלובליים

Flag	Description
`--json`	פלט JSON קריא למכונה.
`--base-url <url>`	השתמש בדashboard שמעוכב או פיתוח.
`--org <slug>`	בחר ארגון להפעלה זו.
`--token <token>`	דרוס את token session המשתמש השמור.
`--api-key <key>`	הוסכם אוטומציה עם מפתח API; לעולם לא נשמר.
`--timeout <seconds>`	timeout HTTP; חייב להיות חיובי. ברירת מחדל: `30`.
`--quiet`, `-q`	דיכוי פלט סטטוס על stderr.
`--no-color`	השבתה של פלט צבעוני.
`--insecure` / `--secure`	השבתה או שחזור של אימות תעודה TLS.
`--version`	הדפס את הגרסה ופרוק והצא.
`--help`, `-h`	הצגת עזרה.

--api-key מיועד לאוטומציה. כניסה, החלפת ארגון, ופקודות assistant דורשות session משתמש.

משתנים סביבה

Variable	Equivalent or purpose
`FP_DASHBOARD_URL`	`--base-url`
`FP_ORG`	`--org`
`FP_TOKEN`	`--token`
`FP_API_KEY`	`--api-key`
`FP_JSON`	`--json`
`FP_INSECURE`	`--insecure`
`FP_HOME`	עקירת ספריית תצורת CLI (ברירת מחדל `~/.failproofai/fpcli`).
`FP_ANALYTICS_DISABLED` או `DO_NOT_TRACK`	השבתה של אנליטיקה CLI אנונימית.
`NO_COLOR`	השבתה של פלט צבעוני.

דגלים מפורשים דורסים משתנים סביבה, שדורסים תצורה שמורה. במצב מפתח API, בחר את הדייר בצורה מפורשת עם --org או FP_ORG.

הכתיבים AGENTEYE_* של משתנים אלה אינם נקראים על ידי fp ומעולם לא נקראו — ה-CLI מצהיר על FP_* (fp_cli/app.py), ומשתנה לא מוכר אינו נחשב שגיאה. הגדרת AGENTEYE_DASHBOARD_URL אינה מפנה את ה-CLI ליעד אחר; מתעלמים ממנה, והפקודה רצה בשקט מול ה-dashboard השמור.AGENTEYE_HOME ו-AGENTEYE_ENVIRONMENT עדיין קיימים, אך הם משתייכים ל-collector וה-telemetry SDK, לא ל-CLI זה.

פקודות המחיקות, רוקות, מדכאות, פותרות, או מחליפות תצורה מהות כברירת מחדל. השתמש ב---yes רק לאחר אימות הארגון הפעיל והיעד.

​כניסה

​תחביר

​פקודות CLI

​אימות

​Events

​Sessions

​Evaluations

​Errors

​שימוש וערכי מסננים

​Organizations

​API keys

​Queries

​Users

​Settings

​Alerts

​Audits

​Audit create options

​Issues

​Cloud assistant

​Policies

​Fleet

​Guardrails

​דגלים גלובליים

​משתנים סביבה

כניסה

תחביר

פקודות CLI

אימות

Events

Sessions

Evaluations

Errors

שימוש וערכי מסננים

Organizations

API keys

Queries

Users

Settings

Alerts

Audits

Audit create options

Issues

Cloud assistant

Policies

Fleet

Guardrails

דגלים גלובליים

משתנים סביבה