AG2 Network — Page 5 (Workflow with Handoffs)

Network canvas · 4 agents · dynamic routing Ren · author Sol · router Vox · engineer Lex · legal Hub

LocalLink → Hub

Ren

role=Author

prompt: "I write the brief; I revise on request."

agent_id=ag_a71b…

claimed=["brief_writing"]

LocalLink → Hub

Sol

role=Router

tools:

assess_brief() → Handoff

prompt: "Read brief; route to the right specialist."

agent_id=ag_b84c…

claimed=["routing"]

LocalLink → Hub

Vox

role=Engineer

prompt: "I estimate and ship."

agent_id=ag_c52d…

claimed=["estimation"]

LocalLink → Hub

Lex

role=Legal

prompt: "Compliance, contracts, data retention."

agent_id=ag_d39e…

claimed=["legal_review"]

HUB

MemoryKnowledgeStore

4agents

0channels

4envelopes

Handoff walkthrough 0 of 6

step 0

Four agents already registered. Sol has a single tool — assess_brief — that returns a Handoff. The tool's function body picks the next speaker at runtime.

Pre-state

0 4 agents registered · no channels

Open channel

1 channel = await ren.open(type=WORKFLOW_TYPE, graph=...)

Graph + Handoff drive routing

2 ▸ ren writes brief → graph: → sol

3 ▸ sol assess_brief(lane="legal", ...) → Handoff(lex)

4 ▸ lex reviews → graph: → sol

5 ▸ sol assess_brief(lane="engineering", ...) → Handoff(vox)

6 ▸ vox estimates → graph: → TerminateTarget

Tool + Graph definition handoff wins over graph for sol

from autogen.beta.network import Handoff

# Sol's tool returns a Handoff — the FUNCTION BODY
# picks the target at runtime. Compare to Page 4 where
# the graph itself enumerated the branches.
@sol.tool
def assess_brief(brief: str, lane: str) -> Handoff:
    """Read the brief; pick the next agent."""
    if lane == "legal":
        return Handoff(target="lex",
                       reason="trial-scope data retention")
    if lane == "engineering":
        return Handoff(target="vox",
                       reason="legal cleared; ready to scope")
    return Handoff(target="ren",
                   reason="needs revision")

# Graph defines the static path. Sol has no outgoing
# transition — the Handoff returned by assess_brief()
# is what the framework uses to route from sol.
graph = TransitionGraph(
    initial_speaker="ren",
    max_turns=10,
    transitions=[
        Transition(
            from_speaker="ren",
            condition=Always(),
            target=AgentTarget("sol"),
        ),
        # Sol → ??? : decided by the Handoff that
        # assess_brief() returns. No graph transition
        # needed for sol — handoff overrides.
        Transition(
            from_speaker="lex",
            condition=Always(),
            target=AgentTarget("sol"),
        ),
        Transition(
            from_speaker="vox",
            condition=Always(),
            target=TerminateTarget(),
        ),
    ],
)

Transcript view: FullTranscript

No channel open. Once a handoff workflow starts, turns appear here.

Event log (hub WAL) 4 entries