provide env var to enable tool error logging

Author: Bohdan Danyliuk

src/agents/_debug.py

@@ -17,6 +17,10 @@ def _load_dont_log_tool_data() -> bool:
     return _debug_flag_enabled("OPENAI_AGENTS_DONT_LOG_TOOL_DATA", default=True)
 
 
+def _load_log_tool_errors() -> bool:
+    return _debug_flag_enabled("OPENAI_AGENTS_LOG_TOOL_ERRORS", default=False)
+
+
 DONT_LOG_MODEL_DATA = _load_dont_log_model_data()
 """By default we don't log LLM inputs/outputs, to prevent exposing sensitive information. Set this
 flag to enable logging them.
@@ -26,3 +30,6 @@ def _load_dont_log_tool_data() -> bool:
 """By default we don't log tool call inputs/outputs, to prevent exposing sensitive information. Set
 this flag to enable logging them.
 """
+
+LOG_TOOL_ERRORS = _load_log_tool_errors()
+"""By default we don't log tool errors. Set this flag to enable logging them."""

src/agents/tool.py

@@ -456,6 +456,11 @@ async def _on_invoke_tool(ctx: ToolContext[Any], input: str) -> Any:
                         },
                     )
                 )
+                if _debug.LOG_TOOL_ERRORS:
+                    logger.exception(
+                        f"Tool error occurred: {e.__class__.__name__}",
+                        exc_info=e,
+                    )
                 return result
 
         return FunctionTool(