fix(py): improve tool call usage in docs

[huangjeff5]

Show default tool usage (defaulting to function name / docstring) rather than showing off name/description overrides, which is a secondary use case.

[gemini-code-assist]

Code Review

This pull request updates several documentation files to simplify the @ai.tool decorator by removing explicit name and description arguments, letting them default to the function name and docstring instead. The review feedback correctly identifies that changing the tool name from camelCase (getWeather) to snake_case (get_weather) in tool-calling.mdx introduces inconsistencies, as subsequent code examples in the same file still reference the old name and will fail at runtime.

[huangjeff5]

@gemini review

[gemini-code-assist]

Code Review

This pull request updates the documentation examples to define tools using the @ai.tool() decorator without explicit name and description arguments, defaulting instead to the function name and docstring. A review comment correctly identifies a missed reference in src/content/docs/docs/tool-calling.mdx where webSearch needs to be updated to web_search to prevent a NameError in the example code.

[huangjeff5]

Added a note in tool-calling.mdx clarifying that name and description decorator parameters can still be used to override the default function name and docstring in ec572a5.

[huangjeff5]

@gemini review

[huangjeff5]

Updated flows.mdx python examples in 5d1a415 to include docstrings and explained that @ai.flow() defaults name to function name and description to the docstring (with optional decorator parameter overrides).

[gemini-code-assist]

Code Review

This pull request updates the documentation across multiple files to demonstrate the simplified @ai.tool() decorator syntax, where the tool name defaults to the function name and the description is retrieved from the function's docstring. References to tool names have been updated from camelCase to snake_case to match this new behavior. There are no review comments, so I have no additional feedback to provide.