---
type: email
from: dtimon <notifications@github.com>
subject: Re: [openai/openai-agents-python] docs: add deterministic workflow

 example with state machine pattern (PR #2648)
received: 2026-03-12 07:26:44
date_header: Wed, 11 Mar 2026 10:47:10 -0700
priority: normal
status: awaiting_approval
uid: 45401
---

## Email Content

**From:** dtimon <notifications@github.com>
**Subject:** Re: [openai/openai-agents-python] docs: add deterministic workflow

 example with state machine pattern (PR #2648)
**Date:** Wed, 11 Mar 2026 10:47:10 -0700

### Body (preview)

dtimon left a comment (openai/openai-agents-python#2648)



Hi @seratch,



Thanks for considering the PR. I'd like to respectfully highlight why this example offers distinct value, as @jjcampana noted regarding deterministic workflows being a key SDK challenge:



1.  **Different architectural pattern:** Shows a _single evolving agent_ vs. multiple specialized agents with handoffs. Performance could be improved if the "hand-off" includes time delays

2. **Deterministic flow without routing:** Solves step-by-step workflows without handoff decisions, using shared state

3. **Undemonstrated SDK techniques:** Features dynamic **is_enabled** with context and _get_dynamic_instructions()_ - **patterns not covered elsewhere**

4. **Complementary educational value:** As @jjcampana mentioned, provides a simpler alternative for **linear workflows** vs. handoff complexity

5. **Practical use case:** Addresses real needs (forms, wizards, onboarding) where developers need deterministic control over conversational flow

6. **Tools**: It reduces the number of "tools" that the agent must consider in each execution.



Suggestion: Keep as a complementary example showcasing a **different architectural approach** to the same state management problem since it could be considered a new pattern



-- 

Reply to this email directly or view it on GitHub:

https://github.com/openai/openai-agents-python/pull/2648#issuecomment-4040986553

You are receiving this because you are subscribed to this thread.



Message ID: <openai/openai-agents-python/pull/2648/c4040986553@github.com>

---

## Suggested Actions
- [ ] Reply
- [ ] Archive
- [ ] Escalate
