Failproof Cloud CLI

Используйте fp для проверки телеметрии Cloud, управления облачным enforcement (политики, развертывания флота, решения guardrail), а также управления аудитами, findings, issues, alerts, ключами, пользователями, запросами и параметрами. Используйте failproofai для локальных hooks, политик, захвата и регистрации машин. Установите выпущенный Cloud CLI как изолированный инструмент:

uv tool install fp-cloud-cli
fp version

Вход в систему

fp login
fp whoami

Синтаксис

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

Глобальные параметры должны предшествовать команде:

fp --json sessions --since 24h

Запустите fp COMMAND --help или fp COMMAND SUBCOMMAND --help для справки в терминале.

Команды CLI

Аутентификация

Команда	Назначение	Параметры
`fp login`	Вход с использованием одноразового кода, отправленного по электронной почте, и выбор организации.	`--email`, `-e`; `--org`; `--force`
`fp logout`	Отозвать и удалить сохраненный сеанс пользователя.	—
`fp whoami`	Показать текущую идентичность, режим аутентификации, организацию и разрешения.	—
`fp version`	Показать установленную версию CLI.	—
`fp help`	Показать справку по команде верхнего уровня.	—

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

События

fp events [OPTIONS]

Выводит отдельные события агента. Легкий поток по умолчанию исключает необработанные полезные нагрузки; используйте --full только для ограниченного исследования.

Параметр	Описание
`--limit`, `-n <n>`	Максимум всего строк. По умолчанию: `50`.
`--since <window>`	`all`, `15m`, `1h`, `6h`, `24h` или `7d`.
`--from <timestamp>` / `--to <timestamp>`	Диапазон ISO 8601 UTC; переопределяет `--since`.
`--env <value>`	Фильтр окружения; повторяется или разделяется запятыми.
`--event-type <value>`	Фильтр типа события; повторяется или разделяется запятыми.
`--agent-id <value>`	Фильтр агента; повторяется или разделяется запятыми.
`--session-id <value>`	Фильтр сеанса; повторяется или разделяется запятыми.
`--search <text>`	Поиск текста в полезной нагрузке; повторяется с совпадением любого условия.
`--order asc\|desc`	Порядок времени. По умолчанию: сначала новые.
`--all`	Автоматическое разбиение на страницы до `--limit`.
`--cursor <token>`	Возобновить с непрозрачного курсора.
`--page-size <n>`	Строк на запрос с `--all`; максимум `200`.
`--full`	Включить необработанные полезные нагрузки через более тяжелую конечную точку события.
`--fields <csv>`	Возвращать только выбранные поля; запрос `payload` включает полный режим.

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

--all разбивает на страницы до --limit, который по умолчанию равен 50 — поэтому --all само по себе останавливается на 50 строках. Когда он останавливается рано, ответ содержит next_cursor для возобновления; "next_cursor": null означает, что поток действительно исчерпан.

Сеансы

fp sessions [OPTIONS]

Параметр	Описание
`--limit`, `-n <n>`	Максимум всего строк. По умолчанию: `50`.
`--since <window>`	`all`, `15m`, `1h`, `6h`, `24h` или `7d`.
`--from <timestamp>` / `--to <timestamp>`	Диапазон ISO 8601 UTC; переопределяет `--since`.
`--env <value>`	Фильтр окружения; повторяется или разделяется запятыми.
`--status <value>`	`done`, `error` или `timeout`; повторяется или разделяется запятыми.
`--agent-id <value>`	Совпадают сеансы, включающие любого выбранного агента.
`--session-id <value>`	Фильтр сеанса; повторяется или разделяется запятыми.
`--all`	Автоматическое разбиение на страницы до `--limit`.
`--cursor <token>`	Возобновить с непрозрачного курсора.
`--page-size <n>`	Строк на запрос с `--all`; максимум `200`.
`--fields <csv>`	Возвращать только выбранные поля.
`--full-ids`	Не сокращать ID сеансов в выводе терминала.
`--agents`	Развернуть список агентов для многоагентных сеансов.

Оценки

fp evals [OPTIONS]

Параметр	Описание
`--aggregate`	Показать итоги и статистику по баллам вместо отдельных оценок.
`--limit`, `-n <n>`	Максимум строк в списке. По умолчанию: `50`.
`--since`, `--from`, `--to`	Выбрать временной диапазон.
`--env`, `--status`, `--agent-id`, `--session-id`	Сузить до одного точного значения за фильтр.
`--score KEY:MIN..MAX`	Диапазон баллов; повторяется и все диапазоны должны совпадать.
`--all`, `--cursor`, `--page-size`	Управлять разбиением на страницы списка.
`--fields <csv>`	Возвращать только выбранные поля.
`--full-ids`	Показать полные ID сеансов.
`--scores-full`	Показать каждый балл в выводе терминала.

Ошибки

fp errors [OPTIONS]

Параметр	Описание
`--aggregate`	Суммировать совпадающие ошибки вместо вывода строк.
`--limit`, `-n <n>`	Максимум строк в списке. По умолчанию: `50`.
`--since`, `--from`, `--to`	Выбрать временной диапазон.
`--env`, `--error-type`, `--event-type`, `--agent-id`, `--session-id`	Сузить популяцию ошибок.
`--search <text>`	Поиск текста в полезной нагрузке; повторяется.
`--order asc\|desc`	Порядок времени.
`--all`, `--cursor`, `--page-size`	Управлять разбиением на страницы списка.
`--fields <csv>`	Возвращать только выбранные поля.
`--full-ids`	Показать полные ID сеансов.

Использование и значения фильтров

Команда	Назначение
`fp usage`	Показать использование для текущего окна измерения.
`fp list envs`	Вывести наблюдаемые окружения.
`fp list agents`	Вывести наблюдаемые ID агентов.
`fp list event_types`	Вывести типы событий.
`fp list score_filters`	Вывести ключи баллов оценки.
`fp list models`	Вывести имена моделей.
`fp list hooks`	Вывести имена hooks.
`fp list tools`	Вывести имена инструментов.
`fp list error_types`	Вывести типы ошибок.

Организации

Команда	Назначение
`fp orgs list`	Вывести доступные организации.
`fp orgs switch [SLUG]`	Сохранить активную организацию; запрашивает, если опущено.
`fp orgs current`	Показать активную организацию.
`fp orgs perms`	Показать ваши разрешения в активной организации.

Ключи API

Команда	Назначение	Параметры
`fp keys list`	Вывести ключи организации.	`--show-id`; `--fields <csv>`
`fp keys show NAME`	Показать один ключ и его гранты.	—
`fp keys create NAME`	Создать ключ и открыть его секрет один раз.	`--permission-set`; `--add`; `--remove`
`fp keys update NAME`	Заменить набор разрешений или настроить гранты.	`--permission-set`; `--add`; `--remove`; `--yes`, `-y`
`fp keys regenerate NAME`	Повернуть секрет и открыть замену один раз.	`--yes`, `-y`
`fp keys disable NAME`	Навсегда отозвать ключ.	`--yes`, `-y`

Токены разрешений используют resource:action, такие как events:add. Повторяйте --add, разделяйте запятыми или используйте точечные действия, такие как events:read.add.

Запросы

Команда	Назначение	Параметры
`fp query list`	Вывести сохраненные запросы.	`--show-id`; `--fields <csv>`
`fp query show NAME`	Показать один запрос.	—
`fp query create NAME`	Сохранить запрос.	`--sql <text\|@file>`; `--description`
`fp query update NAME`	Обновить или переименовать запрос.	`--name`; `--sql`; `--description`; `--yes`, `-y`
`fp query delete NAME`	Удалить сохраненный запрос.	`--yes`, `-y`
`fp query run [NAME]`	Запустить сохраненный запрос или SQL на лету.	`--sql`; `--limit`; `--all`; `--arg`, `--param`
`fp query schema [TABLE]`	Вывести доступные таблицы или проверить одну таблицу.	—

Пользователи

Команда	Назначение	Параметры
`fp users list`	Вывести членов организации.	`--active-only`; `--show-id`
`fp users show EMAIL`	Показать члена и его гранты.	—
`fp users create EMAIL`	Добавить члена.	`--permission-set`; `--add`; `--remove`
`fp users update EMAIL`	Изменить гранты члена.	`--permission-set`; `--add`; `--remove`; `--yes`, `-y`
`fp users disable EMAIL`	Отключить вход.	`--yes`, `-y`
`fp users enable EMAIL`	Повторно включить вход.	`--yes`, `-y`

Параметры

Команда	Назначение	Параметры
`fp settings list`	Вывести параметры организации и текущие значения.	—
`fp settings schema`	Показать принятые значения и описания.	—
`fp settings set KEY`	Изменить существующий параметр.	ровно одно из `--value`, `--json-value`, `--file`; опциональное `--yes`, `-y`

Алерты

Команда	Назначение	Параметры
`fp alerts list`	Вывести правила алертов.	`--show-id`
`fp alerts show NAME`	Показать один алерт.	—
`fp alerts create NAME`	Создать алерт.	`--file`; `--description`; `--severity`; `--trigger-kind`; `--trigger-spec`; `--channels`; `--eval-interval-secs`; `--min-breaches`; `--eval-window`
`fp alerts update NAME`	Обновить или переименовать алерт.	параметры create плюс `--name`; `--yes`, `-y`
`fp alerts delete NAME`	Удалить алерт.	`--yes`, `-y`
`fp alerts test NAME`	Отправить тестовое уведомление.	`--channels`; `--yes`, `-y`

Серьезности алертов — info, warning и critical. Виды триггеров — metric_threshold, custom_sql, evaluation_score, eval_compound и per_event. Интервалы оценки должны быть между 30 и 86,400 секундами.

Аудиты

Команда	Назначение	Параметры
`fp audits list`	Вывести аудиты.	`--enabled-only`; `--show-id`
`fp audits show NAME`	Показать одно определение аудита и состояние.	—
`fp audits create NAME`	Создать аудит и немедленно поставить в очередь его первый запуск.	См. параметры создания.
`fp audits edit NAME`	Заменить параметры аудита, сохраняя неуказанные значения.	параметры создания определения; `--name`; `--yes`, `-y`
`fp audits delete NAME`	Удалить аудит, его findings и историю запусков.	`--yes`, `-y`
`fp audits run NAME`	Поставить в очередь ручной запуск.	—
`fp audits runs NAME`	Вывести историю запусков.	`--limit`, `-n`; `--show-id`
`fp audits context-show NAME`	Показать краткую справку и состояние выборки ссылок справочника.	—
`fp audits context-set NAME`	Изменить краткую справку или ссылки справочника.	`--text`; `--text-file`; `--url`; `--clear-urls`
`fp audits context-refresh NAME`	Повторно выбрать ссылки справочника.	—
`fp audits findings`	Вывести findings.	`--audit`; `--run-id`; `--status`; `--limit`, `-n`; `--offset`; `--show-id`
`fp audits finding FINDING_ID`	Показать один finding и его доказательства.	—
`fp audits ack FINDING_ID`	Подтвердить finding.	`--reason`
`fp audits mute FINDING_ID`	Подавить повторяющийся паттерн.	`--reason`; `--yes`, `-y`
`fp audits dismiss FINDING_ID`	Отметить паттерн как не требующий действия и подавить его.	`--reason`; `--yes`, `-y`
`fp audits resolve FINDING_ID`	Отметить finding как исправленный без будущего подавления.	`--yes`, `-y`
`fp audits reopen FINDING_ID`	Вернуть finding в живую очередь и очистить подавление.	—
`fp audits assign FINDING_ID`	Установить владельца finding.	обязательный `--to <email>`

Параметры создания аудита

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

Параметр	Описание
`--file <path>`	Основать определение на JSON или использовать `-` для stdin. Явные флаги переопределяют значения файла.
`--description <text>`	Указать вопрос о сбое или назначение.
`--enabled` / `--disabled`	Начать расписание включенным или выключенным. По умолчанию: включено.
`--schedule-interval-secs <n>`	`3600`–`604800`. По умолчанию: `86400`.
`--schedule-anchor <timestamp>`	Фиксированная фаза UTC в формате ISO 8601. По умолчанию: следующие 09:00 UTC.
`--window-mode since_last\|fixed`	Продолжить после последнего полностью анализируемого окна или повторно проверить скользящее окно. По умолчанию: `since_last`.
`--lookback-window-secs <n>`	`3600`–`7776000`. По умолчанию: `604800`.
`--scope '<json>'`	Фильтровать по `environments`, `agent_ids` или другим поддерживаемым полям области.
`--ignore-error-type <type>`	Исключить типы ошибок; повторяется или разделяется запятыми.
`--llm` / `--no-llm`	Включить или отключить агентский анализ. По умолчанию: включено.
`--top-k <n>`	Сохранить `1`–`500` findings. По умолчанию: `50`.
`--sensitivity low\|medium\|high`	Установить чувствительность отчета. По умолчанию: `medium`.
`--channels '<json>'`	Массив каналов уведомлений.
`--text <brief>`	Встроенная краткая справка, максимум 8,192 символов.
`--text-file <path>`	Прочитать краткую справку из файла; взаимно исключающее с `--text`.
`--url <https-url>`	Добавить общую ссылку справочника HTTPS; повторяется до пяти раз.

Включите контекст при создании, если первый запуск его нуждается. Создание фиксирует определение и контекст вместе перед началом поставленного в очередь запуска.

fp audits run является асинхронным. Опросите fp audits runs NAME до тех пор, пока последний запуск не завершится успешно или не завершится ошибкой, прежде чем читать его findings.

Issues

Команда	Назначение	Параметры
`fp issues list`	Вывести issues.	`--state`; `--alert-id`; `--limit`, `-n`; `--show-id`
`fp issues count`	Подсчитать открытые или выбранные состояния issues.	`--state`
`fp issues show INCIDENT_ID`	Показать детали issue, комментарии, подписчиков и активность.	—
`fp issues open`	Открыть ручной или связанный с алертом issue.	обязательный `--summary`; опциональные `--title`, `--alert-id`, `--severity`
`fp issues ack INCIDENT_ID`	Подтвердить issue.	—
`fp issues assign INCIDENT_ID`	Заменить ответственных; опустить опцию для их очистки.	повторяемый `--assignee`
`fp issues resolve INCIDENT_ID`	Разрешить issue.	`--yes`, `-y`
`fp issues comment-list INCIDENT_ID`	Вывести комментарии.	—
`fp issues comment-add INCIDENT_ID`	Добавить комментарий.	ровно одно из `--body`, `--file`
`fp issues comment-delete INCIDENT_ID COMMENT_ID`	Удалить комментарий.	`--yes`, `-y`
`fp issues subscribers INCIDENT_ID`	Вывести подписчиков.	—
`fp issues subscribe INCIDENT_ID`	Подписать себя или другого оператора.	`--email`
`fp issues unsubscribe INCIDENT_ID`	Удалить подписку.	`--email`

Действительные состояния issues — firing, acknowledged и resolved. Серьезности автономных issues — info, warning и critical.

Облачный помощник

Команда	Назначение	Параметры
`fp agent health`	Проверить доступность помощника и конфигурацию.	—
`fp agent models`	Вывести доступные модели помощника.	—
`fp agent chats`	Вывести сохраненные чаты.	—
`fp agent ask [MESSAGE]`	Начать или продолжить чат; читает stdin, когда сообщение опущено.	`--chat`; `--model`; `--page-context`
`fp agent show CHAT_ID`	Показать сохраненный разговор.	—
`fp agent rename CHAT_ID`	Переименовать разговор.	обязательный `--title`
`fp agent delete CHAT_ID`	Удалить разговор.	`--yes`, `-y`

Политики

Версии политик, управляемые облаком. Только сеанс — каждая команда здесь выходит с кодом 2 под ключом API перед любым запросом, потому что это корневые маршруты записи, намеренно отсутствующие в /v1.

Команда	Назначение	Параметры
`fp policies list`	Вывести версии политик.	`--json`
`fp policies show POLICY_ID`	Показать одну политику с ее исходным кодом.	—
`fp policies publish NAME PATH`	Создать версию из локального `.mjs`.	`--description`; `--no-verify`
`fp policies enable POLICY_ID`	Добавить ее обратно в каждое развертывание, из которого она была удалена, создав новое поколение в каждом.	`--yes`, `-y`
`fp policies disable POLICY_ID`	Удалить из каждого развертывания, которое ее содержит, создав новое поколение в каждом.	`--yes`, `-y`
`fp policies delete POLICY_ID`	Удалить версию политики.	`--yes`, `-y`
`fp policies test PATH`	Запустить политику локально против синтетического контекста. Применяет фильтр `match` каждой политики, поэтому та, которая не охватывает данное событие/инструмент, сообщается как `skipped` вместо запуска.	`--event`; `--tool`; `--command`; `--file`; `--expect`
`fp policies compose PROMPT`	Разработать политику с помощью помощника. Требует `policies:write`.	—

Флот

Какие машины запускают какие политики. Только сеанс, по той же причине, что и выше.

Команда	Назначение	Параметры
`fp fleet list`	Вывести зарегистрированные машины и их поколение развертывания.	—
`fp fleet show MACHINE_ID`	Набор политик, которые машина в настоящее время запускает.	—
`fp fleet deploy MACHINE_ID`	Заменить весь набор политик машины. Выводит план и запрашивает только в интерактивном терминале без `--json`.	`--add`; `--remove`; `--set`; `--create`; `--yes`, `-y`
`fp fleet diff MACHINE_ID`	Сравнить машину с другим развертыванием.	—
`fp fleet history MACHINE_ID`	Прошлые развертывания для машины.	—
`fp fleet rollback MACHINE_ID GENERATION`	Восстановить набор политик прошлого поколения как новое поколение.	`--yes`, `-y`
`fp fleet rename MACHINE_ID`	Дать машине читаемое имя.	обязательный `--name`

Guardrails

Что enforcement фактически сделал. Только сеанс, по той же причине, что и выше.

Команда	Назначение	Параметры
`fp guardrails summary`	Охват, всего заблокированных/оцененных, спарклайн deny и таблица за политику.	`--since` (`1h`, `6h`, `24h`, `7d`); `--machine`
`fp guardrails timeline`	Решения разбросаны по окну, просуммированы на каждый источник политики.	`--since` (`1h`, `6h`, `24h`, `7d`); `--machine`

Глобальные флаги

Флаг	Описание
`--json`	Выпустить машинно-читаемый JSON.
`--base-url <url>`	Использовать самостоятельно размещенный или развивающийся dashboard.
`--org <slug>`	Выбрать организацию для этого вызова.
`--token <token>`	Переопределить сохраненный токен пользовательского сеанса.
`--api-key <key>`	Аутентифицировать автоматизацию с помощью ключа API; никогда не сохраняется.
`--timeout <seconds>`	Timeout HTTP; должен быть положительным. По умолчанию: `30`.
`--quiet`, `-q`	Подавить статус output на stderr.
`--no-color`	Отключить цветной output.
`--insecure` / `--secure`	Отключить или восстановить проверку сертификата TLS.
`--version`	Вывести развернутую версию и выйти.
`--help`, `-h`	Показать справку.

--api-key предназначен для автоматизации. Вход, переключение организации и команды помощника требуют пользовательский сеанс.

Переменные окружения

Переменная	Эквивалент или назначение
`FP_DASHBOARD_URL`	`--base-url`
`FP_ORG`	`--org`
`FP_TOKEN`	`--token`
`FP_API_KEY`	`--api-key`
`FP_JSON`	`--json`
`FP_INSECURE`	`--insecure`
`FP_HOME`	Переместить каталог конфигурации CLI (по умолчанию `~/.failproofai/fpcli`).
`FP_ANALYTICS_DISABLED` или `DO_NOT_TRACK`	Отключить анонимную аналитику CLI.
`NO_COLOR`	Отключить цветной output.

Явные флаги переопределяют переменные окружения, которые переопределяют сохраненную конфигурацию. В режиме ключа API выберите тенант явно с помощью --org или FP_ORG.

Написания AGENTEYE_* этих параметров не читаются fp и никогда не были — CLI объявляет FP_* (fp_cli/app.py), и неизвестная переменная не является ошибкой. Установка AGENTEYE_DASHBOARD_URL не перенаправляет CLI; она игнорируется и команда молча выполняется против сохраненного dashboard вместо этого.AGENTEYE_HOME и AGENTEYE_ENVIRONMENT все еще существуют, но они принадлежат сборщику и телеметрии SDK, а не этому CLI.

Команды, которые удаляют, отзывают, подавляют, разрешают или заменяют конфигурацию, запрашивают по умолчанию. Используйте --yes только после проверки активной организации и цели.

Connect your agents

Reference

Вход в систему

Синтаксис

Команды CLI

Аутентификация

События

Сеансы

Оценки

Ошибки

Использование и значения фильтров

Организации

Ключи API

Запросы

Пользователи

Параметры

Алерты

Аудиты

Параметры создания аудита

Issues

Облачный помощник

Политики

Флот

Guardrails

Глобальные флаги

Переменные окружения

​Вход в систему

​Синтаксис

​Команды CLI

​Аутентификация

​События

​Сеансы

​Оценки

​Ошибки

​Использование и значения фильтров

​Организации

​Ключи API

​Запросы

​Пользователи

​Параметры

​Алерты

​Аудиты

​Параметры создания аудита

​Issues

​Облачный помощник

​Политики

​Флот

​Guardrails

​Глобальные флаги

​Переменные окружения

Вход в систему

Синтаксис

Команды CLI

Аутентификация

События

Сеансы

Оценки

Ошибки

Использование и значения фильтров

Организации

Ключи API

Запросы

Пользователи

Параметры

Алерты

Аудиты

Параметры создания аудита

Issues

Облачный помощник

Политики

Флот

Guardrails

Глобальные флаги

Переменные окружения