Expand description
SwarmEngine Agent 定義
Worker/Manager Agent の trait 定義と関連型。
§アーキテクチャ概要
SwarmEngine は2層の Agent 階層を持ちます:
┌─────────────────────────────────────────────────────────────┐
│ ManagerAgent │
│ observe_and_decide() - N Tick ごとに全体を観察・判断 │
│ → Guidance（方針・ヒント）または WorkerInstruction を発行 │
└─────────────────────────────────────────────────────────────┘
│
Guidance / WorkerInstruction
▼
┌─────────────┐ ┌─────────────┐ ┌─────────────┐
│ WorkerAgent │ │ WorkerAgent │ │ WorkerAgent │
│ │ │ │ │ │
└─────────────┘ └─────────────┘ └─────────────┘
│ │ │
└───────────────┼───────────────┘
▼
think_and_act() - 毎 Tick 実行§モジュール構成
batch- BatchInvoker trait と関連型escalation- Escalation 関連型manager- ManagerAgent trait と関連型worker- WorkerAgent trait と関連型
Modules§
- batch
- BatchInvoker - Batch LLM 推論の抽象化
- escalation
- Escalation - Worker から Manager への介入要求
- manager
- ManagerAgent - 観察・判断・指示を行う上位Agent
- manager_
impl - DefaultBatchManagerAgent - Core層のManagerAgent デフォルト実装
- worker
- WorkerAgent - 毎 Tick 実行する Agent
- worker_
impl - Generic Worker - シェルコマンドを実行する汎用 Worker
Structs§
- Action
Candidate - プロンプト構築用の Action 情報
- Action
Param - プロンプト構築用の Action パラメータ情報
- Adaptive
Scope Strategy - 適応的 Scope 戦略
- Adjacent
Strategy - 隣接N件のみ見える戦略
- AllVisible
Strategy - 全員が見える戦略（デフォルト）
- Async
Task Request - 非同期タスクリクエスト
- Batch
Decision Request - Batch リクエスト（1 Manager が 1 Tick で送る全リクエスト）
- Cache
Update - ローカルキャッシュ更新リクエスト
- Context
Resolver - コンテキスト解決器
- Context
Store - 正規化されたコンテキストデータストア
- Decision
Response - LLM からの判断レスポンス
- Default
Analyzer - デフォルトの Analyzer 実装
- Default
Batch Manager Agent - Core層の ManagerAgent デフォルト実装
- Default
Batch Manager Agent Builder - DefaultBatchManagerAgent Builder
- Default
Manager Config - DefaultBatchManagerAgent 設定
- EdgeId
- エッジID
- Escalation
- Escalation 情報（WorkerState に保存）
- Exploration
Target - Manager から Worker への探索指示
- Extension
Aware Worker - Extension を活用する Worker
- Fixed
Scope Strategy - 固定 Scope 戦略
- Generic
Worker - 汎用 Worker - Guidance の Action を直接実行
- Global
Context - Global情報（全リクエスト共通）
- Guidance
- ManagerAgent から Worker への指示・方針
- Guidance
Context - NeedsGuidance 時に ManagerAgent に渡すコンテキスト
- Issue
- Issue - Worker が困っていること
- Management
Decision - ManagerAgent の決定結果
- Manager
Context - Manager固有のコンテキスト
- Manager
Id - Manager ID
- Manager
Instruction - Manager から Worker への指示（Prompt 埋め込み用の軽量版）
- NodeId
- ノードID
- Progress
Worker - 進捗を報告する Worker
- Proposed
Option - 提案オプション
- Relevant
State - 関連 State のスナップショット
- Resolved
Context - 解決済みコンテキスト（LLM層に渡る）
- Scheduled
Action - スケジュールされたアクション
- Shared
Update - SharedData 更新リクエスト
- Task
Context - タスク状況（Analyzer が生成、Manager が消費）
- Task
Description - Task 説明
- Worker
Ctx - Worker固有のコンテキスト
- Worker
Decision Request - 個別 Worker への判断リクエスト
- Worker
State Delta - Worker の状態変更リクエスト（Runtime が Phase 6 でマージ）
- Worker
Summary - Worker 状態の要約
Enums§
- Batch
Invoke Error - Batch 推論エラー
- Context
Target - コンテキストの対象
- Context
View - コンテキストの可視範囲を定義
- Escalation
Reason - Escalation 理由
- Management
Strategy - ManagerAgent の起動タイミング戦略
- Priority
- 優先度
- Trial
Policy - 試行ポリシー
- Work
Result - Worker の実行結果
- Worker
Scope - Worker に渡す情報のスコープ
Traits§
- Analyzer
- 状況分析器: SwarmState → TaskContext
- Batch
Invoker - Batch LLM 推論の抽象化
- Manager
Agent - 観察・判断・指示を行う上位Agent（Batch 対応）
- Neighbor
Strategy - Neighbor決定戦略
- Scope
Strategy - Scope 決定戦略
- Worker
Agent - 毎 Tick 実行する Agent
Functions§
- execute_
action - Action を実行（Bash/Read/Write/Grep をサポート）
- run_
bash - シェルコマンドを実行
- run_
grep - パターン検索
- run_
read - ファイルを読み込む
- run_
write - ファイルに書き込む
Type Aliases§
- Batch
Invoke Result - Batch 推論結果