Amazon Bedrock is a fully managed service on AWS that provides access to foundation models from various AI companies through a single API.

​
How to Set Up Amazon Bedrock Chat Models

We recommend configuring Claude 3.7 Sonnet as your chat model.
config.yaml
models:
  - name: Claude 3.7 Sonnet
    provider: bedrock
    model: us.anthropic.claude-3-7-sonnet-20250219-v1:0
    env:
      region: us-east-1
      profile: bedrock
    roles:
      - chat
If you run into the following error when connecting to the new Claude 3.5 Sonnet 2 models from AWS - 400 Invocation of model ID anthropic.claude-3-5-sonnet-20241022-v2:0 with on-demand throughput isn't supported. Retry your request with the ID or ARN of an inference profile that contains this model.
You can fix this using the following config:
config.yaml
models:
  - name: Claude 3.5 Sonnet
    provider: bedrock
    model: us.anthropic.claude-3-5-sonnet-20241022-v2:0
    env:
      region: us-east-1
      profile: bedrock
    roles:
      - chat

​
How to Set Up Amazon Bedrock Autocomplete Models

Bedrock currently does not offer any autocomplete models. However, Codestral from Mistral and Point from Poolside will be supported in the near future. In the meantime, you can view a list of autocomplete model providers here.

​
How to Configure Amazon Bedrock Embeddings Models

We recommend configuring amazon.titan-embed-text-v2:0 as your embeddings model.
config.yaml
models:
  - name: Embeddings Model
    provider: bedrock
    model: amazon.titan-embed-text-v2:0
    env:
      region: us-west-2
    roles:
      - embed

​
How to Configure Amazon Bedrock Reranking Models

We recommend configuring cohere.rerank-v3-5:0 as your reranking model, you may also use amazon.rerank-v1:0.
config.yaml
models:
  - name: Bedrock Reranker
    provider: bedrock
    model: cohere.rerank-v3-5:0
    env:
      region: us-west-2
    roles:
      - rerank

​
How to Enable Prompt Caching with Amazon Bedrock

Bedrock allows Claude models to cache tool payloads, system messages, and chat messages between requests. Enable this behavior by adding promptCaching: true under defaultCompletionOptions in your model configuration. Prompt caching is generally available for:
  • Claude 3.7 Sonnet
  • Claude 3.5 Haiku
  • Amazon Nova Micro
  • Amazon Nova Lite
  • Amazon Nova Pro
Customers who were granted access to Claude 3.5 Sonnet v2 during the prompt caching preview will retain that access, but it cannot be enabled for new users on that model.
config.yaml
models:
  - name: Claude 3.7 Sonnet
    provider: bedrock
    model: us.anthropic.claude-3-7-sonnet-20250219-v1:0
    defaultCompletionOptions:
      promptCaching: true
Prompt caching is not supported in JSON configuration files, so use the YAML syntax above to enable it.

​
How to Set Up Authentication for Amazon Bedrock

Authentication will be through temporary or long-term credentials in ~/.aws/credentials under a configured profile (e.g. “bedrock”). 
[bedrock]
aws_access_key_id = abcdefg
aws_secret_access_key = hijklmno
aws_session_token = pqrstuvwxyz # Optional: means short term creds.
You can also use an AWS accessKeyId and secretAccessKey for authentication instead of a local credentials profile.
config.yaml
models:
  - name: Claude 3.7 Sonnet
    provider: bedrock
    model: us.anthropic.claude-3-7-sonnet-20250219-v1:0
    env:
      region: us-east-1
      accessKeyId: ${{ secrets.AWS_ACCESS_KEY_ID }} # can also enter key inline here for local assistants
      secretAccessKey: ${{ secrets.AWS_SECRET_ACCESS_KEY }} # can also enter key inline here for local assistants
    roles:
      - chat

​
How to Configure Custom Imported Models with Amazon Bedrock

To setup Bedrock using custom imported models, add the following to your config file:
config.yaml
models:
  - name: AWS Bedrock deepseek-coder-6.7b-instruct
    provider: bedrockimport
    model: deepseek-coder-6.7b-instruct
    env:
      region: us-west-2
      profile: bedrock
      modelArn: arn:aws:bedrock:us-west-2:XXXXX:imported-model/XXXXXX
Authentication will be through temporary or long-term credentials in ~/.aws/credentials under a configured profile (e.g. “bedrock”). 
[bedrock]
aws_access_key_id = abcdefg
aws_secret_access_key = hijklmno
aws_session_token = pqrstuvwxyz # Optional: means short term creds.