Consult Agentica APIs when building workflows where multiple AI agents cooperate. This reference covers eleven coordination patterns, agent tracking, shared state, handoffs, and ways to combine results, with pointers to detailed API specifications.
Reference guide for Agentica multi-agent infrastructure APIs
Review the instructions the agent will receive before you install.
Complete API specification for Agentica multi-agent coordination infrastructure.
| 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) |
| 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 |
| 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 |
See: API_SPEC.md in this skill directory
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 spec: .claude/skills/agentica-infrastructure/API_SPEC.md
Source: scripts/agentica_patterns/
No reviews yet. Tell others what you thought.
No login needed. Share how it worked for you, ask a question, or note where it did not run.
No comments yet. Be the first to write one.
Coordinate background agents through saved files, keeping lengthy work transcripts out of the main conversation. It defines how to pass results between agents, monitor progress, and verify completed work with tests.
Delegate implementation, file reading, and testing to separate agents, then bring concise summaries back to the main conversation. The rules explain when delegation helps and when a small edit is better handled directly.
Organize implementation work across research, planning, validation, implementation, and review agents. Each stage passes files to the next, while implementation starts with failing tests and the main conversation coordinates the workflow.
Connect Agentica SDK agents to Claude Code CLI through a proxy, an intermediary server. Use setup and debugging guidance to address file permissions, streamed responses, result formatting, and agents reporting success without performing the requested operations.
Write clearer instructions for Agentica and REPL agents by specifying roles, file operations, and output formats. Includes templates for dividing research, coordinating specialists, reviewing solutions, and passing results between agents through files.
Build Python agents with Agentica SDK using function decorators or agent instances. Examples cover conversation memory, external tools, MCP connections for tool access, multi-agent coordination, typed results, and logging to help implement and debug agent behavior.