SKILL.md — Agha Actor Model: 並行エージェントシステム設計
決定ポイント
タスクタイプに基づくアクター作成戦略の選択
タスクに逐次依存関係がある場合:
├─ 顧客パターンを使用: 応答アドレス付きで子アクターを作成
├─ 子アクターに顧客アドレスをパラメータとして渡す
└─ 子アクターは結果を(親ではなく)顧客に直接送信
タスクに長時間計算が必要な場合:
├─ 計算用の非感受性アクターを作成
├─ 受信メッセージをバッファアクターに転送
└─ 計算完了時にバッファから再開
タスクに動的リソース割り当てが必要な場合:
├─ オンデマンドでリソースマネージャーアクターを作成
├─ 機能(アドレス)をメッセージデータとして渡す
└─ 中央レジストリなし - アドレスはシステム内を流れる
タスクに障害分離要件がある場合:
├─ リスクの高い操作には監視付き子アクターを生成
├─ 監視者は応答の欠如によって障害を検出
└─ 他のアクターに影響を与えずに障害アクターを交換
既存のエージェントシステムを構成する場合:
├─ インターフェースが因果構造を維持しているか検証
├─ (単独動作だけでなく)合成下での動作をテスト
└─ メッセージプロトコルを(共有状態ではなく)境界として使用
メッセージ送信 vs 状態置き換えの決定木
他のエージェントとの調整が必要な場合:
├─ メッセージを**送信**(先にローカル状態を変更しない)
├─ 応答が必要な場合は応答アドレスを含める
└─ メッセージの順序を決して仮定しない
ローカル計算が必要な場合:
├─ 置き換え動作を**指定**
├─ 新しい状態をカプセル化(内部を公開しない)
└─ 一度に一つのメッセージ処理を保証
動的スケーリングが必要な場合:
├─ 特定の動作を持つ新しいアクターを**作成**
├─ 必要なアドレスを新しいアクターに渡す
└─ 共有初期化状態なし
障害モード
1. 中央オーケストレーターアンチパターン
検出方法: 一つのアクターがすべてのメッセージをルーティングしたり、すべてのシステム状態を保持している場合 症状: 単一障害点、負荷時のボトルネック、無限再帰問題 修正方法: それぞれがローカルコンテキストのみを知るアクターコミュニティに分解し、機能ルーティングを使用
2. 同期ブロッキングの誤謬
検出方法: アクターが置き換え動作を指定する代わりに、応答を待機/ブロックする場合 症状: 負荷時のデッドロック、隠れたタイミング仮定、並行性の低下 修正方法: リクエスト-リプライメッセージペアとしてモデル化し、依存関係には顧客パターンを使用し、非感受性アクターパターンを適用
3. 共有状態汚染
検出方法: 複数のアクターが同じデータ構造を読み書きする場合(ロックを使用していても) 症状: 競合状態、逐次ボトルネック、隠れたグローバル状態 修正方法: 単一アクターに状態をカプセル化し、調整にはメッセージパッシングを使用、相互排除は無料
4. 出力のみの検証
検出方法: テストが相互作用パターンをチェックせずに最終出力のみを比較する場合 症状: Brock-Ackerman異常 - 同じ出力でも異なる合成動作 修正方法: 因果構造の保存を検証し、合成下での動作をテストし、観測等価性を使用
5. 静的トポロジーの仮定
検出方法: 通信グラフが起動時に固定され、実行時の再構成がない場合 症状: オープンシステムを処理できず、動的リソース管理がなく、変更に対して脆弱 修正方法: アドレスを第一級データとして扱い、機能ルーティングを実装し、実行時のトポロジー変更をサポート
実践例
例1: 顧客パターンによるタスク分解
シナリオ: エージェントが逐次サブタスク A → B → C を必要とする複雑なリクエストを処理するが、他のメッセージに対して応答性を維持する必要がある。
初心者のアプローチ:
リクエストを受信 →
サブタスクAを呼び出してブロック
サブタスクBを呼び出してブロック
サブタスクCを呼び出してブロック
最終結果を送信
アクターモデルのエキスパート適用:
リクエストを受信 →
アドレスB、C、最終受信者を持つ顧客_BCアクターを作成
サブタスクAリクエストをA_プロセッサに送信し、顧客_BCを応答アドレスとして指定
置き換え動作を指定: 次のリクエストの準備完了
顧客_BCがAの結果を受信 →
結果をB_プロセッサに送信し、顧客_Cを応答アドレスとして指定
顧客_CがBの結果を受信 →
結果をC_プロセッサに送信し、最終_受信者を応答アドレスとして指定
行われた主要な決定:
- ブロックを避けるために顧客パターンを使用
- 各ステップがチェーン内の次の顧客を作成
- 元のエージェントは全体を通して応答性を維持
- サブタスクの障害はそのチェーンのみに影響
例2: 監視による障害回復
シナリオ: システムがエージェント障害をシステム全体にカスケードさせずに処理する必要がある。
初心者のアプローチ: エージェント呼び出しをtry-catchで囲み、障害時にすべてを再起動。
エキスパートの適用:
監視者がワーカー_アクターを作成 →
応答タイムアウト付きでワーカーにタスクを送信
置き換えを指定: "応答待ち"
タイムアウト内に応答を受信した場合 →
結果をクライアントに転送
置き換えを指定: "準備完了"
タイムアウトが切れた場合 →
新しいワーカー_アクターを作成(古いものは障害)
新しいワーカーにタスクを再送信
置き換えを指定: "応答待ち"
対処されたトレードオフ:
- 監視はビジネスロジックとは別の関心事
- 障害アクターは修復ではなく、分離され交換される
- タイムアウト検出と保証付き配信のバランス
- 監視者とワーカーの間に共有状態なし
品質ゲート
- いかなるアクターもそのメッセージ処理ループをブロックしない(必要に応じて非感受性アクターパターンを適用)
- すべての調整にメッセージパッシングを使用(アクター間の可変共有状態なし)
- メッセージ配信は保証されるが、順序は仮定しない
- アドレスは機能ルーティングのために第一級データとして扱われる
- 各アクターはすべてのメッセージタイプに対して置き換え動作を指定する
- アクター作成は計算ニーズに基づいて動的に行われる
- 障害分離はアクター境界を越えたカスケード障害を防ぐ
- システムトポロジーは中央レジストリなしで実行時に再構成可能
- 合成動作は検証されており、単独コンポーネントの動作だけではない
- 同期操作はリクエスト-リプライメッセージペアとしてモデル化される
NOT-FOR 境界
このスキルは以下の用途には使用すべきではない:
- 単純な逐次計算 → 代わりに関数型プログラミングを使用
- 物理的に共有メモリが必要なシステム → 代わりにロックベースの並行パターンを使用
- 厳しいタイミング制約のあるリアルタイムシステム → 正式なタイミング分析を伴う同期メッセージパッシングを使用
- 調整を必要としない数学計算 → 純粋関数型アプローチを使用
以下の場合は他のスキルに委任する:
- 特定のアクターフレームワークの実装 → プラットフォーム固有の実装ガイドを使用
- アクターシステムのパフォーマンスチューニング → [パフォーマンス最適化]スキルを使用
- アクタープロパティの形式的検証 → [形式手法]スキルを使用
- アクター永続化のデータベース設計 → [データアーキテクチャ]スキルを使用
範囲に関する一般的な誤解:
- アクターは単なる「非同期メソッドを持つオブジェクト」ではない - 完全な3タプル応答が必要
- アクターモデルは分散システムのためだけではない - あらゆる並行計算に適用可能
- 主にパフォーマンス最適化ではない - 正しさと合成可能性のためのフレームワークである