--- title: Dynamic Agent Workflows description: Let a parent agent write a workflow that fans out tasks and combines their results. --- import RunExampleCode from "/sdk/shared-snippets/how-to-run-example.mdx"; Use `WorkflowToolSet` when a parent agent needs to coordinate several sub-agent calls in a Python workflow. For direct task delegation, start with [TaskToolSet](/sdk/guides/task-tool-set). ## Coverage Audit Example The parent writes a workflow with `async def main(wf)` and submits it to the workflow tool. The workflow uses `wf.map_agents` to audit four project areas with at most two concurrent sub-agents. It then uses `wf.reduce_agent` to combine their findings. Run this example from a checkout of `OpenHands/software-agent-sdk`: its prompt names that repository’s source and test directories. The audit inspects code and tests; it does not run the test suite or measure coverage percentages. The auditor has terminal and file-editor tools. Its read-only instructions are prompts, not a sandbox restriction. Use a disposable checkout for this example. ```python icon="python" expandable examples/01_standalone_sdk/52_dynamic_workflow.py """Dynamic workflow tool example. This example demonstrates the intended workflow shape: 1. The parent agent writes a Python workflow script. 2. The parent agent calls the workflow tool with that generated script. 3. The workflow fans out sub-agents to audit test coverage by project area. 4. A reducer sub-agent summarizes the repo-wide coverage risks. """ import os from pathlib import Path from openhands.sdk import LLM, Agent, AgentContext, Conversation, Tool from openhands.sdk.context import Skill from openhands.sdk.subagent import register_agent_if_absent from openhands.tools.delegate import DelegationVisualizer from openhands.tools.file_editor import FileEditorTool from openhands.tools.terminal import TerminalTool from openhands.tools.workflow import WorkflowToolSet llm = LLM( model=os.getenv("LLM_MODEL", "gpt-5.5"), api_key=os.getenv("LLM_API_KEY"), base_url=os.getenv("LLM_BASE_URL"), usage_id="dynamic-workflow-demo", ) # Sub-agent used by the generated workflow. def create_coverage_auditor(llm: LLM) -> Agent: return Agent( llm=llm, tools=[ Tool(name=TerminalTool.name), Tool(name=FileEditorTool.name), ], agent_context=AgentContext( skills=[ Skill( name="coverage_audit", content=( "You audit whether source code has meaningful test " "coverage. Use read-only inspection commands and file " "views. Compare source modules against the matching " "tests under tests/sdk, tests/tools, tests/workspace, " "or tests/agent_server. Identify risky untested " "behavior, and recommend the " "next tests to add. Use at most three tool calls, " "avoid broad dumps, and do not edit files." ), trigger=None, ) ], system_message_suffix=( "Return a concise coverage assessment with evidence, gaps, " "and recommended tests. Keep command output under 200 lines " "and do not modify the repository." ), ), ) register_agent_if_absent( name="coverage_auditor", factory_func=create_coverage_auditor, description="Audits test coverage quality for one project area.", ) # The parent agent has the workflow tool. It is responsible for writing the # workflow script and then calling the tool with that generated Python code. parent_agent = Agent( llm=llm, tools=[Tool(name=WorkflowToolSet.name)], agent_context=AgentContext( skills=[ Skill( name="workflow_author", content=( "When a task benefits from parallel sub-agents, write a " "Python workflow script with `async def main(wf):` and call " "the workflow tool. Keep intermediate findings inside the " "workflow and return only the reducer's final report. " "Prefer bounded prompts and `max_concurrency=2` for " "examples that inspect repositories." ), trigger=None, ) ] ), ) conversation = Conversation( agent=parent_agent, workspace=Path.cwd(), visualizer=DelegationVisualizer(name="CoverageWorkflow"), max_iteration_per_run=6, # increase if more turns needed to write the script ) conversation.send_message( "Write and run a dynamic workflow that audits whether test coverage is " "good across this repository. In the workflow code you generate, create " "one item for each project area: `openhands-sdk/openhands/sdk`, " "`openhands-tools/openhands/tools`, " "`openhands-workspace/openhands/workspace`, and " "`openhands-agent-server/openhands/agent_server`. Use `wf.map_agents` " "with `max_concurrency=2` to fan out one `coverage_auditor` sub-agent " "per area. Each sub-agent should inspect source files and matching tests " "under `tests/sdk`, `tests/tools`, `tests/workspace`, or " "`tests/agent_server` with at most three read-only commands or file views, " "avoid running the full test suite, and report coverage strengths, risky " "gaps, and the " "next tests to add. Finally use `wf.reduce_agent` with " "`coverage_auditor` to synthesize a " "repo-wide coverage report with the highest-priority gaps. Return the " "final report to me." ) conversation.run() cost = conversation.conversation_stats.get_combined_metrics().accumulated_cost print(f"EXAMPLE_COST: {cost}") ``` The example limits the parent to six iterations. Increase `max_iteration_per_run` if it needs more turns to write and run the workflow. Each coverage auditor is instructed to use at most three inspection calls. ## Next Steps - [TaskToolSet](/sdk/guides/task-tool-set) — Delegate directly to specialized agents. - [File-Based Agents](/sdk/guides/agent-file-based) — Define reusable sub-agents.