> ## 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. # Cloud cli title: "Failproof Cloud CLI" description: "Полный справочник для запросов и управления Failproof AI Cloud с помощью fp." icon: "cloud-cog" ----------------- Используйте `fp` для проверки телеметрии Cloud и управления аудитами, выводами, проблемами, оповещениями, ключами, пользователями, запросами и параметрами. Используйте [`failproofai`](/ru/reference/failproof-cli) для локальных хуков, политик, захвата и регистрации машин. Установите выпущенный Cloud CLI как изолированный инструмент: ```bash theme={null} uv tool install fp-cli fp version ``` ## Вход в систему ```bash theme={null} fp login fp whoami ``` ## Синтаксис ```text theme={null} fp [GLOBAL_OPTIONS] COMMAND [SUBCOMMAND] [ARGUMENTS] [OPTIONS] ``` Глобальные параметры должны предшествовать команде: ```bash theme={null} 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` | Показать справку по командам верхнего уровня. | — | ```bash theme={null} fp login --email you@example.com --org reliability-team fp whoami ``` ### События ```text theme={null} fp events [OPTIONS] ``` Список отдельных событий агента. Лёгкая лента по умолчанию исключает необработанные данные; используйте `--full` только для ограниченного расследования. | Параметр | Описание | | ----------------------------------------- | -------------------------------------------------------------------------- | | `--limit`, `-n ` | Максимальное количество строк. По умолчанию: `50`. | | `--since ` | `all`, `15m`, `1h`, `6h`, `24h` или `7d`. | | `--from ` / `--to ` | Диапазон ISO 8601 UTC; переопределяет `--since`. | | `--env ` | Фильтр окружения; повторяйте или разделяйте запятыми значения. | | `--event-type ` | Фильтр типа события; повторяйте или разделяйте запятыми значения. | | `--agent-id ` | Фильтр агента; повторяйте или разделяйте запятыми значения. | | `--session-id ` | Фильтр сеанса; повторяйте или разделяйте запятыми значения. | | `--search ` | Поиск текста данных; повторяемый, совпадает любой термин. | | `--order asc\|desc` | Временной порядок. По умолчанию: новейшие первыми. | | `--all` | Автоматическая пагинация до `--limit`. | | `--cursor ` | Возобновить с непрозрачного курсора. | | `--page-size ` | Строк за запрос с `--all`; максимум `200`. | | `--full` | Включить необработанные данные через более тяжёлую конечную точку событий. | | `--fields ` | Возвращать только выбранные поля; запрос `payload` включает полный режим. | ```bash theme={null} fp events --session-id --order asc --all fp --json events --full --session-id --all ``` ### Сеансы ```text theme={null} fp sessions [OPTIONS] ``` | Параметр | Описание | | ----------------------------------------- | --------------------------------------------------------------------------- | | `--limit`, `-n ` | Максимальное количество строк. По умолчанию: `50`. | | `--since ` | `all`, `15m`, `1h`, `6h`, `24h` или `7d`. | | `--from ` / `--to ` | Диапазон ISO 8601 UTC; переопределяет `--since`. | | `--env ` | Фильтр окружения; повторяйте или разделяйте запятыми значения. | | `--status ` | `done`, `error` или `timeout`; повторяйте или разделяйте запятыми значения. | | `--agent-id ` | Сопоставление сеансов, включающих любого выбранного агента. | | `--session-id ` | Фильтр сеанса; повторяйте или разделяйте запятыми значения. | | `--all` | Автоматическая пагинация до `--limit`. | | `--cursor ` | Возобновить с непрозрачного курсора. | | `--page-size ` | Строк за запрос с `--all`; максимум `200`. | | `--fields ` | Возвращать только выбранные поля. | | `--full-ids` | Не сокращать идентификаторы сеансов в выводе терминала. | | `--agents` | Развернуть состав агентов для сеансов с несколькими агентами. | ### Оценки ```text theme={null} fp evals [OPTIONS] ``` | Параметр | Описание | | ------------------------------------------------- | --------------------------------------------------------------- | | `--aggregate` | Показать итоги и статистику по оценкам вместо отдельных оценок. | | `--limit`, `-n ` | Максимальное количество строк списка. По умолчанию: `50`. | | `--since`, `--from`, `--to` | Выберите диапазон времени. | | `--env`, `--status`, `--agent-id`, `--session-id` | Сузить до одного точного значения за фильтр. | | `--score KEY:MIN..MAX` | Диапазон оценок; повторяемый, все диапазоны должны совпадать. | | `--all`, `--cursor`, `--page-size` | Управление пагинацией списка. | | `--fields ` | Возвращать только выбранные поля. | | `--full-ids` | Показать полные идентификаторы сеансов. | | `--scores-full` | Показать все оценки в выводе терминала. | ### Ошибки ```text theme={null} fp errors [OPTIONS] ``` | Параметр | Описание | | --------------------------------------------------------------------- | --------------------------------------------------------- | | `--aggregate` | Суммировать совпадающие ошибки вместо списка строк. | | `--limit`, `-n ` | Максимальное количество строк списка. По умолчанию: `50`. | | `--since`, `--from`, `--to` | Выберите диапазон времени. | | `--env`, `--error-type`, `--event-type`, `--agent-id`, `--session-id` | Сузить совокупность ошибок. | | `--search ` | Поиск текста данных; повторяемый. | | `--order asc\|desc` | Временной порядок. | | `--all`, `--cursor`, `--page-size` | Управление пагинацией списка. | | `--fields ` | Возвращать только выбранные поля. | | `--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 ` | | `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 ` | | `fp query show NAME` | Показать один запрос. | — | | `fp query create NAME` | Сохранить запрос. | `--sql `; `--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](#audit-create-options). | | `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 ` | #### Параметры create аудита ```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 ``` | Параметр | Описание | | --------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | | `--file ` | Основать определение на JSON или использовать `-` для stdin. Явные флаги переопределяют значения файла. | | `--description ` | Укажите вопрос отказа или цель. | | `--enabled` / `--disabled` | Начать расписание включённым или выключённым. По умолчанию: включено. | | `--schedule-interval-secs ` | `3600`–`604800`. По умолчанию: `86400`. | | `--schedule-anchor ` | Фиксированная фаза UTC в формате ISO 8601. По умолчанию: следующий 09:00 UTC. | | `--window-mode since_last\|fixed` | Продолжить после последнего полностью проанализированного окна или повторно проверить скользящее окно. По умолчанию: `since_last`. | | `--lookback-window-secs ` | `3600`–`7776000`. По умолчанию: `604800`. | | `--scope ''` | Фильтр по `environments`, `agent_ids` или другим поддерживаемым полям области. | | `--ignore-error-type ` | Исключить типы ошибок; повторяйте или разделяйте запятыми. | | `--llm` / `--no-llm` | Включить или отключить анализ агентом. По умолчанию: включено. | | `--top-k ` | Сохранить `1`–`500` выводов. По умолчанию: `50`. | | `--sensitivity low\|medium\|high` | Установить чувствительность отчётов. По умолчанию: `medium`. | | `--channels ''` | Массив канала уведомлений. | | `--text ` | Встроенное краткое описание, максимум 8192 символа. | | `--text-file ` | Прочитать краткое описание из файла; взаимно исключающий с `--text`. | | `--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 ` | Использовать самостоятельно размещённую или развивающую панель управления. | | `--org ` | Выбрать организацию для этого вызова. | | `--token ` | Переопределить сохранённый токен пользовательского сеанса. | | `--api-key ` | Аутентифицировать автоматизацию с помощью ключа API; никогда не сохраняется. | | `--timeout ` | Тайм-аут 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` только после проверки активной организации и цели.