Docs: AWS Bedrock retry behavior (#3379)

Co-authored-by: Douwe Maan <[email protected]>

Author: cjermain

docs/models/bedrock.md

@@ -114,3 +114,47 @@ model = BedrockConverseModel(
 agent = Agent(model)
 ...
 ```
+
+## Configuring Retries
+
+Bedrock uses boto3's built-in retry mechanisms. You can configure retry behavior by passing a custom boto3 client with retry settings:
+
+```python
+import boto3
+from botocore.config import Config
+
+from pydantic_ai import Agent
+from pydantic_ai.models.bedrock import BedrockConverseModel
+from pydantic_ai.providers.bedrock import BedrockProvider
+
+# Configure retry settings
+config = Config(
+    retries={
+        'max_attempts': 5,
+        'mode': 'adaptive'  # Recommended for rate limiting
+    }
+)
+
+bedrock_client = boto3.client(
+    'bedrock-runtime',
+    region_name='us-east-1',
+    config=config
+)
+
+model = BedrockConverseModel(
+    'us.amazon.nova-micro-v1:0',
+    provider=BedrockProvider(bedrock_client=bedrock_client),
+)
+agent = Agent(model)
+```
+
+### Retry Modes
+
+- `'legacy'` (default): 5 attempts, basic retry behavior
+- `'standard'`: 3 attempts, more comprehensive error coverage
+- `'adaptive'`: 3 attempts with client-side rate limiting (recommended for handling `ThrottlingException`)
+
+For more details on boto3 retry configuration, see the [AWS boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/retries.html).
+
+!!! note
+    Unlike other providers that use httpx for HTTP requests, Bedrock uses boto3's native retry mechanisms. The retry strategies described in [HTTP Request Retries](../retries.md) do not apply to Bedrock.

docs/retries.md

@@ -339,3 +339,17 @@ agent = Agent(model)
 - Use async transports for better concurrency when handling multiple requests
 
 For more advanced retry configurations, refer to the [tenacity documentation](https://tenacity.readthedocs.io/).
+
+## Provider-Specific Retry Behavior
+
+### AWS Bedrock
+
+The AWS Bedrock provider uses boto3's built-in retry mechanisms instead of httpx. To configure retries for Bedrock, use boto3's `Config`:
+
+```python
+from botocore.config import Config
+
+config = Config(retries={'max_attempts': 5, 'mode': 'adaptive'})
+```
+
+See [Bedrock: Configuring Retries](models/bedrock.md#configuring-retries) for complete examples.