Skip to content

AgentCore Browser

AWS-managed browser automation provider backed by Bedrock AgentCore using Playwright.

Configuration

Server-Side (Gateway Config)

providers:
  browser:
    backend: "agentic_primitives_gateway.primitives.browser.agentcore.AgentCoreBrowserProvider"
    config:
      region: "us-east-1"
Parameter Default Description
region us-east-1 AWS region for AgentCore

Using the Browser API

All standard browser endpoints work with this provider. See the Browser API reference for the full endpoint list.

# Start a session
curl -X POST http://localhost:8000/api/v1/browser/sessions

# Navigate
curl -X POST http://localhost:8000/api/v1/browser/sessions/{id}/navigate \
  -d '{"url": "https://example.com"}'

# Read page content
curl http://localhost:8000/api/v1/browser/sessions/{id}/content

Using with Declarative Agents

agents:
  specs:
    web-agent:
      model: "us.anthropic.claude-sonnet-4-20250514-v1:0"
      primitives:
        browser:
          enabled: true

Prerequisites

  • pip install agentic-primitives-gateway[agentcore]
  • AWS credentials with AgentCore access
  • Playwright browsers managed by AgentCore