> ## Documentation Index
> Fetch the complete documentation index at: https://spacesail.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# AWS Bedrock

> Learn how to use AWS Bedrock with Agno.

Use AWS Bedrock to access various foundation models on AWS. Manage your access to models [on the portal](https://us-east-1.console.aws.amazon.com/bedrock/home?region=us-east-1#/model-catalog).

See all the [AWS Bedrock foundational models](https://docs.aws.amazon.com/bedrock/latest/userguide/models-supported.html). Not all Bedrock models support all features. See the [supported features for each model](https://docs.aws.amazon.com/bedrock/latest/userguide/conversation-inference-supported-models-features.html).

We recommend experimenting to find the best-suited model for your use-case. Here are some general recommendations:

* For a Mistral model with generally good performance, look at `mistral.mistral-large-2402-v1:0`.
* You can play with Amazon Nova models. Use `amazon.nova-pro-v1:0` for general purpose tasks.
* For Claude models, see our [Claude integration](/concepts/models/aws-claude).

<Warning>
  Async usage of AWS Bedrock is not yet supported. When using `AwsBedrock` with
  an `Agent`, you can only use `agent.run` and `agent.print_response`.
</Warning>

## Authentication

Set your `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY` and `AWS_REGION` environment variables.

Get your keys from [here](https://us-east-1.console.aws.amazon.com/iam/home?region=us-east-1#/home).

<CodeGroup>
  ```bash Mac theme={null}
  export AWS_ACCESS_KEY_ID=***
  export AWS_SECRET_ACCESS_KEY=***
  export AWS_REGION=***
  ```

  ```bash Windows theme={null}
  setx AWS_ACCESS_KEY_ID ***
  setx AWS_SECRET_ACCESS_KEY ***
  setx AWS_REGION ***
  ```
</CodeGroup>

## Example

Use `AwsBedrock` with your `Agent`:

<CodeGroup>
  ```python agent.py theme={null}
  from agno.agent import Agent
  from agno.models.aws import AwsBedrock

  agent = Agent(
      model=AwsBedrock(id="mistral.mistral-large-2402-v1:0"),
      markdown=True
  )

  # Print the response on the terminal
  agent.print_response("Share a 2 sentence horror story.")
  ```
</CodeGroup>

<Note> View more examples [here](/examples/models/aws/bedrock/basic). </Note>

## Parameters

| Parameter               | Type                       | Default                             | Description                                                                                                                                                               |
| ----------------------- | -------------------------- | ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id`                    | `str`                      | `"mistral.mistral-small-2402-v1:0"` | The specific model ID used for generating responses.                                                                                                                      |
| `name`                  | `str`                      | `"AwsBedrock"`                      | The name identifier for the AWS Bedrock agent.                                                                                                                            |
| `provider`              | `str`                      | `"AwsBedrock"`                      | The provider of the model.                                                                                                                                                |
| `aws_sso_auth`          | `Optional[bool]`           | `False`                             | Remove the need for access and secret keys by leveraging the current profile's authentication.                                                                            |
| `aws_region`            | `Optional[str]`            | `None`                              | The AWS region to use for API requests.                                                                                                                                   |
| `aws_access_key_id`     | `Optional[str]`            | `None`                              | The AWS access key ID to use for authentication.                                                                                                                          |
| `aws_secret_access_key` | `Optional[str]`            | `None`                              | The AWS secret access key to use for authentication.                                                                                                                      |
| `session`               | `Optional[Session]`        | `None`                              | A boto3 Session object to use for authentication.                                                                                                                         |
| `max_tokens`            | `Optional[int]`            | `None`                              | The maximum number of tokens to generate in the response.                                                                                                                 |
| `temperature`           | `Optional[float]`          | `None`                              | The sampling temperature to use, between 0 and 2. Higher values like 0.8 make the output more random, while lower values like 0.2 make it more focused and deterministic. |
| `top_p`                 | `Optional[float]`          | `None`                              | The nucleus sampling parameter. The model considers the results of the tokens with top\_p probability mass.                                                               |
| `stop_sequences`        | `Optional[List[str]]`      | `None`                              | A list of sequences where the API will stop generating further tokens.                                                                                                    |
| `request_params`        | `Optional[Dict[str, Any]]` | `None`                              | Additional parameters for the request, provided as a dictionary.                                                                                                          |
| `client_params`         | `Optional[Dict[str, Any]]` | `None`                              | Additional client parameters for initializing the `AwsBedrock` client, provided as a dictionary.                                                                          |
| `client`                | `Optional[AwsClient]`      | `None`                              | A pre-configured AWS client instance.                                                                                                                                     |

`AwsBedrock` is a subclass of the [Model](/reference/models/model) class and has access to the same params.
