Agentcore

1---2name: agentcore3description: Run agent-browser on AWS Bedrock AgentCore cloud browsers. Use when the user wants to use AgentCore, run browser automation on AWS, use a cloud browser with AWS credentials, or needs a managed browser session backed by AWS infrastructure. Triggers include "use agentcore", "run on AWS", "cloud browser with AWS", "bedrock browser", "agentcore session", or any task requiring AWS-hosted browser automation.4allowed-tools: Bash(agent-browser:*), Bash(npx agent-browser:*)5---6 7# AWS Bedrock AgentCore8 9Run agent-browser on cloud browser sessions hosted by AWS Bedrock AgentCore. All standard agent-browser commands work identically; the only difference is where the browser runs.10 11## Setup12 13Credentials are resolved automatically:14 151. Environment variables (`AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY`, optionally `AWS_SESSION_TOKEN`)162. AWS CLI fallback (`aws configure export-credentials`), which supports SSO, IAM roles, and named profiles17 18No additional setup is needed if the user already has working AWS credentials.19 20## Core Workflow21 22```bash23# Open a page on an AgentCore cloud browser24agent-browser -p agentcore open https://example.com25 26# Everything else is the same as local Chrome27agent-browser snapshot -i28agent-browser click @e129agent-browser screenshot page.png30agent-browser close31```32 33## Environment Variables34 35| Variable | Description | Default |36|----------|-------------|---------|37| `AGENTCORE_REGION` | AWS region | `us-east-1` |38| `AGENTCORE_BROWSER_ID` | Browser identifier | `aws.browser.v1` |39| `AGENTCORE_PROFILE_ID` | Persistent browser profile (cookies, localStorage) | (none) |40| `AGENTCORE_SESSION_TIMEOUT` | Session timeout in seconds | `3600` |41| `AWS_PROFILE` | AWS CLI profile for credential resolution | `default` |42 43## Persistent Profiles44 45Use `AGENTCORE_PROFILE_ID` to persist browser state across sessions. This is useful for maintaining login sessions:46 47```bash48# First run: log in49AGENTCORE_PROFILE_ID=my-app agent-browser -p agentcore open https://app.example.com/login50agent-browser snapshot -i51agent-browser fill @e1 "user@example.com"52agent-browser fill @e2 "password"53agent-browser click @e354agent-browser close55 56# Future runs: already authenticated57AGENTCORE_PROFILE_ID=my-app agent-browser -p agentcore open https://app.example.com/dashboard58```59 60## Live View61 62When a session starts, AgentCore prints a Live View URL to stderr. Open it in a browser to watch the session in real time from the AWS Console:63 64```65Session: abc123-def45666Live View: https://us-east-1.console.aws.amazon.com/bedrock-agentcore/browser/aws.browser.v1/session/abc123-def456#67```68 69## Region Selection70 71```bash72# Default: us-east-173agent-browser -p agentcore open https://example.com74 75# Explicit region76AGENTCORE_REGION=eu-west-1 agent-browser -p agentcore open https://example.com77```78 79## Credential Patterns80 81```bash82# Explicit credentials (CI/CD, scripts)83export AWS_ACCESS_KEY_ID=AKIA...84export AWS_SECRET_ACCESS_KEY=...85agent-browser -p agentcore open https://example.com86 87# SSO (interactive)88aws sso login --profile my-profile89AWS_PROFILE=my-profile agent-browser -p agentcore open https://example.com90 91# IAM role / default credential chain92agent-browser -p agentcore open https://example.com93```94 95## Using with AGENT_BROWSER_PROVIDER96 97Set the provider via environment variable to avoid passing `-p agentcore` on every command:98 99```bash100export AGENT_BROWSER_PROVIDER=agentcore101export AGENTCORE_REGION=us-east-2102 103agent-browser open https://example.com104agent-browser snapshot -i105agent-browser click @e1106agent-browser close107```108 109## Common Issues110 111**"Failed to run aws CLI"** means AWS CLI is not installed or not in PATH. Either install it or set `AWS_ACCESS_KEY_ID` and `AWS_SECRET_ACCESS_KEY` directly.112 113**"AWS CLI failed: ... Run 'aws sso login'"** means SSO credentials have expired. Run `aws sso login` to refresh them.114 115**Session timeout:** The default is 3600 seconds (1 hour). For longer tasks, increase with `AGENTCORE_SESSION_TIMEOUT=7200`.