Skip to content

Commit 9b0c761

Browse files
authored
feat: Add callouts for common bedrock errors (#102)
Co-authored-by: Mackenzie Zastrow <zastrowm@users.noreply.github.com>
1 parent ea00dc3 commit 9b0c761

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
@@ -511,6 +511,36 @@ response = agent("If a train travels at 120 km/h and needs to cover 450 km, how
511511

512512
> **Note**: Not all models support structured reasoning output. Check the [inference reasoning documentation](https://docs.aws.amazon.com/bedrock/latest/userguide/inference-reasoning.html) for details on supported models.
513513
514+
## Troubleshooting
515+
516+
### Model access issue
517+
518+
If you encounter the following error:
519+
520+
> You don't have access to the model with the specified model ID
521+
522+
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
523+
524+
### On-demand throughput isn’t supported
525+
526+
If you encounter the error:
527+
528+
> 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.
529+
530+
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:
531+
532+
Instead of:
533+
534+
```
535+
anthropic.claude-3-7-sonnet-20250219-v1:0
536+
```
537+
538+
Use:
539+
540+
```
541+
us.anthropic.claude-3-7-sonnet-20250219-v1:0
542+
```
543+
514544
## Related Resources
515545

516546
- [Amazon Bedrock Documentation](https://docs.aws.amazon.com/bedrock/)

0 commit comments

Comments
 (0)