Quick Start

This guide will help you get started with the Amazon Bedrock Agents with Return Control SDK by creating a simple agent that can tell you the current time.

Minimal Working Example

# Minimal working example
import datetime
from bedrock_agents_sdk import Client, Agent, ActionGroup

def get_time() -> dict:
    """Get the current time"""
    now = datetime.datetime.now()
    return {"time": now.strftime("%H:%M:%S")}

# Create an action group for time-related functions
time_group = ActionGroup(
    name="TimeService",
    description="Provides time-related information",
    functions=[get_time]
)

# Create the agent with the action group
agent = Agent(
    name="TimeAgent",
    model="anthropic.claude-3-sonnet-20240229-v1:0",
    instructions="You are a helpful assistant that can tell the time.",
    action_groups=[time_group]
)

client = Client()

# Run the agent locally
client.run(agent=agent)

Step-by-Step Guide

1. Install the SDK

pip install git+https://github.com/aws-samples/bedrock-agents-sdk.git

2. Create a Python File

Create a new file called time_agent.py and add the code from the minimal working example above.

3. Run the Agent Locally

python time_agent.py

4. Deploy to AWS

To deploy your agent to AWS, use the deploy method:

client.deploy(
    stack_name="time-agent",
    s3_bucket="my-deployment-bucket",
    s3_prefix="time-agent"
)

That’s it! You’ve created and deployed your first agent using the Amazon Bedrock Agents with Return Control SDK.