MadoHub Docs

Agent ルーティング

高度な変換機能を備えた AI エージェント間の自律的出力・コンテキスト連携。

Agent ルーティングは MadoHub の中核をなすオーケストレーション機能です。あるエージェントがタスクを完了すると、MadoHub はその実行結果を自動的に抽出し、構造化された実行プロンプトへと変換して後続のエージェントへシームレスに伝達します。

動作の流れ

  1. トリガー(Trigger) — 接続されたソースタイルが、設定された条件(アイドル検知、完了シグナル、正規表現一致、継続ストリーミング)に基づいて起動します。
  2. 抽出(Extract) — MadoHub がエージェントの最新出力を取得します。Claude Code 等の主要 CLI に対しては、ネイティブな構造化セッション抽出を用いてターミナルのノイズを完全に排除します。
  3. 変換(Transform) — 取得した出力を後続エージェント向けのプロンプトへ再構成します(AI 改編、テンプレート包装、直接パススルー)。
  4. 配信(Deliver) — 変換されたプロンプトは適応型ペーシングでターゲット端末へ注入され、各エージェントに応じた送信シーケンスで確実に実行されます。

高忠実度セッション抽出(High-Fidelity Session Capture)

従来の端末自動化では、画面の文字列をそのままスクレイピングするため、ANSI カラーコードやプログレスバー、改行の崩れなどのノイズが混入しがちでした。

MadoHub はネイティブな構造化セッション抽出エンジンを採用しています。

  • 純粋なコンテキスト抽出:エージェントの内部セッション記録と直接連携し、Assistant による真の思考推論、コード差分、ツール実行結果のみをクリアに抽出します。
  • ワークスペースの自動コンテキスト同期:キャンバス上のタイルと実際のプロジェクトディレクトリを自動的に照合し、引き継ぎ時にも相対パスやプロジェクト文脈の整合性を厳格に保ちます。
  • 完全非侵入型の監視:エージェントのソースコードに手を加える必要はなく、公式 CLI の安全性と安定性をそのまま維持します。

トリガー種別(Trigger Types)

種別動作と推奨シナリオ
on-idleアイドル検知(推奨):エージェントの処理完了と一定の静止時間を検知してトリガー。最も高精度で安定。
on-complete完了シグナル:エージェントが明示的に完了を出力したタイミングで即座にトリガー。
on-keywordパターン一致:出力中に指定の正規表現やキーワードが現れた瞬間にトリガー。
always継続ストリーム:出力の終了を待たず、新しく生成されたテキストをリアルタイムで常時転送。

変換種別(Transform Types)

種別説明と適用
ai-routingAI 変換(中核機能):AI モデルを活用し、後続エージェントの役割に最適化された文脈プロンプトを自動生成。設定でモデルを指定可能。
prompt-wrapテンプレート包装:ユーザー定義テンプレートで出力を包む。変数:{output}、{round}、{maxRounds}、{source}。
summaryインテリジェント要約:前段エージェントの要点と差分を AI が簡潔に要約して転送。
full-output完全転送:端末出力の末尾 30 行をそのまま転送。
rawコンパクト転送:端末出力の末尾 10 行を転送。

適応型端末配信

長大なプロンプトの送信を確実に行うため、MadoHub は端末ごとの適応型配信プロトコルを実装しています。

  • 適応型フロー制御:受け手側のターミナルバッファの状態に応じて入力速度を自動調整し、文字列の欠落や端末フリーズを防止します。
  • プロトコル最適化ハンドシェイク:Claude Code、Codex、Amp、OpenCode、標準 Shell それぞれの送信プロトコルを自動識別し、コマンドを決定論的に実行させます。

ループ保護と安全機能

エージェント間で無限ループが発生するのを防ぐため、堅牢なセーフガードを備えています。

設定項目デフォルト設定可能範囲説明
maxRounds51–20自動停止するまでの最大連携ラウンド数。トークンの無駄な消費を防止。
cooldownMs3s1–30s連続実行時の強制クールダウン秒数。急激な過負荷を防止。
stopKeyword—任意の文字列"LGTM" や "RESOLVED" などの終了キーワードを検知した時点でルーティングを即時停止。

連携ワークフローの例

ターミナル 1(Claude Code:リファクタリング) ターミナル 2(Claude Code:コードレビュー)
┌──────────────────────┐    →    ┌──────────────────────┐
│ "auth モジュールの刷新" │         │ 受信内容:             │
│                      │         │ "src/auth/ の変更点  │
│ ✓ 完了 — 3 ファイル   │         │  をレビューしてください"│
└──────────────────────┘         └──────────────────────┘

エージェント 1 のリファクタリング完了後、MadoHub が純粋なコード変更を抽出し、ai-routing を通じて具体的なレビュー指示を生成してエージェント 2 へ自動的に引き継ぎます。

On this page