Failproof Cloud CLI

Usa fp per ispezionare la telemetria Cloud e gestire audit, findings, issues, alert, chiavi, utenti, query e impostazioni. Usa failproofai per hook locali, policies, capture e enrollment delle macchine. Installa la CLI Cloud rilasciata come strumento isolato:

uv tool install fp-cli
fp version

Accedi

fp login
fp whoami

Sintassi

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

Le opzioni globali devono precedere il comando:

fp --json sessions --since 24h

Esegui fp COMMAND --help o fp COMMAND SUBCOMMAND --help per l’aiuto nel terminale.

Comandi CLI

Autenticazione

Comando	Scopo	Opzioni
`fp login`	Accedi con un codice monouso inviato via email e seleziona un’organizzazione.	`--email`, `-e`; `--org`; `--force`
`fp logout`	Revoca e rimuovi la sessione utente salvata.	—
`fp whoami`	Mostra l’identità attuale, la modalità di autenticazione, l’organizzazione e i permessi.	—
`fp version`	Mostra la versione CLI installata.	—
`fp help`	Mostra l’aiuto per i comandi di primo livello.	—

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

Eventi

fp events [OPTIONS]

Elenca i singoli eventi degli agent. Il feed leggero predefinito esclude i payload grezzi; usa --full solo per un’indagine delimitata.

Opzione	Descrizione
`--limit`, `-n <n>`	Numero massimo totale di righe. Predefinito: `50`.
`--since <window>`	`all`, `15m`, `1h`, `6h`, `24h`, o `7d`.
`--from <timestamp>` / `--to <timestamp>`	Intervallo ISO 8601 UTC; sostituisce `--since`.
`--env <value>`	Filtro per ambiente; ripeti o separa con virgola i valori.
`--event-type <value>`	Filtro per tipo di evento; ripeti o separa con virgola i valori.
`--agent-id <value>`	Filtro per agent; ripeti o separa con virgola i valori.
`--session-id <value>`	Filtro per sessione; ripeti o separa con virgola i valori.
`--search <text>`	Ricerca testo nel payload; ripetibile, qualsiasi termine corrisponde.
`--order asc\|desc`	Ordine temporale. Predefinito: più recente per primo.
`--all`	Auto-paginazione fino a `--limit`.
`--cursor <token>`	Riprendi da un cursore opaco.
`--page-size <n>`	Righe per richiesta con `--all`; massimo `200`.
`--full`	Includi payload grezzi tramite l’endpoint evento più pesante.
`--fields <csv>`	Restituisci solo i campi selezionati; richiedere `payload` abilita la modalità completa.

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

Sessioni

fp sessions [OPTIONS]

Opzione	Descrizione
`--limit`, `-n <n>`	Numero massimo totale di righe. Predefinito: `50`.
`--since <window>`	`all`, `15m`, `1h`, `6h`, `24h`, o `7d`.
`--from <timestamp>` / `--to <timestamp>`	Intervallo ISO 8601 UTC; sostituisce `--since`.
`--env <value>`	Filtro per ambiente; ripeti o separa con virgola i valori.
`--status <value>`	`done`, `error`, o `timeout`; ripeti o separa con virgola i valori.
`--agent-id <value>`	Abbina sessioni che coinvolgono un agent selezionato qualsiasi.
`--session-id <value>`	Filtro per sessione; ripeti o separa con virgola i valori.
`--all`	Auto-paginazione fino a `--limit`.
`--cursor <token>`	Riprendi da un cursore opaco.
`--page-size <n>`	Righe per richiesta con `--all`; massimo `200`.
`--fields <csv>`	Restituisci solo i campi selezionati.
`--full-ids`	Non abbreviare gli ID sessione nell’output del terminale.
`--agents`	Espandi il roster degli agent per sessioni multi-agent.

Valutazioni

fp evals [OPTIONS]

Opzione	Descrizione
`--aggregate`	Mostra totali e statistiche per punteggio invece di valutazioni individuali.
`--limit`, `-n <n>`	Numero massimo di righe nell’elenco. Predefinito: `50`.
`--since`, `--from`, `--to`	Seleziona l’intervallo di tempo.
`--env`, `--status`, `--agent-id`, `--session-id`	Ristretti a un valore esatto per filtro.
`--score KEY:MIN..MAX`	Intervallo punteggi; ripetibile e tutti gli intervalli devono corrispondere.
`--all`, `--cursor`, `--page-size`	Controlla la paginazione dell’elenco.
`--fields <csv>`	Restituisci solo i campi selezionati.
`--full-ids`	Mostra gli ID sessione completi.
`--scores-full`	Mostra ogni punteggio nell’output del terminale.

Errori

fp errors [OPTIONS]

Opzione	Descrizione
`--aggregate`	Riassumi gli errori corrispondenti invece di elencare le righe.
`--limit`, `-n <n>`	Numero massimo di righe nell’elenco. Predefinito: `50`.
`--since`, `--from`, `--to`	Seleziona l’intervallo di tempo.
`--env`, `--error-type`, `--event-type`, `--agent-id`, `--session-id`	Restringi la popolazione di errori.
`--search <text>`	Ricerca testo nel payload; ripetibile.
`--order asc\|desc`	Ordine temporale.
`--all`, `--cursor`, `--page-size`	Controlla la paginazione dell’elenco.
`--fields <csv>`	Restituisci solo i campi selezionati.
`--full-ids`	Mostra gli ID sessione completi.

Utilizzo e valori di filtro

Comando	Scopo
`fp usage`	Mostra l’utilizzo per la finestra di conteggio corrente.
`fp list envs`	Elenca gli ambienti osservati.
`fp list agents`	Elenca gli ID agent osservati.
`fp list event_types`	Elenca i tipi di evento.
`fp list score_filters`	Elenca le chiavi dei punteggi di valutazione.
`fp list models`	Elenca i nomi dei modelli.
`fp list hooks`	Elenca i nomi degli hook.
`fp list tools`	Elenca i nomi degli strumenti.
`fp list error_types`	Elenca i tipi di errore.

Organizzazioni

Comando	Scopo
`fp orgs list`	Elenca le organizzazioni accessibili.
`fp orgs switch [SLUG]`	Salva un’organizzazione attiva; chiede quando omesso.
`fp orgs current`	Mostra l’organizzazione attiva.
`fp orgs perms`	Mostra i tuoi permessi nell’organizzazione attiva.

Chiavi API

Comando	Scopo	Opzioni
`fp keys list`	Elenca le chiavi dell’organizzazione.	`--show-id`; `--fields <csv>`
`fp keys show NAME`	Mostra una chiave e le sue concessioni.	—
`fp keys create NAME`	Crea una chiave e rivela il suo segreto una volta.	`--permission-set`; `--add`; `--remove`
`fp keys update NAME`	Sostituisci il set di permessi o regola le concessioni.	`--permission-set`; `--add`; `--remove`; `--yes`, `-y`
`fp keys regenerate NAME`	Ruota il segreto e rivela la sostituzione una volta.	`--yes`, `-y`
`fp keys disable NAME`	Revoca permanentemente una chiave.	`--yes`, `-y`

I token di permesso usano il formato resource:action, come events:add. Ripeti --add, separa con virgola i token, o usa azioni puntate come events:read.add.

Query

Comando	Scopo	Opzioni
`fp query list`	Elenca le query salvate.	`--show-id`; `--fields <csv>`
`fp query show NAME`	Mostra una query.	—
`fp query create NAME`	Salva una query.	`--sql <text\|@file>`; `--description`
`fp query update NAME`	Aggiorna o rinomina una query.	`--name`; `--sql`; `--description`; `--yes`, `-y`
`fp query delete NAME`	Elimina una query salvata.	`--yes`, `-y`
`fp query run [NAME]`	Esegui una query salvata o SQL ad hoc.	`--sql`; `--limit`; `--all`; `--arg`, `--param`
`fp query schema [TABLE]`	Elenca le tabelle interrogabili o ispezionane una.	—

Utenti

Comando	Scopo	Opzioni
`fp users list`	Elenca i membri dell’organizzazione.	`--active-only`; `--show-id`
`fp users show EMAIL`	Mostra un membro e le sue concessioni.	—
`fp users create EMAIL`	Aggiungi un membro.	`--permission-set`; `--add`; `--remove`
`fp users update EMAIL`	Cambia le concessioni di un membro.	`--permission-set`; `--add`; `--remove`; `--yes`, `-y`
`fp users disable EMAIL`	Disabilita l’accesso.	`--yes`, `-y`
`fp users enable EMAIL`	Riabilita l’accesso.	`--yes`, `-y`

Impostazioni

Comando	Scopo	Opzioni
`fp settings list`	Elenca le impostazioni dell’organizzazione e i valori correnti.	—
`fp settings schema`	Mostra i valori accettati e le descrizioni.	—
`fp settings set KEY`	Cambia un’impostazione esistente.	esattamente uno tra `--value`, `--json-value`, `--file`; opzionale `--yes`, `-y`

Alert

Comando	Scopo	Opzioni
`fp alerts list`	Elenca le regole di alert.	`--show-id`
`fp alerts show NAME`	Mostra un alert.	—
`fp alerts create NAME`	Crea un alert.	`--file`; `--description`; `--severity`; `--trigger-kind`; `--trigger-spec`; `--channels`; `--eval-interval-secs`; `--min-breaches`; `--eval-window`
`fp alerts update NAME`	Aggiorna o rinomina un alert.	opzioni di creazione più `--name`; `--yes`, `-y`
`fp alerts delete NAME`	Elimina un alert.	`--yes`, `-y`
`fp alerts test NAME`	Invia una notifica di test.	`--channels`; `--yes`, `-y`

Le severità degli alert sono info, warning e critical. I tipi di trigger sono metric_threshold, custom_sql, evaluation_score, eval_compound e per_event. Gli intervalli di valutazione devono essere tra 30 e 86.400 secondi.

Audit

Comando	Scopo	Opzioni
`fp audits list`	Elenca gli audit.	`--enabled-only`; `--show-id`
`fp audits show NAME`	Mostra una definizione di audit e il suo stato.	—
`fp audits create NAME`	Crea un audit e accodati immediatamente la sua prima esecuzione.	Vedi opzioni di creazione.
`fp audits edit NAME`	Sostituisci le impostazioni dell’audit mantenendo i valori non specificati.	opzioni di definizione della creazione; `--name`; `--yes`, `-y`
`fp audits delete NAME`	Elimina un audit, i suoi findings e la cronologia delle esecuzioni.	`--yes`, `-y`
`fp audits run NAME`	Accoda un’esecuzione manuale.	—
`fp audits runs NAME`	Elenca la cronologia delle esecuzioni.	`--limit`, `-n`; `--show-id`
`fp audits context-show NAME`	Mostra il brief e lo stato di recupero dell’URL di riferimento.	—
`fp audits context-set NAME`	Cambia il brief o gli URL di riferimento.	`--text`; `--text-file`; `--url`; `--clear-urls`
`fp audits context-refresh NAME`	Ri-scarica gli URL di riferimento.	—
`fp audits findings`	Elenca i findings.	`--audit`; `--run-id`; `--status`; `--limit`, `-n`; `--offset`; `--show-id`
`fp audits finding FINDING_ID`	Mostra un finding e le sue prove.	—
`fp audits ack FINDING_ID`	Riconosci un finding.	`--reason`
`fp audits mute FINDING_ID`	Sopprimere un pattern ricorrente.	`--reason`; `--yes`, `-y`
`fp audits dismiss FINDING_ID`	Contrassegna un pattern come non attuabile e sopprimilo.	`--reason`; `--yes`, `-y`
`fp audits resolve FINDING_ID`	Contrassegna un finding come risolto senza soppressione futura.	`--yes`, `-y`
`fp audits reopen FINDING_ID`	Restituisci un finding alla coda attiva e cancella la soppressione.	—
`fp audits assign FINDING_ID`	Imposta il proprietario del finding.	`--to <email>` obbligatorio

Opzioni di creazione dell’audit

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

Opzione	Descrizione
`--file <path>`	Basa la definizione su JSON, o usa `-` per stdin. I flag espliciti sostituiscono i valori del file.
`--description <text>`	Dichiara la domanda di fallimento o lo scopo.
`--enabled` / `--disabled`	Avvia la pianificazione attiva o disattivata. Predefinito: abilitato.
`--schedule-interval-secs <n>`	`3600`–`604800`. Predefinito: `86400`.
`--schedule-anchor <timestamp>`	Fase UTC fissa in formato ISO 8601. Predefinito: prossimo 09:00 UTC.
`--window-mode since_last\|fixed`	Continua dopo l’ultima finestra completamente analizzata o ispeziona ripetutamente una finestra mobile. Predefinito: `since_last`.
`--lookback-window-secs <n>`	`3600`–`7776000`. Predefinito: `604800`.
`--scope '<json>'`	Filtra per `environments`, `agent_ids`, o altri campi di scope supportati.
`--ignore-error-type <type>`	Escludi i tipi di errore; ripeti o separa con virgola.
`--llm` / `--no-llm`	Abilita o disabilita l’analisi agentica. Predefinito: abilitato.
`--top-k <n>`	Mantieni `1`–`500` findings. Predefinito: `50`.
`--sensitivity low\|medium\|high`	Imposta la sensibilità di segnalazione. Predefinito: `medium`.
`--channels '<json>'`	Array di canali di notifica.
`--text <brief>`	Brief inline, massimo 8.192 caratteri.
`--text-file <path>`	Leggi il brief da un file; mutuamente esclusivo con `--text`.
`--url <https-url>`	Aggiungi un riferimento HTTPS pubblico; ripeti fino a cinque volte.

Includi il contesto durante la creazione quando la prima esecuzione ne ha bisogno. La creazione confirma la definizione e il contesto insieme prima che l’esecuzione in coda inizi.

fp audits run è asincrono. Esegui il polling di fp audits runs NAME finché l’esecuzione più recente non riesce o fallisce prima di leggere i suoi findings.

Issues

Comando	Scopo	Opzioni
`fp issues list`	Elenca le issues.	`--state`; `--alert-id`; `--limit`, `-n`; `--show-id`
`fp issues count`	Conta le issues aperte o i stati selezionati.	`--state`
`fp issues show INCIDENT_ID`	Mostra i dettagli dell’issue, i commenti, i sottoscritti e l’attività.	—
`fp issues open`	Apri una issue manuale o collegata a un alert.	`--summary` obbligatorio; opzionale `--title`, `--alert-id`, `--severity`
`fp issues ack INCIDENT_ID`	Riconosci una issue.	—
`fp issues assign INCIDENT_ID`	Sostituisci gli assegnatari; ometti l’opzione per cancellarli.	`--assignee` ripetibile
`fp issues resolve INCIDENT_ID`	Risolvi una issue.	`--yes`, `-y`
`fp issues comment-list INCIDENT_ID`	Elenca i commenti.	—
`fp issues comment-add INCIDENT_ID`	Aggiungi un commento.	esattamente uno tra `--body`, `--file`
`fp issues comment-delete INCIDENT_ID COMMENT_ID`	Elimina un commento.	`--yes`, `-y`
`fp issues subscribers INCIDENT_ID`	Elenca i sottoscritti.	—
`fp issues subscribe INCIDENT_ID`	Sottoscrivi te stesso o un altro operatore.	`--email`
`fp issues unsubscribe INCIDENT_ID`	Rimuovi una sottoscrizione.	`--email`

Gli stati validi delle issues sono firing, acknowledged e resolved. Le severità delle issues autonome sono info, warning e critical.

Assistente Cloud

Comando	Scopo	Opzioni
`fp agent health`	Verifica la disponibilità e la configurazione dell’assistente.	—
`fp agent models`	Elenca i modelli dell’assistente disponibili.	—
`fp agent chats`	Elenca le chat salvate.	—
`fp agent ask [MESSAGE]`	Avvia o continua una chat; leggi stdin quando il messaggio viene omesso.	`--chat`; `--model`; `--page-context`
`fp agent show CHAT_ID`	Mostra una conversazione salvata.	—
`fp agent rename CHAT_ID`	Rinomina una conversazione.	`--title` obbligatorio
`fp agent delete CHAT_ID`	Elimina una conversazione.	`--yes`, `-y`

Flag globali

Flag	Descrizione
`--json`	Emetti JSON leggibile da macchina.
`--base-url <url>`	Usa un dashboard self-hosted o di sviluppo.
`--org <slug>`	Seleziona un’organizzazione per questa invocazione.
`--token <token>`	Sostituisci il token di sessione utente salvato.
`--api-key <key>`	Autentica l’automazione con una chiave API; mai salvata.
`--timeout <seconds>`	Timeout HTTP; deve essere positivo. Predefinito: `30`.
`--quiet`, `-q`	Sopprimere l’output di stato su stderr.
`--no-color`	Disabilita l’output colorato.
`--insecure` / `--secure`	Disabilita o ripristina la verifica del certificato TLS.
`--version`	Stampa la versione non racchiusa ed esci.
`--help`, `-h`	Mostra l’aiuto.

--api-key è destinato all’automazione. L’accesso, il passaggio di organizzazione e i comandi dell’assistente richiedono una sessione utente.

Variabili di ambiente

Variabile	Equivalente o scopo
`AGENTEYE_DASHBOARD_URL`	`--base-url`
`AGENTEYE_ORG`	`--org`
`AGENTEYE_CLI_TOKEN`	`--token`
`AGENTEYE_CLI_API_KEY`	`--api-key`
`AGENTEYE_CLI_JSON`	`--json`
`AGENTEYE_INSECURE`	`--insecure`
`AGENTEYE_HOME`	Rilocalizza la directory di configurazione CLI corrente.
`AGENTEYE_ANALYTICS_DISABLED` o `DO_NOT_TRACK`	Disabilita l’analytics CLI anonima.
`NO_COLOR`	Disabilita l’output colorato.

I flag espliciti sostituiscono le variabili di ambiente, che sostituiscono la configurazione salvata. In modalità chiave API, seleziona il tenant esplicitamente con --org o AGENTEYE_ORG.

I comandi che eliminano, revocano, sopprimono, risolvono o sostituiscono la configurazione chiedono per impostazione predefinita. Usa --yes solo dopo aver verificato l’organizzazione attiva e il target.

Connect your agents

Reference

HTTP API

Accedi

Sintassi

Comandi CLI

Autenticazione

Eventi

Sessioni

Valutazioni

Errori

Utilizzo e valori di filtro

Organizzazioni

Chiavi API

Query

Utenti

Impostazioni

Alert

Audit

Opzioni di creazione dell’audit

Issues

Assistente Cloud

Flag globali

Variabili di ambiente

​Accedi

​Sintassi

​Comandi CLI

​Autenticazione

​Eventi

​Sessioni

​Valutazioni

​Errori

​Utilizzo e valori di filtro

​Organizzazioni

​Chiavi API

​Query

​Utenti

​Impostazioni

​Alert

​Audit

​Opzioni di creazione dell’audit

​Issues

​Assistente Cloud

​Flag globali

​Variabili di ambiente

Accedi

Sintassi

Comandi CLI

Autenticazione

Eventi

Sessioni

Valutazioni

Errori

Utilizzo e valori di filtro

Organizzazioni

Chiavi API

Query

Utenti

Impostazioni

Alert

Audit

Opzioni di creazione dell’audit

Issues

Assistente Cloud

Flag globali

Variabili di ambiente