> ## 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. # Failproof Cloud CLI > Riferimento completo per interrogare e amministrare Failproof AI Cloud con fp. Usa `fp` per ispezionare la telemetria Cloud e gestire audit, findings, issues, alert, chiavi, utenti, query e impostazioni. Usa [`failproofai`](/it/reference/failproof-cli) per hook locali, policies, capture e enrollment delle macchine. Installa la CLI Cloud rilasciata come strumento isolato: ```bash theme={null} uv tool install fp-cli fp version ``` ## Accedi ```bash theme={null} fp login fp whoami ``` ## Sintassi ```text theme={null} fp [GLOBAL_OPTIONS] COMMAND [SUBCOMMAND] [ARGUMENTS] [OPTIONS] ``` Le opzioni globali devono precedere il comando: ```bash theme={null} 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. | — | ```bash theme={null} fp login --email you@example.com --org reliability-team fp whoami ``` ### Eventi ```text theme={null} 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 ` | Numero massimo totale di righe. Predefinito: `50`. | | `--since ` | `all`, `15m`, `1h`, `6h`, `24h`, o `7d`. | | `--from ` / `--to ` | Intervallo ISO 8601 UTC; sostituisce `--since`. | | `--env ` | Filtro per ambiente; ripeti o separa con virgola i valori. | | `--event-type ` | Filtro per tipo di evento; ripeti o separa con virgola i valori. | | `--agent-id ` | Filtro per agent; ripeti o separa con virgola i valori. | | `--session-id ` | Filtro per sessione; ripeti o separa con virgola i valori. | | `--search ` | 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 ` | Riprendi da un cursore opaco. | | `--page-size ` | Righe per richiesta con `--all`; massimo `200`. | | `--full` | Includi payload grezzi tramite l'endpoint evento più pesante. | | `--fields ` | Restituisci solo i campi selezionati; richiedere `payload` abilita la modalità completa. | ```bash theme={null} fp events --session-id --order asc --all fp --json events --full --session-id --all ``` ### Sessioni ```text theme={null} fp sessions [OPTIONS] ``` | Opzione | Descrizione | | ----------------------------------------- | ------------------------------------------------------------------- | | `--limit`, `-n ` | Numero massimo totale di righe. Predefinito: `50`. | | `--since ` | `all`, `15m`, `1h`, `6h`, `24h`, o `7d`. | | `--from ` / `--to ` | Intervallo ISO 8601 UTC; sostituisce `--since`. | | `--env ` | Filtro per ambiente; ripeti o separa con virgola i valori. | | `--status ` | `done`, `error`, o `timeout`; ripeti o separa con virgola i valori. | | `--agent-id ` | Abbina sessioni che coinvolgono un agent selezionato qualsiasi. | | `--session-id ` | Filtro per sessione; ripeti o separa con virgola i valori. | | `--all` | Auto-paginazione fino a `--limit`. | | `--cursor ` | Riprendi da un cursore opaco. | | `--page-size ` | Righe per richiesta con `--all`; massimo `200`. | | `--fields ` | 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 ```text theme={null} fp evals [OPTIONS] ``` | Opzione | Descrizione | | ------------------------------------------------- | ---------------------------------------------------------------------------- | | `--aggregate` | Mostra totali e statistiche per punteggio invece di valutazioni individuali. | | `--limit`, `-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 ` | Restituisci solo i campi selezionati. | | `--full-ids` | Mostra gli ID sessione completi. | | `--scores-full` | Mostra ogni punteggio nell'output del terminale. | ### Errori ```text theme={null} fp errors [OPTIONS] ``` | Opzione | Descrizione | | --------------------------------------------------------------------- | --------------------------------------------------------------- | | `--aggregate` | Riassumi gli errori corrispondenti invece di elencare le righe. | | `--limit`, `-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 ` | Ricerca testo nel payload; ripetibile. | | `--order asc\|desc` | Ordine temporale. | | `--all`, `--cursor`, `--page-size` | Controlla la paginazione dell'elenco. | | `--fields ` | 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 ` | | `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 ` | | `fp query show NAME` | Mostra una query. | — | | `fp query create NAME` | Salva una query. | `--sql `; `--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](#audit-create-options). | | `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 ` obbligatorio | #### Opzioni di creazione dell'audit ```bash theme={null} 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 ` | Basa la definizione su JSON, o usa `-` per stdin. I flag espliciti sostituiscono i valori del file. | | `--description ` | Dichiara la domanda di fallimento o lo scopo. | | `--enabled` / `--disabled` | Avvia la pianificazione attiva o disattivata. Predefinito: abilitato. | | `--schedule-interval-secs ` | `3600`–`604800`. Predefinito: `86400`. | | `--schedule-anchor ` | 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 ` | `3600`–`7776000`. Predefinito: `604800`. | | `--scope ''` | Filtra per `environments`, `agent_ids`, o altri campi di scope supportati. | | `--ignore-error-type ` | Escludi i tipi di errore; ripeti o separa con virgola. | | `--llm` / `--no-llm` | Abilita o disabilita l'analisi agentica. Predefinito: abilitato. | | `--top-k ` | Mantieni `1`–`500` findings. Predefinito: `50`. | | `--sensitivity low\|medium\|high` | Imposta la sensibilità di segnalazione. Predefinito: `medium`. | | `--channels ''` | Array di canali di notifica. | | `--text ` | Brief inline, massimo 8.192 caratteri. | | `--text-file ` | Leggi il brief da un file; mutuamente esclusivo con `--text`. | | `--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 ` | Usa un dashboard self-hosted o di sviluppo. | | `--org ` | Seleziona un'organizzazione per questa invocazione. | | `--token ` | Sostituisci il token di sessione utente salvato. | | `--api-key ` | Autentica l'automazione con una chiave API; mai salvata. | | `--timeout ` | 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.