From be58c5860eb1db4c7441325b5f70b9333913969b Mon Sep 17 00:00:00 2001
From: Rohan Mehta <rm@openai.com>
Date: Mon, 14 Apr 2025 11:39:10 -0400
Subject: [PATCH 1/2] Add docs for customizng agent-as-tool

---
 docs/tools.md | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/docs/tools.md b/docs/tools.md
index f7a88691..2d017c14 100644
--- a/docs/tools.md
+++ b/docs/tools.md
@@ -259,6 +259,27 @@ async def main():
     print(result.final_output)
 ```
 
+### Customizing tool-agents
+
+The `agent.as_tool` function is a convenience method to make it easy to turn an agent into a tool. It doesn't support all configuration though; for example, you can't set `max_turns`. For advanced use cases, it's very easy to configure it yourself:
+
+```python
+@function_tool
+async def run_my_agent() -> str:
+  """A tool that runs the agent with custom configs".
+
+    agent = Agent(name="My agent", instructions="...")
+
+    result = await Runner.run(
+        agent,
+        input="...",
+        max_turns=5,
+        run_config=...
+    )
+
+    return str(result.final_output)
+```
+
 ## Handling errors in function tools
 
 When you create a function tool via `@function_tool`, you can pass a `failure_error_function`. This is a function that provides an error response to the LLM in case the tool call crashes.

From 1da007533eba73241b326388aef4fa0903ad01bc Mon Sep 17 00:00:00 2001
From: Rohan Mehta <rm@openai.com>
Date: Mon, 14 Apr 2025 12:39:11 -0400
Subject: [PATCH 2/2] Update docs/tools.md

Co-authored-by: pakrym-oai <pakrym@openai.com>
---
 docs/tools.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/tools.md b/docs/tools.md
index 2d017c14..5fe2eced 100644
--- a/docs/tools.md
+++ b/docs/tools.md
@@ -261,7 +261,7 @@ async def main():
 
 ### Customizing tool-agents
 
-The `agent.as_tool` function is a convenience method to make it easy to turn an agent into a tool. It doesn't support all configuration though; for example, you can't set `max_turns`. For advanced use cases, it's very easy to configure it yourself:
+The `agent.as_tool` function is a convenience method to make it easy to turn an agent into a tool. It doesn't support all configuration though; for example, you can't set `max_turns`. For advanced use cases, use `Runner.run` directly in your tool implementation:
 
 ```python
 @function_tool