Glossary

Reference intermediate

A working vocabulary for building multi-agent systems. Terms borrow from distributed systems — deliberately, because a fleet of agents is a distributed system whose nodes happen to be non-deterministic. See the course landing page and siblings: rules, cheat-sheet, framework-reference, troubleshooting.

A–C

Term Definition
Agent An LLM-driven unit with its own instructions, tool set, and (usually) its own context window. The atomic node of an orchestrated system.
Backpressure A signal from a saturated downstream agent or queue that throttles upstream producers to prevent unbounded queue growth.
Blackboard A shared workspace (often a key-value store or document) that agents read from and write to instead of messaging each other directly — a form of shared state coordination.
Circuit breaker A guard that trips after repeated failures from a downstream agent or model, short-circuiting calls so they fail fast instead of piling up retries.
Compensation A corrective action that undoes the visible effect of a completed step when a later step fails — the rollback unit of a saga.

D–E

Term Definition
Dead-letter queue (DLQ) A holding queue for messages or sub-tasks that failed all retries, parked for later inspection or manual replay rather than silently dropped.
Decomposition Splitting a complex goal into sub-tasks small enough for individual agents — by skill (functional), by partition (data), or by phase (temporal).
Distributed tracing Correlating one logical request across many agents and tool calls via a shared trace ID, reconstructing the full causal path.
Eventual consistency The acceptance that shared state read by different agents may briefly disagree, converging once all writes propagate — common with blackboard coordination.
Event-driven A coordination style where agents react to events published on a bus rather than being called directly, decoupling producers from consumers.

F–H

Term Definition
Fan-out / fan-in Dispatching one task to many agents in parallel (fan-out) then aggregating their results into a single answer (fan-in); the core of pipeline parallelism.
Fallback A degraded path taken when the primary agent fails — a cheaper model, a simpler heuristic, or a cached prior result.
Guardrail A validation layer at the orchestration boundary that inspects an agent's input or output and blocks, edits, or escalates unsafe results.
Handoff An explicit transfer of control (and relevant context) from one agent to another, e.g. a triage agent handing a coding task to a specialist.
Hierarchical pattern Multiple layers of supervisors, each managing a team of workers — a supervisor of supervisors, used when one coordinator cannot fan out far enough.
from claude_agent_sdk import AgentDefinition, ClaudeAgentOptions, query

# Workers and coordinator are all AgentDefinitions; the coordinator delegates
# via the built-in `Agent` tool (the Agent SDK has no separate handoff() call).
AGENTS = {
    "researcher": AgentDefinition(
        description="Gathers primary sources.",
        prompt="Search the web and return url/claim pairs.",
        tools=["WebSearch", "WebFetch"]),
    "writer": AgentDefinition(
        description="Drafts prose from gathered sources.",
        prompt="Draft from the sources; add no facts of your own.",
        tools=["Read"]),
}

opts = ClaudeAgentOptions(
    system_prompt="Research first, then delegate drafting to the writer.",
    allowed_tools=["Agent"],          # the coordinator's only tool: delegate
    agents=AGENTS, permission_mode="default")

async for message in query(prompt="Brief me on local LLM trends.", options=opts):
    ...

I–M

Term Definition
Idempotency The property that re-running a step (after a retry or replay) produces the same effect as running it once — essential because retries are routine.
Idempotency key A caller-supplied unique token attached to a request so the receiver can detect and dedupe a replayed call.
Intelligent routing Sending each task to the cheapest model or agent capable of handling it, escalating to stronger models only when complexity demands.
Message passing Coordination via structured, schema-defined messages exchanged between agents — explicit, auditable, and easy to version.
Multi-agent system (MAS) Any system where two or more agents cooperate (or compete) to accomplish a goal that exceeds a single agent's capacity.

O–P

Term Definition
Orchestration The discipline of coordinating multiple agents — deciding who does what, in what order, with what data, and how failures are handled.
Peer-to-peer pattern Agents communicate directly with one another without a central coordinator; flexible but harder to reason about and debug.
Pipeline pattern Agents arranged as sequential stages, each transforming the output of the previous one — extraction, then validation, then summarization.
Prompt caching Reusing the expensive prefix of a prompt (system instructions, shared context) across agent calls so it is processed once, cutting latency and cost.
Provenance A record of which agent produced which artifact and from what inputs — the audit trail that makes results trustworthy and reproducible.

R–S

Term Definition
Retry budget A cap on total retries across the system (not just per call) so a storm of failures cannot multiply token spend without bound.
Saga A long-running workflow modeled as a sequence of steps, each with a compensating action, giving rollback semantics without distributed transactions.
Shared state A common store all agents read and write — the blackboard model; powerful but introduces concurrency and consistency concerns.
SLO (Service Level Objective) A measurable reliability target for an agent system, e.g. "95% of research runs complete in under 90 seconds with a valid answer."
Supervisor A central coordinator agent that decomposes a goal, delegates sub-tasks to specialist workers, and assembles their outputs.

T–W

Term Definition
Temporal / Prefect / Airflow Workflow engines that manage deterministic flow control, retries, and durable state while AI agents handle the intelligent steps inside activities or tasks.
Token budgeting Allocating a ceiling of tokens per agent or per task so no single branch of the workflow can consume the entire spend.
Tool A callable (API, function, query) an agent may invoke; least-privilege scoping of tools per agent is a core security control.
Workflow activity A unit of work in a workflow engine (Temporal's activity, Prefect's task) — the place to wrap a non-deterministic agent call with timeouts and retries.
# Temporal: wrap an agent call as a durable, retryable activity.
from temporalio import activity, workflow
from datetime import timedelta

@activity.defn
async def run_synthesis(sources: list[str]) -> str:
    return await synthesis_agent.run(sources)

@workflow.defn
class ResearchWorkflow:
    @workflow.run
    async def run(self, sources: list[str]) -> str:
        return await workflow.execute_activity(
            run_synthesis, sources,
            start_to_close_timeout=timedelta(minutes=3),
        )

See Also