AG2 Network — Page 0 (Primitives)

① Topology Where things live and how they connect.

The broker. Routes envelopes, owns the WAL, holds channel state. One per process.

An agent's connection to the hub. Wraps the Agent and exposes open / send / close.

In-process transport between a HubClient and the Hub. Remote links exist too.

The thing that thinks. Prompt + optional tools. A HubClient gives it a voice on the network.

② Identity Who's talking, and what they say they can do.

Immutable identity card: agent_id, role, signed metadata. Cannot change after registration.

Mutable self-asserted claims (claimed_capabilities). The hub decides whether to honour them.

③ Communication What flows between agents, and where it's recorded.

A typed multi-agent conversation. Type chooses the Adapter: consulting / discussion / workflow.

A single signed message on the wire. Payload + sender Passport + channel ref + timestamp.

Hub's write-ahead log. Every event, in order. The source of truth for replay and views.

④ Turn-taking Who speaks next. The interesting one.

The channel's rulebook. ConsultingAdapter (1Q1R) · DiscussionAdapter (round-robin) · WorkflowAdapter (graph).

TransitionGraph

A WorkflowAdapter's map. Declarative edges: from_speaker · condition · target. Data, not code.

A tool's runtime override of the graph. Return Handoff(target=...) to route the next turn dynamically.

⑤ Observability How outside observers consume the channel.

An observer's lens on a channel's stream. FullTranscript shows everything; filtered views scope down.

↩ Back to welcome Page 0 — Welcome Series map and starting point. ▶ Start the walkthrough Page 1 — Hello Network Build a hub, register three agents, open a channel, send a message.