docs: disable thinking config (#1779)

Author: Kludex

docs/models/gemini.md

@@ -183,7 +183,7 @@ agent = Agent(model)
 ...
 ```
 
-### Customising region
+### Customizing region
 
 Whichever way you authenticate, you can specify which region requests will be sent to via the `region` argument.
 
@@ -218,3 +218,46 @@ model = GeminiModel(
 agent = Agent(model)
 ...
 ```
+
+### Model settings
+
+You can use the [`GeminiModelSettings`][pydantic_ai.models.gemini.GeminiModelSettings] class to customize the model request.
+
+#### Disable thinking
+
+You can disable thinking by setting the `thinking_budget` to `0` on the `google_thinking_config`:
+
+```python
+from pydantic_ai import Agent
+from pydantic_ai.models.gemini import GeminiModel, GeminiModelSettings
+
+model_settings = GeminiModelSettings(gemini_thinking_config={'thinking_budget': 0})
+model = GeminiModel('gemini-2.0-flash')
+agent = Agent(model, model_settings=model_settings)
+...
+```
+
+Check out the [Gemini API docs](https://ai.google.dev/gemini-api/docs/thinking) for more on thinking.
+
+#### Safety settings
+
+You can customize the safety settings by setting the `google_safety_settings` field.
+
+```python
+from pydantic_ai import Agent
+from pydantic_ai.models.gemini import GeminiModel, GeminiModelSettings
+
+model_settings = GeminiModelSettings(
+    gemini_safety_settings=[
+        {
+            'category': 'HARM_CATEGORY_DANGEROUS_CONTENT',
+            'threshold': 'BLOCK_ONLY_HIGH',
+        }
+    ]
+)
+model = GeminiModel('gemini-2.0-flash')
+agent = Agent(model, model_settings=model_settings)
+...
+```
+
+Check out the [Gemini API docs](https://ai.google.dev/gemini-api/docs/safety-settings) for more on safety settings.

docs/models/google.md

@@ -158,3 +158,48 @@ See the [Gemini API docs](https://ai.google.dev/gemini-api/docs/safety-settings)
 
     See [this discussion](https://discuss.ai.google.dev/t/i-am-using-google-generative-ai-model-gemini-1-5-pro-for-image-analysis-but-getting-error/34866/4)
     for more details.
+
+## Model settings
+
+You can use the [`GoogleModelSettings`][pydantic_ai.models.google.GoogleModelSettings] class to customize the model request.
+
+### Disable thinking
+
+You can disable thinking by setting the `thinking_budget` to `0` on the `google_thinking_config`:
+
+```python
+from pydantic_ai import Agent
+from pydantic_ai.models.google import GoogleModel, GoogleModelSettings
+
+model_settings = GoogleModelSettings(google_thinking_config={'thinking_budget': 0})
+model = GoogleModel('gemini-2.0-flash')
+agent = Agent(model, model_settings=model_settings)
+...
+```
+
+Check out the [Gemini API docs](https://ai.google.dev/gemini-api/docs/thinking) for more on thinking.
+
+### Safety settings
+
+You can customize the safety settings by setting the `google_safety_settings` field.
+
+```python
+from google.genai.types import HarmBlockThreshold, HarmCategory
+
+from pydantic_ai import Agent
+from pydantic_ai.models.google import GoogleModel, GoogleModelSettings
+
+model_settings = GoogleModelSettings(
+    google_safety_settings=[
+        {
+            'category': HarmCategory.HARM_CATEGORY_HATE_SPEECH,
+            'threshold': HarmBlockThreshold.BLOCK_LOW_AND_ABOVE,
+        }
+    ]
+)
+model = GoogleModel('gemini-2.0-flash')
+agent = Agent(model, model_settings=model_settings)
+...
+```
+
+See the [Gemini API docs](https://ai.google.dev/gemini-api/docs/safety-settings) for more on safety settings.

pydantic_ai_slim/pydantic_ai/_cli.py

@@ -57,7 +57,7 @@
 
 
 class SimpleCodeBlock(CodeBlock):
-    """Customised code blocks in markdown.
+    """Customized code blocks in markdown.
 
     This avoids a background color which messes up copy-pasting and sets the language name as dim prefix and suffix.
     """
@@ -70,7 +70,7 @@ def __rich_console__(self, console: Console, options: ConsoleOptions) -> RenderR
 
 
 class LeftHeading(Heading):
-    """Customised headings in markdown to stop centering and prepend markdown style hashes."""
+    """Customized headings in markdown to stop centering and prepend markdown style hashes."""
 
     def __rich_console__(self, console: Console, options: ConsoleOptions) -> RenderResult:
         # note we use `Style(bold=True)` not `self.style_name` here to disable underlining which is ugly IMHO