Skip to content

Commit a3bcc46

Browse files
zastrowmUnshure
authored andcommitted
feat: Add callouts for common bedrock errors (strands-agents#102)
Co-authored-by: Mackenzie Zastrow <zastrowm@users.noreply.github.com>
1 parent 1c5a027 commit a3bcc46

File tree

1 file changed

+30
-0
lines changed

1 file changed

+30
-0
lines changed

docs/user-guide/concepts/model-providers/amazon-bedrock.md

Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -553,6 +553,36 @@ print(f"Category: {result.category}")
553553
print(f"Price: ${result.price}")
554554
print(f"Features: {result.features}")
555555
print(f"Rating: {result.rating}")
556+
557+
558+
## Troubleshooting
559+
560+
### Model access issue
561+
562+
If you encounter the following error:
563+
564+
> You don't have access to the model with the specified model ID
565+
566+
This may indicate that the model is not enabled in your Amazon Bedrock account for the specified region. To resolve this issue follow the [instructions above](#requesting-access-to-bedrock-models) to request access to the model
567+
568+
### On-demand throughput isn’t supported
569+
570+
If you encounter the error:
571+
572+
> Invocation of model ID XXXX with on-demand throughput isn’t supported. Retry your request with the ID or ARN of an inference profile that contains this model.
573+
574+
This typically indicates that the model requires Cross-Region Inference, as documented in the [Amazon Bedrock documentation on inference profiles](https://docs.aws.amazon.com/bedrock/latest/userguide/inference-profiles-support.html#inference-profiles-support-system). To resolve this issue, prefix your model ID with the appropriate regional identifier (`us.`or `eu.`) based on where your agent is running. For example:
575+
576+
Instead of:
577+
578+
```
579+
anthropic.claude-3-7-sonnet-20250219-v1:0
580+
```
581+
582+
Use:
583+
584+
```
585+
us.anthropic.claude-3-7-sonnet-20250219-v1:0
556586
```
557587

558588
## Related Resources

0 commit comments

Comments
 (0)