> ## 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 > Référence complète pour interroger et administrer Failproof AI Cloud avec fp. 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`](/fr/reference/failproof-cli) 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é : ```bash theme={null} uv tool install fp-cli fp version ``` ## Connexion ```bash theme={null} fp login fp whoami ``` ## Syntaxe ```text theme={null} fp [GLOBAL_OPTIONS] COMMAND [SUBCOMMAND] [ARGUMENTS] [OPTIONS] ``` Les options globales doivent être placées avant la commande : ```bash theme={null} 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. | — | ```bash theme={null} fp login --email you@example.com --org reliability-team fp whoami ``` ### Événements ```text theme={null} 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 ` | Nombre total maximum de lignes. Par défaut : `50`. | | `--since ` | `all`, `15m`, `1h`, `6h`, `24h` ou `7d`. | | `--from ` / `--to ` | Plage ISO 8601 UTC ; remplace `--since`. | | `--env ` | Filtre d'environnement ; répétable ou séparé par des virgules. | | `--event-type ` | Filtre de type d'événement ; répétable ou séparé par des virgules. | | `--agent-id ` | Filtre d'agent ; répétable ou séparé par des virgules. | | `--session-id ` | Filtre de session ; répétable ou séparé par des virgules. | | `--search ` | 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 ` | Reprendre depuis un curseur opaque. | | `--page-size ` | 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 ` | Retourner uniquement les champs sélectionnés ; demander `payload` active le mode complet. | ```bash theme={null} fp events --session-id --order asc --all fp --json events --full --session-id --all ``` ### Sessions ```text theme={null} fp sessions [OPTIONS] ``` | Option | Description | | ----------------------------------------- | ------------------------------------------------------------------------ | | `--limit`, `-n ` | Nombre total maximum de lignes. Par défaut : `50`. | | `--since ` | `all`, `15m`, `1h`, `6h`, `24h` ou `7d`. | | `--from ` / `--to ` | Plage ISO 8601 UTC ; remplace `--since`. | | `--env ` | Filtre d'environnement ; répétable ou séparé par des virgules. | | `--status ` | `done`, `error` ou `timeout` ; répétable ou séparé par des virgules. | | `--agent-id ` | Faire correspondre les sessions impliquant l'un des agents sélectionnés. | | `--session-id ` | Filtre de session ; répétable ou séparé par des virgules. | | `--all` | Pagination automatique jusqu'à `--limit`. | | `--cursor ` | Reprendre depuis un curseur opaque. | | `--page-size ` | Lignes par requête avec `--all` ; maximum `200`. | | `--fields ` | 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 ```text theme={null} fp evals [OPTIONS] ``` | Option | Description | | ------------------------------------------------- | ---------------------------------------------------------------------------------------- | | `--aggregate` | Afficher les totaux et les statistiques par score au lieu des évaluations individuelles. | | `--limit`, `-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 ` | 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 ```text theme={null} fp errors [OPTIONS] ``` | Option | Description | | --------------------------------------------------------------------- | ----------------------------------------------------------------- | | `--aggregate` | Résumer les erreurs correspondantes au lieu de lister les lignes. | | `--limit`, `-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 ` | 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 ` | 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 ` | | `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 ` | | `fp query show NAME` | Afficher une requête. | — | | `fp query create NAME` | Enregistrer une requête. | `--sql ` ; `--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](#audit-create-options). | | `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 ` requis | #### Options de création d'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 ``` | Option | Description | | --------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- | | `--file ` | Baser la définition sur du JSON, ou utiliser `-` pour stdin. Les options explicites remplacent les valeurs du fichier. | | `--description ` | É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 ` | `3600`–`604800`. Par défaut : `86400`. | | `--schedule-anchor ` | 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 ` | `3600`–`7776000`. Par défaut : `604800`. | | `--scope ''` | Filtrer par `environments`, `agent_ids` ou autres champs de portée pris en charge. | | `--ignore-error-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 ` | Conserver `1`–`500` résultats. Par défaut : `50`. | | `--sensitivity low\|medium\|high` | Définir la sensibilité du rapport. Par défaut : `medium`. | | `--channels ''` | Tableau de canaux de notification. | | `--text ` | Résumé en ligne, maximum 8 192 caractères. | | `--text-file ` | Lire le résumé depuis un fichier ; mutuellement exclusif avec `--text`. | | `--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 ` | Utiliser un tableau de bord auto-hébergé ou de développement. | | `--org ` | Sélectionner une organisation pour cette invocation. | | `--token ` | Remplacer le jeton de session utilisateur enregistré. | | `--api-key ` | Authentifier l'automatisation avec une clé API ; jamais enregistrée. | | `--timeout ` | 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.