---
type: email
from: Kazuhiro Sera <notifications@github.com>
subject: Re: [openai/openai-agents-python] Enhance function tool schemas with

 Annotated types (PR #1777)
received: 2026-03-06 07:40:22
date_header: Sun, 21 Sep 2025 23:12:13 -0700
priority: normal
status: awaiting_approval
uid: 30956
---

## Email Content

**From:** Kazuhiro Sera <notifications@github.com>
**Subject:** Re: [openai/openai-agents-python] Enhance function tool schemas with

 Annotated types (PR #1777)
**Date:** Sun, 21 Sep 2025 23:12:13 -0700

### Body (preview)

@seratch commented on this pull request.







>  

 from openai.types.responses import ResponseFunctionCallArgumentsDeltaEvent

 

 from agents import Agent, Runner, function_tool

 

 

 @function_tool

-def write_file(filename: str, content: str) -> str:

+def write_file(filename:Annotated[str,"Name of the file"], content: str) -> str:



```suggestion

def write_file(filename: Annotated[str, "Name of the file"], content: str) -> str:

```



>      """Write content to a file."""

     return f"File {filename} written successfully"

 

 

 @function_tool

-def create_config(project_name: str, version: str, dependencies: list[str]) -> str:

-    """Create a configuration file for a project."""

+def create_config(project_name:Annotated[str,"Project name"], version:Annotated[str,"Project version"], dependencies: Annotated[Optional[list[str]],"Dependencies (list of packages)"]) -> str:



```suggestion

def create_config(

    project_name: Annotated[str, "Project name"],

    version: Annotated[str, "Project version"],

    dependencies: Annotated[Optional[list[str]], "Dependencies (list of packages)"],

) -> str:

```



-- 

Reply to this email directly or view it on GitHub:

https://github.com/openai/openai-agents-python/pull/1777#pullrequestreview-3250739663

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



Message ID: <openai/openai-agents-python/pull/1777/review/3250739663@github.com>

---

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