Skip to content

Add new workflow builder examples + docs#22

Merged
pamelafox merged 17 commits intoAzure-Samples:mainfrom
pamelafox:workflowbuilders
Mar 3, 2026
Merged

Add new workflow builder examples + docs#22
pamelafox merged 17 commits intoAzure-Samples:mainfrom
pamelafox:workflowbuilders

Conversation

@pamelafox
Copy link
Contributor

Adds new workflow examples (English + Spanish) showcasing additional Agent Framework workflow patterns, and updates the READMEs so the workflow index tables include all workflow scripts in this branch.

New files added:

  • examples/

    • examples/workflow_fan_out_fan_in_edges.py
    • examples/workflow_aggregator_summary.py
    • examples/workflow_aggregator_structured.py
    • examples/workflow_aggregator_voting.py
    • examples/workflow_aggregator_ranked.py
    • examples/workflow_agents_concurrent.py
    • examples/workflow_multi_selection_edge_group.py
    • examples/workflow_handoffbuilder.py
    • examples/workflow_handoffbuilder_rules.py
    • examples/workflow_magenticone.py
  • examples/spanish/

    • examples/spanish/workflow_fan_out_fan_in_edges.py
    • examples/spanish/workflow_aggregator_summary.py
    • examples/spanish/workflow_aggregator_structured.py
    • examples/spanish/workflow_aggregator_voting.py
    • examples/spanish/workflow_aggregator_ranked.py
    • examples/spanish/workflow_agents_concurrent.py
    • examples/spanish/workflow_multi_selection_edge_group.py
    • examples/spanish/workflow_handoffbuilder.py
    • examples/spanish/workflow_handoffbuilder_rules.py
    • examples/spanish/workflow_magenticone.py

Also includes small doc/translation consistency updates (Spanish agent display names) and updates to existing workflow scripts + uv.lock as needed.

Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds a new set of workflow-builder/orchestration examples (English + Spanish) to broaden the repository’s coverage of Agent Framework workflow patterns, and updates the example indexes/docs accordingly.

Changes:

  • Introduces new workflow examples covering fan-out/fan-in, multiple aggregation strategies, multi-selection routing, concurrent orchestration, autonomous handoff orchestration, and MagenticOne.
  • Updates several existing examples to use default_options={"response_format": ...} and consume structured outputs via agent_response.value.
  • Updates README index tables (English + Spanish) and refreshes uv.lock for dependency resolution.

Reviewed changes

Copilot reviewed 34 out of 35 changed files in this pull request and generated 16 comments.

Show a summary per file
File Description
uv.lock Dependency lockfile updates.
examples/workflow_switch_case.py Updates structured output usage to default_options + agent_response.value.
examples/workflow_converge.py Updates structured output parsing to agent_response.value + default_options.
examples/workflow_conditional_structured.py Updates structured output parsing to agent_response.value + default_options.
examples/workflow_conditional_state.py Updates structured output parsing to agent_response.value + default_options.
examples/workflow_conditional_state_isolated.py Updates structured output parsing to agent_response.value + default_options.
examples/workflow_fan_out_fan_in_edges.py New explicit fan-out/fan-in edge-group example.
examples/workflow_aggregator_summary.py New LLM summarization aggregator example.
examples/workflow_aggregator_structured.py New structured extraction (typed Pydantic) aggregator example.
examples/workflow_aggregator_voting.py New majority-vote (pure logic) aggregator example.
examples/workflow_aggregator_ranked.py New LLM-as-judge ranking aggregator example.
examples/workflow_agents_concurrent.py New ConcurrentBuilder orchestration example.
examples/workflow_multi_selection_edge_group.py New multi-selection routing example using add_multi_selection_edge_group.
examples/workflow_handoffbuilder.py New autonomous HandoffBuilder example (content pipeline).
examples/workflow_handoffbuilder_rules.py New HandoffBuilder example with explicit routing rules.
examples/workflow_magenticone.py New MagenticOne orchestration example with streaming + ledger events.
examples/spanish/workflow_switch_case.py Spanish equivalent update for structured output usage.
examples/spanish/workflow_converge.py Spanish equivalent update for structured output parsing/options.
examples/spanish/workflow_conditional_structured.py Spanish equivalent update for structured output parsing/options.
examples/spanish/workflow_conditional_state.py Spanish equivalent update for structured output parsing/options.
examples/spanish/workflow_conditional_state_isolated.py Spanish equivalent update for structured output parsing/options.
examples/spanish/workflow_fan_out_fan_in_edges.py Spanish version of explicit fan-out/fan-in edges example.
examples/spanish/workflow_aggregator_summary.py Spanish version of LLM summarization aggregator example.
examples/spanish/workflow_aggregator_structured.py Spanish version of structured extraction aggregator example.
examples/spanish/workflow_aggregator_voting.py Spanish version of majority-vote aggregator example.
examples/spanish/workflow_aggregator_ranked.py Spanish version of LLM-as-judge ranking aggregator example.
examples/spanish/workflow_agents_concurrent.py Spanish version of ConcurrentBuilder orchestration example.
examples/spanish/workflow_multi_selection_edge_group.py Spanish version of multi-selection routing example.
examples/spanish/workflow_handoffbuilder.py Spanish version of autonomous HandoffBuilder example.
examples/spanish/workflow_handoffbuilder_rules.py Spanish version of HandoffBuilder example with explicit rules.
examples/spanish/workflow_magenticone.py Spanish version of MagenticOne orchestration example.
examples/spanish/workflow_agents.py Improves output printing for Spanish workflow-agents example.
examples/spanish/README.md Updates Spanish example index table to include new workflow scripts.
README.md Updates root example index table to include new workflow scripts.
AGENTS.md Updates Spanish-translation guidance (includes agent/workflow naming guidance).

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

- Fix E225 spacing in workflow_aggregator_voting.py (Comment 4)
- Translate Spanish agent/workflow display names in 7 Spanish files (Comments 5-8, 12-14)
- Wrap long line in workflow_aggregator_structured.py (Comment 11)
- Fix typo 'ass umptions' in workflow_magenticone.py (Comment 16)
- Fix I001 import sorting in aggregator_ranked files
- Fix UP035 Literal import in aggregator_structured files
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 34 out of 35 changed files in this pull request and generated 4 comments.


💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@madebygps
Copy link
Contributor

Left a few comments

- Remove hardcoded port 8101 from workflow_magenticone.py (EN+ES)
- Revert Spanish agent/workflow names to English in workflow_fan_out_fan_in_edges, workflow_converge
- Fix Run: -> Ejecutar: in Spanish workflow_magenticone.py
- Improve summarizer comment in workflow_aggregator_summary (EN+ES)
- Fix handoff output handling with get_outputs() guard in workflow_handoffbuilder_rules (EN+ES)
- Bump max_iterations 8->20 in workflow_conditional_state (EN+ES)
- Translate 'Please add a fix' to Spanish in workflow_aggregator_voting
@madebygps
Copy link
Contributor

lgtm!

@pamelafox pamelafox merged commit d0c53e7 into Azure-Samples:main Mar 3, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants