agentica-infrastructure

Agentica 基础设施参考

Agentica 多 Agent 协调基础设施的完整 API 规范。

适用场景

• 使用 Agentica 模式构建多 Agent 工作流
• 需要模式类的准确构造函数签名
• 想要了解协调数据库架构
• 使用基本组件实现自定义模式
• 调试 Agent 跟踪或孤立 Agent 检测

快速参考

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	带跟踪功能的 Agent
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	结构化 Agent 交接
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/