Files
agent-framework/python/packages/orchestrations
T
Copilot 5d355ac507 Python: Fix HandoffBuilder silently dropping context_provider during agent cloning (#3721)
* Initial plan

* Fix context_provider parameter name bug and add test

Co-authored-by: markwallace-microsoft <127216156+markwallace-microsoft@users.noreply.github.com>

* Improve context_provider test to directly check cloned agent

Co-authored-by: markwallace-microsoft <127216156+markwallace-microsoft@users.noreply.github.com>

* Improve test based on code review feedback

Co-authored-by: markwallace-microsoft <127216156+markwallace-microsoft@users.noreply.github.com>

* Remove unused events variable in test_context_provider_preserved_during_handoff

Co-authored-by: markwallace-microsoft <127216156+markwallace-microsoft@users.noreply.github.com>

* Fix formatting: remove trailing whitespace from test_handoff.py

Co-authored-by: markwallace-microsoft <127216156+markwallace-microsoft@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: markwallace-microsoft <127216156+markwallace-microsoft@users.noreply.github.com>
5d355ac507 ยท 2026-02-06 23:23:45 +00:00
History
..

Agent Framework Orchestrations

Orchestration patterns for Microsoft Agent Framework. This package provides high-level builders for common multi-agent workflow patterns.

Installation

pip install agent-framework-orchestrations

Orchestration Patterns

SequentialBuilder

Chain agents/executors in sequence, passing conversation context along:

from agent_framework_orchestrations import SequentialBuilder

workflow = SequentialBuilder().participants([agent1, agent2, agent3]).build()

ConcurrentBuilder

Fan-out to multiple agents in parallel, then aggregate results:

from agent_framework_orchestrations import ConcurrentBuilder

workflow = ConcurrentBuilder().participants([agent1, agent2, agent3]).build()

HandoffBuilder

Decentralized agent routing where agents decide handoff targets:

from agent_framework_orchestrations import HandoffBuilder

workflow = (
    HandoffBuilder()
    .participants([triage, billing, support])
    .with_start_agent(triage)
    .build()
)

GroupChatBuilder

Orchestrator-directed multi-agent conversations:

from agent_framework_orchestrations import GroupChatBuilder

workflow = (
    GroupChatBuilder()
    .with_orchestrator(selection_func=my_selector)
    .participants([agent1, agent2])
    .build()
)

MagenticBuilder

Sophisticated multi-agent orchestration using the Magentic One pattern:

from agent_framework_orchestrations import MagenticBuilder

workflow = (
    MagenticBuilder()
    .participants([researcher, writer, reviewer])
    .with_manager(agent=manager_agent)
    .build()
)

Usage with agent_framework

You can also import orchestrations through the main agent_framework package:

from agent_framework.orchestrations import SequentialBuilder, ConcurrentBuilder

Documentation

For more information, see the Agent Framework documentation.