Catalog / Orchestration
Magentic manager
A manager keeps the plan in a task ledger outside its own context, checks progress after every turn, and rewrites the plan when the work stalls.
Reference task used across all patterns: "My order arrived damaged. Can I get a refund?"
Topology
Run
11 steps
Ready to run
Play runs the whole scenario. Step advances one event at a time so you can read what happens.
Metrics
| Wall-clock time | 0.0 s |
|---|---|
| Tokens processed | 0 |
| Estimated cost | $0.000 |
| Replans | 0 |
All steps
Normal run
- Request arrives. The manager will not do the work itself. Its job is to plan, assign, check progress, and notice when the plan has stopped working.
- Plan. The manager lists what is known, what must be found out, and who can find it: the order record first, then proof of damage.
- Write the ledger. The plan is stored outside any model's context. Long tasks outlive a context window, and a ledger does not forget step one by step ten.
- Assign task one. One agent works at a time, on one task from the ledger.
- Task one done. The order agent finds order 4417, delivered 12 Sep. The manager marks the task complete.
- Assign task two. Next on the ledger is proof of damage.
- A dead end. The carrier has no record under the order id. A fixed plan would stall here, or report failure.
- Replan. After every turn the manager asks whether progress is being made. It is not, so it rewrites the plan to search by tracking number instead.
- Assign the new task. The same agent, a different approach.
- Task two done. Under the tracking number the carrier's damage report turns up. The ledger is complete.
- Respond. Refund approved. It was slower and dearer than a plain orchestrator, and it got past an obstacle that would have stopped one.
Outcome: correct answer, after one replan. The ledger and the progress check are what set this apart from an orchestrator. They pay off on open-ended tasks where the first plan is likely to be wrong.
Failure mode
- Request arrives. Identical start to the normal run.
- Plan and ledger. The same plan, written to the ledger.
- Task one done. The order agent finds order 4417. Nothing has gone wrong yet.
- A dead end. The carrier's API is down today. The agent reports it the only way it can, as no record found.
- Replan. No progress, so the manager replans to search by tracking number. So far this is the pattern working as designed.
- The same dead end. A different query against the same dead API gives the same answer.
- Replan, and replan again. Plans three and four reword the same search. The ledger records every attempt, but nothing counts them or asks why they all fail alike.
- Budget exhausted. The large model's planning turns were the expensive part. The run ends with a full ledger of attempts and no answer for the customer.
Failure: replanning without a stall limit. The ability to replan turns into a loop when nothing bounds it. Mitigation: count stalled turns, cap the replans, tell tool failures apart from empty results, and escalate to a person at the limit.
Execution trace
Reference
- Problem
- The task is open-ended. The steps cannot be listed up front, and the first plan will probably turn out to be wrong.
- Analogy
- A project manager with a whiteboard. After every stand-up they check the board, and when a task is stuck they redraw the plan.
- Use when
- Long, open-ended tasks across several specialist agents, where getting stuck is likely and recovering is worth the extra cost.
- Avoid when
- The steps are known or the task is short. The ledger and progress checks add a large-model turn to every step.
- Typical failure
- Replanning loop: every stall triggers another plan, and nothing limits how often.
- Also known as
- Magentic orchestration (Microsoft)Magentic-One (AutoGen)
- Related patterns
- Orchestrator–workers (specialises)
- Group chat and debate (alternative)
Space play or pause → next step ← previous step R reset F failure mode