Failproof Cloud CLI

Используйте fp для проверки телеметрии Cloud, управления облачным вынужденным применением (политиками, развёртываниями флота, решениями guardrail) и управления аудитами, выводами, проблемами, оповещениями, ключами, пользователями, запросами и параметрами. Используйте failproofai для локальных перехватчиков, политик, захвата и регистрации машин. Установите выпущенный 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`	Не сокращайте идентификаторы сеансов в выводе терминала.
`--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`	Показать полные идентификаторы сеансов.
`--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`	Показать полные идентификаторы сеансов.

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

Команда	Назначение
`fp usage`	Показать использование для текущего окна учёта.
`fp list envs`	Список наблюдаемых окружений.
`fp list agents`	Список наблюдаемых идентификаторов агентов.
`fp list event_types`	Список типов событий.
`fp list score_filters`	Список ключей баллов оценки.
`fp list models`	Список названий моделей.
`fp list 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`	Обновить или переименовать оповещение.	параметры создания плюс `--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`	Удалить аудит, его выводы и историю запусков.	`--yes`, `-y`
`fp audits run NAME`	Поставить в очередь ручной запуск.	—
`fp audits runs NAME`	Список истории запусков.	`--limit`, `-n`; `--show-id`
`fp audits context-show NAME`	Показать состояние краткого описания и получения справочного URL.	—
`fp audits context-set NAME`	Изменить краткое описание или справочные URL.	`--text`; `--text-file`; `--url`; `--clear-urls`
`fp audits context-refresh NAME`	Повторно получить справочные URL.	—
`fp audits findings`	Список выводов.	`--audit`; `--run-id`; `--status`; `--limit`, `-n`; `--offset`; `--show-id`
`fp audits finding FINDING_ID`	Показать один вывод и его доказательства.	—
`fp audits ack FINDING_ID`	Подтвердить вывод.	`--reason`
`fp audits mute FINDING_ID`	Подавить повторяющийся паттерн.	`--reason`; `--yes`, `-y`
`fp audits dismiss FINDING_ID`	Отметить паттерн как неприменимый и подавить его.	`--reason`; `--yes`, `-y`
`fp audits resolve FINDING_ID`	Отметить вывод как исправленный без будущего подавления.	`--yes`, `-y`
`fp audits reopen FINDING_ID`	Вернуть вывод в живую очередь и очистить подавление.	—
`fp audits assign FINDING_ID`	Установить владельца вывода.	требуемый `--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` выводов. По умолчанию: `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 до тех пор, пока последний запуск не завершится успешно или не потерпит неудачу, прежде чем читать его выводы.

Проблемы

Команда	Назначение	Параметры
`fp issues list`	Список проблем.	`--state`; `--alert-id`; `--limit`, `-n`; `--show-id`
`fp issues count`	Подсчёт открытых или выбранных состояний проблемы.	`--state`
`fp issues show INCIDENT_ID`	Показать детали проблемы, комментарии, подписчиков и активность.	—
`fp issues open`	Открыть ручную или связанную с оповещением проблему.	требуемый `--summary`; опциональный `--title`, `--alert-id`, `--severity`
`fp issues ack INCIDENT_ID`	Подтвердить проблему.	—
`fp issues assign INCIDENT_ID`	Заменить ответственных; пропустите параметр, чтобы очистить их.	повторяемый `--assignee`
`fp issues resolve INCIDENT_ID`	Разрешить проблему.	`--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`

Допустимые состояния проблемы — firing, acknowledged и resolved. Серьёзность автономной проблемы — 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-path`; `--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`	Восстановить предыдущее развёртывание.	`--yes`, `-y`
`fp fleet rename MACHINE_ID`	Присвоить машине читаемое имя.	требуемый `--name`

Guardrails

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

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

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

Флаг	Описание
`--json`	Выдать машиночитаемый JSON.
`--base-url <url>`	Используйте самостоятельно размещённую или облачную приборную панель разработки.
`--org <slug>`	Выбрать организацию для этого вызова.
`--token <token>`	Переопределить сохранённый токен сеанса пользователя.
`--api-key <key>`	Аутентифицировать автоматизацию с помощью ключа API; никогда не сохраняется.
`--timeout <seconds>`	Тайм-аут HTTP; должен быть положительным. По умолчанию: `30`.
`--quiet`, `-q`	Подавить вывод статуса на stderr.
`--no-color`	Отключить цветной вывод.
`--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`	Отключить цветной вывод.

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

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

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

Connect your agents

Reference

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

Синтаксис

Команды CLI

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

События

Сеансы

Оценки

Ошибки

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

Организации

Ключи API

Запросы

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

Параметры

Оповещения

Аудиты

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

Проблемы

Облачный ассистент

Политики

Флот

Guardrails

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

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

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

​Синтаксис

​Команды CLI

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

​События

​Сеансы

​Оценки

​Ошибки

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

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

​Ключи API

​Запросы

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

​Параметры

​Оповещения

​Аудиты

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

​Проблемы

​Облачный ассистент

​Политики

​Флот

​Guardrails

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

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

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

Синтаксис

Команды CLI

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

События

Сеансы

Оценки

Ошибки

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

Организации

Ключи API

Запросы

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

Параметры

Оповещения

Аудиты

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

Проблемы

Облачный ассистент

Политики

Флот

Guardrails

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

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