マルチエージェント・パターン決定記録（PDR）
マルチエージェント協調パターンの選定を1件記録するためのテンプレートです。重要なのは、選択した案が「先進的」であることを示すのではなく、現在の制約下で、より単純なベースラインより適している理由と、どの時点でフォールバックすべきかを明確にすることです。
1. 基本情報
| フィールド |
内容 |
| PDR 番号 |
PDR-000 |
| 決定名 |
|
| ステータス |
Proposed / Accepted / Superseded |
| 日付 |
|
| 決定者 |
|
| 関連する ADR / 要件 / インシデント |
|
2. タスクと制約
目標
複数の Agent を検討する理由
| 境界の候補 |
該当するか |
エビデンス |
| ドメイン境界 |
|
|
| データ境界 |
|
|
| ツール境界 |
|
|
| 権限境界 |
|
|
| 状態境界 |
|
|
| 障害境界 |
|
|
| チーム境界 |
|
|
主要な制約
- レイテンシ / SLO：
- コスト予算：
- データと権限：
- リスクと承認：
- 可用性と縮退運転：
- エビデンスと監査：
3. 制御モデル
| 問い |
決定 |
| 次のステップを決めるのは誰か？ |
|
| 全体目標と結果を所有するのは誰か？ |
|
| Agent をどのように接続するか？ |
|
| 各 Agent の実際の境界は何か？ |
|
| どのように完了、部分完了、または停止とするか？ |
|
4. 候補案
| 案 |
利点 |
リスク / コスト |
検証対象とするか |
| 決定論的ワークフロー |
|
|
|
| 単一 Agent |
|
|
|
| Handoff |
|
|
|
| Supervisor |
|
|
|
| Router + Fan-Out/Join |
|
|
|
| その他 |
|
|
|
5. 決定
選択したパターンと組み合わせ方
より単純なベースラインを選ばない理由
所有権と状態の書き込み主体
| 状態 / 成果物 |
所有者 |
並行処理とバージョン戦略 |
| Global Task |
|
|
| Agent Local State |
|
|
| Delegation Ledger |
|
|
| Artifact / Evidence |
|
|
| Policy / Approval |
|
|
協調契約
- Delegation Contract：
- Result Contract：
- Evidence Contract：
- Join Contract：
権限とリスクの境界
- 委譲後の有効権限の算出方法：
- 再委譲を許可するか：
- 自動実行を許可する最高リスクレベル：
- 人手による承認ポイント：
6. 障害と収束
| シナリオ |
対応 |
| 単一 Agent のタイムアウト |
|
| 不正な Result Schema |
|
| エビデンスの競合 |
|
| 依存先が利用不能 |
|
| メッセージ / 結果の重複 |
|
| 予算の枯渇 |
|
| 進展がない状態の継続 |
|
| 高リスク操作が未承認 |
|
7. 検証計画
| 指標 |
単純なベースライン |
目標 |
観測期間 |
| タスク成功率 |
|
|
|
| 結果のエビデンスカバー率 |
|
|
|
| エンドツーエンドレイテンシ P95 |
|
|
|
| タスク単位コスト P95 |
|
|
|
| 縮退運転での完了率 |
|
|
|
| 許可されていない副作用 |
|
0 |
|
障害注入
8. フォールバックと再評価
フォールバック方法
再評価の条件
- マルチエージェントにより品質またはレイテンシが大幅に改善されない。
- 協調コストが便益を上回る。
- Supervisor / Join が主要なボトルネックになる。
- 権限、エビデンス、または状態の境界を継続的に満たせない。
- ビジネス目標、リスクレベル、またはチームの所有権が変化する。
9. 結果