Skip to content

clarify docs for tool_use_behavior and simplify description of stop_on_first_tool behavior #1510

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Aug 18, 2025
+7 −3
Merged

clarify docs for tool_use_behavior and simplify description of stop_on_first_tool behavior #1510

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
9121ddb
Update docstring in `_check_for_final_output_from_tools` to reflect c…
Abishai-kashif Aug 17, 2025
799cf3e
Clarify that first tool call output is used directly as final result
Abishai-kashif Aug 17, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 4 additions & 1 deletion src/agents/_run_impl.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -961,7 +961,10 @@ async def _check_for_final_output_from_tools(
context_wrapper: RunContextWrapper[TContext],
config: RunConfig,
) -> ToolsToFinalOutputResult:
"""Returns (i, final_output)."""
"""Determine if tool results should produce a final output.
Returns:
ToolsToFinalOutputResult: Indicates whether final output is ready, and the output value.
"""
if not tool_results:
return _NOT_FINAL_OUTPUT

Expand Down
5 changes: 3 additions & 2 deletions src/agents/agent.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -205,8 +205,9 @@ class Agent(AgentBase, Generic[TContext]):
This lets you configure how tool use is handled.
- "run_llm_again": The default behavior. Tools are run, and then the LLM receives the results
and gets to respond.
- "stop_on_first_tool": The output of the first tool call is used as the final output. This
means that the LLM does not process the result of the tool call.
- "stop_on_first_tool": The output from the first tool call is treated as the final result.
In other words, it isn’t sent back to the LLM for further processing but is used directly
as the final output.
- A StopAtTools object: The agent will stop running if any of the tools listed in
`stop_at_tool_names` is called.
The final output will be the output of the first matching tool call.
Expand Down