failproofai 1.0.1-beta.1 → 1.0.1

package/.next/standalone/docs-old/ja/agenteye/api-keys.mdx

@@ -0,0 +1,280 @@
+---
+title: "APIキー"
+description: "APIキーはFailproof AI Observabilityサーバーへのアクセスを制御し、コレクターが読み取り権限や管理者権限を持つことなくイベントを送信できるようにします。"
+---
+
+
+APIキーはFailproof AI Observabilityサーバーへのアクセスを制御し、コレクターが読み取り権限や管理者権限を持つことなくイベントを送信できるようにします。各キーには1つ以上のパーミッションが付与されており、各パーミッションは特定のサーバールートへのアクセスを制限します。必要な最小限のパーミッションのみを付与してください。ほとんどのデプロイメントでは、3種類のキーを作成するだけで十分です。
+
+## ほとんどのデプロイメントで必要な3つのキー
+
+| キー | パーミッション | 使用者 |
+|---|---|---|
+| コレクターキー | `events:add` | 各エージェントマシン上の`agenteye-collector`がイベントを送信するために使用。 |
+| ダッシュボード読み取りキー | `events:read`、`keys:read` | データを変更せずにクエリを実行する読み取り専用のオペレーターまたは連携サービス。 |
+| ブートストラップ管理者キー | すべてのパーミッション | インスタンスを最初に起動するオペレーター（およびダッシュボード）。`ADMIN_KEY`環境変数からシードされます。[ブートストラップ管理者キー](#bootstrap-admin-key)を参照してください。 |
+
+まずここから始めてください。より細かいカスタムスコープのキーが必要な場合のみ、以下の完全なパーミッションカタログを参照してください。[推奨キーレイアウト](#recommended-key-layout)および[キーの作成](#creating-keys)も参照してください。
+
+---
+
+## パーミッション
+
+サーバーは固定のパーミッションカタログを強制します。各パーミッションは特定のHTTPルートへのアクセスを制限します。**管理者キー**はすべてのパーミッションを持ち、スコープ付きキーは作成時に付与したサブセットのみを持ちます。不明なパーミッション文字列はキー作成時に拒否されます。
+
+> **注意:** 2つの有効なパーミッションは人間/ダッシュボード専用であり、APIキーには付与できません: `orgs:admin`（インスタンス管理、オペレーター専用）と`keys:update`です。どちらかを付与しようとする`POST /keys`または`PATCH /keys/:id`リクエストはHTTP 422で拒否されます。ベアラーキーがキーを作成できても編集できない理由については、以下の`keys:update`の行を参照してください。
+
+### イベントの取り込みとクエリ
+
+| パーミッション | HTTPルート | 許可される操作 |
+|---|---|---|
+| `events:add` | `POST /events` | コレクターからイベントのバッチを取り込みます。コレクターに必要な唯一のパーミッションです。 |
+| `events:read` | `GET /events`、`GET /events/latency_aggregate`、`GET /events/environments`、`GET /events/models`、`GET /sessions/:session_id/export` | イベントのクエリ、既知の環境の一覧表示、データに含まれるモデル識別子の一覧表示（モデルビューとモデルフィルターで使用）、ヒートマップ/パーセンタイルバンドを構成するレイテンシ集計の計算、セッションのJSONLとしてのエクスポート。共有フィルターバーファセットエンドポイント`GET /events/environments`および`GET /events/agent_ids`は`events:read`**または**`evaluations:read`のどちらでもアクセス可能であるため、セッションページ（`evaluations:read`でゲート）は同じorg別ファセットを再利用できます。`GET /events/models`はこれに含まれません: `events:read`が必要であり、`evaluations:read`のみを持つプリンシパルは403を受け取ります。 |
+
+### セッションと評価
+
+| パーミッション | HTTPルート | 許可される操作 |
+|---|---|---|
+| `evaluations:read` | `GET /sessions`、`GET /evaluations`、`GET /evaluations/aggregate`、`GET /evaluations/environments`、`GET /evaluation-jobs` | セッションの一覧表示、評価結果の読み取り、ダッシュボードで使用される集計済みeval健全性、評価ジョブワーカーキューの状態。 |
+| `evaluations:trigger` | `POST /sessions/:session_id/re-evaluate` | 完了したセッションの再評価を手動でキューに追加します。 |
+
+### ダッシュボード
+
+| パーミッション | HTTPルート | 許可される操作 |
+|---|---|---|
+| `dashboards:read` | `GET /dashboards`、`GET /dashboards/:id`、`GET /dashboards/:id/tiles` | ダッシュボードの一覧表示、読み込み、タイルの読み取り。 |
+| `dashboards:write` | `POST /dashboards`、`PUT /dashboards/:id`、`POST /dashboards/:id/tiles`、`PUT /dashboards/:id/tiles/:tile_id`、`DELETE /dashboards/:id/tiles/:tile_id`、`PUT /dashboards/:id/tiles/layout` | ダッシュボードの作成と編集、タイルの追加/編集/削除、タイルグリッドの並べ替え。 |
+| `dashboards:delete` | `DELETE /dashboards/:id` | ダッシュボード全体の削除（タイルレベルの削除は`dashboards:write`に含まれます）。 |
+
+### 保存済みクエリ（SQLコンポーザー）
+
+| パーミッション | HTTPルート | 許可される操作 |
+|---|---|---|
+| `queries:read` | `GET /queries`、`GET /queries/:id`、`GET /queries/schema` | 保存済みクエリの一覧表示、読み込み、コンポーザーが対象とする読み取り専用スキーマの確認。 |
+| `queries:write` | `POST /queries`、`PUT /queries/:id` | 保存済みクエリの作成と編集。SQLは`queries:run`呼び出しと同様に、同じ読み取り専用ロールとガードされたSQLチェックを通じてルーティングされます。 |
+| `queries:delete` | `DELETE /queries/:id` | 保存済みクエリの削除。 |
+| `queries:run` | `POST /queries/run` | コンポーザーが使用する読み取り専用ロールに対して、保存済みまたはアドホックSQLを実行します。 |
+
+### AIアシスタント
+
+| パーミッション | HTTPルート | 許可される操作 |
+|---|---|---|
+| `agent:use` | `GET /agent/conversations`、`POST /agent/conversations`、`GET /agent/conversations/:id`、`PATCH /agent/conversations/:id`、`DELETE /agent/conversations/:id`、`PUT /agent/conversations/:id/messages` | AIアシスタントとの会話と、自分自身の（プライベートな）会話の管理。アシスタントドックを表示するには**ユーザー**に必要です。アシスタント自身のキーは`dashboard-assistant`であり、別途シードされます（以下を参照）。 |
+
+### APIキー
+
+| パーミッション | HTTPルート | 許可される操作 |
+|---|---|---|
+| `keys:create` | `POST /keys` | 新しいスコープ付きAPIキーを作成します。既存キーのパーミッション編集は**含まれません**（それは`keys:update`です）。 |
+| `keys:read` | `GET /keys` | 既存キーの一覧表示。シークレットはこのエンドポイントでは返されません。 |
+| `keys:update` | `PATCH /keys/:id` | 既存キーのパーミッションを編集します。**人間/ダッシュボード専用**のパーミッションであり、APIキーには割り当てられません（ベアラーキーはキーを作成できますが、編集はできません）。 |
+| `keys:disable` | `POST /keys/:id/disable` | キーを無効化します。保護されたキー（`admin`、`dashboard-assistant`）は無効化できません。これらは環境変数の変更と再起動によってローテートしてください。 |
+| `keys:regenerate` | `POST /keys/:id/regenerate` | キーのシークレットをローテートします。保護されたキーはこのルートから再生成できません。 |
+
+### ダッシュボードユーザー
+
+| パーミッション | HTTPルート | 許可される操作 |
+|---|---|---|
+| `users:create` | `POST /users`、`GET /users/defaults` | 新しいダッシュボードユーザーの招待（メール＋ワンタイムパスコード（OTP）ログインの発行）と、招待フォームのシードに使用するダッシュボード設定のデフォルトパーミッションセットの読み取り。 |
+| `users:read` | `GET /users`、`GET /users/:id` | ユーザーの一覧表示と単一ユーザーレコードの読み込み。 |
+| `users:update` | `PUT /users/:id` | ユーザーのパーミッションを編集します。更新時に対象ユーザーへパーミッション変更メールが送信され、次回リクエスト時に有効になります。再ログインは不要です。 |
+| `users:delete` | `DELETE /users/:id`、`POST /users/:id/enable` | ユーザーの無効化（セッションを即時失効）と、以前に無効化されたユーザーの再有効化。 |
+
+これらのパーミッションはダッシュボードの**Users**ページを支援しており、各メンバーに付与されたスコープがチップとして表示されます:
+
+![Usersページ: 各ダッシュボードユーザーのカード（メール、付与されたパーミッション、編集/無効化コントロール）](/agenteye/images/users.png)
+
+### 運用設定
+
+| パーミッション | HTTPルート | 許可される操作 |
+|---|---|---|
+| `settings:read` | `GET /settings`、`GET /settings/schema`、`GET /settings/model-context-windows`、`GET /settings/model-context-windows/resolve` | ダッシュボード管理の運用設定とそのメタデータの表示、モデルごとのコンテキストウィンドウオーバーライドの一覧表示、モデルの有効なウィンドウの解決。 |
+| `settings:write` | `PUT /settings/:key`、`PUT /settings/model-context-windows`、`DELETE /settings/model-context-windows` | 運用設定の編集と、モデルごとのコンテキストウィンドウオーバーライドの追加/変更/削除。変更はサーバーを再起動せずに新しいイベントに反映されます。 |
+
+![Settingsページ: 許可されたサインインやセッション/OTP有効期間などのダッシュボード管理の運用設定（再起動なしで編集可能）](/agenteye/images/settings.png)
+
+### アラートとインシデント
+
+| パーミッション | HTTPルート | 許可される操作 |
+|---|---|---|
+| `alerts:read` | `GET /alerts`、`GET /alerts/:id` | 設定されたアラート定義の表示。 |
+| `alerts:write` | `POST /alerts`、`PUT /alerts/:id`、`DELETE /alerts/:id`、`POST /alerts/:id/test` | アラート定義の作成、編集、削除、テスト発火。 |
+| `incidents:read` | `GET /alerts/incidents`、`GET /alerts/incidents/:iid`、`GET /alerts/incidents/:iid/comments`、`GET /alerts/incidents/:iid/subscribers` | インシデントとトリアージ履歴の表示。 |
+| `incidents:write` | `POST /alerts/:id/incidents` | 既存のアラートに対して手動でインシデントを開始します。 |
+| `incidents:ack` | `POST /alerts/incidents/:iid/ack`、`POST /alerts/incidents/:iid/assign`、`POST /alerts/incidents/:iid/resolve`、`POST /alerts/incidents/:iid/comments`、`POST /alerts/incidents/:iid/subscribe`、`POST /alerts/incidents/:iid/unsubscribe` | インシデントの確認、担当割り当て、解決、コメント。 |
+
+### 監査
+
+| パーミッション | HTTPルート | 許可される操作 |
+|---|---|---|
+| `audits:read` | `GET /audits`、`GET /audits/:id`、`GET /audits/:id/runs`、`GET /audits/findings`、`GET /audits/findings/:fid` | 監査定義、実行履歴、所見の表示。 |
+| `audits:write` | `POST /audits`、`PUT /audits/:id`、`DELETE /audits/:id`、`POST /audits/:id/run`、`POST /audits/findings/:fid/status` | 監査の作成、編集、削除、実行、所見のトリアージ（確認/ミュート/却下/解決/再オープン/割り当て）。 |
+
+> **注意:** キーに監査機能を付与するには、`audits:*`を明示的に付与してください。Auditsが追加されたときに既存の付与者がどのように移行されたかについては、[アップグレードと後方互換性に関する注記](#upgrade-and-backward-compatibility-notes)を参照してください。
+
+> 受信者ピッカーエンドポイント`GET /alerts/recipients`（アラート編集者が通知できるメンバーのメール一覧を取得）は`alerts:read`**または**`alerts:write`のいずれかを持つユーザーがアクセス可能であるため、アラート編集者は`users:read`を付与されなくてもピッカーにデータを入力できます。
+
+> ダッシュボードビューワーには`dashboards:read`（保存済みビューの読み込み）と`evaluations:read`（ヘルスメトリクスは評価データから計算）の**両方**が必要です。ダッシュボードの作成や編集を許可するには`dashboards:write`を、削除を許可するには`dashboards:delete`を付与してください。
+
+> `/health`と`/auth/*`（OTPリクエスト、OTP検証、セッション確認、ログアウト）は設計上、認証不要です。これらはログインフローと生存確認プローブです。`GET /access-granters`は有効なキーが必要ですが、特定のパーミッションは不要であるため、ログイン済みのすべてのユーザーがアクセス変更について連絡すべき管理者を確認できます。
+
+---
+
+## パーミッションセット
+
+パーミッションセットを使用すると、毎回個別のトークンを手作業で選択する代わりに、名前付きロールを適用できます。新しいダッシュボードユーザーやAPIキーごとに十数個のパーミッションを1つずつ選択する代わりに、セットを選択することで、割り当てられた全員が一貫した、確認可能な付与を受けます。カスタムセットを編集すると、既にそれに割り当てられているすべてのユーザーに新しい付与が再適用されるため、ロール変更は1回の編集で完了し、全メンバーを個別に更新する必要がありません。
+
+すべてのオーガナイゼーションには3つの組み込みセットが初期設定されています:
+
+| セット | パーミッション | 対象 |
+|---|---|---|
+| `read-only` | `events:read`、`keys:read`、`users:read`、`evaluations:read`、`dashboards:read`、`queries:read`、`settings:read`、`alerts:read`、`audits:read`、`incidents:read` | すべての運用機能への読み取り専用アクセス。 |
+| `standard` | `read-only`のすべて、加えて`evaluations:trigger`、`queries:run`、`incidents:ack`、`agent:use` | 読み取り専用に加えて、日常的なオンコール操作: クエリの実行、セッションの再評価、インシデントの確認、AIアシスタントの使用。 |
+| `admin` | 割り当て可能なすべてのパーミッション | orgの完全な制御。 |
+
+3つの組み込みセットは**変更不可**です。その名前は常に同じ意味を持つため、`read-only`、`standard`、`admin`はポリシーやオンボーディングで安全に参照できます。オペレーターはオーガナイゼーション固有のロールをモデル化するために追加の**カスタムセット**を作成できます（例: 「ダッシュボード作成者」ロールや「コレクターのみ」ロール）。
+
+セットはダッシュボードに表示され、`GET /permission-sets`（一覧、`users:read`でゲート）および`POST /permission-sets` / `PUT /permission-sets/:name` / `DELETE /permission-sets/:name`（カスタムセットの作成、編集、削除、`settings:write`でゲート）のAPIを通じて管理されます。組み込みセットの削除や編集は拒否されます。
+
+セットメンバーシップは他の2つの機能を支援します:
+
+- **`DEFAULT_USER_PERMISSIONS`**（管理者が**+ new user**を開いたときに事前選択される付与）はデフォルトで`standard`セットになります。
+- **`agenteye-orgctl`の`--set`フラグ**（オペレーターメンバー管理）は名前付きセットからメンバーを開始し、その後`--add` / `--remove`で微調整します。
+
+> **注意:** セットにキーに割り当て不可能なパーミッションが含まれている場合（例: `keys:update`を含むカスタムセット）、そのセットからキーをシードすると、割り当て不可能なトークンが除外されます。除外しない場合、サーバーはHTTP 422でキーを拒否します。ダッシュボードユーザーにはこの制限は適用されません。
+
+---
+
+## ブートストラップ管理者キー
+
+管理者キーは、オペレーターがゼロからアクセスを構築するための単一のルート認証情報です。このキーを使用して、他のすべてのスコープ付きキーを発行し、最初のダッシュボードユーザーを招待し、他のキーが存在する前にインスタンスを設定できます。これはkeys APIを通じて作成しない唯一のキーです。サーバーが最初の起動時にアクセス可能になるよう、環境からプロビジョニングされます。
+
+サーバーで`ADMIN_KEY`環境変数を設定してください。起動のたびに、サーバーはこの値をすべてのパーミッションを持つ管理者キーとしてアップサートします。
+
+ローテートするには: `ADMIN_KEY`を新しいシークレットに変更してサーバーを再起動します。
+
+---
+
+## オーガナイゼーションスコープ
+
+**オーガナイゼーション自体は、このkeys APIではなく、オペレーターによってアウトオブバンドで作成・管理されます。** orgとメンバーのライフサイクル（orgの作成/名前変更/削除/パージ、メンバーの追加/更新/削除）は**`agenteye-orgctl`** CLIで行います。これに対するHTTP APIやダッシュボードのボタンはありません。**変わらないのは、org別APIキーは依然としてダッシュボード（またはこのkeys API経由）でorgメンバーによって発行される**という点です。
+
+マルチorgデプロイメントでは、orgメンバーが（このkeys APIまたはダッシュボードの**Keys**ページから）作成するすべてのキーは**1つのオーガナイゼーション**に属し、そのorgのデータのみを読み書きできます。orgはキー作成時にスタンプされ、すべてのリクエストで強制されます。2つのブートストラップキーのみが例外です: `admin`キー（`ADMIN_KEY`からシード）と`dashboard-assistant`キー（`AGENT_API_KEY`からシード）は**インスタンススコープ**です（orgを持ちません）。ダッシュボードは`admin`キーで認証し、サインイン済みメンバーの代わりにorg別リクエストをプロキシします。シングルテナントデプロイメントではこれを意識する必要はありません。すべてのキーは組み込みの`default` orgに属します。
+
+---
+
+## キーの作成
+
+管理者キー（または`keys:create`パーミッションを持つキー）を使用して、追加のスコープ付きキーを作成します。
+
+### コレクターキー（取り込みのみ）
+
+```bash
+curl -s -X POST http://your-server/keys \
+  -H "Authorization: Bearer $ADMIN_KEY" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "name": "prod-collector",
+    "key": "your-collector-secret",
+    "permissions": ["events:add"]
+  }'
+```
+
+### ダッシュボードキー（読み取りのみ）
+
+```bash
+curl -s -X POST http://your-server/keys \
+  -H "Authorization: Bearer $ADMIN_KEY" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "name": "dashboard",
+    "key": "your-dashboard-secret",
+    "permissions": ["events:read", "keys:read"]
+  }'
+```
+
+HTTP APIでキーを作成する場合、`key`の値は自分で指定します。強力なシークレットを選択し、安全に保管してください。（ダッシュボードは逆の動作をします: 強力なシークレットを生成し、作成時に一度だけ表示します。[ダッシュボードでのキー管理](#key-management-in-the-dashboard)を参照してください。）レスポンスでキーが作成されたことを確認できます:
+
+```json
+{
+  "id": "550e8400-e29b-41d4-a716-446655440000",
+  "name": "prod-collector",
+  "permissions": ["events:add"],
+  "created_at": "2026-04-01T12:00:00Z"
+}
+```
+
+---
+
+## キーの一覧表示
+
+```bash
+curl -s http://your-server/keys \
+  -H "Authorization: Bearer $ADMIN_KEY"
+```
+
+一覧レスポンスではキーのシークレットは返されません。ID、名前、パーミッションのみが返されます。
+
+---
+
+## キーの無効化
+
+無効化するとキーレコードを削除せずに、即座にアクセスが失効します。
+
+```bash
+curl -s -X POST http://your-server/keys/<id>/disable \
+  -H "Authorization: Bearer $ADMIN_KEY"
+```
+
+---
+
+## キーの再生成
+
+既存キーの新しいシークレットを生成します。古いシークレットは即座に無効化されます。
+
+```bash
+curl -s -X POST http://your-server/keys/<id>/regenerate \
+  -H "Authorization: Bearer $ADMIN_KEY"
+```
+
+レスポンスには新しい平文シークレットが含まれており、**一度だけ表示されます**。
+
+---
+
+## ダッシュボードでのキー管理
+
+ダッシュボードの**Keys**ページでは、上記のすべての操作をUIで行えます。一覧を表示するには`keys:read`パーミッションを持つキーが必要で、作成/編集/無効化/再生成の操作にはそれぞれ`keys:create` / `keys:update` / `keys:disable` / `keys:regenerate`が必要です。キーのパーミッションの編集（`keys:update`）とキーの作成（`keys:create`）は別々になっているため、オペレーターにキーの発行権限を付与しつつ既存キーの再スコープ権限を与えない、またはその逆が可能です。管理者キーはこれらすべてをカバーします。
+
+ダッシュボードからキーを作成する場合、シークレットを入力する必要はありません。ダッシュボードが強力なシークレットを生成し、作成時に**一度だけ**表示します。すぐにコピーして安全に保管してください。再生成の場合と同様、二度と表示されません。パーミッションを直接選択することも、パーミッションセットからシードすることもできます（以下を参照）。
+
+![APIキーページ: 各キーのカード（名前、付与されたパーミッション、作成日時）と再生成・無効化アクション。`admin`などの保護されたキーはマーク付き](/agenteye/images/api-keys.png)
+
+---
+
+## 推奨キーレイアウト
+
+| キー | パーミッション | 使用者 |
+|---|---|---|
+| `admin`（`ADMIN_KEY`環境変数でブートストラップ） | すべて | 運用/セットアップ、およびダッシュボード（`ADMIN_KEY`で認証し、パーミッションチェック付きでユーザーリクエストをプロキシ） |
+| ホストごとのコレクターキー | `events:add` | 各エージェントマシン上のコレクター |
+| `dashboard-assistant`（`AGENT_API_KEY`環境変数でブートストラップ） | `events:read`、`evaluations:read`、`dashboards:read`、`dashboards:write`、`queries:read`、`queries:write`、`queries:run` | AIアシスタント、自動シード済み、**保護済み**; APIを通じて編集不可 |
+| アシスタントテレメトリーキー（オプション） | `events:add` | AIアシスタントのセルフインストルメンテーション（有効な場合） |
+
+> **注意:** アシスタントのキーは`AGENT_API_KEY`環境変数（エージェントが`AGENTEYE_API_KEY`として提示するのと同じシークレット）からサーバーによって**自動的にシード**されます。手動のキー発行手順も管理者キーの関与もありません。パーミッションはソースコードに固定されているため、設定ミスによってスコープが拡大することはありません: イベント/評価/ダッシュボード全体の読み取り、加えてクエリ作成フロー「AIにクエリを書いてもらう」のためのダッシュボード書き込みとクエリ読み取り/書き込み/実行。すべてのSQLは引き続き同じ読み取り専用ロールとガードされたSQLパスを通過するため、これは*データサーフェス*ではなく*作成サーフェス*を拡大します。破壊的な操作（`queries:delete`、`dashboards:delete`）は意図的にアシスタントキーから除外されています。`admin`キーと同様に**保護されています**: keys APIを通じて無効化や再生成はできず、`AGENT_API_KEY`を変更して再起動することでのみローテートできます。ダッシュボード*ユーザー*がアシスタントを表示して使用するには、追加で`agent:use`パーミッションが必要です。セルフインストルメンテーションを有効にする場合は、アシスタントに`events:add`専用の別キーを付与してください。
+
+---
+
+## アップグレードと後方互換性に関する注記
+
+これらは既存のインスタンスをアップグレードする場合にのみ必要です。新規デプロイメントはスキップしてください。
+
+> Auditsが追加された際、既存の付与者はアラートと同じロール形状に沿って拡張されました: `alerts:read`を持つすべてのユーザーとパーミッションセットには`audits:read`が追加され、`alerts:write`を持つすべてのユーザーには`audits:write`が追加されました。既存のAPIキーは**拡張されませんでした**。監査機能が必要なキーには`audits:*`を明示的に付与してください。
+
+> レガシーな`alerts:ack`トークンの保存済み付与は`incidents:ack`として解析されるため、オンコール担当者はキーを再発行せずにアクセスを維持できます。このトークンはダッシュボードのユーザーエディターから割り当てられなくなりました。マトリックスでは代わりに`incidents:ack`が提供されています。
+
+---
+
+## 次のステップ
+
+- [Python SDK](/ja/agenteye/python-sdk): エージェントコードがイベント送信時にどのように認証するか。
+- [Security](/ja/agenteye/security): サインイン、アクセス制御、オーガナイゼーションごとのデータ分離の仕組み。

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

@@ -0,0 +1,63 @@
+---
+title: "AIアシスタント"
+description: "エージェントのデータに自然な言葉で質問すると、証拠へ直接リンクした回答が得られます。"
+---
+
+
+エージェントのデータに自然な言葉で質問すると、証拠へ直接リンクした回答が得られます。SQLを書く必要も、ダッシュボードを掘り下げる必要もありません。**Failproof AI Observability**アシスタントは、チームの誰もがエージェントに関する答えをすばやく得るための最短の方法です。
+
+![Failproof AI Observabilityアシスタントがダッシュボード内で自然言語の質問に回答している画面。ライブのエージェントアクティビティテーブル、エージェントごとのモデル使用状況の内訳、テキストによる要点が表示され、実行したクエリもインラインで示されている](/agenteye/images/assistant.png)
+*自然な言葉で質問すると、自分のデータから構築された回答が得られます。ここでは、最もアクティブなエージェントとそれらが使用するモデルを分析し、すべての数値を確認できるよう実行したクエリも表示されます。*
+
+学習コストはゼロです。チャットを開いて知りたいことを入力するだけで、返ってきたリンクをたどれます。
+
+```
+You:  which sessions errored today?
+AI:   5 sessions errored today, newest first. Each one is linked:
+      • checkout-agent   14:02   tool timeout
+      • billing-agent    11:47   unhandled error
+      • ...and 3 more
+
+You:  summarize this session          (asked while viewing a run)
+AI:   This run took 12 steps across 3 tools and failed near the end when a
+      payment tool returned an error. It scored low on your "resolved" eval.
+      Links: the session, the failing event, and that evaluation.
+```
+
+## 質問するだけで、証拠へ直接ジャンプ
+
+推測やクエリ作成はもう不要です。「今週の本番環境でクオリティはどう推移している？」「今日エラーになったセッションはどれ？」「このセッションを要約して」と聞けば、クエリを構築して自分で読む代わりに、数秒で直接的な答えが返ってきます。
+
+すべての回答には根拠が付きます。アシスタントは回答の導出に使用した正確なセッション、保存済みクエリ、ダッシュボードへのリンクを提示するので、鵜呑みにせずクリックして確認できます。また**ページ認識機能**も備えています。セッションを閲覧中に「このセッション」について質問すると、どの実行を指しているかを自動的に把握します。履歴スイッチャーから以前の会話を再度開けば、中断したところから再開できます。
+
+## 良い回答を保存済みクエリやダッシュボードに変換
+
+回答を保存しておきたいと思ったら、アシスタントに保存を依頼してください。保存済みクエリ用のSQLを下書きしたり、それらのクエリからダッシュボードをまとめたりして、**承認 / 却下**カードを表示します。「承認」をクリックするまで何も書き込まれないので、「聞くだけ」のスピード感を保ちながら、最終決定は常に自分の手に残ります。
+
+**クエリ**ページではさらに一歩進んで、SQLの作成者として機能します。欲しいクエリを説明すると（「過去7日間のエージェント別エラー率を表示して」）、エディタに直接SQLをストリーミングし、変更を反映する前に**承認**または**却下**できるdiffビューを開きます。
+
+![ObservabilityのクエリページとそのSQLエディタ](/agenteye/images/query-lab.png)
+*クエリページ：アシスタントが下書きの読み取り専用クエリをストリーミングし、承認または却下できるエディタです。*
+
+ここで質問してSQLを作成する際には`queries:run`権限が使用されます。これはエディタの**実行**ボタンと同じ権限です。他のすべての場所でのチャットには`agent:use`が必要です。
+
+## チーム全体に安心して開放できる
+
+アシスタントが何に触れるかを心配することなく、全員に開放できます。
+
+- **閲覧できるデータのみを読み取ります。** 回答は自分の読み取り権限の範囲にスコープされるため、データへのアクセス範囲が拡大することはありません。
+- **書き込みはすべてあなたの確認を待ちます。** 保存済みクエリとダッシュボードは、明示的に承認をクリックした後にのみ作成され、このゲートをオフにする設定はありません。
+- **削除は一切できません。** 削除ツールは公開されておらず、アシスタントは削除権限を持ちません。削除操作はダッシュボード上であなたの手に委ねられています。
+- **組織の外には出ません。** アシスタントは現在表示中の組織のみを参照します。
+- **質問内容はあなただけのものです。** プロンプトと回答は自分のObservabilityデータベースに保存され、プロダクトアナリティクスは使用メタデータのみを記録し、プロンプトのテキストは記録しません。
+
+## 見つけ方
+
+アシスタントは組織配下のすべてのページ（`/<org-slug>/...`）の右端に表示されています。レールをクリックするか、`⌘J` / `Ctrl+J`を押すと全画面チャットパネルに展開され、端をドラッグしてサイズを変更できます。幅はリロード後も記憶されます。使用するには**`agent:use`**権限が必要で、権限がない場合はレールがグレーアウトされます。デプロイ環境でまだ有効化されていない場合（LLM接続が必要です）、動作するチャットの代わりにミュートされたレールが表示されます。
+
+## 関連情報
+
+- [CLIとエージェント](/ja/agenteye/cli-and-agents)
+- [クエリ](/ja/agenteye/queries)
+- [ダッシュボード](/ja/agenteye/dashboards)
+- [評価スイート](/ja/agenteye/evaluation-suite)

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

@@ -0,0 +1,54 @@
+---
+title: "監査：自動信頼性アナリスト"
+description: "Failproof AI Observabilityは、ルールを書いていなかった障害を自動的に発見し、優先順位付きで根拠のある「修正すべき項目リスト」を提供します。"
+---
+
+
+Failproof AI Observabilityは、ルールを書いていなかった障害を自動的に発見し、優先順位付きで根拠のある「修正すべき項目リスト」を提供します。まるで専任のアナリストが毎晩ログを精査し、翌朝には簡潔なリストをデスクに残してくれるようなものです。
+
+<div style={{ position: "relative", width: "100%", paddingBottom: "56.25%", height: 0, overflow: "hidden", borderRadius: "12px", margin: "1.5rem 0" }}>
+  <iframe src="https://www.youtube.com/embed/C5nHKGQIqZQ?autoplay=1&mute=1&loop=1&playlist=C5nHKGQIqZQ&rel=0&playsinline=1" title="Watch: Automatically find where your agent is failing (2 min)" allow="autoplay; encrypted-media; picture-in-picture; fullscreen" allowFullScreen style={{ position: "absolute", top: 0, left: 0, width: "100%", height: "100%", border: 0 }}></iframe>
+</div>
+
+*2分間のツアー：スケジュール実行から実際に対処できる修正案まで。*
+
+![監査ページ：セッション内の障害パターンをスキャンする定期ジョブ。スケジュールと感度設定付き](/agenteye/images/audits.png)
+*各監査は定期的に実行されるジョブで、セッションを分析して優先順位付きの根拠ある推奨事項をまとめます。*
+
+## 次に何を修正すべきか、推測をやめよう
+
+アラートは既知の問題を検知します。監査は未知の問題を検知します。設定したスケジュールに従い、監査はすべてのエージェントセッションを横断的に読み取り、修正すべきパターンを探し出します。ログをひたすらスクロールして問題を見つけようとする時間ではなく、発見した内容への対処に時間を使えるようになります。
+
+1回の実行で、本番環境でエージェントを実際に壊す障害モードを調査します：
+
+- **エラークラスター**：共通の根本原因を持つ同じ障害の繰り返し。
+- **ベースラインからのドリフト**：既知の正常ウィンドウから静かに乖離していく挙動。
+- **トランスクリプト内のゴール失敗**：技術的には完了したが、本来の目的を果たせなかった実行。
+- **ツールの誤用**：不適切なツールの選択、不正な引数、または呼び出しを無駄に消費するループ。
+- **品質とコストのトレードオフ**：より安く得られる出力に対して過剰な費用をかけている箇所。
+- **カバレッジのギャップ**：どのevalやアラートも監視していない挙動。
+
+**感度**設定（低・中・高）ひとつで調査の強度を決められます。ノイズの多いステージング環境と厳格な本番環境でそれぞれ、欲しいシグナルに合わせてチューニングできます。
+
+## すべての推奨事項には根拠が伴う
+
+発見内容を盲目的に信頼する必要はありません。各推奨事項には、その根拠となった正確なセッションとそれを発見したSQLが引用されています。主張を逆算して検証する手間なく、ワンクリックで証拠を開いて問題を確認できます。
+
+認証情報の漏洩に関する発見では、さらに一歩踏み込んでマッチした個別のイベントへのリンクが提供されます。クリックすると、セッション内のその正確な瞬間に直接ジャンプでき、長いトランスクリプトの先頭からスクロールする必要はありません。リンクにはイベント名が表示されますが、検出された秘密情報は発見内容に書き込まれることはないため、発見内容を読むことで認証情報が二重に記録される心配はありません。セッションが保持期間を過ぎてイベントが存在しない場合も、誤操作かと悩ませることなく、ページに明確に表示されます。
+
+これが監査の誠実さを保つ仕組みでもあります。サーバーは引用されたすべてのセッションの実在を確認し、**根拠が成立しない推奨事項はすべて破棄します**。監査は調査するものであり、でっち上げはしません。リストに載るのは実在して再現可能な問題であり、重要度順にランク付けされ、最大の改善効果を持つものが先頭に表示されます。
+
+## 修正をガードレールに変える
+
+問題を修正することは成果の半分に過ぎません。もう半分は、同じ問題がひっそりと再発しないようにすることです。すべての発見には**再発アラートを下書きするワンクリックショートカット**が付いており、調整可能な適切な初期トリガーがあらかじめ入力されています。発見をクローズしてアラートを有効化すれば、次にそのパターンが現れたとき、将来の監査で再発見するのではなく、通知を受け取れます。
+
+## どこで使えるか
+
+監査はダッシュボードの **`/<org-slug>/audits`**（サイドバーから *analyze* → *audits*）にあります。実行結果と発見内容の閲覧には **`audits:read`** 権限が必要です。監査の作成・編集・トリアージには **`audits:write`** 権限が必要です。監査のスコープとケイデンスを設定し、次のスケジュール実行を待たずにすぐ結果が欲しいときは **Run now** をクリックしてください。
+
+## 関連情報
+
+- [アラート](/ja/agenteye/alerts)：既知のしきい値を超えた瞬間に通知を受け取る。
+- [評価](/ja/agenteye/evaluations)：すべての実行をスコアリングして品質の低下を自動的に検出する。
+- [エラートラッキング](/ja/agenteye/error-tracking)：エージェントがスローするエラーをグループ化して追跡する。
+- [インシデント](/ja/agenteye/incidents)：監査で発見した問題を修正完了まで追跡する。

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

@@ -0,0 +1,80 @@
+---
+title: "CLI"
+description: "Failproof AI Observabilityのデプロイ全体を、コマンド一つで。"
+---
+
+
+Failproof AI Observabilityのデプロイ全体を、コマンド一つで。ターミナルを離れずに本番環境の確認、APIキーの発行、インシデントの承認が可能。CIへのスクリプト組み込みや、コーディングエージェントへの自然言語による指示にも対応しています。
+
+```bash
+pipx install agenteye
+agenteye login --email you@example.com      # 6桁のコードがメールで届きます
+agenteye --json sessions --since 24h         # 過去1日のエージェント実行一覧（新しい順）
+```
+
+*`agenteye` CLIはダッシュボードと通信します。これはサーバーにイベントを送信するコレクターとは別のツールです。*
+
+## デプロイ全体を、コマンド一つで
+
+簡単な確認のためにタブを行き来するのはもう終わりにしましょう。`agenteye` CLIは単一のバイナリからデータの参照と組織の管理を行えるため、ダッシュボードをクリックして回っていた作業が1行のコマンドになります。再実行、エイリアス登録、ランブックへの貼り付けも自由自在です。4つの機能領域を提供します：
+
+- **データの参照：** `sessions`、`events`、`evals`、`errors`を時間・エージェント・環境でフィルタリング。
+- **組織の管理：** `keys`、`users`、`settings`、`alerts`、`incidents`。
+- **分析の実行：** 保存済みSQLとイベントデータに対するアドホックな `query` ランナー。
+- **アシスタントへの質問：** `agent ask` でダッシュボード上のものと同じ読み取り専用アナリストに問い合わせ。
+
+`pipx` で一度インストールし、メールで届く6桁のコードでサインインすれば準備完了です。セッションは約1日持続します。期限切れになったら `agenteye login` を再実行してください。ブラウザを開かずに本番環境の確認、キーの発行、発火中のインシデントのトリアージが行えます：
+
+```bash
+agenteye errors --since 24h --aggregate      # エラータイプ別にグループ化して何が壊れているかを確認
+agenteye incidents list --state firing       # 現在発火中のインシデントを確認
+agenteye keys create ci --add events:add     # イベント送信専用のキーを発行（シークレットは一度だけ表示）
+```
+
+一つ覚えておくべき習慣があります：`--json` のようなグローバルオプションはコマンドの前に置きます。`agenteye --json sessions` が正しく、`agenteye sessions --json` は正しくありません。
+
+## スクリプト化してCIに組み込む
+
+すべてのコマンドは `--json` に対応しており、それがすべてを変えます。クリーンなJSONがstdoutに出力され、人間向けのステータスや警告はstderrに出力されるため、`--json` でキャプチャした出力は余計な行を取り除く必要なくそのまま `jq` にパイプできます。これにより、CLIはプロンプトで使う場合にも、出力をパースするコーディングエージェントにとっても等しく使いやすいツールになっています：
+
+```bash
+agenteye --json sessions --since 24h --status error | jq -r '.sessions[].session_id'
+```
+
+無人実行を前提に設計されています。ターミナルが接続されていない場合は確認プロンプトが自動的にスキップされるため、パイプラインで処理が止まることはありません。また、すべてのコマンドは意味のある終了コードを返します：`0` 成功、`4` 未ログイン、`5` 権限不足（メッセージに権限名が明示されます。例：`alerts:write`）、`3` ダッシュボードに接続不可。スクリプトは `4` を受け取って再認証を行ったり、`5` を受け取って管理者に何を依頼すべきかを正確に把握したりと、失敗の原因が不明なまま処理を終了せずに対処できます。
+
+## コーディングエージェントに自然言語で操作させる
+
+さらに言えば、これらのフラグをすべて覚える必要はないはずです。**CLIスキル**は `agenteye-cli` という小さなAgent Skillフォルダで、Claude CodeやCodexのようなコーディングエージェントに自然言語のリクエストからCLIを操作する方法を教えます。「今日、何か壊れているものはある？」と聞けば、エージェントが適切なコマンドを選んであなたの代わりに実行し、結果を文章で答えてくれます。
+
+Claude Codeの場合、`agenteye-cli` フォルダを `~/.claude/skills/` に置くだけで自動的に検出されます。Failproof AI Observabilityがそのフォルダを提供します。スキルはすでにインストール済みのCLIを操作するだけなので、追加でインストールするものはありません。メールコードによるログインはエージェントが代行できないため、先にご自身でログインしておいてください。
+
+エージェントはあなたのログイン権限でCLIを実行するため、読み取りも書き込みも含め、あなたが許可されているすべての操作が可能です：キーの作成、設定の変更、インシデントの解決など。エージェントに対してCLIの「本当によろしいですか？」プロンプトは表示されないため、スキルは変更を行う前に正確なコマンドを提示してあなたの承認を待つよう設計されています。確認ステップはあなた自身です。
+
+```text
+you    session run-001 が失敗した原因は？
+
+agent  Running: agenteye --json events --session-id run-001 --all
+       checkout-agentが3回目のツール呼び出しでTimeoutErrorが発生しました。
+```
+
+読み取りはすぐに実行され、書き込みはすべてあなたの確認を待ちます：
+
+```text
+you    CIにイベントの送信だけできるキーを発行して。
+
+agent  APIキーを作成します。以下のコマンドを実行します：
+         agenteye keys create ci --add events:add
+       続行してよいですか？
+
+you    yes
+
+agent  完了しました。events:addのみの権限で「ci」キーを作成しました。シークレットは一度しか表示されないため、今すぐ保存してください。
+```
+
+## 関連情報
+
+- [CLIリファレンス](/ja/agenteye/cli)：すべてのコマンド、フラグ、JSONの形式。
+- [エージェント向けCLIレシピ](/ja/agenteye/cli-recipes)：コピー＆ペーストで使える `jq` パターンと終了コードの処理方法。
+- [CLIエージェントスキル](/ja/agenteye/cli-skill)：`agenteye-cli` スキルのインストールと実行方法。
+- [AIアシスタント](/ja/agenteye/assistant)：`agent ask` が接続するダッシュボード内のアナリスト。