failproofai 1.0.1-beta.0 → 1.0.1

package/.next/standalone/docs-old/ja/agenteye/cli.mdx

@@ -0,0 +1,350 @@
+---
+title: "CLI"
+description: "ターミナルまたはスクリプトから Failproof AI Observability の全機能を操作できます。ダッシュボードへのアクセスは不要です。"
+---
+
+
+ターミナルまたはスクリプトから Failproof AI Observability の全機能を操作できます。ダッシュボードへのアクセスは不要です。`agenteye` CLI はデータ（セッション、イベントログ、評価）の照会と、組織管理（API キー、ユーザー、設定、アラート、インシデント、保存済みクエリ）を行います。チェックの自動化、Observability を CI に組み込む場合、またはコーディングエージェントが本番環境を検査する場合に役立ちます。すべてのコマンドは `--json` フラグに対応しているため、プロンプトでの手動操作でも、コーディングエージェント（Claude Code、Cursor）がシェルから呼び出して結果をパースする場合でも、同様に利用できます。
+
+1 つのバイナリで以下が可能です:
+
+- **データの読み取り**: `sessions`、`events`、`evals`、`errors`（時間・エージェント・環境・スコアでフィルタリング）。
+- **組織の管理**: `keys`、`users`、`settings`、`alerts`、`incidents`。
+- **アナリティクスの実行**: 保存済み SQL とアドホッククエリランナー（`query`）。
+- **AI アシスタントへの問い合わせ**: ダッシュボードでチャットできる読み取り専用アナリストと同一（`agent`）。
+
+> **注意:** これは `agenteye` CLI です。コレクターデーモン（`agenteye-collector`）とは異なるツールです。CLI はダッシュボードと通信し、コレクターはイベントをサーバーに送信します。
+
+---
+
+## クイックスタート
+
+何もない状態から最初の結果を得るまで 4 行で完了します。CLI をダッシュボードに向け、サインインし、ユーザー確認を行い、直近 1 日の実行履歴を取得します:
+
+```bash
+pipx install agenteye
+agenteye --base-url https://agenteye.example.com login --email you@example.com   # 6桁のコードがメールで届きます
+agenteye whoami                                                                  # ユーザーとアクティブな組織を確認
+agenteye --json sessions --since 24h                                             # エージェント実行1件につき1行、直近24時間分
+```
+
+最後のコマンドは、直近のセッションの JSON オブジェクトを出力します（最新順、デフォルトで最大 50 件）。`jq` にパイプして絞り込むか、`--json` を省略するとボックス型のカラー表示テーブルが表示されます。各行には実行のステータスと、評価器によるスコアリングが行われている場合はメトリクススコアが含まれます（以下は省略形）:
+
+```json
+{
+  "sessions": [
+    {
+      "session_id": "run-8f2a",
+      "agent_id": "checkout-bot",
+      "environment": "prod",
+      "status": "error",
+      "scores": { "helpfulness": 0.42, "tool_efficiency": 0.55 },
+      "event_count": 37,
+      "started_at": "2026-07-16T09:14:02Z",
+      "last_event_at": "2026-07-16T09:14:48Z"
+    }
+  ],
+  "next_cursor": null
+}
+```
+
+このページの残りでは各要素について説明します: [インストール](#installation)、[サインイン](#authentication)、[設定](#configuration)、すべてのコマンドに共通する[グローバル規約](#global-options--conventions)、[完全なコマンドリファレンス](#command-reference)。
+
+---
+
+## インストール
+
+CLI は **`agenteye`** という名前の公開 PyPI パッケージです。依存関係を独立して管理できるよう、隔離された環境にインストールしてください:
+
+```bash
+pipx install agenteye
+# または
+uv tool install agenteye
+```
+
+Python 3.10 以上が必要です。インストールされるコマンド名は **`agenteye`** です:
+
+```bash
+agenteye --version
+agenteye --help
+```
+
+> **注意:** Failproof AI Observability の Python SDK も `agenteye` という配布名を使用しています。`pipx` または `uv tool` でインストール（共有 virtualenv への `pip install` ではなく）することで、両者の競合を避けられます。SDK が同一環境にインストールされていない場合に限り、`pip install agenteye` のみでも問題ありません。
+
+---
+
+## 認証
+
+CLI はメールで送信されるワンタイムコードを使って**ダッシュボード**に認証します:
+
+```bash
+agenteye login --email you@example.com
+# 6桁のコードがメールで届くので、プロンプトに貼り付けてください。
+```
+
+セッショントークンは `~/.agenteye/cli.json`（あなただけが読み取り可能、モード `0600`）に保存され、デフォルトで 24 時間有効です。期限切れになった場合は `agenteye login` を再度実行してください。
+
+```bash
+agenteye whoami     # 現在のユーザー、アクティブな組織、権限を表示
+agenteye logout     # セッションを無効化し、保存済みトークンを削除
+```
+
+`whoami` はセッションが存在しない場合や期限切れでもエラーになりません。代わりに `logged_in: false` を返すため、スクリプトやエージェントが安全に認証状態を確認できます（ベース URL が設定されていない場合やダッシュボードに到達できない場合は非ゼロで終了することがあります）。
+
+**要件:** ダッシュボードへのサインインが許可されたメールアドレスであること（Failproof AI Observability 管理者に確認してください）、およびダッシュボードがベース URL で到達可能であること（[設定](#configuration)を参照）。コードをリクエストしても届かない場合、そのメールアドレスはまだダッシュボードアクセスが有効になっていない可能性があります。
+
+---
+
+## 組織の選択（マルチテナント）
+
+アカウントが複数の組織に属している場合、**ログイン時**にアクティブな組織を選択してください。選択内容は保存され、以降のすべてのコマンドで使用されます:
+
+```bash
+agenteye login --org acme           # 認証とアクティブテナントの設定を一度に行う
+agenteye orgs list                  # アクセス可能な組織の一覧（アクティブな組織にマーク付き）
+agenteye orgs switch globex         # 保存済みデフォルトを変更
+agenteye --org globex sessions      # 単一コマンドでのみ上書き
+```
+
+組織が 1 つだけの場合は自動的に選択されるため、`--org` は不要です。複数の組織に属していてどれも選択していない場合、CLI が一覧を表示して `--org <slug>` を付けて再実行するよう促します。アクティブな組織はすべてのリクエストでダッシュボードに送信され、権限は**組織ごと**に解決されます。`agenteye whoami` はアクティブな組織、その組織内での権限、およびすべてのメンバーシップを表示します。
+
+---
+
+## 設定
+
+| 設定 | フラグ | 環境変数 | デフォルト |
+|---|---|---|---|
+| ダッシュボードベース URL | `--base-url` | `AGENTEYE_DASHBOARD_URL` | **必須**（デフォルトなし） |
+| アクティブな組織/テナント | `--org` | `AGENTEYE_ORG` | ログイン時に選択し `~/.agenteye/cli.json` に保存 |
+| セッショントークン | `--token` | `AGENTEYE_CLI_TOKEN` | `~/.agenteye/cli.json` から取得 |
+| JSON 出力 | `--json` | `AGENTEYE_CLI_JSON` | オフ |
+| TLS 検証をスキップ | `--insecure` / `--secure` | `AGENTEYE_INSECURE` | オフ（ログイン時に保存） |
+| リクエストタイムアウト（秒） | `--timeout` | _（なし）_ | 30 |
+| 利用状況テレメトリの無効化 | _（なし）_ | `AGENTEYE_ANALYTICS_DISABLED`（または `DO_NOT_TRACK`） | テレメトリは現在無効です。送信は行われません |
+
+解決順序は**フラグ → 環境変数 → 設定ファイル**です。デフォルト値はありません。コマンドごとに（`--base-url https://agenteye.example.com`）または環境変数で一度設定する必要があります（初回 `login` 後にも保存されます）:
+
+```bash
+export AGENTEYE_DASHBOARD_URL=https://agenteye.example.com
+```
+
+設定ディレクトリは `AGENTEYE_HOME` を優先します（SDK とコレクターで使われているのと同じ規約）。設定されている場合、`cli.json` は `$AGENTEYE_HOME/cli.json` に置かれます。
+
+### 自己署名または内部 TLS
+
+ダッシュボードが自己署名または内部証明書を使用した HTTPS で提供されている場合（例: 生のロードバランサーホスト名）、TLS 検証が `CERTIFICATE_VERIFY_FAILED` エラーで失敗します。証明書検証をスキップするには `--insecure` を指定してください:
+
+```bash
+agenteye --base-url https://agenteye.internal --insecure login
+```
+
+`--insecure` は**ログイン時に `cli.json` に保存される**ため、以降のコマンドは自動的に検証をスキップします。フラグを繰り返す必要はありません。一時的に検証を有効にしたい場合は `--secure` を使用します。次回ログイン時に検証を再び有効にしておくこともできます。検証を無効にしているコマンドでは、CLI が stderr に警告を表示します。検証をスキップすると中間者攻撃からの保護がなくなります。これに依存する前に、ダッシュボードへのネットワークパス（VPN、プライベートサブネットなど）を信頼できることを確認してください。
+
+---
+
+## テレメトリとプライバシー
+
+> **注意:** 現在の CLI は**利用状況テレメトリを一切送信しません。** マスターキルスイッチがオンになっているため、環境にかかわらず何も送信されません。以下のセクションでは、テレメトリが将来有効化された場合のオプトアウト機能について説明します。
+
+有効化された場合でも、テレメトリは**匿名の利用状況アナリティクスのみ**であり、エージェント・セッション・イベントデータは含まれません:
+
+- **エージェント・セッション・イベントデータがインフラ外に出ることは一切ありません。** 報告されるのは CLI の利用状況のみです: コマンドとサブコマンド名（例: `keys create`）、使用したフラグの**名前**（値は含まない）、成功/終了ステータス、実行時間、および変更操作ごとのイベント（例: `api_key_created`、`query_run`）で静的な名前/列挙値と大まかなカウントのみが含まれます。ダッシュボード URL、セッショントークン、メール、組織スラッグ、リソース ID、SQL、キーシークレット、クエリフィルターは**送信されません**。オペレーターは不透明な内部 ID によってのみ識別され、メールアドレスは使用されません。
+- CLI の環境で `AGENTEYE_ANALYTICS_DISABLED=1` を設定することで**事前にオプトアウト**できます（CLI はクロスツール規約 `DO_NOT_TRACK=1` にも対応しています）。この設定はテレメトリが有効化された瞬間から効果を発揮するため、プライバシーを重視する環境では永続的にオプトアウト状態を維持できます。
+- テレメトリが有効化された場合、CLI は PostHog（`https://us.i.posthog.com`）に直接送信します。そのホストをブロックしているマシンでは何も送信されず、CLI の動作にも影響はありません。
+
+---
+
+## グローバルオプションと規約
+
+一度読んでおいてください。すべてのコマンドに適用されます。
+
+- **グローバルオプションはコマンドの前に置きます。** `agenteye --json sessions` が正しい形式です。`agenteye sessions --json` は使用エラーになります。グローバルオプションは `--json`、`--base-url`、`--org`、`--token`、`--insecure`/`--secure`、`--timeout`、`--quiet`、`--no-color` です。
+- **`--json` は純粋な JSON のみを stdout に出力します。** ヒューマン向けのステータス行、警告、エラーは **stderr** に出力されるため、`--json` の stdout キャプチャはステータス行が表示される場合でも `jq` へのパイプに適したクリーンな状態を保ちます。`--json` なしではボックス型のカラー表示が人間向けに表示されます。
+- **`--help` で詳細を確認できます。** すべてのコマンドとサブコマンドに `--help`（および `-h` エイリアス）があります: `agenteye -h`、`agenteye sessions -h`、`agenteye keys create -h`。トップレベルのヘルプには終了コードとグローバルオプションの一覧も含まれます。グローバルなマシンリーダブルなサーフェスダンプはありません。コマンドごとの `--help` と、2 つのレジストリ専用の `agenteye query schema`・`agenteye settings schema` を使用してください。
+- **スクリプトとエージェントでは確認プロンプトが自動スキップされます。** 作成・更新・削除コマンドはインタラクティブなターミナルでは「本当によいですか?」と確認を求めますが、**`--json` 使用時または stdin が TTY でない場合は自動スキップされます**（TTY はインタラクティブなターミナルセッションです。パイプや CI ランナーは TTY ではありません）。スクリプトやエージェントがハングすることはありません。明示的にスキップするには `--yes`/`-y` を使用します。エージェントに対してプロンプトが表示されないため、エージェントは破壊的な操作を行う前に人間に確認を求めるべきです。
+- **ページネーション:** 結果は最新順でカーソルページネーションされます（各ページには次のページを取得するためのトークンが返されます）。`--limit N`（エイリアス `-n`）は行数を制限し、**デフォルトは 50** です。`--all` は自動ページネーション（200 行ずつ）を行いますが、**`--limit` まで**しか取得しません。そのため `--all` だけでも 50 件で停止します。完全なスキャンには大きな明示的な上限を指定してください: `--all --limit 1000`。`--page-size N` はリクエストあたりのチャンクサイズを制御します（最大 200）。`--cursor <id>` は前のページの `next_cursor` からの再開に使用します。
+- **時間フィルター:** `--since` は相対的なウィンドウを取ります: `15m`、`1h`、`6h`、`24h`、`7d`、または `all`（ダッシュボードのプリセット）。より長いまたはカスタムの範囲（例: 直近 30 日間）には `--from`/`--to` を使用します: **`T` とタイムゾーンを含む** ISO-8601 UTC タイムスタンプ（例: `2026-06-01T00:00:00Z`）で `--since` を上書きします。スペース区切りまたはタイムゾーンなしの値は使用エラーになります。
+- **`--fields a,b,c`**（`events`、`sessions`、`evals`、`errors` で使用可）は、テーブルと `--json` の両方で出力をそれらのキーに制限します。不明な名前は有効な一覧とともに拒否されるため、フィールド名を簡単に調べられます。
+- **`--file payload.json`**（または `--file -` で stdin を読み込む）は、リソースが複雑な形状を持つ場合に完全な JSON リクエストボディを提供します（`alerts create/update`、`settings set`、`users create/update`）。保存済みクエリの SQL には代わりに `--sql @file.sql` を使用します。
+- **複数値フィルター**はカンマ区切りでセットとしてマッチします（1 つのフィルター内では OR、フィルター間では AND）: `--event-type tool_use,tool_result`。Click のオプションは可変長ではないため、`--add a b` は機能しません。`--add a,b`、フラグの繰り返し（`--add a --add b`）、またはクォート（`--add "a b"`）を使用してください。
+
+---
+
+## コマンドリファレンス
+
+### 最もよく使う 5 つのコマンド
+
+日常的な作業のほとんどは、少数の読み取りコマンドで完結します。まずここから始め、必要に応じて以下の全機能を参照してください:
+
+| コマンド | 機能 | 試してみる |
+|---|---|---|
+| `sessions` | エージェント実行 1 件につき 1 行: 時刻、環境、エージェント、ステータス、最新スコア。 | `agenteye --json sessions --since 24h --status error` |
+| `events` | 実行内のステップごとの生のトレイル（`--full` でペイロード付き）。 | `agenteye --json events --session-id run-001 --all` |
+| `evals` | 評価結果とスコア。`--aggregate` でロールアップ。 | `agenteye --json evals --aggregate --since 7d --env prod` |
+| `errors` | エラーになったイベントのみ。`--aggregate` でタイプ別のカウント。 | `agenteye --json errors --since 24h --aggregate` |
+| `list` | 有効なフィルター値を確認（エージェント、環境、モデルなど）。 | `agenteye list agents` |
+
+### CLI でできるすべてのこと
+
+以下に全機能を示します。CLI には **18 のトップレベルコマンド**があります。すべての読み取りコマンドは `--json` と上記のグローバルオプションに対応しています。各コマンドの詳細なフラグ一覧と JSON の形式は `agenteye <command> -h`（または `<command> <subcommand> -h`）で確認できます。
+
+### ID 管理: `login` · `logout` · `whoami` · `orgs` · `version` · `help`
+
+```bash
+agenteye login --email you@example.com [--org acme]   # メールによるワンタイムコード; セッションを保存
+agenteye logout                                       # このマシンの保存済みセッションを削除
+agenteye whoami                                       # 現在のユーザー、アクティブな組織、権限
+agenteye version                                      # CLI バージョンを表示（--version と同じ）
+agenteye help                                         # トップレベルのヘルプ（--help と同じ）
+```
+
+`orgs` はアクティブなテナントを確認・切り替えます:
+
+```bash
+agenteye orgs list        # 所属組織と各組織でのロール（アクティブな組織にマーク付き）
+agenteye orgs switch acme # 保存済みアクティブ組織を変更（スラッグ省略時は TTY 上で一覧から選択）
+agenteye orgs current     # アクティブな組織の ID カード
+agenteye orgs perms       # アクティブな組織でのリソース別権限
+```
+
+### 観察（読み取り専用）: `events` · `sessions` · `evals` · `errors` · `list`
+
+これらのコマンドは確認を必要としません。共通フィルター: `--session-id`、`--agent-id`、`--env`（`--environment` では**ない**）、時間範囲（`--since` / `--from` / `--to`）。
+
+```bash
+# events（エイリアス: ステップごとの生のトレイル）、最新順
+agenteye --json events --session-id run-001 --event-type tool_use,tool_result --all --limit 1000
+agenteye --json events --since 1h --search timeout --all | jq '.events[].payload'
+
+# sessions: エージェント実行 1 件につき 1 行（時刻/環境/エージェント/セッション/ステータス; スコアフィルタリングなし）
+agenteye --json sessions --since 24h --status error
+agenteye --json sessions --agent-id checkout-bot --env prod --all --limit 1000
+
+# evals: 評価結果とスコア; --score はメトリクスでフィルタリング、--aggregate はロールアップ
+agenteye --json evals --score helpfulness:0.5..0.8 --score tool_efficiency:..0.3
+agenteye --json evals --aggregate --since 7d --env prod        # ステータスの内訳 + キー別スコア統計
+
+# errors: エラーになったイベント; --aggregate でカウント/セッション/エージェント/最終確認時刻
+agenteye --json errors --since 24h --aggregate
+agenteye --json errors --since 24h --error-type timeout --all --limit 1000
+
+# list: フィルタリング前に有効なフィルター値を確認
+agenteye list envs        # 他にも: agents event_types score_filters models hooks tools error_types
+```
+
+`--score KEY:MIN..MAX`（**`evals`** で使用、`sessions` ではない）は繰り返し可能で AND 結合されます。どちらの境界値も省略可能（`..0.5` は ≤ 0.5、`0.9..` は ≥ 0.9）。リクエストあたり最大 20 個のスコアフィルター。`evals --scores-full` は**人間用テーブルのみ**の表示フラグです。`+N` カウントと最初の数件の代わりに、すべてのスコアペアを表示します。`--json` では常に完全なスコアオブジェクトが返されるため、このフラグは効果がありません。**セッション全体を端から端まで読む**には、イベントトレイルと評価を組み合わせます:
+
+```bash
+agenteye --json events --session-id run-001 --all --limit 1000 | jq '.events[] | {ts, event_type}'
+agenteye --json evals  --session-id run-001                       # スコアとステータス
+```
+
+### 管理（権限が必要）: `keys` · `users` · `settings` · `alerts` · `incidents`
+
+**`keys`**: API キー。シークレットはローカルで生成され、サーバーに送信されます（サーバーはハッシュのみ保存します）。シークレットは作成/再生成時に**一度だけ**表示されます。その場で控えてください。`--json` では `key` フィールドにのみ表示されます。**名前**で参照します。
+
+```bash
+agenteye keys list                                   # アクティブなキーを先に、次に無効化済みを表示
+agenteye keys show ci-bot
+agenteye keys create ci-bot --add events:read.add    # 必要なスコープのみ指定; シークレットは1回だけ表示
+agenteye keys create ops --permission-set standard --remove queries:run   # プリセットをベースにして調整
+agenteye keys update ci-bot --add evaluations:read --yes
+agenteye keys regenerate ci-bot --yes                # シークレットをローテーション（古いものは無効になります）
+agenteye keys disable ci-bot --yes                   # 無効化
+```
+
+権限は `(permission-set ∪ --add) − --remove` として機能します。トークンは `slug:action`（例: `events:read`）または `slug:action.action`（1 つのリソースで複数のアクションを展開: `events:read.add` → `events:read`、`events:add`）です。プリセット: `read-only`、`standard`、`admin`。人間専用の権限（`keys:update`）はキーに付与できません。
+
+**`users`**: 組織メンバー。**メールアドレス**で参照します（UUID の id も使用可能）。
+
+```bash
+agenteye users list [--active-only]
+agenteye users show dev@corp.com
+agenteye users create dev@corp.com --permission-set standard
+agenteye users update dev@corp.com --add alerts:write --remove queries:delete   # 変更内容を確認して実行
+agenteye users disable dev@corp.com --yes            # 保護/セルフガード付き
+agenteye users enable dev@corp.com
+```
+
+**`settings`**: 固定レジストリ（既存のキーを読み取り・変更できます。新しいキーは作成できません）。
+
+```bash
+agenteye settings list                               # キー・値・型・更新日時（シークレットはマスク表示）
+agenteye settings schema                             # 各キーが受け付ける値（型・範囲・説明）
+agenteye settings set session_ttl_secs --value 86400 --yes
+```
+
+**`alerts`**: アラート定義。**名前**で参照します。`create` は位置引数の NAME に加え、フラグまたは `--file` による完全な JSON ボディを受け付けます。
+
+```bash
+agenteye alerts list
+agenteye alerts show high-errors
+agenteye alerts create high-errors --file alert.json          # NAME は必須（位置引数）
+agenteye alerts update high-errors --severity critical --yes
+agenteye alerts test high-errors --yes                        # テスト通知を送信
+agenteye alerts delete high-errors --yes
+```
+
+**`incidents`**: アラートインシデント。ID で参照します（短縮 ID も使用可能）。`show` で完全なアクティビティログを表示します。操作前に確認してください。
+
+```bash
+agenteye incidents list --state firing                # 他にも: acknowledged, resolved
+agenteye incidents count
+agenteye incidents show <id>
+agenteye incidents ack <id>
+agenteye incidents assign <id> you@corp.com           # 担当者はオペレーターである必要があります
+agenteye incidents resolve <id> --yes
+agenteye incidents open --alert-id <id> --severity critical    # アラートに対して手動で開く
+agenteye incidents comment-add <id> "root cause: upstream 5xx"
+agenteye incidents comment-list <id> ; agenteye incidents comment-delete <id> <comment-id>
+agenteye incidents subscribe <id> ; agenteye incidents unsubscribe <id> ; agenteye incidents subscribers <id>
+```
+
+### アナリティクスとアシスタント: `query` · `agent`
+
+**`query`**: アナリティクスストアに対する保存済み SQL とアドホックランナー。保存済みクエリは**名前**で参照します。SQL はサーバー側で検証されます（SELECT/WITH のみ、ステートメントタイムアウト、行数上限）。
+
+```bash
+agenteye query schema [TABLE]                         # アナリティクスビューのカラム構成
+agenteye query run --sql "select count(*) from analytics.events"
+agenteye query run errs --arg prod --limit 100        # 保存済みクエリを位置引数 $1 付きで実行
+agenteye query list ; agenteye query show errs
+agenteye query create errs --sql @errs.sql --description "errored events (24h)"
+agenteye query update errs --sql @errs.sql --yes ; agenteye query delete errs --yes
+```
+
+**`agent`**: 組み込みの **AI アシスタント**と会話します（ダッシュボードでチャットできる読み取り専用アナリストと同一）。チャットは短いチャット ID で参照します（プレフィックスで解決）。
+
+```bash
+agenteye agent health                                 # AI アシスタントが設定済み/到達可能か確認
+agenteye agent models                                 # --model に渡せるモデルの一覧（デフォルトにマーク付き）
+agenteye agent ask "which agents errored most in the last day?"    # チャットを開始し、短い ID を表示
+agenteye agent ask --chat <short-id> "and which tools did they call?"   # そのチャットを継続
+agenteye agent chats ; agenteye agent show <short-id>
+agenteye agent rename <short-id> --title "error triage" ; agenteye agent delete <short-id>
+```
+
+---
+
+## 終了コード
+
+| コード | 意味 |
+|---|---|
+| 0 | 成功 |
+| 1 | 予期しないエラー（例: ダッシュボードが 5xx を返した） |
+| 2 | 使用エラー（無効な引数、不明なコマンド/フラグ、名前の衝突） |
+| 3 | ダッシュボードに到達できない |
+| 4 | 未ログインまたはセッション期限切れ。`agenteye login` を実行してください |
+| 5 | 認証済みだが必要な権限がない（メッセージに権限名が表示されます） |
+| 6 | 指定されたリソースが見つからない（例: 不明なセッションまたはインシデント ID） |
+
+これらにより CLI を安全にスクリプト化できます: コーディングエージェントは `4` で再認証を促したり、`5` で不足している権限を通知したりできます。終了コードの処理パターンと JSON 出力の形式については、[エージェント向け CLI レシピ](/ja/agenteye/cli-recipes)を参照してください。
+
+---
+
+## 次のステップ
+
+- **[エージェント向け CLI レシピ](/ja/agenteye/cli-recipes)**: コピー&ペーストで使えるクエリパターン、`jq` ワンライナー、`--fields` プロジェクション、終了コードの処理、JSON 出力の形式。CLI を操作するコーディングエージェント向けに書かれています。
+- **[CLI エージェントスキル](/ja/agenteye/cli-skill)**: この CLI を Claude Code / Codex のインストール可能な*スキル*としてパッケージ化し、コーディングエージェントが平易な英語のリクエストから Failproof AI Observability を操作できるようにします。
+- **[API キー](/ja/agenteye/api-keys)**: `keys create --add …` の背後にある権限モデル。
+- **[AI アシスタント](/ja/agenteye/assistant)**: `agent ask` が利用するアシスタントの有効化。

package/.next/standalone/docs-old/ja/agenteye/codex-capture.mdx

@@ -0,0 +1,55 @@
+---
+title: "Codex セッションキャプチャ"
+description: "チームのローカル OpenAI Codex セッションを通常のセッションおよびイベントとして AgentEye に取り込みます — Codex の使い方を変える必要はありません。"
+---
+
+エンジニアたちはすでに毎日 OpenAI Codex を使っています。Codex セッションキャプチャは、それらのコーディングセッションを通常のセッションおよびイベントとして AgentEye に取り込むことで、他の観測対象と並べて検索・再生・評価できるようにします。これは [Python SDK](/ja/agenteye/python-sdk) を補完する機能です。SDK は自分で書いたエージェントを計装するのに対し、こちらはチームがすでに行っている Codex の作業をキャプチャします — 使い方を変える必要は一切ありません。
+
+小さなバックグラウンドコレクターが Codex のローカルセッショントランスクリプトを書き込みと同時に読み取り、AgentEye に送信します。1 台のマシンに 1 つのコレクターを置くだけで、すべてのローカル Codex サーフェスを一括でキャプチャできます — サーフェスごとのセットアップは不要です。
+
+同じコレクターで他のエージェントもキャプチャできます — [OpenClaw](/ja/agenteye/openclaw-capture) や [Hermes](/ja/agenteye/hermes-capture) をご覧ください。使用しているものをそれぞれ有効にしてください。1 つのコレクターで複数を同時にキャプチャできます。
+
+---
+
+## キャプチャされる内容
+
+**ローカル**で動作するすべての Codex サーフェスは同じオンディスクのセッショントランスクリプトを生成し、コレクターはそれらをすべて取得します。
+
+- Codex **CLI** および `codex exec`
+- **VS Code / IDE 拡張機能**
+- セッションをローカルで実行している場合の**デスクトップアプリ**
+
+各 Codex セッションは AgentEye の[セッション](/ja/agenteye/sessions)になり、ユーザーとアシスタントのメッセージ、推論、ツール呼び出し、ツールの結果、トークン使用量が対応する[イベント](/ja/agenteye/event-stream)になります。各セッションの発生元（CLI、IDE、またはデスクトップ）も記録されるため、区別することができます。
+
+> **クラウドセッションはキャプチャされません。** デスクトップアプリはセッションをますます Codex クラウドで実行するようになっており、マシン上にはメタデータのみが保存されます — ローカルに読み取るトランスクリプトは存在しません。ローカルで実行されたセッションのみがキャプチャされます。
+
+---
+
+## 有効にする方法
+
+キャプチャは有効にするまでオフになっています。`events:add` 権限を持つ API キー（[API キー](/ja/agenteye/api-keys)を参照）でコレクターをインストールし、Codex キャプチャを有効にします。
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/FailproofAI/agenteye-collector/main/install.sh \
+  | sh -s -- --key <YOUR_API_KEY> --codex-enabled
+```
+
+これにより、コレクターのインストール、バックグラウンドサービスとしての登録、およびキャプチャの開始が行われます。動作を確認するには次のコマンドを実行してください。
+
+```bash
+agenteye-collector health
+```
+
+初回実行時に既存の Codex セッションが一括でバックフィルされ、その後の新しいアクティビティは数秒以内にストリーミングされます。Codex 自身のファイルは読み取り専用です — 変更・移動・削除は一切されません。また、再起動をまたいでも各セッションは正確に 1 回だけ送信されます。
+
+---
+
+## 表示される場所
+
+キャプチャされたセッションは **Sessions** に表示され、そのイベントは他の観測対象エージェントと同様に **Events** ストリームに表示されます — そのため、[セッションリプレイ](/ja/agenteye/sessions)、[検索](/ja/agenteye/queries)、[評価](/ja/agenteye/evaluations)、[アラート](/ja/agenteye/alerts)もすべて利用できます。Codex エージェントでフィルタリングすると、それだけを表示できます。
+
+---
+
+## プライバシー
+
+Codex トランスクリプトにはセッション全体が含まれます — コマンド出力、ファイルの内容、Codex が読み書きしたものすべてを含み、シークレットが含まれることもあります。キャプチャされたセッションはそのまま送信されるため、AgentEye にその内容を集約することが適切なマシンおよびチームに限ってキャプチャを有効にしてください。また、コレクターには `events:add` のみにスコープされたキーを使用してください。データがどのように隔離されて保管されるかについては、[セキュリティ](/ja/agenteye/security)をご覧ください。

package/.next/standalone/docs-old/ja/agenteye/concepts.mdx

@@ -0,0 +1,87 @@
+---
+title: "概念"
+description: "Failproof AI Observability の用語集 — イベント、セッション、評価、監査、ファインディング、インシデントをひとつの場所で定義します。"
+---
+
+
+このページでは、Failproof AI Observability が使用する用語を定義します。他のガイドで見慣れない用語があれば、ここで確認できます。最初から通読する必要はありません。ざっと目を通すか、確認したい用語が出てきたときに参照してください。
+
+---
+
+## データモデル
+
+**イベント**
+データの最小単位です。1 つのイベントは、エージェントが実行した単一のステップを記録します。`tool_use`、`model_request`、`hook_completed`、`error` などがあります。エージェントは [Python SDK](/ja/agenteye/python-sdk) を通じてイベントを送信し、**Events** ページにリアルタイムで表示されます。
+
+**セッション**
+`session_id` によって識別される、1 回のエージェント実行です。セッションは同じ ID を持つすべてのイベントをまとめたもので、**Sessions** ページの 1 行として表示され、詳細ページでは実行グラフとして描画されます。セッションは通常 `agent_start` で始まり、`agent_end` で終わります。
+
+**エージェント**
+`agent_id` によって識別される、実行内の名前付きアクターです。1 回の実行に複数のエージェントが関与することがあります。たとえば、サマライザーのサブエージェントを生成するプランナーなどです。サブエージェントは `parent_id` を持ち、これによって Failproof AI Observability は実行グラフ上でそれぞれ独立したレーンに描画できます。
+
+**環境**
+実行が行われた場所を示すラベルです。`production`、`staging`、`dev` などがあります。SDK の設定時に一度だけ設定します。ダッシュボードのほぼすべてのページで環境によるフィルタリングが可能です。
+
+**コンテキストウィンドウ使用率**
+レスポンスがモデルのコンテキストウィンドウを消費した割合です。Failproof AI Observability は認識しているモデルの `model_response` イベントにこの値を付与するため、プロンプトの増大や差し迫ったコンパクションをイベントストリーム上で直接確認できます。
+
+---
+
+## 品質
+
+**評価（Evaluation）**
+完了したセッションに対して、あなたが実行するスコアリングサービスが生成する品質スコアです。評価はオプトイン方式です。評価器を接続するまで、セッションは記録されますがスコアリングは行われません。各評価には複数の名前付きスコア（例：`helpfulness`、`factuality`、`tool_efficiency`）を含めることができ、それぞれに短い根拠メモが付きます。[Evaluation suite](/ja/agenteye/evaluation-suite) を参照してください。
+
+**スコアキー**
+評価器が報告する 1 つの評価軸の名前です（例：`helpfulness`）。アラートと監査は、特定のスコアキーを時系列で監視できます。
+
+**評価器（Evaluator）**
+あなたのスコアリングサービスです。Failproof AI Observability は完了した実行のトランスクリプトをこのサービスに POST し、返されたスコアを保存します。デフォルトの評価器は提供されません。スコアリングのロジックはあなた自身が実装します。
+
+---
+
+## 障害の発見と修正
+
+**フック（Hook）**
+エージェントフレームワークがステップの前後に実行するガードレールまたは副作用です。コンテンツの安全チェック、PII のマスキング、予算ガードなどが該当します。フックは `outcome`（allow、deny、modify）を持つ `hook_triggered` / `hook_completed` イベントを送信し、専用のオブザーブページを持ちます。
+
+**アラートルール**
+エラー率、p95 レイテンシ、トークンコスト、または評価器のスコアなどのメトリクスが設定したしきい値を超えたときに発火するルールです。ルールが発火すると、インシデントが作成され、設定したチャンネル（メール、Slack、webhook、ダッシュボード内）に通知が送られます。[Alerts](/ja/agenteye/alerts) を参照してください。
+
+**インシデント**
+アラートルールが発火したときに作成されるオープンな問題です。インシデントにはライフサイクル（承認、割り当て、解決）があり、すべての操作を記録するアクティビティタイムラインを持ちます。手動で作成することもできます。
+
+**監査（Audit）**
+まだルールを定義していない障害パターンをセッション横断でログから探り出す、定期的な調査です（毎時から毎週まで設定可能）。エラーのクラスター、低スコア、レイテンシの外れ値、ツール呼び出しのループ、完了しなかった実行などを検出します。アラートがすでに把握しているメトリクスを監視するのに対し、監査は次に注目すべき点を教えてくれます。[Audits](/ja/agenteye/audits) を参照してください。
+
+**ファインディング（Finding）**
+監査実行から得られる、優先度付きかつ証拠に基づいた結果の 1 件です。ファインディングはパターンを名付け、その背後にある正確なセッションにリンクし、トリアージのライフサイクル（承認、解決、ミュート、却下）を持ちます。Failproof AI Observability は実行をまたいでファインディングを重複排除するため、既知のパターンは積み重なるのではなく更新されます。
+
+**AI アシスタント**
+ダッシュボード内のチャット機能で、あなたのデータを基にエージェントに関する質問に平易な言葉で回答します。デフォルトでは読み取り専用です。アシスタントが作成するもの（保存済みクエリ、ダッシュボードなど）は承認が必要であり、削除操作は一切できません。[AI assistant](/ja/agenteye/assistant) を参照してください。
+
+---
+
+## 実行環境
+
+**組織（テナント）**
+独立したワークスペースです。1 つの Failproof AI Observability インスタンスで複数の組織をホストでき、それぞれが独自のユーザー、キー、データを持ちます。すべてのダッシュボード URL は組織のスラッグ（`/<org-slug>/…`）にスコープされます。
+
+**コレクター**
+`agenteye-collector` は、各エージェントマシン上で動作する軽量なデーモンです。SDK がディスクに書き込んだイベントをバッチ処理し、サーバーに送信します。
+
+**API キー**
+クライアントをサーバーに対して認証するためのスコープ付きトークンです。キーには細かい権限が設定されます（例：コレクター用の `events:add`、ダッシュボードキー用の読み取り専用スコープ）。[API keys](/ja/agenteye/api-keys) を参照してください。
+
+**サーバー**
+インジェストおよび API サービスです。イベントを受信し、運用状態をデータベースに保存し、ダッシュボードと CLI を提供します。
+
+**ダッシュボード**
+Web UI です。すべてのページは組織にスコープされ、サーバーの API を通じてデータを読み取ります。
+
+---
+
+## 次のステップ
+
+- [Overview](/ja/agenteye/overview): これらのコンポーネントがどのように組み合わさるかを説明します。
+- [Observability](/ja/agenteye/observability): オブザーブのサーフェス（Events、Sessions、Models、Tools、Hooks、Errors）について説明します。

package/.next/standalone/docs-old/ja/agenteye/dashboards.mdx

@@ -0,0 +1,46 @@
+---
+title: "ダッシュボード"
+description: "ライブエージェントデータをチーム全員が確認できる共有ビューに変換します。"
+---
+
+
+ライブエージェントデータをチーム全員が確認できる共有ビューに変換します。重要なクエリをチャートとして固定しておけば、誰でも一目で同じ数値を確認できます。クエリを再実行する必要はありません。
+
+![保存済みクエリから構築されたダッシュボード：時間あたりのイベント数の折れ線グラフ、エラータイプ別の棒グラフ、レイテンシのエリアチャート、モデル別トークン数](/agenteye/images/dashboard-fleet.png)
+
+*1枚のボードに4つの保存済みクエリ：時間あたりのイベント数、エラータイプ別、レイテンシ、モデル別トークン数。*
+
+## チーム全員が同じ情報を見る
+
+チャットにスクリーンショットを貼り付けたり、1日に同じクエリを何度も再実行したりする必要はもうありません。ダッシュボードはチーム全員がまったく同じビューを開ける、組織共有のボードです。元データが更新されると、チャートもそれに合わせて更新されます。ボードは常に最新の状態を保つため、古い数字をめぐって議論になることもありません。
+
+上記のフリートダッシュボードは、日常運用に適した構成の例です。
+
+- **時間あたりのイベント数**の折れ線グラフ：スループットを監視し、急激な落ち込みを検知できます
+- **エラータイプ別**の棒グラフ：主要な障害カテゴリを一目で把握できます
+- **レイテンシ**のエリアチャート：ユーザーから苦情が来る前に遅延を検出できます
+- **モデル別トークン数**の内訳：コストを常に把握できます
+
+ボードは `/<org-slug>/dashboards` で確認できます。
+
+## 保存済みクエリをピンする
+
+すべてのタイルは保存済みクエリから始まります。[クエリ](/ja/agenteye/queries)ライブラリ（組み込みプリセットと独自クエリ、イベントおよび評価データに対応）で目的のクエリを作成・保存し、データに合ったチャートとしてダッシュボードにピンします。時系列のトレンドには**折れ線**、カテゴリの比較には**棒**、ボリュームには**エリア**、割合の内訳には**円**グラフを選べます。
+
+タイルは保存済みクエリをチャートとして表示しているだけなので、手動で同期する必要はありません。クエリを一度更新すれば、それを使用するすべてのダッシュボードも自動的に更新されます。
+
+## 量だけでなく品質も監視する
+
+量はエージェントが動いているかどうかを示します。品質はエージェントが実際に仕事をこなしているかどうかを示します。[評価スコア](/ja/agenteye/evaluations)をダッシュボードに表示すれば、実行の品質を時系列で追跡できます。品質の低下はチャートの落ち込みとして現れるため、ユーザーから突然クレームが来るより前に気づくことができます。
+
+![保存済み評価クエリから構築された品質重視のダッシュボード](/agenteye/images/dashboard-quality.png)
+
+*品質ボードは、オペレーションの数値と並べて評価スコアを前面に表示します。*
+
+オペレーションボードと品質ボードを並べて配置することで、チームは「正常に動いているか？」と「十分な品質か？」の両方を1か所で確認できます。クエリを再実行する必要もありません。
+
+## 関連ページ
+
+- [クエリ](/ja/agenteye/queries)：タイルの元となるクエリを作成・保存する。
+- [評価](/ja/agenteye/evaluations)：実行にスコアを付けて品質を時系列でチャート化する。
+- [アラート](/ja/agenteye/alerts)：これらのメトリクスのしきい値を超えたときに通知を受け取る。

package/.next/standalone/docs-old/ja/agenteye/error-tracking.mdx

@@ -0,0 +1,41 @@
+---
+title: "エラートラッキング"
+description: "エージェントが発生させたすべての障害を一カ所で確認できます。大量のエラーが発生しても、1つの問題としてグループ化されます。"
+---
+
+
+エージェントが発生させたすべての障害を一カ所で確認できます。大量のエラーが発生しても、1つの問題としてグループ化されます。「何かが赤くなっている」という状態から、問題のある実行を特定するまで、ライブフィードをスクロールすることなくワンクリックで辿り着けます。
+
+![Errorsページ：上部に時系列の障害ヒストグラム、下部にグループ化された赤いエラー行が並び、それぞれに「+ alert」ボタンがある](/agenteye/images/errors.png)
+*Errorsページ：時系列の障害ヒストグラムと、繰り返し発生した障害を1行にまとめたインシデント一覧。*
+
+## すべての障害を自動収集
+
+エージェントが壊れたとき、ライブイベントストリームをスクロールして赤い行を見逃さないように監視し続ける必要はありません。**Errors** ページがその収集作業を代わりに行います。ダッシュボードで赤く表示されるすべての情報を1つのトリアージ画面にまとめるため、最初に目にするのは「何が壊れているか」であり、「どこを探すべきか」ではありません。
+
+また、明らかな障害だけでなく、静かな失敗も捕捉します。明示的な `error` イベントに加え、Failproof AI Observability は `tool_result`、`hook_completed`、`agent_end` のペイロードに失敗が含まれている場合もここに表示します。エラーを返したツールや異常終了したフックも、大きな例外がスローされなかったからといって見逃されることはありません。
+
+ページ上部のヒストグラムは、エラーを時系列でプロットします。一目で、これが断続的な背景ノイズなのか、数分前から始まったスパイクなのかが分かるため、すぐに対応の優先度を判断できます。
+
+すべてのオブザーブ画面と同様に、Errors ページは組織にスコープされており、日付範囲・環境・エージェント・セッションでフィルタリングできます。フリート全体の一覧から、実際に関心のある1つのエージェントや環境に絞り込むことが可能です。
+
+## 何百もの同一行ではなく、1つのインシデントとして
+
+依存関係が1つ壊れるだけで、同じエラーが1分間に何百回も発火することがあります。そのままでは、ほぼ同一の行が壁のように並び、本当に見るべき情報が埋もれてしまいます。
+
+Failproof AI Observability は、同じセッションとエラータイプを共有する繰り返しの障害を1行に折りたたみます。大量のエラーが1件のインシデントとして表示されます。ログ行ではなく問題の数を数えられるようになり、重要なシグナルが大量のノイズに埋もれることなく上位に留まります。
+
+## 「何かが赤い」から正確なイベントへ
+
+任意の行をクリックすると、そのランのセッション内に直接ジャンプし、失敗した正確なイベントの位置が表示されます。セッション ID をコピーしたり、問題が起きた瞬間を探してスクロールしたりする必要はありません。エージェントが壊れる直前に何をしていたかが分かる完全な実行グラフが一目で確認できる状態で、その場所に直接到達します。
+
+`alerts:write` 権限を持っている場合、各行には **+ alert** ボタンも表示されます。クリックすると Observability が新しいアラートルールを開き、同じ障害を再度検知するための設定があらかじめ入力された状態になっています。トリアージしたばかりのインシデントが、次回は二度目のサプライズではなく、通知として届くようになります。
+
+**場所：** **Errors** ページはダッシュボードのオブザーブセクションにあり、`/<org-slug>/errors` でアクセスできます。
+
+## 関連ページ
+
+- [Alerts](/ja/agenteye/alerts)：任意の障害をページングルールに変換します。
+- [Incidents](/ja/agenteye/incidents)：発火したアラートをオープンからリゾルブまで追跡します。
+- [Sessions](/ja/agenteye/sessions)：エラーの背後にある完全な実行を開きます。
+- [Audits](/ja/agenteye/audits)：Observability がすべての実行にわたる障害パターンを自動検出します。