fp を使用して、Cloudのテレメトリの検査、クラウド管理の適用（ポリシー、フリートデプロイメント、ガードレール決定）の管理、および監査、所見、課題、アラート、キー、ユーザー、クエリ、設定の管理を行います。ローカルフック、ポリシー、キャプチャ、マシン登録には 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 | 現在のID、認証モード、組織、および権限を表示します。 | — |
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 | フィルターごとに1つの正確な値に絞り込みます。 |
--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 | フック名を一覧表示します。 |
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 | 1つのキーとそのグラントを表示します。 | — |
fp keys create NAME | キーを作成し、シークレットを1回だけ表示します。 | --permission-set; --add; --remove |
fp keys update NAME | 権限セットを置き換えるか、グラントを調整します。 | --permission-set; --add; --remove; --yes, -y |
fp keys regenerate NAME | シークレットをローテーションし、置き換えを1回だけ表示します。 | --yes, -y |
fp keys disable NAME | キーを恒久的に無効化します。 | --yes, -y |
events:add のように resource:action の形式を使用します。--add を繰り返すか、トークンをカンマ区切りにするか、events:read.add のようなドット記法のアクションを使用してください。
クエリ
| コマンド | 目的 | オプション |
|---|---|---|
fp query list | 保存済みクエリを一覧表示します。 | --show-id; --fields <csv> |
fp query show NAME | 1つのクエリを表示します。 | — |
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] | クエリ可能なテーブルを一覧表示するか、1つのテーブルを検査します。 | — |
ユーザー
| コマンド | 目的 | オプション |
|---|---|---|
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 のいずれか1つ（必須）。オプションで --yes, -y。 |
アラート
| コマンド | 目的 | オプション |
|---|---|---|
fp alerts list | アラートルールを一覧表示します。 | --show-id |
fp alerts show NAME | 1つのアラートを表示します。 | — |
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 | 1つの監査定義と状態を表示します。 | — |
fp audits create NAME | 監査を作成し、最初の実行を即座にキューに入れます。 | 作成オプションを参照。 |
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 | 1つの所見とその証拠を表示します。 | — |
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> | ISO 8601形式の固定UTCフェーズ。デフォルト：次の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リファレンスを追加します。最大5回繰り返し可能。 |
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 のいずれか1つ（必須） |
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 |
ポリシー
クラウド管理のポリシーバージョン。セッション限定 — APIキーを使用した場合、リクエストの前にすべてのコマンドが終了コード2 で終了します。これらは /v1 に意図的に存在しないルート限定の書き込みルートだからです。
| コマンド | 目的 | オプション |
|---|---|---|
fp policies list | ポリシーバージョンを一覧表示します。 | --json |
fp policies show POLICY_ID | ソースを含む1つのポリシーを表示します。 | — |
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 |
ガードレール
実際に適用が行ったこと。上記と同じ理由でセッション限定。| コマンド | 目的 | オプション |
|---|---|---|
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 | 色付き出力を無効にします。 |
--org または FP_ORG でテナントを明示的に選択してください。
これらの変数の
AGENTEYE_* 形式は fp では読み込まれず、これまでも読み込まれたことはありません。CLIは FP_* を宣言しており（fp_cli/app.py）、未知の変数はエラーになりません。AGENTEYE_DASHBOARD_URL を設定してもCLIの向き先は変わりません。無視され、コマンドは保存済みダッシュボードに対してサイレントに実行されます。AGENTEYE_HOME と AGENTEYE_ENVIRONMENT は引き続き存在しますが、これらはコレクターとテレメトリSDKに属するものであり、このCLIには属しません。削除、無効化、抑制、解決、または設定の置き換えを行うコマンドは、デフォルトで確認プロンプトが表示されます。アクティブな組織とターゲットを確認した後にのみ
--yes を使用してください。