feat(python): Pydantic AI integration tool call exception option (#15849)

Document getsentry/sentry-python#5237.

Author: alexander-alderman-webb

docs/platforms/python/integrations/pydantic-ai/index.mdx

@@ -241,6 +241,13 @@ You can pass the following keyword arguments to `PydanticAIIntegration()`:
 
   The default is `True`.
 
+- `handled_tool_call_exceptions`:
+
+  Option to capture tool call exceptions that Pydantic AI prevents from bubbling up. These include validation errors when an agent is configured to
+  retry tool calls. All additional tool call exceptions reported when this option is `True` are handled errors in Sentry. This option has no effect on exceptions that are not handled by Pydantic AI.
+
+  The default is `True`.
+
 ## Supported Versions
 
 - Pydantic AI: 1.0.0+