因果ツリーエンジン

因果ツリーエンジン (Causal Tree Engine, CTE) は、最終応答をコミットする前に複数の応答戦略を並列評価する投機的実行システムです。PRX エージェントパイプラインのインテント分類と LLM 呼び出しの間に統合されます。

デフォルトで無効。 CTE はオプトイン機能です。設定ファイルで causal_tree.enabled = true を設定して有効にしてください。

動作フロー

スナップショット → 展開 → リハーサル → スコアリング → 選択 → フィードバック

1. スナップショット — 現在の因果状態をキャプチャ（セッションコンテキスト、予算、制約）
2. 展開 — 候補ブランチを生成（直接回答、ツール使用、サブエージェント委任など）
3. リハーサル — 有望なブランチの軽量「ドライラン」を読み取り専用モードで実行
4. スコアリング — 信頼度、コスト、レイテンシの加重複合でブランチをランク付け
5. 選択 — 最高スコアのブランチが閾値を満たせばコミット、そうでなければフォールバック
6. フィードバック — オブザーバビリティと将来の学習のために決定をログ記録

CTE を有効にすべきタイミング

シナリオ	推奨
シンプルな Q&A、カジュアルチャット	CTE を無効のまま
マルチステップツール使用ワークフロー	CTE を有効化
自律エージェントタスク（Xin / 自己進化）	CTE を有効化
コスト重視のデプロイ	CTE を有効化し extra_token_ratio_limit を厳しく設定

クイックスタート

PRX 設定ファイル（~/.openprx/config.toml）に追加：

[causal_tree]
enabled = true

その他のパラメータにはすべて適切なデフォルト値があります。完全なパラメータリストは設定リファレンスを参照してください。

サーキットブレーカー

CTE にはカスケード障害を防止する組み込みサーキットブレーカーがあります：

• circuit_breaker_threshold 回連続失敗後（デフォルト：5回）、CTE がトリップし全リクエストがバイパス
• circuit_breaker_cooldown_secs（デフォルト：60秒）経過後、サーキットブレーカーがリトライを許可
• 1回の成功で失敗カウンターがリセット

メトリクス

メトリクス	説明
hit_at_1_ratio	第1位ブランチが正解だった割合
hit_at_3_ratio	正解ブランチがトップ3に含まれた割合
wasted_speculation_ratio	実行されたが使用されなかったリハーサルの割合
commit_success_rate	コミット成功率
avg_extra_latency_ms	実行あたりの平均追加レイテンシ
circuit_breaker_trips	サーキットブレーカーがトリップした回数

関連ページ

• 設定リファレンス
• エージェントランタイム
• LLM ルーター
• オブザーバビリティ