> ## 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 > Referencia completa para consultar y administrar Failproof AI Cloud con fp. Usa `fp` para inspeccionar la telemetría de Cloud y gestionar auditorías, hallazgos, incidencias, alertas, claves, usuarios, consultas y configuración. Usa [`failproofai`](/es/reference/failproof-cli) para hooks locales, políticas, captura e inscripción de máquinas. Instala el Cloud CLI publicado como herramienta aislada: ```bash theme={null} uv tool install fp-cli fp version ``` ## Iniciar sesión ```bash theme={null} fp login fp whoami ``` ## Sintaxis ```text theme={null} fp [GLOBAL_OPTIONS] COMMAND [SUBCOMMAND] [ARGUMENTS] [OPTIONS] ``` Las opciones globales deben ir antes del comando: ```bash theme={null} fp --json sessions --since 24h ``` Ejecuta `fp COMMAND --help` o `fp COMMAND SUBCOMMAND --help` para obtener ayuda en la terminal. ## Comandos del CLI ### Autenticación | Comando | Propósito | Opciones | | ------------ | -------------------------------------------------------------------------------------------- | ----------------------------------- | | `fp login` | Inicia sesión con un código de un solo uso enviado por correo y selecciona una organización. | `--email`, `-e`; `--org`; `--force` | | `fp logout` | Revoca y elimina la sesión de usuario guardada. | — | | `fp whoami` | Muestra la identidad actual, el modo de autenticación, la organización y los permisos. | — | | `fp version` | Muestra la versión instalada del CLI. | — | | `fp help` | Muestra la ayuda de comandos de nivel superior. | — | ```bash theme={null} fp login --email tu@ejemplo.com --org equipo-de-fiabilidad fp whoami ``` ### Eventos ```text theme={null} fp events [OPTIONS] ``` Lista eventos individuales de agentes. El feed ligero predeterminado excluye los payloads sin procesar; usa `--full` solo para una investigación acotada. | Opción | Descripción | | ----------------------------------------- | ------------------------------------------------------------------------------------ | | `--limit`, `-n ` | Máximo total de filas. Predeterminado: `50`. | | `--since ` | `all`, `15m`, `1h`, `6h`, `24h` o `7d`. | | `--from ` / `--to ` | Rango UTC ISO 8601; reemplaza `--since`. | | `--env ` | Filtro de entorno; repite o separa valores con comas. | | `--event-type ` | Filtro de tipo de evento; repite o separa valores con comas. | | `--agent-id ` | Filtro de agente; repite o separa valores con comas. | | `--session-id ` | Filtro de sesión; repite o separa valores con comas. | | `--search ` | Búsqueda de texto en el payload; repetible, coincide con cualquier término. | | `--order asc\|desc` | Orden temporal. Predeterminado: más reciente primero. | | `--all` | Paginación automática hasta `--limit`. | | `--cursor ` | Reanuda desde un cursor opaco. | | `--page-size ` | Filas por solicitud con `--all`; máximo `200`. | | `--full` | Incluye payloads sin procesar a través del endpoint de eventos más pesado. | | `--fields ` | Devuelve solo los campos seleccionados; solicitar `payload` activa el modo completo. | ```bash theme={null} fp events --session-id --order asc --all fp --json events --full --session-id --all ``` ### Sesiones ```text theme={null} fp sessions [OPTIONS] ``` | Opción | Descripción | | ----------------------------------------- | ------------------------------------------------------------------- | | `--limit`, `-n ` | Máximo total de filas. Predeterminado: `50`. | | `--since ` | `all`, `15m`, `1h`, `6h`, `24h` o `7d`. | | `--from ` / `--to ` | Rango UTC ISO 8601; reemplaza `--since`. | | `--env ` | Filtro de entorno; repite o separa valores con comas. | | `--status ` | `done`, `error` o `timeout`; repite o separa valores con comas. | | `--agent-id ` | Coincide con sesiones que involucran cualquier agente seleccionado. | | `--session-id ` | Filtro de sesión; repite o separa valores con comas. | | `--all` | Paginación automática hasta `--limit`. | | `--cursor ` | Reanuda desde un cursor opaco. | | `--page-size ` | Filas por solicitud con `--all`; máximo `200`. | | `--fields ` | Devuelve solo los campos seleccionados. | | `--full-ids` | No acorta los IDs de sesión en la salida de la terminal. | | `--agents` | Expande el listado de agentes para sesiones multiagente. | ### Evaluaciones ```text theme={null} fp evals [OPTIONS] ``` | Opción | Descripción | | ------------------------------------------------- | ------------------------------------------------------------------------------------ | | `--aggregate` | Muestra totales y estadísticas por puntuación en lugar de evaluaciones individuales. | | `--limit`, `-n ` | Máximo de filas en el listado. Predeterminado: `50`. | | `--since`, `--from`, `--to` | Selecciona el rango de tiempo. | | `--env`, `--status`, `--agent-id`, `--session-id` | Restringe a un valor exacto por filtro. | | `--score KEY:MIN..MAX` | Rango de puntuación; repetible y todos los rangos deben coincidir. | | `--all`, `--cursor`, `--page-size` | Controla la paginación del listado. | | `--fields ` | Devuelve solo los campos seleccionados. | | `--full-ids` | Muestra los IDs de sesión completos. | | `--scores-full` | Muestra todas las puntuaciones en la salida de la terminal. | ### Errores ```text theme={null} fp errors [OPTIONS] ``` | Opción | Descripción | | --------------------------------------------------------------------- | --------------------------------------------------------- | | `--aggregate` | Resume los errores coincidentes en lugar de listar filas. | | `--limit`, `-n ` | Máximo de filas en el listado. Predeterminado: `50`. | | `--since`, `--from`, `--to` | Selecciona el rango de tiempo. | | `--env`, `--error-type`, `--event-type`, `--agent-id`, `--session-id` | Restringe la población de errores. | | `--search ` | Busca texto en el payload; repetible. | | `--order asc\|desc` | Orden temporal. | | `--all`, `--cursor`, `--page-size` | Controla la paginación del listado. | | `--fields ` | Devuelve solo los campos seleccionados. | | `--full-ids` | Muestra los IDs de sesión completos. | ### Uso y valores de filtro | Comando | Propósito | | ----------------------- | -------------------------------------------------- | | `fp usage` | Muestra el uso para la ventana de medición actual. | | `fp list envs` | Lista los entornos observados. | | `fp list agents` | Lista los IDs de agentes observados. | | `fp list event_types` | Lista los tipos de eventos. | | `fp list score_filters` | Lista las claves de puntuación de evaluación. | | `fp list models` | Lista los nombres de modelos. | | `fp list hooks` | Lista los nombres de hooks. | | `fp list tools` | Lista los nombres de herramientas. | | `fp list error_types` | Lista los tipos de errores. | ### Organizaciones | Comando | Propósito | | ----------------------- | ------------------------------------------------------------------ | | `fp orgs list` | Lista las organizaciones accesibles. | | `fp orgs switch [SLUG]` | Guarda una organización activa; solicita confirmación si se omite. | | `fp orgs current` | Muestra la organización activa. | | `fp orgs perms` | Muestra tus permisos en la organización activa. | ### Claves de API | Comando | Propósito | Opciones | | ------------------------- | -------------------------------------------------------- | ------------------------------------------------------ | | `fp keys list` | Lista las claves de la organización. | `--show-id`; `--fields ` | | `fp keys show NAME` | Muestra una clave y sus permisos. | — | | `fp keys create NAME` | Crea una clave y revela su secreto una sola vez. | `--permission-set`; `--add`; `--remove` | | `fp keys update NAME` | Reemplaza el conjunto de permisos o ajusta los permisos. | `--permission-set`; `--add`; `--remove`; `--yes`, `-y` | | `fp keys regenerate NAME` | Rota el secreto y revela el reemplazo una sola vez. | `--yes`, `-y` | | `fp keys disable NAME` | Revoca una clave de forma permanente. | `--yes`, `-y` | Los tokens de permiso usan el formato `recurso:acción`, por ejemplo `events:add`. Repite `--add`, separa los tokens con comas, o usa acciones con punto como `events:read.add`. ### Consultas | Comando | Propósito | Opciones | | ------------------------- | ------------------------------------------------------ | ------------------------------------------------- | | `fp query list` | Lista las consultas guardadas. | `--show-id`; `--fields ` | | `fp query show NAME` | Muestra una consulta. | — | | `fp query create NAME` | Guarda una consulta. | `--sql `; `--description` | | `fp query update NAME` | Actualiza o renombra una consulta. | `--name`; `--sql`; `--description`; `--yes`, `-y` | | `fp query delete NAME` | Elimina una consulta guardada. | `--yes`, `-y` | | `fp query run [NAME]` | Ejecuta una consulta guardada o SQL ad-hoc. | `--sql`; `--limit`; `--all`; `--arg`, `--param` | | `fp query schema [TABLE]` | Lista las tablas consultables o inspecciona una tabla. | — | ### Usuarios | Comando | Propósito | Opciones | | ------------------------ | -------------------------------------- | ------------------------------------------------------ | | `fp users list` | Lista los miembros de la organización. | `--active-only`; `--show-id` | | `fp users show EMAIL` | Muestra un miembro y sus permisos. | — | | `fp users create EMAIL` | Agrega un miembro. | `--permission-set`; `--add`; `--remove` | | `fp users update EMAIL` | Modifica los permisos de un miembro. | `--permission-set`; `--add`; `--remove`; `--yes`, `-y` | | `fp users disable EMAIL` | Deshabilita el inicio de sesión. | `--yes`, `-y` | | `fp users enable EMAIL` | Rehabilita el inicio de sesión. | `--yes`, `-y` | ### Configuración | Comando | Propósito | Opciones | | --------------------- | ------------------------------------------------------------ | ------------------------------------------------------------------------------ | | `fp settings list` | Lista los ajustes de la organización y sus valores actuales. | — | | `fp settings schema` | Muestra los valores aceptados y sus descripciones. | — | | `fp settings set KEY` | Modifica un ajuste existente. | exactamente uno de `--value`, `--json-value`, `--file`; `--yes`, `-y` opcional | ### Alertas | Comando | Propósito | Opciones | | ----------------------- | --------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | | `fp alerts list` | Lista las reglas de alerta. | `--show-id` | | `fp alerts show NAME` | Muestra una alerta. | — | | `fp alerts create NAME` | Crea una alerta. | `--file`; `--description`; `--severity`; `--trigger-kind`; `--trigger-spec`; `--channels`; `--eval-interval-secs`; `--min-breaches`; `--eval-window` | | `fp alerts update NAME` | Actualiza o renombra una alerta. | opciones de creación más `--name`; `--yes`, `-y` | | `fp alerts delete NAME` | Elimina una alerta. | `--yes`, `-y` | | `fp alerts test NAME` | Envía una notificación de prueba. | `--channels`; `--yes`, `-y` | Las severidades de alerta son `info`, `warning` y `critical`. Los tipos de disparador son `metric_threshold`, `custom_sql`, `evaluation_score`, `eval_compound` y `per_event`. Los intervalos de evaluación deben estar entre 30 y 86.400 segundos. ### Auditorías | Comando | Propósito | Opciones | | -------------------------------- | ------------------------------------------------------------------------------- | --------------------------------------------------------------------------- | | `fp audits list` | Lista las auditorías. | `--enabled-only`; `--show-id` | | `fp audits show NAME` | Muestra una definición de auditoría y su estado. | — | | `fp audits create NAME` | Crea una auditoría y encola inmediatamente su primera ejecución. | Ver [opciones de creación](#audit-create-options). | | `fp audits edit NAME` | Reemplaza los ajustes de la auditoría conservando los valores no especificados. | opciones de definición de creación; `--name`; `--yes`, `-y` | | `fp audits delete NAME` | Elimina una auditoría, sus hallazgos y el historial de ejecuciones. | `--yes`, `-y` | | `fp audits run NAME` | Encola una ejecución manual. | — | | `fp audits runs NAME` | Lista el historial de ejecuciones. | `--limit`, `-n`; `--show-id` | | `fp audits context-show NAME` | Muestra el resumen y el estado de obtención de las URLs de referencia. | — | | `fp audits context-set NAME` | Cambia el resumen o las URLs de referencia. | `--text`; `--text-file`; `--url`; `--clear-urls` | | `fp audits context-refresh NAME` | Vuelve a obtener las URLs de referencia. | — | | `fp audits findings` | Lista los hallazgos. | `--audit`; `--run-id`; `--status`; `--limit`, `-n`; `--offset`; `--show-id` | | `fp audits finding FINDING_ID` | Muestra un hallazgo y su evidencia. | — | | `fp audits ack FINDING_ID` | Confirma la recepción de un hallazgo. | `--reason` | | `fp audits mute FINDING_ID` | Suprime un patrón recurrente. | `--reason`; `--yes`, `-y` | | `fp audits dismiss FINDING_ID` | Marca un patrón como no accionable y lo suprime. | `--reason`; `--yes`, `-y` | | `fp audits resolve FINDING_ID` | Marca un hallazgo como corregido sin supresión futura. | `--yes`, `-y` | | `fp audits reopen FINDING_ID` | Devuelve un hallazgo a la cola activa y elimina la supresión. | — | | `fp audits assign FINDING_ID` | Asigna el propietario del hallazgo. | `--to ` requerido | #### Opciones de creación de auditoría ```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 ``` | Opción | Descripción | | --------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | | `--file ` | Basa la definición en JSON, o usa `-` para stdin. Las flags explícitas reemplazan los valores del archivo. | | `--description ` | Indica la pregunta de fallo o el propósito. | | `--enabled` / `--disabled` | Inicia la programación activada o desactivada. Predeterminado: habilitado. | | `--schedule-interval-secs ` | `3600`–`604800`. Predeterminado: `86400`. | | `--schedule-anchor ` | Fase UTC fija en formato ISO 8601. Predeterminado: próximas 09:00 UTC. | | `--window-mode since_last\|fixed` | Continúa después de la última ventana completamente analizada o inspecciona repetidamente una ventana deslizante. Predeterminado: `since_last`. | | `--lookback-window-secs ` | `3600`–`7776000`. Predeterminado: `604800`. | | `--scope ''` | Filtra por `environments`, `agent_ids` u otros campos de alcance compatibles. | | `--ignore-error-type ` | Excluye tipos de errores; repite o separa con comas. | | `--llm` / `--no-llm` | Activa o desactiva el análisis agéntico. Predeterminado: habilitado. | | `--top-k ` | Conserva entre `1` y `500` hallazgos. Predeterminado: `50`. | | `--sensitivity low\|medium\|high` | Establece la sensibilidad de reporte. Predeterminado: `medium`. | | `--channels ''` | Array de canales de notificación. | | `--text ` | Resumen en línea, máximo 8.192 caracteres. | | `--text-file ` | Lee el resumen desde un archivo; mutuamente exclusivo con `--text`. | | `--url ` | Agrega una referencia HTTPS pública; repite hasta cinco veces. | Incluye el contexto durante la creación cuando la primera ejecución lo necesite. La creación confirma la definición y el contexto juntos antes de que comience la ejecución en cola. `fp audits run` es asíncrono. Sondea `fp audits runs NAME` hasta que la última ejecución tenga éxito o falle antes de leer sus hallazgos. ### Incidencias | Comando | Propósito | Opciones | | ------------------------------------------------- | ------------------------------------------------------------------------------ | ----------------------------------------------------------------------- | | `fp issues list` | Lista las incidencias. | `--state`; `--alert-id`; `--limit`, `-n`; `--show-id` | | `fp issues count` | Cuenta las incidencias abiertas o los estados de incidencia seleccionados. | `--state` | | `fp issues show INCIDENT_ID` | Muestra los detalles, comentarios, suscriptores y actividad de una incidencia. | — | | `fp issues open` | Abre una incidencia manual o vinculada a una alerta. | `--summary` requerido; `--title`, `--alert-id`, `--severity` opcionales | | `fp issues ack INCIDENT_ID` | Confirma la recepción de una incidencia. | — | | `fp issues assign INCIDENT_ID` | Reemplaza los asignados; omite la opción para eliminarlos. | `--assignee` repetible | | `fp issues resolve INCIDENT_ID` | Resuelve una incidencia. | `--yes`, `-y` | | `fp issues comment-list INCIDENT_ID` | Lista los comentarios. | — | | `fp issues comment-add INCIDENT_ID` | Agrega un comentario. | exactamente uno de `--body`, `--file` | | `fp issues comment-delete INCIDENT_ID COMMENT_ID` | Elimina un comentario. | `--yes`, `-y` | | `fp issues subscribers INCIDENT_ID` | Lista los suscriptores. | — | | `fp issues subscribe INCIDENT_ID` | Te suscribe a ti o a otro operador. | `--email` | | `fp issues unsubscribe INCIDENT_ID` | Elimina una suscripción. | `--email` | Los estados válidos de incidencia son `firing`, `acknowledged` y `resolved`. Las severidades de incidencias independientes son `info`, `warning` y `critical`. ### Asistente en la nube | Comando | Propósito | Opciones | | ------------------------- | ---------------------------------------------------------------- | ------------------------------------- | | `fp agent health` | Verifica la disponibilidad y configuración del asistente. | — | | `fp agent models` | Lista los modelos de asistente disponibles. | — | | `fp agent chats` | Lista los chats guardados. | — | | `fp agent ask [MESSAGE]` | Inicia o continúa un chat; lee stdin cuando se omite el mensaje. | `--chat`; `--model`; `--page-context` | | `fp agent show CHAT_ID` | Muestra una conversación guardada. | — | | `fp agent rename CHAT_ID` | Renombra una conversación. | `--title` requerido | | `fp agent delete CHAT_ID` | Elimina una conversación. | `--yes`, `-y` | ## Flags globales | Flag | Descripción | | ------------------------- | ------------------------------------------------------------------ | | `--json` | Emite JSON legible por máquina. | | `--base-url ` | Usa un dashboard autoalojado o de desarrollo. | | `--org ` | Selecciona una organización para esta invocación. | | `--token ` | Reemplaza el token de sesión de usuario guardado. | | `--api-key ` | Autentica la automatización con una clave de API; nunca se guarda. | | `--timeout ` | Tiempo de espera HTTP; debe ser positivo. Predeterminado: `30`. | | `--quiet`, `-q` | Suprime la salida de estado en stderr. | | `--no-color` | Deshabilita la salida con color. | | `--insecure` / `--secure` | Deshabilita o restaura la verificación del certificado TLS. | | `--version` | Imprime la versión y sale. | | `--help`, `-h` | Muestra la ayuda. | `--api-key` está destinado a la automatización. Los comandos de inicio de sesión, cambio de organización y asistente requieren una sesión de usuario. ## Variables de entorno | Variable | Equivalente o propósito | | ---------------------------------------------- | ------------------------------------------------------ | | `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` | Reubica el directorio de configuración actual del CLI. | | `AGENTEYE_ANALYTICS_DISABLED` o `DO_NOT_TRACK` | Deshabilita las analíticas anónimas del CLI. | | `NO_COLOR` | Deshabilita la salida con color. | Las flags explícitas reemplazan las variables de entorno, que a su vez reemplazan la configuración guardada. En el modo de clave de API, selecciona el tenant explícitamente con `--org` o `AGENTEYE_ORG`. Los comandos que eliminan, revocan, suprimen, resuelven o reemplazan configuración solicitan confirmación de forma predeterminada. Usa `--yes` solo después de verificar la organización activa y el objetivo.