Failproof Cloud CLI

Utilisez fp pour inspecter la télémétrie Cloud et gérer les audits, les résultats, les incidents, les alertes, les clés, les utilisateurs, les requêtes et les paramètres. Utilisez failproofai pour les hooks locaux, les politiques, la capture et l’enrôlement des machines. Installez la version publiée du Cloud CLI en tant qu’outil isolé :

uv tool install fp-cli
fp version

Connexion

fp login
fp whoami

Syntaxe

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

Les options globales doivent être placées avant la commande :

fp --json sessions --since 24h

Exécutez fp COMMAND --help ou fp COMMAND SUBCOMMAND --help pour obtenir l’aide dans le terminal.

Commandes CLI

Authentification

Commande	Objectif	Options
`fp login`	Se connecter avec un code à usage unique envoyé par e-mail et sélectionner une organisation.	`--email`, `-e` ; `--org` ; `--force`
`fp logout`	Révoquer et supprimer la session utilisateur enregistrée.	—
`fp whoami`	Afficher l’identité actuelle, le mode d’authentification, l’organisation et les permissions.	—
`fp version`	Afficher la version du CLI installée.	—
`fp help`	Afficher l’aide des commandes de premier niveau.	—

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

Événements

fp events [OPTIONS]

Liste les événements individuels des agents. Le flux léger par défaut exclut les charges utiles brutes ; n’utilisez --full que pour une investigation délimitée.

Option	Description
`--limit`, `-n <n>`	Nombre total maximum de lignes. Par défaut : `50`.
`--since <window>`	`all`, `15m`, `1h`, `6h`, `24h` ou `7d`.
`--from <timestamp>` / `--to <timestamp>`	Plage ISO 8601 UTC ; remplace `--since`.
`--env <value>`	Filtre d’environnement ; répétable ou séparé par des virgules.
`--event-type <value>`	Filtre de type d’événement ; répétable ou séparé par des virgules.
`--agent-id <value>`	Filtre d’agent ; répétable ou séparé par des virgules.
`--session-id <value>`	Filtre de session ; répétable ou séparé par des virgules.
`--search <text>`	Recherche dans le texte des charges utiles ; répétable, avec correspondance sur n’importe quel terme.
`--order asc\|desc`	Ordre chronologique. Par défaut : plus récent en premier.
`--all`	Pagination automatique jusqu’à `--limit`.
`--cursor <token>`	Reprendre depuis un curseur opaque.
`--page-size <n>`	Lignes par requête avec `--all` ; maximum `200`.
`--full`	Inclure les charges utiles brutes via le point de terminaison d’événements plus lourd.
`--fields <csv>`	Retourner uniquement les champs sélectionnés ; demander `payload` active le mode complet.

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

Sessions

fp sessions [OPTIONS]

Option	Description
`--limit`, `-n <n>`	Nombre total maximum de lignes. Par défaut : `50`.
`--since <window>`	`all`, `15m`, `1h`, `6h`, `24h` ou `7d`.
`--from <timestamp>` / `--to <timestamp>`	Plage ISO 8601 UTC ; remplace `--since`.
`--env <value>`	Filtre d’environnement ; répétable ou séparé par des virgules.
`--status <value>`	`done`, `error` ou `timeout` ; répétable ou séparé par des virgules.
`--agent-id <value>`	Faire correspondre les sessions impliquant l’un des agents sélectionnés.
`--session-id <value>`	Filtre de session ; répétable ou séparé par des virgules.
`--all`	Pagination automatique jusqu’à `--limit`.
`--cursor <token>`	Reprendre depuis un curseur opaque.
`--page-size <n>`	Lignes par requête avec `--all` ; maximum `200`.
`--fields <csv>`	Retourner uniquement les champs sélectionnés.
`--full-ids`	Ne pas raccourcir les identifiants de session dans la sortie terminal.
`--agents`	Développer la liste des agents pour les sessions multi-agents.

Évaluations

fp evals [OPTIONS]

Option	Description
`--aggregate`	Afficher les totaux et les statistiques par score au lieu des évaluations individuelles.
`--limit`, `-n <n>`	Nombre maximum de lignes dans la liste. Par défaut : `50`.
`--since`, `--from`, `--to`	Sélectionner la plage de temps.
`--env`, `--status`, `--agent-id`, `--session-id`	Restreindre à une valeur exacte par filtre.
`--score KEY:MIN..MAX`	Plage de scores ; répétable et toutes les plages doivent correspondre.
`--all`, `--cursor`, `--page-size`	Contrôler la pagination de la liste.
`--fields <csv>`	Retourner uniquement les champs sélectionnés.
`--full-ids`	Afficher les identifiants de session complets.
`--scores-full`	Afficher tous les scores dans la sortie terminal.

Erreurs

fp errors [OPTIONS]

Option	Description
`--aggregate`	Résumer les erreurs correspondantes au lieu de lister les lignes.
`--limit`, `-n <n>`	Nombre maximum de lignes dans la liste. Par défaut : `50`.
`--since`, `--from`, `--to`	Sélectionner la plage de temps.
`--env`, `--error-type`, `--event-type`, `--agent-id`, `--session-id`	Restreindre la population d’erreurs.
`--search <text>`	Rechercher dans le texte des charges utiles ; répétable.
`--order asc\|desc`	Ordre chronologique.
`--all`, `--cursor`, `--page-size`	Contrôler la pagination de la liste.
`--fields <csv>`	Retourner uniquement les champs sélectionnés.
`--full-ids`	Afficher les identifiants de session complets.

Utilisation et valeurs de filtre

Commande	Objectif
`fp usage`	Afficher l’utilisation pour la fenêtre de mesure actuelle.
`fp list envs`	Lister les environnements observés.
`fp list agents`	Lister les identifiants d’agents observés.
`fp list event_types`	Lister les types d’événements.
`fp list score_filters`	Lister les clés de scores d’évaluation.
`fp list models`	Lister les noms des modèles.
`fp list hooks`	Lister les noms des hooks.
`fp list tools`	Lister les noms des outils.
`fp list error_types`	Lister les types d’erreurs.

Organisations

Commande	Objectif
`fp orgs list`	Lister les organisations accessibles.
`fp orgs switch [SLUG]`	Enregistrer une organisation active ; invite à en choisir une si omise.
`fp orgs current`	Afficher l’organisation active.
`fp orgs perms`	Afficher vos permissions dans l’organisation active.

Clés API

Commande	Objectif	Options
`fp keys list`	Lister les clés de l’organisation.	`--show-id` ; `--fields <csv>`
`fp keys show NAME`	Afficher une clé et ses autorisations.	—
`fp keys create NAME`	Créer une clé et révéler son secret une seule fois.	`--permission-set` ; `--add` ; `--remove`
`fp keys update NAME`	Remplacer l’ensemble de permissions ou ajuster les autorisations.	`--permission-set` ; `--add` ; `--remove` ; `--yes`, `-y`
`fp keys regenerate NAME`	Faire tourner le secret et révéler le remplacement une seule fois.	`--yes`, `-y`
`fp keys disable NAME`	Révoquer définitivement une clé.	`--yes`, `-y`

Les jetons de permission utilisent le format resource:action, par exemple events:add. Répétez --add, séparez les jetons par des virgules, ou utilisez des actions pointées telles que events:read.add.

Requêtes

Commande	Objectif	Options
`fp query list`	Lister les requêtes enregistrées.	`--show-id` ; `--fields <csv>`
`fp query show NAME`	Afficher une requête.	—
`fp query create NAME`	Enregistrer une requête.	`--sql <text\|@file>` ; `--description`
`fp query update NAME`	Mettre à jour ou renommer une requête.	`--name` ; `--sql` ; `--description` ; `--yes`, `-y`
`fp query delete NAME`	Supprimer une requête enregistrée.	`--yes`, `-y`
`fp query run [NAME]`	Exécuter une requête enregistrée ou du SQL ad hoc.	`--sql` ; `--limit` ; `--all` ; `--arg`, `--param`
`fp query schema [TABLE]`	Lister les tables interrogeables ou inspecter une table.	—

Utilisateurs

Commande	Objectif	Options
`fp users list`	Lister les membres de l’organisation.	`--active-only` ; `--show-id`
`fp users show EMAIL`	Afficher un membre et ses autorisations.	—
`fp users create EMAIL`	Ajouter un membre.	`--permission-set` ; `--add` ; `--remove`
`fp users update EMAIL`	Modifier les autorisations d’un membre.	`--permission-set` ; `--add` ; `--remove` ; `--yes`, `-y`
`fp users disable EMAIL`	Désactiver la connexion.	`--yes`, `-y`
`fp users enable EMAIL`	Réactiver la connexion.	`--yes`, `-y`

Paramètres

Commande	Objectif	Options
`fp settings list`	Lister les paramètres de l’organisation et leurs valeurs actuelles.	—
`fp settings schema`	Afficher les valeurs acceptées et les descriptions.	—
`fp settings set KEY`	Modifier un paramètre existant.	exactement l’une des options `--value`, `--json-value`, `--file` ; `--yes`, `-y` en option

Alertes

Commande	Objectif	Options
`fp alerts list`	Lister les règles d’alerte.	`--show-id`
`fp alerts show NAME`	Afficher une alerte.	—
`fp alerts create NAME`	Créer une alerte.	`--file` ; `--description` ; `--severity` ; `--trigger-kind` ; `--trigger-spec` ; `--channels` ; `--eval-interval-secs` ; `--min-breaches` ; `--eval-window`
`fp alerts update NAME`	Mettre à jour ou renommer une alerte.	options de création plus `--name` ; `--yes`, `-y`
`fp alerts delete NAME`	Supprimer une alerte.	`--yes`, `-y`
`fp alerts test NAME`	Envoyer une notification de test.	`--channels` ; `--yes`, `-y`

Les niveaux de gravité des alertes sont info, warning et critical. Les types de déclencheur sont metric_threshold, custom_sql, evaluation_score, eval_compound et per_event. Les intervalles d’évaluation doivent être compris entre 30 et 86 400 secondes.

Audits

Commande	Objectif	Options
`fp audits list`	Lister les audits.	`--enabled-only` ; `--show-id`
`fp audits show NAME`	Afficher une définition d’audit et son état.	—
`fp audits create NAME`	Créer un audit et mettre immédiatement en file d’attente sa première exécution.	Voir options de création.
`fp audits edit NAME`	Remplacer les paramètres d’audit en conservant les valeurs non spécifiées.	options de définition de création ; `--name` ; `--yes`, `-y`
`fp audits delete NAME`	Supprimer un audit, ses résultats et son historique d’exécution.	`--yes`, `-y`
`fp audits run NAME`	Mettre en file d’attente une exécution manuelle.	—
`fp audits runs NAME`	Lister l’historique des exécutions.	`--limit`, `-n` ; `--show-id`
`fp audits context-show NAME`	Afficher le résumé et l’état de récupération des URL de référence.	—
`fp audits context-set NAME`	Modifier le résumé ou les URL de référence.	`--text` ; `--text-file` ; `--url` ; `--clear-urls`
`fp audits context-refresh NAME`	Re-récupérer les URL de référence.	—
`fp audits findings`	Lister les résultats.	`--audit` ; `--run-id` ; `--status` ; `--limit`, `-n` ; `--offset` ; `--show-id`
`fp audits finding FINDING_ID`	Afficher un résultat et ses preuves.	—
`fp audits ack FINDING_ID`	Accuser réception d’un résultat.	`--reason`
`fp audits mute FINDING_ID`	Supprimer un motif récurrent.	`--reason` ; `--yes`, `-y`
`fp audits dismiss FINDING_ID`	Marquer un motif comme non exploitable et le supprimer.	`--reason` ; `--yes`, `-y`
`fp audits resolve FINDING_ID`	Marquer un résultat comme corrigé sans suppression future.	`--yes`, `-y`
`fp audits reopen FINDING_ID`	Remettre un résultat dans la file active et effacer la suppression.	—
`fp audits assign FINDING_ID`	Définir le responsable du résultat.	`--to <email>` requis

Options de création d’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

Option	Description
`--file <path>`	Baser la définition sur du JSON, ou utiliser `-` pour stdin. Les options explicites remplacent les valeurs du fichier.
`--description <text>`	Énoncer la question d’échec ou l’objectif.
`--enabled` / `--disabled`	Démarrer la planification activée ou désactivée. Par défaut : activée.
`--schedule-interval-secs <n>`	`3600`–`604800`. Par défaut : `86400`.
`--schedule-anchor <timestamp>`	Phase UTC fixe au format ISO 8601. Par défaut : prochain 09:00 UTC.
`--window-mode since_last\|fixed`	Continuer après la dernière fenêtre entièrement analysée ou inspecter répétitivement une fenêtre glissante. Par défaut : `since_last`.
`--lookback-window-secs <n>`	`3600`–`7776000`. Par défaut : `604800`.
`--scope '<json>'`	Filtrer par `environments`, `agent_ids` ou autres champs de portée pris en charge.
`--ignore-error-type <type>`	Exclure des types d’erreurs ; répétable ou séparé par des virgules.
`--llm` / `--no-llm`	Activer ou désactiver l’analyse agentique. Par défaut : activée.
`--top-k <n>`	Conserver `1`–`500` résultats. Par défaut : `50`.
`--sensitivity low\|medium\|high`	Définir la sensibilité du rapport. Par défaut : `medium`.
`--channels '<json>'`	Tableau de canaux de notification.
`--text <brief>`	Résumé en ligne, maximum 8 192 caractères.
`--text-file <path>`	Lire le résumé depuis un fichier ; mutuellement exclusif avec `--text`.
`--url <https-url>`	Ajouter une référence HTTPS publique ; répétable jusqu’à cinq fois.

Incluez le contexte lors de la création si la première exécution en a besoin. La création valide la définition et le contexte ensemble avant le début de l’exécution mise en file d’attente.

fp audits run est asynchrone. Interrogez fp audits runs NAME jusqu’à ce que la dernière exécution réussisse ou échoue avant de lire ses résultats.

Incidents

Commande	Objectif	Options
`fp issues list`	Lister les incidents.	`--state` ; `--alert-id` ; `--limit`, `-n` ; `--show-id`
`fp issues count`	Compter les incidents ouverts ou selon les états sélectionnés.	`--state`
`fp issues show INCIDENT_ID`	Afficher les détails d’un incident, ses commentaires, abonnés et activité.	—
`fp issues open`	Ouvrir un incident manuel ou lié à une alerte.	`--summary` requis ; `--title`, `--alert-id`, `--severity` en option
`fp issues ack INCIDENT_ID`	Accuser réception d’un incident.	—
`fp issues assign INCIDENT_ID`	Remplacer les responsables ; omettre l’option pour les effacer.	`--assignee` répétable
`fp issues resolve INCIDENT_ID`	Résoudre un incident.	`--yes`, `-y`
`fp issues comment-list INCIDENT_ID`	Lister les commentaires.	—
`fp issues comment-add INCIDENT_ID`	Ajouter un commentaire.	exactement l’une des options `--body`, `--file`
`fp issues comment-delete INCIDENT_ID COMMENT_ID`	Supprimer un commentaire.	`--yes`, `-y`
`fp issues subscribers INCIDENT_ID`	Lister les abonnés.	—
`fp issues subscribe INCIDENT_ID`	S’abonner soi-même ou un autre opérateur.	`--email`
`fp issues unsubscribe INCIDENT_ID`	Supprimer un abonnement.	`--email`

Les états d’incident valides sont firing, acknowledged et resolved. Les niveaux de gravité des incidents autonomes sont info, warning et critical.

Assistant Cloud

Commande	Objectif	Options
`fp agent health`	Vérifier la disponibilité et la configuration de l’assistant.	—
`fp agent models`	Lister les modèles d’assistant disponibles.	—
`fp agent chats`	Lister les conversations enregistrées.	—
`fp agent ask [MESSAGE]`	Démarrer ou continuer une conversation ; lit stdin si le message est omis.	`--chat` ; `--model` ; `--page-context`
`fp agent show CHAT_ID`	Afficher une conversation enregistrée.	—
`fp agent rename CHAT_ID`	Renommer une conversation.	`--title` requis
`fp agent delete CHAT_ID`	Supprimer une conversation.	`--yes`, `-y`

Options globales

Option	Description
`--json`	Émettre du JSON lisible par machine.
`--base-url <url>`	Utiliser un tableau de bord auto-hébergé ou de développement.
`--org <slug>`	Sélectionner une organisation pour cette invocation.
`--token <token>`	Remplacer le jeton de session utilisateur enregistré.
`--api-key <key>`	Authentifier l’automatisation avec une clé API ; jamais enregistrée.
`--timeout <seconds>`	Délai d’expiration HTTP ; doit être positif. Par défaut : `30`.
`--quiet`, `-q`	Supprimer la sortie d’état sur stderr.
`--no-color`	Désactiver la sortie colorée.
`--insecure` / `--secure`	Désactiver ou restaurer la vérification du certificat TLS.
`--version`	Afficher la version et quitter.
`--help`, `-h`	Afficher l’aide.

--api-key est destiné à l’automatisation. Les commandes de connexion, de changement d’organisation et d’assistant nécessitent une session utilisateur.

Variables d’environnement

Variable	Équivalent ou objectif
`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`	Déplacer le répertoire de configuration CLI actuel.
`AGENTEYE_ANALYTICS_DISABLED` ou `DO_NOT_TRACK`	Désactiver l’analytique CLI anonyme.
`NO_COLOR`	Désactiver la sortie colorée.

Les options explicites remplacent les variables d’environnement, qui remplacent la configuration enregistrée. En mode clé API, sélectionnez le tenant explicitement avec --org ou AGENTEYE_ORG.

Les commandes qui suppriment, révoquent, masquent, résolvent ou remplacent une configuration demandent une confirmation par défaut. N’utilisez --yes qu’après avoir vérifié l’organisation active et la cible.

Connect your agents

Reference

HTTP API

Connexion

Syntaxe

Commandes CLI

Authentification

Événements

Sessions

Évaluations

Erreurs

Utilisation et valeurs de filtre

Organisations

Clés API

Requêtes

Utilisateurs

Paramètres

Alertes

Audits

Options de création d’audit

Incidents

Assistant Cloud

Options globales

Variables d’environnement

​Connexion

​Syntaxe

​Commandes CLI

​Authentification

​Événements

​Sessions

​Évaluations

​Erreurs

​Utilisation et valeurs de filtre

​Organisations

​Clés API

​Requêtes

​Utilisateurs

​Paramètres

​Alertes

​Audits

​Options de création d’audit

​Incidents

​Assistant Cloud

​Options globales

​Variables d’environnement

Connexion

Syntaxe

Commandes CLI

Authentification

Événements

Sessions

Évaluations

Erreurs

Utilisation et valeurs de filtre

Organisations

Clés API

Requêtes

Utilisateurs

Paramètres

Alertes

Audits

Options de création d’audit

Incidents

Assistant Cloud

Options globales

Variables d’environnement