Get started with AgentCore Browser

AgentCore Browser enables your agents to interact with web pages through a managed Chrome browser. In this guide, you'll create an AI agent that navigates a website and extracts information — in under 5 minutes.

Prerequisites

Before you start, ensure you have:

IAM permissions

Attach this policy to your IAM identity. In the IAM Console, find your user or role, choose Add permissions > Create inline policy, switch to JSON view, and paste:

{
    "Version":"2012-10-17",			 	 	 		 	 	 
    "Statement": [
        {
            "Sid": "BedrockAgentCoreBrowserFullAccess",
            "Effect": "Allow",
            "Action": [
                "bedrock-agentcore:CreateBrowser",
                "bedrock-agentcore:ListBrowsers",
                "bedrock-agentcore:GetBrowser",
                "bedrock-agentcore:DeleteBrowser",
                "bedrock-agentcore:StartBrowserSession",
                "bedrock-agentcore:ListBrowserSessions",
                "bedrock-agentcore:GetBrowserSession",
                "bedrock-agentcore:StopBrowserSession",
                "bedrock-agentcore:UpdateBrowserStream",
                "bedrock-agentcore:ConnectBrowserAutomationStream",
                "bedrock-agentcore:ConnectBrowserLiveViewStream"
            ],
            "Resource": "arn:aws:bedrock-agentcore:<Region>:<account_id>:browser/*"
        },
        {
            "Sid": "BedrockModelAccess",
            "Effect": "Allow",
            "Action": [
                "bedrock:InvokeModel",
                "bedrock:InvokeModelWithResponseStream"
            ],
            "Resource": [
                "*"
            ]
        }
    ]
}

Step 1: Install dependencies

pip install bedrock-agentcore strands-agents strands-agents-tools playwright nest-asyncio

Step 2: Create your agent

Create a file named browser_agent.py:

from strands import Agent
from strands_tools.browser import AgentCoreBrowser

# Initialize the Browser tool
browser_tool = AgentCoreBrowser(region="<Region>")

# Create an agent with the Browser tool
agent = Agent(tools=[browser_tool.browser])

# Test the agent with a web search prompt
prompt = "what are the services offered by Bedrock AgentCore? Use the documentation link if needed: https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/what-is-bedrock-agentcore.html"
print(f"\n\nPrompt: {prompt}\n\n")

response = agent(prompt)
print("\n\nAgent Response:")
print(response.message["content"][0]["text"])

Step 3: Run the agent

python browser_agent.py

You should see the agent navigate the website and return details about AgentCore services. If you encounter errors, verify your IAM permissions, model access, and AWS credentials.

Step 4: View the browser session live

While your agent is running, you can watch it in real-time through the AWS Console:

The live view provides a real-time video stream with interactive controls to take over or release control from automation.

Find your resources

After using AgentCore Browser, view your resources in the AWS Console:

Next steps

Now that you have AgentCore Browser working, explore these advanced features: