---
type: email
from: Muhammad Suhaib <notifications@github.com>
subject: [openai/openai-agents-python] docs: clarify ModelSettings.truncation

 behavior (PR #1570)
received: 2026-03-06 07:12:34
date_header: Sat, 23 Aug 2025 08:51:34 -0700
priority: normal
status: awaiting_approval
uid: 28484
---

## Email Content

**From:** Muhammad Suhaib <notifications@github.com>
**Subject:** [openai/openai-agents-python] docs: clarify ModelSettings.truncation

 behavior (PR #1570)
**Date:** Sat, 23 Aug 2025 08:51:34 -0700

### Body (preview)

docs: clarify ModelSettings.truncation behavior



- Expanded the docstring for `ModelSettings.truncation`.

- Documented the behavior of:

  * &quot;auto&quot;: drops middle conversation items if input exceeds context window, request still succeeds and streaming continues normally.

  * &quot;disabled&quot;: (default) request fails with 400 if input exceeds context window.

  * None: defers to provider default (typically &quot;disabled&quot;).

- Aligns SDK docs with the official API reference.



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



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



-- Commit Summary --



  * docs: clarify ToolsToFinalOutputResult docstrings

  * docs: clarify ModelSettings.truncation behavior



-- File Changes --



    A git (0)

    M src/agents/agent.py (9)

    M src/agents/model_settings.py (10)



-- Patch Links --



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

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



-- 

Reply to this email directly or view it on GitHub:

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

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



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

---

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