Cloud cli

title: “Failproof Cloud CLI” description: “Полный справочник для запросов и управления Failproof AI Cloud с помощью fp.” icon: “cloud-cog”

Используйте fp для проверки телеметрии Cloud и управления аудитами, выводами, проблемами, оповещениями, ключами, пользователями, запросами и параметрами. Используйте failproofai для локальных хуков, политик, захвата и регистрации машин. Установите выпущенный Cloud CLI как изолированный инструмент:

uv tool install fp-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
fp --json events --full --session-id <session-id> --all

Сеансы

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]`	Выполнить сохранённый запрос или ad-hoc 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 и 86400 секундами.

Аудиты

Команда	Назначение	Параметры
`fp audits list`	Список аудитов.	`--enabled-only`; `--show-id`
`fp audits show NAME`	Показать одно определение и состояние аудита.	—
`fp audits create NAME`	Создать аудит и сразу же поставить его первый запуск в очередь.	См. параметры create.
`fp audits edit NAME`	Заменить параметры аудита, сохраняя неуказанные значения.	параметры определения create; `--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>`

Параметры create аудита

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>`	Встроенное краткое описание, максимум 8192 символа.
`--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.

Cloud ассистент

Команда	Назначение	Параметры
`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`

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

Флаг	Описание
`--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 предназначен для автоматизации. Вход, переключение организации и команды ассистента требуют пользовательский сеанс.

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

Переменная	Эквивалент или назначение
`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`	Переместить текущий каталог конфигурации CLI.
`AGENTEYE_ANALYTICS_DISABLED` или `DO_NOT_TRACK`	Отключить анонимную аналитику CLI.
`NO_COLOR`	Отключить цветной вывод.

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

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

Connect your agents

Reference

HTTP API

title: “Failproof Cloud CLI” description: “Полный справочник для запросов и управления Failproof AI Cloud с помощью fp.” icon: “cloud-cog”

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

Синтаксис

Команды CLI

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

События

Сеансы

Оценки

Ошибки

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

Организации

API ключи

Запросы

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

Параметры

Оповещения

Аудиты

Параметры create аудита

Проблемы

Cloud ассистент

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

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

​title: “Failproof Cloud CLI” description: “Полный справочник для запросов и управления Failproof AI Cloud с помощью fp.” icon: “cloud-cog”

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

​Синтаксис

​Команды CLI

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

​События

​Сеансы

​Оценки

​Ошибки

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

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

​API ключи

​Запросы

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

​Параметры

​Оповещения

​Аудиты

​Параметры create аудита

​Проблемы

​Cloud ассистент

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

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

title: “Failproof Cloud CLI” description: “Полный справочник для запросов и управления Failproof AI Cloud с помощью fp.” icon: “cloud-cog”

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

Синтаксис

Команды CLI

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

События

Сеансы

Оценки

Ошибки

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

Организации

API ключи

Запросы

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

Параметры

Оповещения

Аудиты

Параметры create аудита

Проблемы

Cloud ассистент

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

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