AWS Bedrock Practical Guide for Beginners

python -m venv .venv
source .venv/bin/activate

pip install --upgrade boto3

export AWS_REGION="eu-west-1"
export BEDROCK_MODEL_ID="your-supported-model-or-inference-profile-id"

# Optional when using a named local AWS profile:
export AWS_PROFILE="your-profile-name"

import os

import boto3
from botocore.exceptions import BotoCoreError, ClientError


AWS_REGION = os.getenv("AWS_REGION", "us-east-1")
MODEL_ID = os.environ["BEDROCK_MODEL_ID"]

client = boto3.client(
    "bedrock-runtime",
    region_name=AWS_REGION,
)


def ask_bedrock(question: str) -> str:
    """Send one question to a Bedrock model using Converse."""

    cleaned_question = question.strip()

    if not cleaned_question:
        raise ValueError("question cannot be empty")

    try:
        response = client.converse(
            modelId=MODEL_ID,
            system=[
                {
                    "text": (
                        "You are a practical AWS assistant. "
                        "Give clear, accurate, concise answers. "
                        "State when important information is missing."
                    )
                }
            ],
            messages=[
                {
                    "role": "user",
                    "content": [
                        {
                            "text": cleaned_question,
                        }
                    ],
                }
            ],
            inferenceConfig={
                "maxTokens": 500,
                "temperature": 0.2,
            },
        )

    except ClientError as exc:
        error = exc.response.get("Error", {})
        code = error.get("Code", "UnknownError")
        message = error.get("Message", str(exc))

        raise RuntimeError(
            f"Amazon Bedrock request failed: {code}: {message}"
        ) from exc

    except BotoCoreError as exc:
        raise RuntimeError(
            f"AWS SDK request failed: {exc}"
        ) from exc

    content = response["output"]["message"]["content"]

    text_blocks = [
        block["text"]
        for block in content
        if "text" in block
    ]

    if not text_blocks:
        raise RuntimeError(
            "Amazon Bedrock returned no text content"
        )

    return "\n".join(text_blocks)


if __name__ == "__main__":
    answer = ask_bedrock(
        "Explain Amazon Bedrock in simple terms."
    )

    print(answer)