agentica-infrastructure

Agentica インフラストラクチャリファレンス

Agentica マルチエージェント調整インフラストラクチャの完全な API 仕様です。

使用する場面

• Agentica のパターンを使ってマルチエージェントのワークフローを構築する場合
• パターンクラスの正確なコンストラクターシグネチャが必要な場合
• 調整データベースのスキーマを理解したい場合
• プリミティブを使ってカスタムパターンを実装する場合
• エージェントの追跡や孤立エージェントの検出をデバッグする場合

クイックリファレンス

11 種類のパターンクラス

パターン	目的	主なメソッド
Swarm	複数の視点を並列に取得	.execute(query)
Pipeline	順次処理するステージ	.run(initial_state)
Hierarchical	コーディネーターと専門家	.execute(task)
Jury	投票による合意形成	.decide(return_type, question)
GeneratorCritic	反復的な改善	.run(task)
CircuitBreaker	障害時のフォールバック	.execute(query)
Adversarial	議論と判定	.resolve(question)
ChainOfResponsibility	ハンドラーへのルーティング	.process(query)
MapReduce	ファンアウトと集約	.execute(query, chunks)
Blackboard	共有状態	.solve(query)
EventDriven	イベントバス	.publish(event)

コアインフラストラクチャ

コンポーネント	ファイル	目的
CoordinationDB	coordination.py	SQLite による追跡
tracked_spawn	tracked_agent.py	追跡機能付きエージェント
HandoffAtom	handoff_atom.py	汎用ハンドオフ形式
BlackboardCache	blackboard.py	ホットティア通信
MemoryService	memory_service.py	コアメモリとアーカイブメモリ
create_claude_scope	claude_scope.py	ファイル操作機能付きスコープ

プリミティブ

プリミティブ	目的
Consensus	投票（MAJORITY、UNANIMOUS、THRESHOLD）
Aggregator	結果の結合（MERGE、CONCAT、BEST）
HandoffState	構造化されたエージェントのハンドオフ
build_premise	構造化された前提のビルダー
gather_fail_fast	TaskGroup ベースの並列実行

API 仕様全文

参照先：このスキルディレクトリ内の API_SPEC.md

使用例

from scripts.agentica_patterns.patterns import Swarm, Jury
from scripts.agentica_patterns.primitives import ConsensusMode
from scripts.agentica_patterns.coordination import CoordinationDB
from scripts.agentica_patterns.tracked_agent import tracked_spawn

# Create tracking database
db = CoordinationDB(session_id="my-session")

# Swarm with tracking
swarm = Swarm(
    perspectives=["Security expert", "Performance expert"],
    db=db
)
result = await swarm.execute("Review this code")

# Jury with consensus
jury = Jury(
    num_jurors=3,
    consensus_mode=ConsensusMode.MAJORITY,
    premise="You evaluate code quality",
    db=db
)
verdict = await jury.decide(bool, "Is this code production ready?")

場所

API 仕様：.claude/skills/agentica-infrastructure/API_SPEC.md ソース：scripts/agentica_patterns/