Skip to main content

​
Code

cookbook/tools/aws_ses_tools.py
from agno.agent import Agent
from agno.models.openai import OpenAIChat
from agno.tools.aws_ses import AWSSESTool
from agno.tools.duckduckgo import DuckDuckGoTools

# Configure email settings
sender_email = "[email protected]"  # Your verified SES email
sender_name = "AI Research Updates"
region_name = "us-east-1"

# Create an agent that can research and send personalized email updates
agent = Agent(
    name="Research Newsletter Agent",
    model=OpenAIChat(id="gpt-4o"),
    description="""You are an AI research specialist who creates and sends
    personalized email newsletters about the latest developments in artificial
    intelligence and technology.""",
    instructions=[
        """When given a prompt:,
        1. Extract the recipient's email address carefully. Look for the
        complete email in format '[email protected]'.,
        2. Research the latest AI developments using DuckDuckGo,
        3. Compose a concise, engaging email with:
           - A compelling subject line,
           - 3-4 key developments or news items,
           - Brief explanations of why they matter,
           - Links to sources,
        4. Format the content in a clean, readable way,
        5. Send the email using AWS SES. IMPORTANT: The receiver_email parameter
        must be the COMPLETE email address including the @ symbol and domain.""",
    ],
    tools=[
        AWSSESTool(
            sender_email=sender_email,
            sender_name=sender_name,
            region_name=region_name
        ),
        DuckDuckGoTools(),
    ],
    markdown=True,
    show_tool_calls=True,
)

agent.print_response(
    "Research AI developments in healthcare from the past week with a focus on practical applications in clinical settings. Send the summary via email to [email protected]"
)

​
Usage

1

Create a virtual environment

Open the Terminal and create a python virtual environment.
python3 -m venv .venv
source .venv/bin/activate
2

Set up AWS SES

​
Verify your email/domain: For testing: 1. Go to [AWS SES

Console](https://console.aws.amazon.com/ses/home) > Verified Identities > Create Identity 2. Choose “Email Address” verification 3. Click verification link sent to your email For production: 1. Choose “Domain” and follow DNS verification steps 2. Add DKIM and SPF records to your domain’s DNS Note: In sandbox mode, both sender and recipient emails must be verified.
3

Configure AWS credentials

​
Create IAM user: 1. Go to IAM Console > Users > Add User 2. Enable

“Programmatic access” 3. Attach ‘AmazonSESFullAccess’ policy ### Set credentials (choose one method): Method 1 - Using AWS CLI: bash aws configure Method 2 - Environment variables: bash export AWS_ACCESS_KEY_ID=xxx export AWS_SECRET_ACCESS_KEY=xxx export AWS_DEFAULT_REGION=us-east-1 export OPENAI_API_KEY=xxx
4

Install libraries

bash pip install -U boto3 openai duckduckgo-search agno
5

Run Agent

bash python cookbook/tools/aws_ses_tools.py
6

Troubleshooting

If emails aren’t sending, check:
  • Both sender and recipient are verified (in sandbox mode)
  • AWS credentials are correctly configured
  • You’re within sending limits
  • Your IAM user has correct SES permissions
  • Use SES Console’s ‘Send Test Email’ feature to verify setup