|
|
| 名称 |
agentica-infrastructure |
| 描述 |
Agentica多代理基础设施API的参考指南 allowed-tools: [读取] user-invocable: false |
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 |
投票（多数、一致、阈值） |
Aggregator |
合并结果（合并、连接、最佳） |
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
# 创建跟踪数据库
db = CoordinationDB(session_id="my-session")
# 带跟踪的Swarm
swarm = Swarm(
perspectives=["Security expert", "Performance expert"],
db=db
)
result = await swarm.execute("Review this code")
# 带共识的Jury
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/