代理基础设施
- 作者仓库星标 3,783
- 作者仓库 Continuous-Claude-v3
- 领域
- 人工智能
- 作者声明的智能体
- 未找到明确声明;不据此推断已兼容或已测试
- 静态检查
- 88 / 100 · 启发式扫描,不代表运行安全
- 运行环境证据
- 未执行;当前没有隔离运行测试证据
- 作者 / 版本 / 许可证
- @parcadei · 未声明许可证
- 上下文用量评级
- 低消耗
- 接入复杂程度
- 需简单配置
- 是否需要外部接口密钥
- 不需要
- 兼容的系统
- 未声明(默认跨平台)
- 运行环境要求
- Python
- 检测到的文件与系统行为
-
- 只读
- 允许写入 / 修改
- 命令执行
- 网络行为
- 仅限本地
- 安装命令数
- 无(仅作为资料)
需要注意: 未声明工具权限范围;实际权限由运行环境决定。
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?")
# Agentica Infrastructure Reference
Complete API specification for Agentica multi-agent coordination infrastructure.
## When to Use
- Building multi-agent workflows with Agentica patterns
- Need exact constructor signatures for pattern classes
- Want to understand coordination database schema
- Implementing custom patterns using primitives
- Debugging agent tracking or orphan detection
## Quick Reference
### 11 Pattern Classes
| Pattern | Purpose | Key Method |
|---------|---------|------------|
| `Swarm` | Parallel perspectives | `.execute(query)` |
| `Pipeline` | Sequential stages | `.run(initial_state)` |
| `Hierarchical` | Coordinator + specialists | `.execute(task)` |
| `Jury` | Voting consensus | `.decide(return_type, question)` |
| `GeneratorCritic` | Iterative refinement | `.run(task)` |
| `CircuitBreaker` | Failure fallback | `.execute(query)` |
| `Adversarial` | Debate + judge | `.resolve(question)` |
| `ChainOfResponsibility` | Route to handler | `.process(query)` |
| `MapReduce` | Fan out + reduce | `.execute(query, chunks)` |
| `Blackboard` | Shared state | `.solve(query)` |
| `EventDriven` | Event bus | `.publish(event)` |
### Core Infrastructure
| Component | File | Purpose |
|-----------|------|---------|
| `CoordinationDB` | `coordination.py` | SQLite tracking |
| `tracked_spawn` | `tracked_agent.py` | Agent with tracking |
| `HandoffAtom` | `handoff_atom.py` | Universal handoff format |
| `BlackboardCache` | `blackboard.py` | Hot tier communication |
| `MemoryService` | `memory_service.py` | Core + Archival memory |
| `create_claude_scope` | `claude_scope.py` | Scope with file ops |
### Primitives
| Primitive | Purpose |
|-----------|---------|
| `Consensus` | Voting (MAJORITY, UNANIMOUS, THRESHOLD) |
| `Aggregator` | Combine results (MERGE, CONCAT, BEST) |
| `HandoffState` | Structured agent handoff |
| `build_premise` | Structured premise builder |
| `gather_fail_fast` | TaskGroup-based parallel execution |
## Full API Spec
See: `API_SPEC.md` in this skill directory
## Usage Example
```python
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?")
```
## Location
API spec: `.claude/skills/agentica-infrastructure/API_SPEC.md`
Source: `scripts/agentica_patterns/`
章节与文件索引
按说明文件中的顺序排列。
何时使用
11 个模式类
核心基础设施
基元
完整 API 规范
文件/命令 -> Swarm · .execute(query) · Pipeline · .run(initial_state) · Hierarchical · .execute(task) · Jury · .decide(return_type, question)
内容校验值 -> 87fef76567df
当前原文的自动摘译,尚未人工审校。
何时使用
使用 Agentica 模式构建多代理工作流程 需要模式类的精确构造函数签名 想要了解协调数据库模式 使用基元实现自定义模式 调试代理跟踪或孤立检测
11 个模式类
模式·目的·关键方法
Swarm·平行视角·.execute(query)``Pipeline·顺序阶段·.run(initial_state)``Hierarchical·协调员+专家·.execute(task)``Jury·投票共识·.decide(return_type, question)核心基础设施
组件 · 文件 · 用途
CoordinationDB·coordination.py· SQLite 跟踪tracked_spawn·tracked_agent.py· 带跟踪的代理HandoffAtom·handoff_atom.py· 通用切换格式BlackboardCache·blackboard.py· 热层通信基元
原始 · 目的
Consensus· 投票(多数、一致、阈值)Aggregator· 合并结果(合并、连接、最佳)HandoffState· 结构化代理移交build_premise· 结构化前提构建器完整 API 规范
请参阅:本技能目录中的
API_SPEC.md