failproofai 1.0.1-beta.1 → 1.0.2-beta.0

package/.next/standalone/docs-old/ja/agenteye/python-sdk.mdx

@@ -0,0 +1,433 @@
+---
+title: "Python SDK"
+description: "AIエージェントが本番環境で何をしたかを正確に把握する: すべてのエージェント実行、ツール呼び出し、モデルリクエスト、フック、および人間の介入。"
+---
+
+
+AIエージェントが本番環境で何をしたかを正確に把握する: すべてのエージェント実行、ツール呼び出し、モデルリクエスト、フック、および人間の介入。Failproof AI Observability Python SDKは、エージェントコードの内側からその実行履歴を記録し、何が起きたかをデバッグ・監査・評価できるようにします。Failproof AI Observabilityでエージェントを観測したい場合にご利用ください。
+
+内部では、SDKが構造化イベントをローカルのJSONLファイルに書き込み、コレクターデーモンがそれらを自動的に収集してプラットフォームに送信します。これらのファイルを自分で管理する必要はありません。
+
+> **ヒント:** Failproof AI Observabilityを初めてお使いですか？このページはSDKイベントの完全なリファレンスです。
+
+<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/VWxukZc5k7s?autoplay=1&mute=1&loop=1&playlist=VWxukZc5k7s&rel=0&playsinline=1" title="Watch: Agent Tracing by Failproof AI (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>
+
+---
+
+## インストール
+
+SDKは公開パッケージインデックスではなく、プライベートホイールとしてお客様に配布されます。取得・インストール・バージョン固定の方法はオンボーディングで説明しています。アクセスが必要な場合は Failproof AI の担当者にお問い合わせください。
+
+インストール後、以下で確認してください:
+
+```bash
+python -c "import agenteye; print(agenteye.__version__)"
+```
+
+コーディングエージェントに統合作業をすべて任せたい場合は、[Python SDK Agent Skill](/ja/agenteye/python-sdk-skill) をご利用ください。インストールパスを把握し、計装ポイントを計画・実装して、イベントが正しく届いているか検証します。
+
+---
+
+## クイックスタート
+
+```python
+import agenteye
+
+agenteye.configure(environment="production")
+
+agenteye.event.agent_start(session_id="run-001", agent_id="planner", goal="answer user query")
+
+agenteye.event.tool_use(
+    session_id="run-001",
+    agent_id="planner",
+    tool_name="web_search",
+    tool_call_id="toolu_01",
+    input={"query": "latest AI research"},
+)
+
+agenteye.event.tool_result(
+    session_id="run-001",
+    agent_id="planner",
+    tool_name="web_search",
+    tool_call_id="toolu_01",
+    output={"results": ["..."]},
+)
+
+agenteye.event.agent_end(session_id="run-001", agent_id="planner", outcome="success")
+```
+
+### 実際の呼び出しへの計装
+
+実際には、既存のエージェントコードをラップします。モデル呼び出しの前に `model_request`、後に `model_response` を配置することで、2つのイベントが実際のリクエストをまたぎ、Failproof AI Observabilityがペアとして関連付けられるようになります:
+
+```python
+import anthropic
+import agenteye
+
+agenteye.configure(environment="production")
+client = anthropic.Anthropic()
+
+messages = [{"role": "user", "content": "Summarise today's incidents."}]
+
+agenteye.event.model_request(
+    session_id="run-001",
+    agent_id="planner",
+    model="claude-sonnet-4-6",
+    messages=messages,
+)
+
+reply = client.messages.create(
+    model="claude-sonnet-4-6",
+    max_tokens=512,
+    messages=messages,
+)
+
+agenteye.event.model_response(
+    session_id="run-001",
+    agent_id="planner",
+    model=reply.model,
+    stop_reason=reply.stop_reason,
+    input_tokens=reply.usage.input_tokens,
+    output_tokens=reply.usage.output_tokens,
+    content=[block.model_dump() for block in reply.content],
+)
+```
+
+ツール呼び出しも同様に `tool_use` と `tool_result` でラップし、ペア間で同じ `tool_call_id` を使い回します。
+
+ダッシュボードに届いたイベントは、タイプ別に色分けされ、環境・エージェント・セッションでフィルタリングできます:
+
+![ライブイベントストリーム。イベントタイプ別に色分けされ、環境・エージェント・セッションでフィルタリング可能](/agenteye/images/events-stream.png)
+
+---
+
+## configure()
+
+```python
+agenteye.configure(
+    base_dir=None,           # Path | str | None. デフォルト: $AGENTEYE_HOME または ~/.agenteye
+    flush_interval=0.5,      # float, フラッシュサイクルの間隔（秒）
+    environment=None,        # str | None. デプロイ環境ラベル
+)
+```
+
+`event.*` を呼び出す前に一度だけ呼び出してください。省略しても問題ありません。デフォルト設定でそのまま動作します。すべての引数はキーワード専用です。上記のように名前で渡してください。
+
+`base_dir` が `None`（デフォルト）の場合、SDKは `$AGENTEYE_HOME` が設定されていればそれを使用し、未設定の場合は `~/.agenteye` にフォールバックします。これはコレクター自身の解決方法と一致しているため、`AGENTEYE_ENVIRONMENT` 環境変数ひとつで SDK とコレクター両方のイベントスプールを共有設定できます。
+
+---
+
+## 環境
+
+すべてのイベントにデプロイ環境のラベルを付けます（`production`、`staging`、`qa`、`canary` など）。一度設定するだけで、SDKがすべてのイベントに自動的に付加します。
+
+**オプション1: `configure()` 経由:**
+
+```python
+agenteye.configure(environment="production")
+```
+
+**オプション2: 環境変数経由:**
+
+```bash
+export AGENTEYE_ENVIRONMENT=production
+```
+
+**優先順位:** `configure(environment=...)` が環境変数より優先されます。どちらも設定されていない場合、デフォルトは `"dev"` です。
+
+環境の値はダッシュボードのファーストクラスフィルターとして表示され、高速クエリのためサーバーに保存されます。
+
+> **警告:** 環境の値にリテラルのカンマ `,` を含めることはできません。ダッシュボードのフィルターはワイヤー上でカンマ区切りのマルチセレクトを使用するため（`?environment=prod,staging`）、`prod,blue` という名前の環境は2つの値に分割されます。カンマを含む環境名のイベントはインジェスト時に拒否されます。
+
+---
+
+## データとプライバシー
+
+SDKは明示的に渡したフィールドのみを記録します。プロンプト、メッセージ、ツールの入出力、モデルのコンテンツは、`event.*` 呼び出しに渡した場合にのみキャプチャされます。プロセスからの暗黙的な読み取りやキャプチャは一切行いません。未設定のフィールドはイベントから完全に省略され、ディスクに書き込まれません。
+
+そのため、データのマスキングはお客様の判断と責任で行ってください。プロンプトやツールのペイロードに保存したくないPIIや機密情報が含まれている場合は、イベントメソッドに渡す前にそれらを除去またはマスクしてください。
+
+---
+
+## イベントリファレンス
+
+ほとんどのイベントは相関IDを共有する開始/終了ペアで構成されています: `tool_use` と `tool_result` は `tool_call_id` を共有し、`hook_triggered` と `hook_completed` は `hook_id` を共有し、`human_wait` と `human_input` は `input_id` を共有します。開始イベントを発行し、処理を実行してから、同じIDで終了イベントを発行してください。Failproof AI Observabilityがペアを照合し `duration_ms` を自動計算するため、`duration_ms` を自分で渡す必要はありません。
+
+![セッションのgit形式の実行グラフとイベントタイムライン。ペアイベントから再構築され、ツール・モデル・フックの内訳パネルを表示](/agenteye/images/session-detail.png)
+
+すべてのイベントメソッドに以下の2フィールドが必須です:
+
+| フィールド | 型 | 説明 |
+|---|---|---|
+| `session_id` | `str` | トップレベルのエージェント実行を識別する |
+| `agent_id` | `str` | セッション内でイベントを発行したエージェントを識別する |
+
+すべてのメソッドはカスタムメタデータ用の任意の `**kwargs` も受け付けます（[カスタムフィールド](#custom-fields) 参照）。
+
+---
+
+### `event.agent_start()`
+
+エージェントが作業を開始したときに発行されます。
+
+```python
+agenteye.event.agent_start(
+    session_id="run-001",
+    agent_id="planner",
+    goal="answer user query",   # str | None
+    parent_id=None,             # str | None - ネストされたエージェントの親 agent_id
+)
+```
+
+---
+
+### `event.agent_end()`
+
+エージェントが作業を完了したときに発行されます。
+
+```python
+agenteye.event.agent_end(
+    session_id="run-001",
+    agent_id="planner",
+    outcome="success",          # str | None
+    summary="Answered query",   # str | None
+)
+```
+
+---
+
+### `event.tool_use()`
+
+エージェントがツールを呼び出したときに発行されます。`tool_result` とペアにしてください。SDKが `duration_ms` を自動計算します。
+
+```python
+agenteye.event.tool_use(
+    session_id="run-001",
+    agent_id="planner",
+    tool_name="web_search",     # str, 必須
+    tool_call_id="toolu_01",    # str, 必須 - 対応する tool_result との相関キー
+    input={"query": "..."},     # dict | None
+)
+```
+
+---
+
+### `event.tool_result()`
+
+ツールが返答したときに発行されます。`tool_call_id` を通じて `tool_use` と関連付けられます。
+
+```python
+agenteye.event.tool_result(
+    session_id="run-001",
+    agent_id="planner",
+    tool_name="web_search",
+    tool_call_id="toolu_01",        # 対応する tool_use と一致させる必要があります
+    output={"results": ["..."]},    # Any | None
+    error=None,                     # str | None - ツールが例外を発生させた場合に設定
+    # duration_ms は自動計算されます - 渡さないでください
+)
+```
+
+---
+
+### `event.model_request()`
+
+LLMにプロンプトを送信する直前に発行されます。
+
+```python
+agenteye.event.model_request(
+    session_id="run-001",
+    agent_id="planner",
+    model="claude-sonnet-4-6", # str | None - 任意のプロバイダー/モデル文字列。検証なし
+    messages=[                   # list[dict] | None - 会話のターン
+        {"role": "user", "content": "..."},
+    ],
+    system="You are helpful.",   # Any | None - 文字列またはコンテンツブロックのリスト
+    tools=[                      # list[dict] | None - モデルに提供するツールスキーマ
+        {"name": "search", "input_schema": {"type": "object"}},
+    ],
+)
+```
+
+`messages` のエントリはプレーン文字列の `content` でも、Anthropic形式のブロックリストの `content` でも受け付けます。サンプリングパラメータ（`temperature`、`max_tokens` など）は追加のkwargsとして渡せます。
+
+---
+
+### `event.model_response()`
+
+LLMがレスポンスを返したときに発行されます。
+
+```python
+agenteye.event.model_response(
+    session_id="run-001",
+    agent_id="planner",
+    model="claude-sonnet-4-6", # str | None - 任意のプロバイダー/モデル文字列。検証なし
+    stop_reason="end_turn",     # str | None
+    input_tokens=1024,          # int | None
+    output_tokens=256,          # int | None
+    content=[                    # Any | None - 文字列またはコンテンツブロックのリスト
+        {"type": "text", "text": "..."},
+    ],
+    role="assistant",            # str | None
+)
+```
+
+`content` はプレーン文字列（汎用プロバイダー）またはAnthropic形式のコンテンツブロックのリストを受け付けます。ツール呼び出しは `{"type": "tool_use", ...}` ブロックとして `content` 内に含まれます。別途 `tool_calls` フィールドはありません。
+
+---
+
+### `event.hook_triggered()`
+
+フックが発火したときに発行されます。`hook_completed` とペアにしてください。SDKが `duration_ms` を自動計算します。
+
+```python
+agenteye.event.hook_triggered(
+    session_id="run-001",
+    agent_id="planner",
+    hook_name="pre_tool_use",   # str, 必須
+    hook_id="hook-abc",         # str, 必須 - 相関キー
+    trigger_event="tool_use",   # str | None
+    input={"tool": "search"},   # Any | None
+)
+```
+
+---
+
+### `event.hook_completed()`
+
+フックが完了したときに発行されます。`hook_id` を通じて `hook_triggered` と関連付けられます。
+
+```python
+agenteye.event.hook_completed(
+    session_id="run-001",
+    agent_id="planner",
+    hook_name="pre_tool_use",
+    hook_id="hook-abc",         # 対応する hook_triggered と一致させる必要があります
+    outcome="allow",            # str | None
+    output=None,                # Any | None
+    error=None,                 # str | None
+    # duration_ms は自動計算されます - 渡さないでください
+)
+```
+
+---
+
+### `event.error()`
+
+未処理のエラーが発生したときに発行されます。
+
+```python
+agenteye.event.error(
+    session_id="run-001",
+    agent_id="planner",
+    error_type="TimeoutError",  # str, 必須
+    message="timed out",        # str, 必須
+    traceback="Traceback...",   # str | None
+)
+```
+
+---
+
+## ヒューマン・イン・ザ・ループ イベント
+
+ヒューマン・イン・ザ・ループイベントは、エージェントの実行に人間が介入する瞬間（承認待ち、入力提供、一時停止、またはエージェントの停止）を監視するためのものです。これらのイベントにより、人間が応答するまでの時間を計測し（SDKがペアイベントの `duration_ms` を自動計算します）、誰がエージェントを一時停止または中断したかを監査し、ダッシュボードに表示される承認・監視ワークフローを構築できます。
+
+### `event.human_wait()`
+
+エージェントが人間からの入力を待つために実行を一時停止したときに発行されます。`human_input` とペアにしてください。SDKが `duration_ms`（人間が応答するまでの時間）を自動計算します。
+
+```python
+agenteye.event.human_wait(
+    session_id="run-001",
+    agent_id="planner",
+    input_id="inp-abc",                          # str, 必須 - 対応する human_input との相関キー
+    prompt="Do you approve this action?",        # str | None - 人間に表示される質問
+    options=["approve", "reject", "defer"],      # list[str] | None - 人間に提示される選択肢
+    reason="approval_required",                  # str | None - 待機している理由
+)
+```
+
+### `event.human_input()`
+
+人間が入力を提供してエージェントが再開したときに発行されます。`input_id` を通じて `human_wait` と関連付けられます。`duration_ms` は自動計算されるため、呼び出し元から渡してはいけません。
+
+```python
+agenteye.event.human_input(
+    session_id="run-001",
+    agent_id="planner",
+    input_id="inp-abc",    # str, 必須 - 対応する human_wait と一致させる必要があります
+    response="approve",    # str | None - 人間の回答（自由テキストまたは選択肢）
+    # duration_ms は自動計算されます - 渡さないでください
+)
+```
+
+### `event.human_pause()`
+
+人間がエージェントを能動的に一時停止したとき（例: ダッシュボードのコントロール経由）に発行されます。エージェントは中断されますが、終了はしません。
+
+```python
+agenteye.event.human_pause(
+    session_id="run-001",
+    agent_id="planner",
+    reason="user_requested",  # str | None
+    user_id="usr_42",         # str | None - エージェントを一時停止した人
+)
+```
+
+### `event.human_interrupt()`
+
+人間がエージェントの実行中に能動的に停止させたときに発行されます。`human_pause` とは異なり、エージェントの作業は中断ではなく終了します。
+
+```python
+agenteye.event.human_interrupt(
+    session_id="run-001",
+    agent_id="planner",
+    reason="output_incorrect",       # str | None
+    user_id="usr_42",                # str | None - エージェントを中断した人
+    at_step="tool_use:web_search",   # str | None - 停止時にエージェントが実行していた処理
+)
+```
+
+---
+
+## カスタムフィールド
+
+追加のキーワード引数は、標準フィールドの後にイベントへ付加されます:
+
+```python
+agenteye.event.tool_use(
+    session_id="run-001",
+    agent_id="planner",
+    tool_name="db_query",
+    tool_call_id="toolu_02",
+    tenant_id="acme",           # カスタムフィールド
+    region="us-east-1",         # カスタムフィールド
+)
+```
+
+`timestamp`、`type`、`environment` は予約済みであり、カスタムフィールドとして渡すと `ValueError`（`Reserved field names cannot be used as custom fields: [...]`）が発生します。`session_id` と `agent_id` はすべてのイベントメソッドの必須パラメータであり、2回渡すことはできません。その場合、Pythonは `TypeError` を発生させます。環境の設定には `configure(environment=...)` または `AGENTEYE_ENVIRONMENT` 変数を使用してください。
+
+ペイロードのフィールドをクエリしたい場合は、構造化JSONで保持してください。JSON がネイティブにサポートしない値（日時、UUID、Decimal、セット、バイト、モデルオブジェクトなど）は文字列に変換されるため、記録は安全に続行されます。
+
+---
+
+## イベントの書き込み方法
+
+イベントはプロセス内でバッファリングされ、`flush_interval` 秒ごと（デフォルト500ms）にディスクにフラッシュされます。各フラッシュは1つのJSONLファイルを書き込みます:
+
+```text
+~/.agenteye/events/event-2026-04-01T12-00-00-000Z.jsonl
+```
+
+コレクターはこのディレクトリを監視し、ファイルを自動的にアップロードします。これらのファイルを直接管理する必要はありません。
+
+各ファイルはアトミックに書き込まれます: SDKは一時ファイルに書き込んだ後、所定の場所にリネームするため、コレクターが書きかけのファイルを読み取ることはありません。プロセス終了時にも最終フラッシュが実行されるため、最後のインターバルでバッファリングされたイベントが失われることはありません。コレクターがオフラインの場合、イベントはディスク上にファイルとして蓄積され、コレクターが復帰次第送信されます。
+
+---
+
+## 次のステップ
+
+- [イベントストリーム](/ja/agenteye/event-stream): これらのイベントがリアルタイムで届く様子を、タイプ別の色分けと環境・エージェント・セッションによるフィルタリングで確認できます。
+- [セッション](/ja/agenteye/sessions): ペアイベントが各エージェント実行を実行グラフとタイムラインとしてどのように再構築するかを確認できます。

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

@@ -0,0 +1,56 @@
+---
+title: "クエリ"
+description: "エージェントデータに関するあらゆる質問を投げかけ、数秒で答えを得られます。"
+---
+
+
+エージェントデータに関するあらゆる質問を投げかけ、数秒で答えを得られます。Failproof AI のオブザーバビリティ機能は、イベントや評価に対してすぐに実行できる保存済みクエリのライブラリを提供しているため、空のSQLエディタではなく実際に動くサンプルからスタートできます。
+
+![保存済みクエリライブラリ: 組み込みプリセットとカスタムクエリが並んだグリッド表示](/agenteye/images/queries.png)
+
+*`/<org-slug>/queries` の保存済みクエリライブラリ: 組み込みプリセットとチームが保存したクエリが並んで表示されます。*
+
+## 白紙のページではなく、プリセットから始める
+
+テーブル名を覚えたり、SQLをゼロから書いたりする必要はありません。ライブラリを開くと、よく聞かれる質問に対応した組み込みプリセットが、チームが保存・命名したクエリの隣にすぐ表示されます。目的に近いものを選べば、答えまでの道のりの大半はすでに終わっています。
+
+保存済みクエリはすべてorg単位でスコープされ共有されるため、チームメンバーが書いた便利なクエリはそのままあなたのものにもなります。クエリに名前と説明を一度付けておけば、組織内の誰でも検索・実行でき、後からダッシュボードに結果をピン留めすることもできます。
+
+`/<org-slug>/queries` からアクセスできます。
+
+## SQLコンポーザーで調整して実行する
+
+クエリを開くとSQLコンポーザーに読み込まれ、その場で調整して即座に結果を確認できます。エクスポートも往復も、他の誰かを待つ必要もありません。
+
+![保存済みクエリを実行中のSQLクエリコンポーザー。スキーマサイドバーとライブ結果グリッドが表示されている](/agenteye/images/query-lab.png)
+
+*SQLコンポーザー: 左側にクエリ、列名を調べる手間を省くスキーマサイドバー、そして下部にライブ結果グリッド。*
+
+- **スキーマサイドバー**にはアナリティクステーブルとその列が一覧表示されるため、フィールド名を探し回ることなくクエリを組み立てられます。
+- **ライブ結果グリッド**は実行した瞬間に行を返すため、試行錯誤を繰り返すのではなく数秒で改善できます。
+- **設計上の読み取り専用。** クエリはイベントストアに対して実行され、サーバー側で検証されます。`SELECT` と `WITH` 文のみが許可されており、ステートメントタイムアウトと行数上限が設けられています。探索的なクエリがデータを変更することは一切なく、暴走したクエリは自動的に停止されます。
+
+結果に満足したら、チーム全体が使えるようにライブラリへ保存するか、出力をダッシュボードにライン・棒グラフ・エリア・円グラフのタイルとしてピン留めしましょう。
+
+## ターミナルから実行する、またはアシスタントに書いてもらう
+
+保存済みクエリはどこで作業していても同じものを利用できます:
+
+- **ターミナルから。** `agenteye` CLIを使えば、同じ保存済みクエリの一覧表示・実行・保存が可能なため、結果をスクリプトに組み込んだり、CIに連携したり、コーディングエージェントに渡したりできます。
+
+```bash
+agenteye query list                 # the same saved queries, from your terminal
+agenteye query run errs --arg prod  # run one and print the rows (add --json to pipe it)
+```
+
+  フルコマンドセットは [CLI and agents](/ja/agenteye/cli-and-agents) を参照してください。
+
+- **AIアシスタントから。** SQLの書き方が分からない場合は、ダッシュボード内の [AIアシスタント](/ja/agenteye/assistant) に平易な言葉で質問するだけで、クエリを下書きしてライブラリに保存してくれます。
+
+保存済みクエリの実行は `queries:run` 権限によって管理されており、クエリの作成・削除に必要な権限とは分離されています。そのため、ライブラリの書き換えを許可することなく読み取りアクセスのみを付与できます。
+
+## 関連情報
+
+- [ダッシュボード](/ja/agenteye/dashboards): クエリ結果をorg全体で共有するグラフにピン留めする。
+- [AIアシスタント](/ja/agenteye/assistant): 平易な言葉で質問し、クエリを取得する。
+- [CLI and agents](/ja/agenteye/cli-and-agents): ターミナルから同じクエリを実行・保存する。

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

@@ -0,0 +1,68 @@
+---
+title: "セキュリティ"
+description: "Failproof AI Observabilityはプロダクション環境のエージェントの近くに配置されるため、プロンプト、ツールの入力、出力を参照します。"
+---
+
+
+Failproof AI Observabilityはプロダクション環境のエージェントの近くに配置されるため、プロンプト、ツールの入力、出力を参照します。このページでは、データの隔離・制御・管理方法について説明します。セキュリティレビューのためにFailproof AI Observabilityを評価している場合は、まずここをお読みください。
+
+---
+
+## データはあなたの環境に留まる
+
+Failproof AI Observabilityはセルフホスト型です。イベント、プロンプト、モデルのレスポンス、アナリティクスはすべて、あなた自身のデータベースおよび環境に保存されます。サードパーティのSaaSにデータが送信されることはなく、データは常にあなた自身のクラウドアカウント内に留まります。
+
+---
+
+## テナント分離
+
+1つのFailproof AI Observabilityインスタンスで複数の組織をホストできます。各組織はストレージ層で分離されており、UIではなくデータベース自体によって強制されます。
+
+- 組織の運用データ（ユーザー、APIキー、ダッシュボード、保存済みクエリ）はその組織にスコープされており、組織をまたいだ読み取りはデータベース自体によってブロックされます。
+- 取り込まれたすべてのイベントには所有組織のスタンプが押されるため、ある組織のイベントを別の組織が読み取ることはできません。
+
+すべてのダッシュボードルートは組織スラグ（`/<org-slug>/…`）の配下にスコープされています。
+
+---
+
+## サインイン
+
+Failproof AI Observabilityはパスワードレスのメールベースサインインを採用しています。フィッシングやリークの対象となるパスワードは存在しません。ユーザーがワンタイムコード（またはワンクリックマジックリンク）をリクエストすると、それがメールで送信され、短時間で失効します。サインインは**許可リスト**によって制御されており、あなたが許可したメールアドレス（またはドメイン）のみが認証できます。
+
+![Failproof AI Observabilityのサインイン画面。メールアドレスに使い捨てコードを送信します](/agenteye/images/login.png)
+
+---
+
+## APIキーによるスコープ付きアクセス
+
+すべてのクライアントは、きめ細かな最小権限を持つAPIキーで認証します。コレクターには`events:add`のみが必要です。ダッシュボードやアシスタント用のキーは読み取り専用にできます。破壊的な操作（削除、再生成）は、明示的に付与を選択する別個の権限です。
+
+![APIキーページ：各キーの権限付与が読み取り・書き込み・破壊的スコープごとに色分けされています](/agenteye/images/api-keys.png)
+
+管理者のブートストラップキーはセットアップ用に保持し、その他の用途には権限を絞ったキーを発行してください。詳しくは[APIキー](/ja/agenteye/api-keys)をご覧ください。
+
+---
+
+## 読み取り専用・承認ゲート付きアシスタント
+
+ダッシュボード内の[AIアシスタント](/ja/agenteye/assistant)はデータに関する質問に回答しますが、設計上の制約があります。
+
+- **デフォルトで読み取り専用**：実行されるSQLはガードを通過し、`SELECT`/`WITH`クエリのみ、単一ステートメント、行数上限付きで許可されます。
+- アシスタントが作成するもの（保存済みクエリ、ダッシュボードなど）はすべて**承認ゲート付き**：書き込みが行われる前に、あなたがすべての内容を確認・承認します。
+- アシスタントは**削除を行うことができません**。
+
+そのため、チームメンバーが「今週最もエラーが多かったエージェントはどれか？」と質問して結果を活用できる一方、アシスタントが自律的にデータを変更・削除することはありません。
+
+---
+
+## 転送中のセキュリティ
+
+すべてのトラフィックはHTTPSで通信されます。TLSはあなた自身の証明書で終端するため、コレクターからサーバーへの通信、およびブラウザからサーバーへの通信は転送中に暗号化されます。
+
+---
+
+## 次のステップ
+
+- [概要](/ja/agenteye/overview)：Failproof AI Observabilityの全体像
+- [APIキー](/ja/agenteye/api-keys)：コレクター、ダッシュボード、アシスタントへのアクセスのスコープ設定
+- [オブザーバビリティ](/ja/agenteye/observability)：Failproof AI Observabilityがエージェントから収集する情報

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

@@ -0,0 +1,57 @@
+---
+title: "セッションと実行グラフ"
+description: "1回の実行で発生したすべてのイベントを1行にまとめ、git スタイルの実行グラフとして数秒で把握できるように可視化します。"
+---
+
+
+実行が失敗した原因を推測するのはもう終わりです。Failproof AI Observability は、1回の実行で発生したすべてのイベントを読みやすい1行にまとめ、実行全体を git スタイルの図として数秒で把握できるように描画します。エージェントが何をどの順番で行ったか、ステップごとに正確に確認できます。
+
+![セッション一覧：環境やエージェントをまたいで1実行1行で表示され、ステータスのバッジと評価スコアのバッジが付く](/agenteye/images/sessions-list.png)
+
+*1実行1行：ステータスのバッジで実行の結果が一目でわかり、評価器を接続するとスコアバッジも表示されます。*
+
+<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/VWxukZc5k7s?autoplay=1&mute=1&loop=1&playlist=VWxukZc5k7s&rel=0&playsinline=1" title="Watch: Agent Tracing by Failproof AI (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>
+
+*エージェントのトレーシング：ゴールからツール、最終的な回答まで、1回の実行をステップごとに追跡します。*
+
+---
+
+## すべての実行を一目で把握する
+
+生のイベント履歴はすべてのステップの真実を記録していますが、数十の実行にわたって何千ものステップがある場合は、個々のステップではなく実行単位での把握が必要です。セッションページは、1回の実行のすべてのイベントを1行にまとめます。これにより、1日分のアクティビティが大量のログではなくスキャンしやすいリストとして表示されます。
+
+各行にはステータスのバッジが付いており、クリックする前から失敗した実行と正常な実行を区別できます。日付範囲・環境・エージェント・セッションでフィルタリングすることで、「すべての実行」から「確認したい実行」へ数クリックで絞り込めます。
+
+評価器を接続すると、完了したすべての実行が自動的にスコアリングされ、最新のスコアがバッジとして行に表示されます。スコアの範囲でフィルタリングできるため、「今週の本番環境で低スコアのすべての実行を表示」はフィルター操作で完結し、手動レビューは不要です。評価器を設定する前でも、セッションは実行の完全な記録を保持します。スコアバッジが付かないだけです。
+
+---
+
+## 実行全体を図として読む
+
+![セッションの git スタイルの実行グラフとイベントタイムラインが並び、右側にはツール・モデル・フックの内訳パネルが表示される](/agenteye/images/session-detail.png)
+
+*実行グラフ（左）はイベントタイムラインの隣に表示され、右側のパネルには実行で使用されたツール・モデル・フックおよびトークン消費量の内訳が表示されます。*
+
+セッションをクリックすると実行グラフが開きます。エージェント・ツール・フック・モデル呼び出しが時系列でどのように展開されたかを git スタイルで可視化したものです。並列サブエージェントはそれぞれ独自のレーンに分岐するため、どの処理が並行して実行されたか、どのサブエージェントが停止したか、実行がどこで問題に陥ったかを、大量のログを頭の中で追うことなく把握できます。
+
+右側のパネルでは実行単位の内訳を確認できます。使用されたツールとモデル、発火したフック、トークン消費量が表示されます。「この実行のコストはなぜこんなに高いのか」「遅いツールはどれか」という疑問への答えが、その原因となったグラフのすぐ隣に置かれています。
+
+個々のイベントはアドレス指定が可能なため、「セッションの3分の2くらいのところ」という曖昧な説明ではなく、特定の瞬間へのリンクを共有できます。任意のイベントからリンクをコピーするか、[監査](/ja/agenteye/audits)の検出結果やエラーのリンクをたどると、そのイベントが選択・スクロールされた状態でセッションが開きます。非常に長い実行でも同様に機能します。タイムラインはブラウザへの負荷を考慮して一定範囲のウィンドウを読み込みますが、そのウィンドウ外を指すリンクでも、先頭に戻されることなく対象のイベントを見つけます。イベントが保持期間を過ぎている場合は、何も選択されないまま終わるのではなく、その旨がページに表示されます。
+
+---
+
+## 見つけ方
+
+すべてのダッシュボードページは組織単位 (`/<org-slug>/…`) でスコープされています。セッションは左サイドバーの **Observe** にあり、Events の隣に配置されています。リストの上部には日付範囲・環境・エージェント・セッションのフィルターが並んでいます。各行を1クリックで完全な実行グラフにアクセスできます。
+
+スコアバッジとスコア範囲によるフィルタリングを有効にするには、評価器を接続してください。詳細は [評価](/ja/agenteye/evaluations) を参照してください。
+
+---
+
+## 関連情報
+
+- [イベントストリーム](/ja/agenteye/event-stream)：各セッションの元となる、ステップごとの生の履歴。
+- [評価](/ja/agenteye/evaluations)：評価器を接続して、各実行にフィルタリング可能なスコアバッジを付与する。
+- [テレメトリ](/ja/agenteye/telemetry)：エージェントの実行がこれらのセッションに取り込まれるまでの仕組み。