---
type: email
from: Kazuhiro Sera <notifications@github.com>
subject: [openai/openai-agents-python] docs: update a few docs and code

 comments (PR #2564)
received: 2026-03-06 00:07:46
priority: high
status: awaiting_approval
---

## Email Content
This pull request updates a few document pages and comments in code for further clarity.

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



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



-- Commit Summary --



  * docs: update a few docs and code comments



-- File Changes --



    M docs/agents.md (43)

    M docs/mcp.md (1)

    M docs/tools.md (37)

    M src/agents/run_internal/oai_conversation.py (29)

    M src/agents/run_internal/session_persistence.py (21)

    M src/agents/run_state.py (35)



-- Patch Links --



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

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



-- 

Reply to this email directly or view it on GitHub:

https://github.com/openai/openai-agents-python/pul...

## Suggested Actions
- [ ] Reply
- [ ] Archive
- [ ] Flag for review
