---
type: email
from: Huzaifa_Dev <notifications@github.com>
subject: [openai/openai-agents-python] Add Advanced Reasoning section with

 depth parameter note (PR #1676)
received: 2026-03-06 07:23:26
date_header: Sat, 06 Sep 2025 13:20:12 -0700
priority: normal
status: awaiting_approval
uid: 29658
---

## Email Content

**From:** Huzaifa_Dev <notifications@github.com>
**Subject:** [openai/openai-agents-python] Add Advanced Reasoning section with

 depth parameter note (PR #1676)
**Date:** Sat, 06 Sep 2025 13:20:12 -0700

### Body (preview)

### Summary

Added a new **&quot;Advanced Reasoning&quot;** section in `agents.md` explaining the `reasoning` parameter in `ModelSettings`.



### Details

- Introduced the `strategy` and `depth` options for advanced reasoning.

- Noted that the **maximum value for the `depth` parameter** is currently undocumented.

- Recommended that contributors start with **low values (like 2–3)** to avoid excessively long computations or errors.



### Motivation

This addition clarifies the usage of the `reasoning` parameter and helps contributors avoid unintended issues due to missing documentation about `depth`.



You can view, comment on, or merge this pull request online at:



  https://github.com/openai/openai-agents-python/pull/1676



-- Commit Summary --



  * Add Advanced Reasoning section with depth parameter note



-- File Changes --



    M docs/agents.md (13)



-- Patch Links --



https://github.com/openai/openai-agents-python/pull/1676.patch

https://github.com/openai/openai-agents-python/pull/1676.diff



-- 

Reply to this email directly or view it on GitHub:

https://github.com/openai/openai-agents-python/pull/1676

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



Message ID: &lt;openai/openai-agents-python/pull/1676@github.com&gt;

---

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